import type { HexGetProjectRunsParams, HexGetProjectRunsResponse } from '@/tools/hex/types' import type { ToolConfig } from '@/tools/types' export const getProjectRunsTool: ToolConfig = { id: 'hex_get_project_runs', name: 'Hex Get Project Runs', description: 'Retrieve API-triggered runs for a Hex project with optional filtering by status and pagination.', version: '1.0.0', params: { apiKey: { type: 'string', required: true, visibility: 'user-only', description: 'Hex API token (Personal or Workspace)', }, projectId: { type: 'string', required: true, visibility: 'user-or-llm', description: 'The UUID of the Hex project', }, limit: { type: 'number', required: false, visibility: 'user-or-llm', description: 'Maximum number of runs to return (1-100, default: 25)', }, offset: { type: 'number', required: false, visibility: 'user-or-llm', description: 'Offset for paginated results (default: 0)', }, statusFilter: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Filter by run status: PENDING, RUNNING, ERRORED, COMPLETED, KILLED, UNABLE_TO_ALLOCATE_KERNEL', }, runTriggerFilter: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Filter by how the run was triggered: ALL, API, SCHEDULED, or APP_REFRESH', }, }, request: { url: (params) => { const searchParams = new URLSearchParams() if (params.limit) searchParams.set('limit', String(params.limit)) if (params.offset) searchParams.set('offset', String(params.offset)) if (params.statusFilter) searchParams.set('statusFilter', params.statusFilter) if (params.runTriggerFilter) searchParams.set('runTriggerFilter', params.runTriggerFilter) const qs = searchParams.toString() return `https://app.hex.tech/api/v1/projects/${params.projectId.trim()}/runs${qs ? `?${qs}` : ''}` }, method: 'GET', headers: (params) => ({ Authorization: `Bearer ${params.apiKey}`, 'Content-Type': 'application/json', }), }, transformResponse: async (response: Response) => { const data = await response.json() const runs = Array.isArray(data) ? data : (data.runs ?? []) return { success: true, output: { runs: runs.map((r: Record) => ({ projectId: (r.projectId as string) ?? null, runId: (r.runId as string) ?? null, runUrl: (r.runUrl as string) ?? null, status: (r.status as string) ?? null, startTime: (r.startTime as string) ?? null, endTime: (r.endTime as string) ?? null, elapsedTime: (r.elapsedTime as number) ?? null, traceId: (r.traceId as string) ?? null, projectVersion: (r.projectVersion as number) ?? null, })), total: runs.length, traceId: data.traceId ?? null, nextPage: data.nextPage ?? null, previousPage: data.previousPage ?? null, }, } }, outputs: { runs: { type: 'array', description: 'List of project runs', items: { type: 'object', properties: { projectId: { type: 'string', description: 'Project UUID' }, runId: { type: 'string', description: 'Run UUID' }, runUrl: { type: 'string', description: 'URL to view the run', optional: true }, status: { type: 'string', description: 'Run status (PENDING, RUNNING, COMPLETED, ERRORED, KILLED, UNABLE_TO_ALLOCATE_KERNEL)', }, startTime: { type: 'string', description: 'Run start time', optional: true }, endTime: { type: 'string', description: 'Run end time', optional: true }, elapsedTime: { type: 'number', description: 'Elapsed time in seconds', optional: true }, traceId: { type: 'string', description: 'Trace ID', optional: true }, projectVersion: { type: 'number', description: 'Project version number', optional: true, }, }, }, }, total: { type: 'number', description: 'Total number of runs returned' }, traceId: { type: 'string', description: 'Top-level trace ID', optional: true }, nextPage: { type: 'string', description: 'Cursor for the next page of runs', optional: true }, previousPage: { type: 'string', description: 'Cursor for the previous page of runs', optional: true, }, }, }