@kb-labs/workflow-entry 2.116.13 → 2.117.0

package/dist/rest/runs-list-handler.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/http-client.ts","../../src/rest/runs-list-handler.ts"],"names":[],"mappings":";;;AAwHA,IAAM,kBAAA,GAAqB,uBAAA;AASpB,SAAS,oBAAA,GAA+B;AAC7C,EAAA,OAAO,MAAA,CAAO,qBAAqB,CAAA,IAAK,kBAAA;AAC1C;;;AC9GA,IAAO,4BAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CACJ,GAAA,EACA,KAAA,EACkB;AAClB,IAAA,MAAM,YAAY,oBAAA,EAAqB;AACvC,IAAA,MAAM,EAAE,MAAA,EAAQ,KAAA,EAAO,QAAO,GAAI,KAAA,CAAM,SAAS,EAAC;AAElD,IAAA,MAAM,cAAA,GAAiB,KAAA,GAAQ,IAAA,CAAK,GAAA,CAAI,KAAK,GAAA,CAAI,QAAA,CAAS,KAAA,EAAO,EAAE,CAAA,IAAK,EAAA,EAAI,CAAC,CAAA,EAAG,GAAI,CAAA,GAAI,EAAA;AACxF,IAAA,MAAM,eAAA,GAAkB,MAAA,GAAS,IAAA,CAAK,GAAA,CAAI,QAAA,CAAS,QAAQ,EAAE,CAAA,IAAK,CAAA,EAAG,CAAC,CAAA,GAAI,CAAA;AAC1E,IAAA,MAAM,aAAA,GAAgB,CAAC,QAAA,EAAU,SAAA,EAAW,WAAW,QAAA,EAAU,WAAA,EAAa,OAAO,SAAS,CAAA;AAC9F,IAAA,MAAM,kBAAkB,MAAA,IAAU,aAAA,CAAc,QAAA,CAAS,MAAM,IAAI,MAAA,GAAS,MAAA;AAE5E,IAAA,MAAM,MAAA,GAAS,IAAI,eAAA,EAAgB;AACnC,IAAA,MAAA,CAAO,MAAA,CAAO,OAAA,EAAS,MAAA,CAAO,cAAc,CAAC,CAAA;AAC7C,IAAA,MAAA,CAAO,MAAA,CAAO,QAAA,EAAU,MAAA,CAAO,eAAe,CAAC,CAAA;AAC/C,IAAA,IAAI,eAAA,EAAiB;AACnB,MAAA,MAAA,CAAO,MAAA,CAAO,UAAU,eAAe,CAAA;AAAA,IACzC;AAEA,IAAA,MAAM,GAAA,GAAM,CAAA,EAAG,SAAS,CAAA,aAAA,EAAgB,MAAM,CAAA,CAAA;AAE9C,IAAA,GAAA,CAAI,QAAA,CAAS,MAAA,CAAO,IAAA,CAAK,CAAA,uCAAA,EAA0C,GAAG,CAAA,CAAE,CAAA;AAExE,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAG,CAAA;AAEhC,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,QAAA,MAAM,IAAI,MAAM,CAAA,KAAA,EAAQ,QAAA,CAAS,MAAM,CAAA,EAAA,EAAK,QAAA,CAAS,UAAU,CAAA,CAAE,CAAA;AAAA,MACnE;AAEA,MAAA,MAAM,MAAA,GAAU,MAAM,QAAA,CAAS,IAAA,EAAK;AAEpC,MAAA,IAAI,CAAC,MAAA,CAAO,EAAA,IAAM,CAAC,OAAO,IAAA,EAAM;AAC9B,QAAA,MAAM,IAAI,KAAA,CAAM,MAAA,CAAO,KAAA,IAAS,sBAAsB,CAAA;AAAA,MACxD;AAEA,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,IAChB,SAAS,KAAA,EAAO;AACd,MAAA,GAAA,CAAI,SAAS,MAAA,CAAO,KAAA;AAAA,QAClB,yCAAA;AAAA,QACA,KAAA,YAAiB,QAAQ,KAAA,GAAQ;AAAA,OACnC;AACA,MAAA,cAAA,CAAe,KAAK,CAAA;AAAA,IACtB;AAAA,EACF;AACF,CAAC","file":"runs-list-handler.js","sourcesContent":["/**\n * HTTP client for interacting with Workflow Daemon\n */\nimport type {\n  WorkflowRerunRequest,\n  WorkflowRestartRequest,\n  WorkflowRestartResponse,\n  WorkflowRunRequest,\n  JobStatusInfo,\n  JobStepsResponse,\n  JobLogsResponse,\n  CronListResponse,\n} from '@kb-labs/workflow-contracts';\nimport { useEnv } from '@kb-labs/sdk';\n\n/** Workflow run summary returned by GET /api/v1/runs */\nexport interface WorkflowRunSummary {\n  id: string;\n  name: string;\n  version?: string;\n  status: 'queued' | 'running' | 'success' | 'failed' | 'cancelled';\n  trigger?: {\n    type: string;\n    actor?: string;\n    payload?: unknown;\n  };\n  createdAt?: string;\n  startedAt?: string;\n  finishedAt?: string;\n  durationMs?: number;\n  inputs?: Record<string, unknown>;\n  hasPendingApproval?: boolean;\n  currentStepName?: string;\n}\n\n/** Full workflow run detail returned by GET /api/v1/runs/:runId */\nexport interface WorkflowRunDetail extends WorkflowRunSummary {\n  env?: Record<string, string>;\n  metadata?: Record<string, unknown>;\n  result?: {\n    status: string;\n    summary?: string;\n    error?: { message: string; code?: string };\n    outputs?: Record<string, unknown>;\n  };\n  jobs?: Array<{\n    id: string;\n    jobName?: string;\n    status: string;\n    startedAt?: string;\n    finishedAt?: string;\n    durationMs?: number;\n    attempt?: number;\n    error?: { message: string; code?: string; stack?: string } | string;\n    steps?: Array<{\n      id: string;\n      name?: string;\n      index?: number;\n      status: string;\n      startedAt?: string;\n      finishedAt?: string;\n      durationMs?: number;\n      attempt?: number;\n      outputs?: Record<string, unknown>;\n      resolvedInputs?: Record<string, unknown>;\n      error?: { message: string; code?: string; details?: Record<string, unknown> } | string;\n      spec?: Record<string, unknown>;\n    }>;\n  }>;\n}\n\n/** Metrics data returned by GET /metrics */\nexport interface WorkflowMetricsData {\n  runs: {\n    total: number;\n    queued: number;\n    running: number;\n    completed: number;\n    failed: number;\n    cancelled: number;\n  };\n  jobs: {\n    total: number;\n    queued: number;\n    running: number;\n    completed: number;\n    failed: number;\n  };\n  [key: string]: unknown;\n}\n\n/** Extended job status returned by GET /api/v1/jobs/:id — includes nested jobs/steps */\nexport interface JobStatusDetail extends Omit<JobStatusInfo, 'result'> {\n  result?: {\n    ok: boolean;\n    summary?: string;\n    error?: { code: string; message: string };\n  };\n  jobs?: Array<{\n    id: string;\n    name: string;\n    status: string;\n    startedAt?: string;\n    finishedAt?: string;\n    durationMs?: number;\n    error?: string;\n    steps?: Array<{\n      id: string;\n      name: string;\n      status: string;\n      handler?: string;\n      startedAt?: string;\n      finishedAt?: string;\n      durationMs?: number;\n      outputs?: Record<string, unknown>;\n      error?: { message?: string } | string;\n    }>;\n  }>;\n}\n\nconst DEFAULT_DAEMON_URL = 'http://localhost:7778';\n\nexport interface DaemonClientOptions {\n  url?: string;\n}\n\n/**\n * Get workflow daemon URL from environment or default\n */\nexport function getWorkflowDaemonUrl(): string {\n  return useEnv('WORKFLOW_DAEMON_URL') ?? DEFAULT_DAEMON_URL;\n}\n\nexport class WorkflowDaemonClient {\n  private readonly baseUrl: string;\n\n  constructor(options: DaemonClientOptions = {}) {\n    this.baseUrl = options.url ?? useEnv('WORKFLOW_DAEMON_URL') ?? DEFAULT_DAEMON_URL;\n  }\n\n  /**\n   * Validate response Content-Type and parse JSON safely\n   */\n  private async parseJsonResponse<T>(response: Response): Promise<T> {\n    const contentType = response.headers.get('content-type');\n    if (!contentType?.includes('application/json')) {\n      throw new Error(`Invalid Content-Type: expected application/json, got ${contentType}`);\n    }\n    return response.json() as Promise<T>;\n  }\n\n  private unwrapData<T>(payload: unknown): T {\n    if (\n      payload\n      && typeof payload === 'object'\n      && 'ok' in payload\n      && (payload as { ok?: boolean }).ok === true\n      && 'data' in payload\n    ) {\n      return (payload as { data: T }).data;\n    }\n    return payload as T;\n  }\n\n  /**\n   * Validate and encode job ID to prevent path traversal attacks\n   */\n  private validateAndEncodeJobId(jobId: string): string {\n    // Validate job ID format (alphanumeric, hyphens, underscores only)\n    if (!/^[a-zA-Z0-9_-]+$/.test(jobId)) {\n      throw new Error(`Invalid job ID format: ${jobId}`);\n    }\n    // Encode for URL safety (defense in depth)\n    return encodeURIComponent(jobId);\n  }\n\n  /**\n   * Health check\n   */\n  async health(): Promise<{ ok: boolean; service: string }> {\n    const response = await fetch(`${this.baseUrl}/health`);\n    if (!response.ok) {\n      throw new Error(`Health check failed: ${response.statusText}`);\n    }\n    return this.parseJsonResponse(response);\n  }\n\n  /**\n   * Get workflow metrics (raw metrics data from daemon)\n   */\n  async getMetrics(): Promise<WorkflowMetricsData> {\n    const response = await fetch(`${this.baseUrl}/metrics`);\n    if (!response.ok) {\n      throw new Error(`Failed to get metrics: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<WorkflowMetricsData>(data);\n  }\n\n  /**\n   * Get job status with full details (jobs, steps, outputs)\n   */\n  async getJobStatus(jobId: string): Promise<JobStatusDetail> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job status: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<JobStatusDetail>(data);\n  }\n\n  /**\n   * Get job steps with outputs\n   */\n  async getJobSteps(jobId: string): Promise<JobStepsResponse> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/steps`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job steps: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<JobStepsResponse>(data);\n  }\n\n  /**\n   * Get job logs\n   */\n  async getJobLogs(jobId: string): Promise<JobLogsResponse['logs']> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/logs`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job logs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<JobLogsResponse>(data);\n    return unwrapped.logs ?? [];\n  }\n\n  /**\n   * Get active executions\n   */\n  async getExecutions(): Promise<JobStatusInfo[]> {\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs`);\n    if (!response.ok) {\n      throw new Error(`Failed to get executions: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ jobs?: JobStatusInfo[] }>(data);\n    const jobs = unwrapped.jobs ?? [];\n    return jobs.filter((job) => job.status === 'running' || job.status === 'pending');\n  }\n\n  /**\n   * Get cron jobs\n   */\n  async getCronJobs(): Promise<CronListResponse> {\n    const response = await fetch(`${this.baseUrl}/api/v1/cron`);\n    if (!response.ok) {\n      throw new Error(`Failed to get cron jobs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<CronListResponse>(data);\n  }\n\n  /**\n   * Submit a job for execution\n   */\n  async submitJob(params: {\n    handler: string;\n    input?: unknown;\n    priority?: number;\n  }): Promise<{ id: string; status: string }> {\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({\n        type: params.handler,\n        payload: params.input,\n        priority: params.priority,\n      }),\n    });\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to submit job: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<unknown>(response);\n    const data = this.unwrapData<{ jobId: string }>(payload);\n    return { id: data.jobId, status: 'pending' };\n  }\n\n  /**\n   * List workflow runs with optional status filter\n   */\n  async listRuns(params: {\n    status?: string;\n    limit?: number;\n    workflowId?: string;\n  } = {}): Promise<WorkflowRunSummary[]> {\n    const query = new URLSearchParams();\n    if (params.status) { query.set('status', params.status); }\n    if (params.limit) { query.set('limit', String(params.limit)); }\n    if (params.workflowId) { query.set('workflowId', params.workflowId); }\n\n    const qs = query.toString();\n    const response = await fetch(`${this.baseUrl}/api/v1/runs${qs ? `?${qs}` : ''}`);\n    if (!response.ok) {\n      throw new Error(`Failed to list runs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ runs?: WorkflowRunSummary[] }>(data);\n    return unwrapped.runs ?? (Array.isArray(data) ? data as WorkflowRunSummary[] : []);\n  }\n\n  /**\n   * Get a specific workflow run with full detail\n   */\n  async getRun(runId: string): Promise<WorkflowRunDetail> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}`);\n    if (response.status === 404) {\n      throw new Error(`Run ${runId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get run: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    // Response shape: { ok: true, data: { run: {...} } }\n    const unwrapped = this.unwrapData<{ run?: WorkflowRunDetail } | WorkflowRunDetail>(data);\n    return ('run' in (unwrapped as object) ? (unwrapped as { run: WorkflowRunDetail }).run : unwrapped) as WorkflowRunDetail;\n  }\n\n  /**\n   * Get run logs, optionally filtered to failed steps only\n   */\n  async getRunLogs(runId: string, params: {\n    stepId?: string;\n    level?: string;\n    limit?: number;\n    failedOnly?: boolean;\n  } = {}): Promise<Array<{ level: string; message: string; timestamp: string; stepId?: string; stepName?: string; stream?: string; [key: string]: unknown }>> {\n    const query = new URLSearchParams();\n    if (params.stepId) { query.set('stepId', params.stepId); }\n    if (params.level) { query.set('level', params.level); }\n    if (params.limit) { query.set('limit', String(params.limit)); }\n    if (params.failedOnly) { query.set('failedOnly', 'true'); }\n\n    const encodedId = encodeURIComponent(runId);\n    const qs = query.toString();\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/logs${qs ? `?${qs}` : ''}`);\n    if (response.status === 404) {\n      throw new Error(`Run ${runId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get run logs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ logs?: unknown[] }>(data);\n    return (unwrapped.logs ?? []) as Array<{ level: string; message: string; timestamp: string; [key: string]: unknown }>;\n  }\n\n  /**\n   * Stream run events via SSE (returns a ReadableStream or EventSource-compatible URL)\n   */\n  getRunEventsUrl(runId: string): string {\n    return `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/events`;\n  }\n\n  /**\n   * List pending approval steps for a run\n   */\n  async listPendingApprovals(runId: string): Promise<{\n    runId: string;\n    pending: Array<{\n      jobId: string;\n      stepId: string;\n      stepName: string;\n      specId?: string;\n      context: Record<string, unknown>;\n      waitingSince?: string;\n    }>;\n  }> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/approvals`);\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to list pending approvals: ${message || response.statusText || response.status}`);\n    }\n    const payload = await this.parseJsonResponse<{\n      ok: boolean;\n      data?: {\n        runId: string;\n        pending: Array<{\n          jobId: string;\n          stepId: string;\n          stepName: string;\n          specId?: string;\n          context: Record<string, unknown>;\n          waitingSince?: string;\n        }>;\n      };\n    }>(response);\n    return this.unwrapData(payload);\n  }\n\n  /**\n   * Resolve (approve or reject) a pending approval step\n   */\n  async resolveApproval(\n    runId: string,\n    jobId: string,\n    stepId: string,\n    action: 'approve' | 'reject',\n    comment?: string,\n    data?: Record<string, unknown>\n  ): Promise<{ runId: string; jobId: string; stepId: string; action: string; resolved: boolean }> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/approvals/resolve`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({ jobId, stepId, action, comment, data }),\n    });\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to resolve approval: ${message || response.statusText || response.status}`);\n    }\n    const payload = await this.parseJsonResponse<{\n      ok: boolean;\n      data?: { runId: string; jobId: string; stepId: string; action: string; resolved: boolean };\n    }>(response);\n    return this.unwrapData(payload);\n  }\n\n  /**\n   * Cancel a workflow run\n   */\n  async cancelRun(runId: string): Promise<void> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/cancel`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: '{}',\n    });\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to cancel run: ${message || response.statusText || response.status}`);\n    }\n  }\n\n  /**\n   * Run workflow by ID\n   */\n  async runWorkflow(\n    workflowId: string,\n    request: WorkflowRunRequest = {}\n  ): Promise<{ runId: string; status: string }> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/workflows/${encodeURIComponent(workflowId)}/runs`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      }\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to run workflow: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: { runId: string; status: string } }>(response);\n    return this.unwrapData<{ runId: string; status: string }>(payload);\n  }\n\n  /**\n   * Rerun a workflow run by ID, optionally only failed jobs\n   */\n  async rerunWorkflow(\n    runId: string,\n    request: WorkflowRerunRequest = {},\n  ): Promise<{ runId: string; status: string }> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/rerun`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      },\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to rerun workflow: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: { runId: string; status: string } }>(response);\n    return this.unwrapData<{ runId: string; status: string }>(payload);\n  }\n\n  /**\n   * Restart a run from a snapshot, optionally resuming from a specific step.\n   * Preceding steps inherit their stored outputs; only the target step and beyond are re-executed.\n   */\n  async restartRun(\n    runId: string,\n    request: WorkflowRestartRequest = {},\n  ): Promise<WorkflowRestartResponse> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/restart`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      },\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to restart run: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: WorkflowRestartResponse }>(response);\n    return this.unwrapData<WorkflowRestartResponse>(payload);\n  }\n}\n","/**\n * REST handler: GET /runs\n * Proxies to workflow daemon GET /api/v1/runs\n * Lists all workflow runs across all workflows.\n */\n\nimport { defineHandler, rethrowForRest, type RestInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { getWorkflowDaemonUrl } from '../http-client.js';\n\ninterface RunsListQuery {\n  status?: string;\n  limit?: string;\n  offset?: string;\n}\n\ninterface ApiEnvelope<T> {\n  ok: boolean;\n  data?: T;\n  error?: string;\n}\n\nexport default defineHandler({\n  async execute(\n    ctx: PluginContextV3,\n    input: RestInput<RunsListQuery>\n  ): Promise<unknown> {\n    const daemonUrl = getWorkflowDaemonUrl();\n    const { status, limit, offset } = input.query || {};\n\n    const validatedLimit = limit ? Math.min(Math.max(parseInt(limit, 10) || 50, 1), 1000) : 50;\n    const validatedOffset = offset ? Math.max(parseInt(offset, 10) || 0, 0) : 0;\n    const validStatuses = ['queued', 'running', 'success', 'failed', 'cancelled', 'dlq', 'skipped'];\n    const validatedStatus = status && validStatuses.includes(status) ? status : undefined;\n\n    const params = new URLSearchParams();\n    params.append('limit', String(validatedLimit));\n    params.append('offset', String(validatedOffset));\n    if (validatedStatus) {\n      params.append('status', validatedStatus);\n    }\n\n    const url = `${daemonUrl}/api/v1/runs?${params}`;\n\n    ctx.platform.logger.info(`[runs-list-handler] Fetching runs from ${url}`);\n\n    try {\n      const response = await fetch(url);\n\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      const result = (await response.json()) as ApiEnvelope<unknown>;\n\n      if (!result.ok || !result.data) {\n        throw new Error(result.error || 'Failed to fetch runs');\n      }\n\n      return result.data;\n    } catch (error) {\n      ctx.platform.logger.error(\n        '[runs-list-handler] Error fetching runs',\n        error instanceof Error ? error : undefined\n      );\n      rethrowForRest(error);\n    }\n  },\n});\n"]}
+{"version":3,"sources":["../../src/http-client.ts","../../src/rest/runs-list-handler.ts"],"names":[],"mappings":";;;AA2HA,IAAM,kBAAA,GAAqB,uBAAA;AASpB,SAAS,oBAAA,GAA+B;AAC7C,EAAA,OAAO,MAAA,CAAO,qBAAqB,CAAA,IAAK,kBAAA;AAC1C;;;ACjHA,IAAO,4BAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CACJ,GAAA,EACA,KAAA,EACkB;AAClB,IAAA,MAAM,YAAY,oBAAA,EAAqB;AACvC,IAAA,MAAM,EAAE,MAAA,EAAQ,KAAA,EAAO,QAAO,GAAI,KAAA,CAAM,SAAS,EAAC;AAElD,IAAA,MAAM,cAAA,GAAiB,KAAA,GAAQ,IAAA,CAAK,GAAA,CAAI,KAAK,GAAA,CAAI,QAAA,CAAS,KAAA,EAAO,EAAE,CAAA,IAAK,EAAA,EAAI,CAAC,CAAA,EAAG,GAAI,CAAA,GAAI,EAAA;AACxF,IAAA,MAAM,eAAA,GAAkB,MAAA,GAAS,IAAA,CAAK,GAAA,CAAI,QAAA,CAAS,QAAQ,EAAE,CAAA,IAAK,CAAA,EAAG,CAAC,CAAA,GAAI,CAAA;AAC1E,IAAA,MAAM,aAAA,GAAgB,CAAC,QAAA,EAAU,SAAA,EAAW,WAAW,QAAA,EAAU,WAAA,EAAa,OAAO,SAAS,CAAA;AAC9F,IAAA,MAAM,kBAAkB,MAAA,IAAU,aAAA,CAAc,QAAA,CAAS,MAAM,IAAI,MAAA,GAAS,MAAA;AAE5E,IAAA,MAAM,MAAA,GAAS,IAAI,eAAA,EAAgB;AACnC,IAAA,MAAA,CAAO,MAAA,CAAO,OAAA,EAAS,MAAA,CAAO,cAAc,CAAC,CAAA;AAC7C,IAAA,MAAA,CAAO,MAAA,CAAO,QAAA,EAAU,MAAA,CAAO,eAAe,CAAC,CAAA;AAC/C,IAAA,IAAI,eAAA,EAAiB;AACnB,MAAA,MAAA,CAAO,MAAA,CAAO,UAAU,eAAe,CAAA;AAAA,IACzC;AAEA,IAAA,MAAM,GAAA,GAAM,CAAA,EAAG,SAAS,CAAA,aAAA,EAAgB,MAAM,CAAA,CAAA;AAE9C,IAAA,GAAA,CAAI,QAAA,CAAS,MAAA,CAAO,IAAA,CAAK,CAAA,uCAAA,EAA0C,GAAG,CAAA,CAAE,CAAA;AAExE,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAG,CAAA;AAEhC,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,QAAA,MAAM,IAAI,MAAM,CAAA,KAAA,EAAQ,QAAA,CAAS,MAAM,CAAA,EAAA,EAAK,QAAA,CAAS,UAAU,CAAA,CAAE,CAAA;AAAA,MACnE;AAEA,MAAA,MAAM,MAAA,GAAU,MAAM,QAAA,CAAS,IAAA,EAAK;AAEpC,MAAA,IAAI,CAAC,MAAA,CAAO,EAAA,IAAM,CAAC,OAAO,IAAA,EAAM;AAC9B,QAAA,MAAM,IAAI,KAAA,CAAM,MAAA,CAAO,KAAA,IAAS,sBAAsB,CAAA;AAAA,MACxD;AAEA,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,IAChB,SAAS,KAAA,EAAO;AACd,MAAA,GAAA,CAAI,SAAS,MAAA,CAAO,KAAA;AAAA,QAClB,yCAAA;AAAA,QACA,KAAA,YAAiB,QAAQ,KAAA,GAAQ;AAAA,OACnC;AACA,MAAA,cAAA,CAAe,KAAK,CAAA;AAAA,IACtB;AAAA,EACF;AACF,CAAC","file":"runs-list-handler.js","sourcesContent":["/**\n * HTTP client for interacting with Workflow Daemon\n */\nimport type {\n  WorkflowRerunRequest,\n  WorkflowRestartRequest,\n  WorkflowRestartResponse,\n  WorkflowRunRequest,\n  JobStatusInfo,\n  JobStepsResponse,\n  JobLogsResponse,\n  CronListResponse,\n} from '@kb-labs/workflow-contracts';\nimport { useEnv } from '@kb-labs/sdk';\n\n/** Workflow run summary returned by GET /api/v1/runs */\nexport interface WorkflowRunSummary {\n  id: string;\n  name: string;\n  version?: string;\n  status: 'queued' | 'running' | 'success' | 'failed' | 'cancelled';\n  trigger?: {\n    type: string;\n    actor?: string;\n    payload?: unknown;\n    parentRunId?: string;\n    parentJobId?: string;\n    parentStepId?: string;\n  };\n  createdAt?: string;\n  startedAt?: string;\n  finishedAt?: string;\n  durationMs?: number;\n  inputs?: Record<string, unknown>;\n  hasPendingApproval?: boolean;\n  currentStepName?: string;\n}\n\n/** Full workflow run detail returned by GET /api/v1/runs/:runId */\nexport interface WorkflowRunDetail extends WorkflowRunSummary {\n  env?: Record<string, string>;\n  metadata?: Record<string, unknown>;\n  result?: {\n    status: string;\n    summary?: string;\n    error?: { message: string; code?: string };\n    outputs?: Record<string, unknown>;\n  };\n  jobs?: Array<{\n    id: string;\n    jobName?: string;\n    status: string;\n    startedAt?: string;\n    finishedAt?: string;\n    durationMs?: number;\n    attempt?: number;\n    error?: { message: string; code?: string; stack?: string } | string;\n    steps?: Array<{\n      id: string;\n      name?: string;\n      index?: number;\n      status: string;\n      startedAt?: string;\n      finishedAt?: string;\n      durationMs?: number;\n      attempt?: number;\n      outputs?: Record<string, unknown>;\n      resolvedInputs?: Record<string, unknown>;\n      error?: { message: string; code?: string; details?: Record<string, unknown> } | string;\n      spec?: Record<string, unknown>;\n    }>;\n  }>;\n}\n\n/** Metrics data returned by GET /metrics */\nexport interface WorkflowMetricsData {\n  runs: {\n    total: number;\n    queued: number;\n    running: number;\n    completed: number;\n    failed: number;\n    cancelled: number;\n  };\n  jobs: {\n    total: number;\n    queued: number;\n    running: number;\n    completed: number;\n    failed: number;\n  };\n  [key: string]: unknown;\n}\n\n/** Extended job status returned by GET /api/v1/jobs/:id — includes nested jobs/steps */\nexport interface JobStatusDetail extends Omit<JobStatusInfo, 'result'> {\n  result?: {\n    ok: boolean;\n    summary?: string;\n    error?: { code: string; message: string };\n  };\n  jobs?: Array<{\n    id: string;\n    name: string;\n    status: string;\n    startedAt?: string;\n    finishedAt?: string;\n    durationMs?: number;\n    error?: string;\n    steps?: Array<{\n      id: string;\n      name: string;\n      status: string;\n      handler?: string;\n      startedAt?: string;\n      finishedAt?: string;\n      durationMs?: number;\n      outputs?: Record<string, unknown>;\n      error?: { message?: string } | string;\n    }>;\n  }>;\n}\n\nconst DEFAULT_DAEMON_URL = 'http://localhost:7778';\n\nexport interface DaemonClientOptions {\n  url?: string;\n}\n\n/**\n * Get workflow daemon URL from environment or default\n */\nexport function getWorkflowDaemonUrl(): string {\n  return useEnv('WORKFLOW_DAEMON_URL') ?? DEFAULT_DAEMON_URL;\n}\n\nexport class WorkflowDaemonClient {\n  private readonly baseUrl: string;\n\n  constructor(options: DaemonClientOptions = {}) {\n    this.baseUrl = options.url ?? useEnv('WORKFLOW_DAEMON_URL') ?? DEFAULT_DAEMON_URL;\n  }\n\n  /**\n   * Validate response Content-Type and parse JSON safely\n   */\n  private async parseJsonResponse<T>(response: Response): Promise<T> {\n    const contentType = response.headers.get('content-type');\n    if (!contentType?.includes('application/json')) {\n      throw new Error(`Invalid Content-Type: expected application/json, got ${contentType}`);\n    }\n    return response.json() as Promise<T>;\n  }\n\n  private unwrapData<T>(payload: unknown): T {\n    if (\n      payload\n      && typeof payload === 'object'\n      && 'ok' in payload\n      && (payload as { ok?: boolean }).ok === true\n      && 'data' in payload\n    ) {\n      return (payload as { data: T }).data;\n    }\n    return payload as T;\n  }\n\n  /**\n   * Validate and encode job ID to prevent path traversal attacks\n   */\n  private validateAndEncodeJobId(jobId: string): string {\n    // Validate job ID format (alphanumeric, hyphens, underscores only)\n    if (!/^[a-zA-Z0-9_-]+$/.test(jobId)) {\n      throw new Error(`Invalid job ID format: ${jobId}`);\n    }\n    // Encode for URL safety (defense in depth)\n    return encodeURIComponent(jobId);\n  }\n\n  /**\n   * Health check\n   */\n  async health(): Promise<{ ok: boolean; service: string }> {\n    const response = await fetch(`${this.baseUrl}/health`);\n    if (!response.ok) {\n      throw new Error(`Health check failed: ${response.statusText}`);\n    }\n    return this.parseJsonResponse(response);\n  }\n\n  /**\n   * Get workflow metrics (raw metrics data from daemon)\n   */\n  async getMetrics(): Promise<WorkflowMetricsData> {\n    const response = await fetch(`${this.baseUrl}/metrics`);\n    if (!response.ok) {\n      throw new Error(`Failed to get metrics: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<WorkflowMetricsData>(data);\n  }\n\n  /**\n   * Get job status with full details (jobs, steps, outputs)\n   */\n  async getJobStatus(jobId: string): Promise<JobStatusDetail> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job status: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<JobStatusDetail>(data);\n  }\n\n  /**\n   * Get job steps with outputs\n   */\n  async getJobSteps(jobId: string): Promise<JobStepsResponse> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/steps`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job steps: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<JobStepsResponse>(data);\n  }\n\n  /**\n   * Get job logs\n   */\n  async getJobLogs(jobId: string): Promise<JobLogsResponse['logs']> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/logs`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job logs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<JobLogsResponse>(data);\n    return unwrapped.logs ?? [];\n  }\n\n  /**\n   * Get active executions\n   */\n  async getExecutions(): Promise<JobStatusInfo[]> {\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs`);\n    if (!response.ok) {\n      throw new Error(`Failed to get executions: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ jobs?: JobStatusInfo[] }>(data);\n    const jobs = unwrapped.jobs ?? [];\n    return jobs.filter((job) => job.status === 'running' || job.status === 'pending');\n  }\n\n  /**\n   * Get cron jobs\n   */\n  async getCronJobs(): Promise<CronListResponse> {\n    const response = await fetch(`${this.baseUrl}/api/v1/cron`);\n    if (!response.ok) {\n      throw new Error(`Failed to get cron jobs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<CronListResponse>(data);\n  }\n\n  /**\n   * Submit a job for execution\n   */\n  async submitJob(params: {\n    handler: string;\n    input?: unknown;\n    priority?: number;\n  }): Promise<{ id: string; status: string }> {\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({\n        type: params.handler,\n        payload: params.input,\n        priority: params.priority,\n      }),\n    });\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to submit job: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<unknown>(response);\n    const data = this.unwrapData<{ jobId: string }>(payload);\n    return { id: data.jobId, status: 'pending' };\n  }\n\n  /**\n   * List workflow runs with optional status filter\n   */\n  async listRuns(params: {\n    status?: string;\n    limit?: number;\n    workflowId?: string;\n  } = {}): Promise<WorkflowRunSummary[]> {\n    const query = new URLSearchParams();\n    if (params.status) { query.set('status', params.status); }\n    if (params.limit) { query.set('limit', String(params.limit)); }\n    if (params.workflowId) { query.set('workflowId', params.workflowId); }\n\n    const qs = query.toString();\n    const response = await fetch(`${this.baseUrl}/api/v1/runs${qs ? `?${qs}` : ''}`);\n    if (!response.ok) {\n      throw new Error(`Failed to list runs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ runs?: WorkflowRunSummary[] }>(data);\n    return unwrapped.runs ?? (Array.isArray(data) ? data as WorkflowRunSummary[] : []);\n  }\n\n  /**\n   * Get a specific workflow run with full detail\n   */\n  async getRun(runId: string): Promise<WorkflowRunDetail> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}`);\n    if (response.status === 404) {\n      throw new Error(`Run ${runId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get run: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    // Response shape: { ok: true, data: { run: {...} } }\n    const unwrapped = this.unwrapData<{ run?: WorkflowRunDetail } | WorkflowRunDetail>(data);\n    return ('run' in (unwrapped as object) ? (unwrapped as { run: WorkflowRunDetail }).run : unwrapped) as WorkflowRunDetail;\n  }\n\n  /**\n   * Get run logs, optionally filtered to failed steps only\n   */\n  async getRunLogs(runId: string, params: {\n    stepId?: string;\n    level?: string;\n    limit?: number;\n    failedOnly?: boolean;\n  } = {}): Promise<Array<{ level: string; message: string; timestamp: string; stepId?: string; stepName?: string; stream?: string; [key: string]: unknown }>> {\n    const query = new URLSearchParams();\n    if (params.stepId) { query.set('stepId', params.stepId); }\n    if (params.level) { query.set('level', params.level); }\n    if (params.limit) { query.set('limit', String(params.limit)); }\n    if (params.failedOnly) { query.set('failedOnly', 'true'); }\n\n    const encodedId = encodeURIComponent(runId);\n    const qs = query.toString();\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/logs${qs ? `?${qs}` : ''}`);\n    if (response.status === 404) {\n      throw new Error(`Run ${runId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get run logs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ logs?: unknown[] }>(data);\n    return (unwrapped.logs ?? []) as Array<{ level: string; message: string; timestamp: string; [key: string]: unknown }>;\n  }\n\n  /**\n   * Stream run events via SSE (returns a ReadableStream or EventSource-compatible URL)\n   */\n  getRunEventsUrl(runId: string): string {\n    return `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/events`;\n  }\n\n  /**\n   * List pending approval steps for a run\n   */\n  async listPendingApprovals(runId: string): Promise<{\n    runId: string;\n    pending: Array<{\n      jobId: string;\n      stepId: string;\n      stepName: string;\n      specId?: string;\n      context: Record<string, unknown>;\n      waitingSince?: string;\n    }>;\n  }> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/approvals`);\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to list pending approvals: ${message || response.statusText || response.status}`);\n    }\n    const payload = await this.parseJsonResponse<{\n      ok: boolean;\n      data?: {\n        runId: string;\n        pending: Array<{\n          jobId: string;\n          stepId: string;\n          stepName: string;\n          specId?: string;\n          context: Record<string, unknown>;\n          waitingSince?: string;\n        }>;\n      };\n    }>(response);\n    return this.unwrapData(payload);\n  }\n\n  /**\n   * Resolve (approve or reject) a pending approval step\n   */\n  async resolveApproval(\n    runId: string,\n    jobId: string,\n    stepId: string,\n    action: 'approve' | 'reject',\n    comment?: string,\n    data?: Record<string, unknown>\n  ): Promise<{ runId: string; jobId: string; stepId: string; action: string; resolved: boolean }> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/approvals/resolve`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({ jobId, stepId, action, comment, data }),\n    });\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to resolve approval: ${message || response.statusText || response.status}`);\n    }\n    const payload = await this.parseJsonResponse<{\n      ok: boolean;\n      data?: { runId: string; jobId: string; stepId: string; action: string; resolved: boolean };\n    }>(response);\n    return this.unwrapData(payload);\n  }\n\n  /**\n   * Cancel a workflow run\n   */\n  async cancelRun(runId: string): Promise<void> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/cancel`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: '{}',\n    });\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to cancel run: ${message || response.statusText || response.status}`);\n    }\n  }\n\n  /**\n   * Run workflow by ID\n   */\n  async runWorkflow(\n    workflowId: string,\n    request: WorkflowRunRequest = {}\n  ): Promise<{ runId: string; status: string }> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/workflows/${encodeURIComponent(workflowId)}/runs`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      }\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to run workflow: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: { runId: string; status: string } }>(response);\n    return this.unwrapData<{ runId: string; status: string }>(payload);\n  }\n\n  /**\n   * Rerun a workflow run by ID, optionally only failed jobs\n   */\n  async rerunWorkflow(\n    runId: string,\n    request: WorkflowRerunRequest = {},\n  ): Promise<{ runId: string; status: string }> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/rerun`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      },\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to rerun workflow: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: { runId: string; status: string } }>(response);\n    return this.unwrapData<{ runId: string; status: string }>(payload);\n  }\n\n  /**\n   * Restart a run from a snapshot, optionally resuming from a specific step.\n   * Preceding steps inherit their stored outputs; only the target step and beyond are re-executed.\n   */\n  async restartRun(\n    runId: string,\n    request: WorkflowRestartRequest = {},\n  ): Promise<WorkflowRestartResponse> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/restart`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      },\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to restart run: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: WorkflowRestartResponse }>(response);\n    return this.unwrapData<WorkflowRestartResponse>(payload);\n  }\n}\n","/**\n * REST handler: GET /runs\n * Proxies to workflow daemon GET /api/v1/runs\n * Lists all workflow runs across all workflows.\n */\n\nimport { defineHandler, rethrowForRest, type RestInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { getWorkflowDaemonUrl } from '../http-client.js';\n\ninterface RunsListQuery {\n  status?: string;\n  limit?: string;\n  offset?: string;\n}\n\ninterface ApiEnvelope<T> {\n  ok: boolean;\n  data?: T;\n  error?: string;\n}\n\nexport default defineHandler({\n  async execute(\n    ctx: PluginContextV3,\n    input: RestInput<RunsListQuery>\n  ): Promise<unknown> {\n    const daemonUrl = getWorkflowDaemonUrl();\n    const { status, limit, offset } = input.query || {};\n\n    const validatedLimit = limit ? Math.min(Math.max(parseInt(limit, 10) || 50, 1), 1000) : 50;\n    const validatedOffset = offset ? Math.max(parseInt(offset, 10) || 0, 0) : 0;\n    const validStatuses = ['queued', 'running', 'success', 'failed', 'cancelled', 'dlq', 'skipped'];\n    const validatedStatus = status && validStatuses.includes(status) ? status : undefined;\n\n    const params = new URLSearchParams();\n    params.append('limit', String(validatedLimit));\n    params.append('offset', String(validatedOffset));\n    if (validatedStatus) {\n      params.append('status', validatedStatus);\n    }\n\n    const url = `${daemonUrl}/api/v1/runs?${params}`;\n\n    ctx.platform.logger.info(`[runs-list-handler] Fetching runs from ${url}`);\n\n    try {\n      const response = await fetch(url);\n\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      const result = (await response.json()) as ApiEnvelope<unknown>;\n\n      if (!result.ok || !result.data) {\n        throw new Error(result.error || 'Failed to fetch runs');\n      }\n\n      return result.data;\n    } catch (error) {\n      ctx.platform.logger.error(\n        '[runs-list-handler] Error fetching runs',\n        error instanceof Error ? error : undefined\n      );\n      rethrowForRest(error);\n    }\n  },\n});\n"]}

package/dist/rest/stats-handler.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/http-client.ts","../../src/rest/stats-handler.ts"],"names":[],"mappings":";;;AAwHA,IAAM,kBAAA,GAAqB,uBAAA;AASpB,SAAS,oBAAA,GAA+B;AAC7C,EAAA,OAAO,MAAA,CAAO,qBAAqB,CAAA,IAAK,kBAAA;AAC1C;;;AC1HA,IAAO,wBAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CAAQ,GAAA,EAAsB,MAAA,EAA6D;AAC/F,IAAA,MAAM,YAAY,oBAAA,EAAqB;AACvC,IAAA,MAAM,GAAA,GAAM,GAAG,SAAS,CAAA,aAAA,CAAA;AAExB,IAAA,GAAA,CAAI,QAAA,CAAS,MAAA,CAAO,IAAA,CAAK,CAAA,oCAAA,EAAuC,GAAG,CAAA,CAAE,CAAA;AAErE,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAG,CAAA;AAEhC,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,QAAA,MAAM,IAAI,MAAM,CAAA,KAAA,EAAQ,QAAA,CAAS,MAAM,CAAA,EAAA,EAAK,QAAA,CAAS,UAAU,CAAA,CAAE,CAAA;AAAA,MACnE;AAEA,MAAA,MAAM,MAAA,GAAU,MAAM,QAAA,CAAS,IAAA,EAAK;AAEpC,MAAA,IAAI,CAAC,MAAA,CAAO,EAAA,IAAM,CAAC,OAAO,IAAA,EAAM;AAC9B,QAAA,MAAM,IAAI,KAAA,CAAM,MAAA,CAAO,KAAA,IAAS,uBAAuB,CAAA;AAAA,MACzD;AAEA,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,IAChB,SAAS,KAAA,EAAO;AACd,MAAA,GAAA,CAAI,SAAS,MAAA,CAAO,KAAA;AAAA,QAClB,sCAAA;AAAA,QACA,KAAA,YAAiB,QAAQ,KAAA,GAAQ;AAAA,OACnC;AACA,MAAA,cAAA,CAAe,KAAK,CAAA;AAAA,IACtB;AAAA,EACF;AACF,CAAC","file":"stats-handler.js","sourcesContent":["/**\n * HTTP client for interacting with Workflow Daemon\n */\nimport type {\n  WorkflowRerunRequest,\n  WorkflowRestartRequest,\n  WorkflowRestartResponse,\n  WorkflowRunRequest,\n  JobStatusInfo,\n  JobStepsResponse,\n  JobLogsResponse,\n  CronListResponse,\n} from '@kb-labs/workflow-contracts';\nimport { useEnv } from '@kb-labs/sdk';\n\n/** Workflow run summary returned by GET /api/v1/runs */\nexport interface WorkflowRunSummary {\n  id: string;\n  name: string;\n  version?: string;\n  status: 'queued' | 'running' | 'success' | 'failed' | 'cancelled';\n  trigger?: {\n    type: string;\n    actor?: string;\n    payload?: unknown;\n  };\n  createdAt?: string;\n  startedAt?: string;\n  finishedAt?: string;\n  durationMs?: number;\n  inputs?: Record<string, unknown>;\n  hasPendingApproval?: boolean;\n  currentStepName?: string;\n}\n\n/** Full workflow run detail returned by GET /api/v1/runs/:runId */\nexport interface WorkflowRunDetail extends WorkflowRunSummary {\n  env?: Record<string, string>;\n  metadata?: Record<string, unknown>;\n  result?: {\n    status: string;\n    summary?: string;\n    error?: { message: string; code?: string };\n    outputs?: Record<string, unknown>;\n  };\n  jobs?: Array<{\n    id: string;\n    jobName?: string;\n    status: string;\n    startedAt?: string;\n    finishedAt?: string;\n    durationMs?: number;\n    attempt?: number;\n    error?: { message: string; code?: string; stack?: string } | string;\n    steps?: Array<{\n      id: string;\n      name?: string;\n      index?: number;\n      status: string;\n      startedAt?: string;\n      finishedAt?: string;\n      durationMs?: number;\n      attempt?: number;\n      outputs?: Record<string, unknown>;\n      resolvedInputs?: Record<string, unknown>;\n      error?: { message: string; code?: string; details?: Record<string, unknown> } | string;\n      spec?: Record<string, unknown>;\n    }>;\n  }>;\n}\n\n/** Metrics data returned by GET /metrics */\nexport interface WorkflowMetricsData {\n  runs: {\n    total: number;\n    queued: number;\n    running: number;\n    completed: number;\n    failed: number;\n    cancelled: number;\n  };\n  jobs: {\n    total: number;\n    queued: number;\n    running: number;\n    completed: number;\n    failed: number;\n  };\n  [key: string]: unknown;\n}\n\n/** Extended job status returned by GET /api/v1/jobs/:id — includes nested jobs/steps */\nexport interface JobStatusDetail extends Omit<JobStatusInfo, 'result'> {\n  result?: {\n    ok: boolean;\n    summary?: string;\n    error?: { code: string; message: string };\n  };\n  jobs?: Array<{\n    id: string;\n    name: string;\n    status: string;\n    startedAt?: string;\n    finishedAt?: string;\n    durationMs?: number;\n    error?: string;\n    steps?: Array<{\n      id: string;\n      name: string;\n      status: string;\n      handler?: string;\n      startedAt?: string;\n      finishedAt?: string;\n      durationMs?: number;\n      outputs?: Record<string, unknown>;\n      error?: { message?: string } | string;\n    }>;\n  }>;\n}\n\nconst DEFAULT_DAEMON_URL = 'http://localhost:7778';\n\nexport interface DaemonClientOptions {\n  url?: string;\n}\n\n/**\n * Get workflow daemon URL from environment or default\n */\nexport function getWorkflowDaemonUrl(): string {\n  return useEnv('WORKFLOW_DAEMON_URL') ?? DEFAULT_DAEMON_URL;\n}\n\nexport class WorkflowDaemonClient {\n  private readonly baseUrl: string;\n\n  constructor(options: DaemonClientOptions = {}) {\n    this.baseUrl = options.url ?? useEnv('WORKFLOW_DAEMON_URL') ?? DEFAULT_DAEMON_URL;\n  }\n\n  /**\n   * Validate response Content-Type and parse JSON safely\n   */\n  private async parseJsonResponse<T>(response: Response): Promise<T> {\n    const contentType = response.headers.get('content-type');\n    if (!contentType?.includes('application/json')) {\n      throw new Error(`Invalid Content-Type: expected application/json, got ${contentType}`);\n    }\n    return response.json() as Promise<T>;\n  }\n\n  private unwrapData<T>(payload: unknown): T {\n    if (\n      payload\n      && typeof payload === 'object'\n      && 'ok' in payload\n      && (payload as { ok?: boolean }).ok === true\n      && 'data' in payload\n    ) {\n      return (payload as { data: T }).data;\n    }\n    return payload as T;\n  }\n\n  /**\n   * Validate and encode job ID to prevent path traversal attacks\n   */\n  private validateAndEncodeJobId(jobId: string): string {\n    // Validate job ID format (alphanumeric, hyphens, underscores only)\n    if (!/^[a-zA-Z0-9_-]+$/.test(jobId)) {\n      throw new Error(`Invalid job ID format: ${jobId}`);\n    }\n    // Encode for URL safety (defense in depth)\n    return encodeURIComponent(jobId);\n  }\n\n  /**\n   * Health check\n   */\n  async health(): Promise<{ ok: boolean; service: string }> {\n    const response = await fetch(`${this.baseUrl}/health`);\n    if (!response.ok) {\n      throw new Error(`Health check failed: ${response.statusText}`);\n    }\n    return this.parseJsonResponse(response);\n  }\n\n  /**\n   * Get workflow metrics (raw metrics data from daemon)\n   */\n  async getMetrics(): Promise<WorkflowMetricsData> {\n    const response = await fetch(`${this.baseUrl}/metrics`);\n    if (!response.ok) {\n      throw new Error(`Failed to get metrics: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<WorkflowMetricsData>(data);\n  }\n\n  /**\n   * Get job status with full details (jobs, steps, outputs)\n   */\n  async getJobStatus(jobId: string): Promise<JobStatusDetail> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job status: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<JobStatusDetail>(data);\n  }\n\n  /**\n   * Get job steps with outputs\n   */\n  async getJobSteps(jobId: string): Promise<JobStepsResponse> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/steps`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job steps: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<JobStepsResponse>(data);\n  }\n\n  /**\n   * Get job logs\n   */\n  async getJobLogs(jobId: string): Promise<JobLogsResponse['logs']> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/logs`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job logs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<JobLogsResponse>(data);\n    return unwrapped.logs ?? [];\n  }\n\n  /**\n   * Get active executions\n   */\n  async getExecutions(): Promise<JobStatusInfo[]> {\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs`);\n    if (!response.ok) {\n      throw new Error(`Failed to get executions: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ jobs?: JobStatusInfo[] }>(data);\n    const jobs = unwrapped.jobs ?? [];\n    return jobs.filter((job) => job.status === 'running' || job.status === 'pending');\n  }\n\n  /**\n   * Get cron jobs\n   */\n  async getCronJobs(): Promise<CronListResponse> {\n    const response = await fetch(`${this.baseUrl}/api/v1/cron`);\n    if (!response.ok) {\n      throw new Error(`Failed to get cron jobs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<CronListResponse>(data);\n  }\n\n  /**\n   * Submit a job for execution\n   */\n  async submitJob(params: {\n    handler: string;\n    input?: unknown;\n    priority?: number;\n  }): Promise<{ id: string; status: string }> {\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({\n        type: params.handler,\n        payload: params.input,\n        priority: params.priority,\n      }),\n    });\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to submit job: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<unknown>(response);\n    const data = this.unwrapData<{ jobId: string }>(payload);\n    return { id: data.jobId, status: 'pending' };\n  }\n\n  /**\n   * List workflow runs with optional status filter\n   */\n  async listRuns(params: {\n    status?: string;\n    limit?: number;\n    workflowId?: string;\n  } = {}): Promise<WorkflowRunSummary[]> {\n    const query = new URLSearchParams();\n    if (params.status) { query.set('status', params.status); }\n    if (params.limit) { query.set('limit', String(params.limit)); }\n    if (params.workflowId) { query.set('workflowId', params.workflowId); }\n\n    const qs = query.toString();\n    const response = await fetch(`${this.baseUrl}/api/v1/runs${qs ? `?${qs}` : ''}`);\n    if (!response.ok) {\n      throw new Error(`Failed to list runs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ runs?: WorkflowRunSummary[] }>(data);\n    return unwrapped.runs ?? (Array.isArray(data) ? data as WorkflowRunSummary[] : []);\n  }\n\n  /**\n   * Get a specific workflow run with full detail\n   */\n  async getRun(runId: string): Promise<WorkflowRunDetail> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}`);\n    if (response.status === 404) {\n      throw new Error(`Run ${runId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get run: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    // Response shape: { ok: true, data: { run: {...} } }\n    const unwrapped = this.unwrapData<{ run?: WorkflowRunDetail } | WorkflowRunDetail>(data);\n    return ('run' in (unwrapped as object) ? (unwrapped as { run: WorkflowRunDetail }).run : unwrapped) as WorkflowRunDetail;\n  }\n\n  /**\n   * Get run logs, optionally filtered to failed steps only\n   */\n  async getRunLogs(runId: string, params: {\n    stepId?: string;\n    level?: string;\n    limit?: number;\n    failedOnly?: boolean;\n  } = {}): Promise<Array<{ level: string; message: string; timestamp: string; stepId?: string; stepName?: string; stream?: string; [key: string]: unknown }>> {\n    const query = new URLSearchParams();\n    if (params.stepId) { query.set('stepId', params.stepId); }\n    if (params.level) { query.set('level', params.level); }\n    if (params.limit) { query.set('limit', String(params.limit)); }\n    if (params.failedOnly) { query.set('failedOnly', 'true'); }\n\n    const encodedId = encodeURIComponent(runId);\n    const qs = query.toString();\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/logs${qs ? `?${qs}` : ''}`);\n    if (response.status === 404) {\n      throw new Error(`Run ${runId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get run logs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ logs?: unknown[] }>(data);\n    return (unwrapped.logs ?? []) as Array<{ level: string; message: string; timestamp: string; [key: string]: unknown }>;\n  }\n\n  /**\n   * Stream run events via SSE (returns a ReadableStream or EventSource-compatible URL)\n   */\n  getRunEventsUrl(runId: string): string {\n    return `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/events`;\n  }\n\n  /**\n   * List pending approval steps for a run\n   */\n  async listPendingApprovals(runId: string): Promise<{\n    runId: string;\n    pending: Array<{\n      jobId: string;\n      stepId: string;\n      stepName: string;\n      specId?: string;\n      context: Record<string, unknown>;\n      waitingSince?: string;\n    }>;\n  }> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/approvals`);\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to list pending approvals: ${message || response.statusText || response.status}`);\n    }\n    const payload = await this.parseJsonResponse<{\n      ok: boolean;\n      data?: {\n        runId: string;\n        pending: Array<{\n          jobId: string;\n          stepId: string;\n          stepName: string;\n          specId?: string;\n          context: Record<string, unknown>;\n          waitingSince?: string;\n        }>;\n      };\n    }>(response);\n    return this.unwrapData(payload);\n  }\n\n  /**\n   * Resolve (approve or reject) a pending approval step\n   */\n  async resolveApproval(\n    runId: string,\n    jobId: string,\n    stepId: string,\n    action: 'approve' | 'reject',\n    comment?: string,\n    data?: Record<string, unknown>\n  ): Promise<{ runId: string; jobId: string; stepId: string; action: string; resolved: boolean }> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/approvals/resolve`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({ jobId, stepId, action, comment, data }),\n    });\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to resolve approval: ${message || response.statusText || response.status}`);\n    }\n    const payload = await this.parseJsonResponse<{\n      ok: boolean;\n      data?: { runId: string; jobId: string; stepId: string; action: string; resolved: boolean };\n    }>(response);\n    return this.unwrapData(payload);\n  }\n\n  /**\n   * Cancel a workflow run\n   */\n  async cancelRun(runId: string): Promise<void> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/cancel`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: '{}',\n    });\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to cancel run: ${message || response.statusText || response.status}`);\n    }\n  }\n\n  /**\n   * Run workflow by ID\n   */\n  async runWorkflow(\n    workflowId: string,\n    request: WorkflowRunRequest = {}\n  ): Promise<{ runId: string; status: string }> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/workflows/${encodeURIComponent(workflowId)}/runs`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      }\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to run workflow: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: { runId: string; status: string } }>(response);\n    return this.unwrapData<{ runId: string; status: string }>(payload);\n  }\n\n  /**\n   * Rerun a workflow run by ID, optionally only failed jobs\n   */\n  async rerunWorkflow(\n    runId: string,\n    request: WorkflowRerunRequest = {},\n  ): Promise<{ runId: string; status: string }> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/rerun`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      },\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to rerun workflow: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: { runId: string; status: string } }>(response);\n    return this.unwrapData<{ runId: string; status: string }>(payload);\n  }\n\n  /**\n   * Restart a run from a snapshot, optionally resuming from a specific step.\n   * Preceding steps inherit their stored outputs; only the target step and beyond are re-executed.\n   */\n  async restartRun(\n    runId: string,\n    request: WorkflowRestartRequest = {},\n  ): Promise<WorkflowRestartResponse> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/restart`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      },\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to restart run: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: WorkflowRestartResponse }>(response);\n    return this.unwrapData<WorkflowRestartResponse>(payload);\n  }\n}\n","/**\n * @module @kb-labs/workflow-cli/rest/stats-handler\n * REST handler for dashboard statistics (proxy to daemon)\n */\n\nimport { defineHandler, rethrowForRest, type RestInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport type { DashboardStatsResponse } from '@kb-labs/workflow-contracts';\nimport { getWorkflowDaemonUrl } from '../http-client';\n\nexport default defineHandler({\n  async execute(ctx: PluginContextV3, _input: RestInput<unknown>): Promise<DashboardStatsResponse> {\n    const daemonUrl = getWorkflowDaemonUrl();\n    const url = `${daemonUrl}/api/v1/stats`;\n\n    ctx.platform.logger.info(`[stats-handler] Fetching stats from ${url}`);\n\n    try {\n      const response = await fetch(url);\n\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      const result = (await response.json()) as { ok: boolean; data?: DashboardStatsResponse; error?: string };\n\n      if (!result.ok || !result.data) {\n        throw new Error(result.error || 'Failed to fetch stats');\n      }\n\n      return result.data;\n    } catch (error) {\n      ctx.platform.logger.error(\n        '[stats-handler] Error fetching stats',\n        error instanceof Error ? error : undefined\n      );\n      rethrowForRest(error);\n    }\n  },\n});\n"]}
+{"version":3,"sources":["../../src/http-client.ts","../../src/rest/stats-handler.ts"],"names":[],"mappings":";;;AA2HA,IAAM,kBAAA,GAAqB,uBAAA;AASpB,SAAS,oBAAA,GAA+B;AAC7C,EAAA,OAAO,MAAA,CAAO,qBAAqB,CAAA,IAAK,kBAAA;AAC1C;;;AC7HA,IAAO,wBAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CAAQ,GAAA,EAAsB,MAAA,EAA6D;AAC/F,IAAA,MAAM,YAAY,oBAAA,EAAqB;AACvC,IAAA,MAAM,GAAA,GAAM,GAAG,SAAS,CAAA,aAAA,CAAA;AAExB,IAAA,GAAA,CAAI,QAAA,CAAS,MAAA,CAAO,IAAA,CAAK,CAAA,oCAAA,EAAuC,GAAG,CAAA,CAAE,CAAA;AAErE,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAG,CAAA;AAEhC,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,QAAA,MAAM,IAAI,MAAM,CAAA,KAAA,EAAQ,QAAA,CAAS,MAAM,CAAA,EAAA,EAAK,QAAA,CAAS,UAAU,CAAA,CAAE,CAAA;AAAA,MACnE;AAEA,MAAA,MAAM,MAAA,GAAU,MAAM,QAAA,CAAS,IAAA,EAAK;AAEpC,MAAA,IAAI,CAAC,MAAA,CAAO,EAAA,IAAM,CAAC,OAAO,IAAA,EAAM;AAC9B,QAAA,MAAM,IAAI,KAAA,CAAM,MAAA,CAAO,KAAA,IAAS,uBAAuB,CAAA;AAAA,MACzD;AAEA,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,IAChB,SAAS,KAAA,EAAO;AACd,MAAA,GAAA,CAAI,SAAS,MAAA,CAAO,KAAA;AAAA,QAClB,sCAAA;AAAA,QACA,KAAA,YAAiB,QAAQ,KAAA,GAAQ;AAAA,OACnC;AACA,MAAA,cAAA,CAAe,KAAK,CAAA;AAAA,IACtB;AAAA,EACF;AACF,CAAC","file":"stats-handler.js","sourcesContent":["/**\n * HTTP client for interacting with Workflow Daemon\n */\nimport type {\n  WorkflowRerunRequest,\n  WorkflowRestartRequest,\n  WorkflowRestartResponse,\n  WorkflowRunRequest,\n  JobStatusInfo,\n  JobStepsResponse,\n  JobLogsResponse,\n  CronListResponse,\n} from '@kb-labs/workflow-contracts';\nimport { useEnv } from '@kb-labs/sdk';\n\n/** Workflow run summary returned by GET /api/v1/runs */\nexport interface WorkflowRunSummary {\n  id: string;\n  name: string;\n  version?: string;\n  status: 'queued' | 'running' | 'success' | 'failed' | 'cancelled';\n  trigger?: {\n    type: string;\n    actor?: string;\n    payload?: unknown;\n    parentRunId?: string;\n    parentJobId?: string;\n    parentStepId?: string;\n  };\n  createdAt?: string;\n  startedAt?: string;\n  finishedAt?: string;\n  durationMs?: number;\n  inputs?: Record<string, unknown>;\n  hasPendingApproval?: boolean;\n  currentStepName?: string;\n}\n\n/** Full workflow run detail returned by GET /api/v1/runs/:runId */\nexport interface WorkflowRunDetail extends WorkflowRunSummary {\n  env?: Record<string, string>;\n  metadata?: Record<string, unknown>;\n  result?: {\n    status: string;\n    summary?: string;\n    error?: { message: string; code?: string };\n    outputs?: Record<string, unknown>;\n  };\n  jobs?: Array<{\n    id: string;\n    jobName?: string;\n    status: string;\n    startedAt?: string;\n    finishedAt?: string;\n    durationMs?: number;\n    attempt?: number;\n    error?: { message: string; code?: string; stack?: string } | string;\n    steps?: Array<{\n      id: string;\n      name?: string;\n      index?: number;\n      status: string;\n      startedAt?: string;\n      finishedAt?: string;\n      durationMs?: number;\n      attempt?: number;\n      outputs?: Record<string, unknown>;\n      resolvedInputs?: Record<string, unknown>;\n      error?: { message: string; code?: string; details?: Record<string, unknown> } | string;\n      spec?: Record<string, unknown>;\n    }>;\n  }>;\n}\n\n/** Metrics data returned by GET /metrics */\nexport interface WorkflowMetricsData {\n  runs: {\n    total: number;\n    queued: number;\n    running: number;\n    completed: number;\n    failed: number;\n    cancelled: number;\n  };\n  jobs: {\n    total: number;\n    queued: number;\n    running: number;\n    completed: number;\n    failed: number;\n  };\n  [key: string]: unknown;\n}\n\n/** Extended job status returned by GET /api/v1/jobs/:id — includes nested jobs/steps */\nexport interface JobStatusDetail extends Omit<JobStatusInfo, 'result'> {\n  result?: {\n    ok: boolean;\n    summary?: string;\n    error?: { code: string; message: string };\n  };\n  jobs?: Array<{\n    id: string;\n    name: string;\n    status: string;\n    startedAt?: string;\n    finishedAt?: string;\n    durationMs?: number;\n    error?: string;\n    steps?: Array<{\n      id: string;\n      name: string;\n      status: string;\n      handler?: string;\n      startedAt?: string;\n      finishedAt?: string;\n      durationMs?: number;\n      outputs?: Record<string, unknown>;\n      error?: { message?: string } | string;\n    }>;\n  }>;\n}\n\nconst DEFAULT_DAEMON_URL = 'http://localhost:7778';\n\nexport interface DaemonClientOptions {\n  url?: string;\n}\n\n/**\n * Get workflow daemon URL from environment or default\n */\nexport function getWorkflowDaemonUrl(): string {\n  return useEnv('WORKFLOW_DAEMON_URL') ?? DEFAULT_DAEMON_URL;\n}\n\nexport class WorkflowDaemonClient {\n  private readonly baseUrl: string;\n\n  constructor(options: DaemonClientOptions = {}) {\n    this.baseUrl = options.url ?? useEnv('WORKFLOW_DAEMON_URL') ?? DEFAULT_DAEMON_URL;\n  }\n\n  /**\n   * Validate response Content-Type and parse JSON safely\n   */\n  private async parseJsonResponse<T>(response: Response): Promise<T> {\n    const contentType = response.headers.get('content-type');\n    if (!contentType?.includes('application/json')) {\n      throw new Error(`Invalid Content-Type: expected application/json, got ${contentType}`);\n    }\n    return response.json() as Promise<T>;\n  }\n\n  private unwrapData<T>(payload: unknown): T {\n    if (\n      payload\n      && typeof payload === 'object'\n      && 'ok' in payload\n      && (payload as { ok?: boolean }).ok === true\n      && 'data' in payload\n    ) {\n      return (payload as { data: T }).data;\n    }\n    return payload as T;\n  }\n\n  /**\n   * Validate and encode job ID to prevent path traversal attacks\n   */\n  private validateAndEncodeJobId(jobId: string): string {\n    // Validate job ID format (alphanumeric, hyphens, underscores only)\n    if (!/^[a-zA-Z0-9_-]+$/.test(jobId)) {\n      throw new Error(`Invalid job ID format: ${jobId}`);\n    }\n    // Encode for URL safety (defense in depth)\n    return encodeURIComponent(jobId);\n  }\n\n  /**\n   * Health check\n   */\n  async health(): Promise<{ ok: boolean; service: string }> {\n    const response = await fetch(`${this.baseUrl}/health`);\n    if (!response.ok) {\n      throw new Error(`Health check failed: ${response.statusText}`);\n    }\n    return this.parseJsonResponse(response);\n  }\n\n  /**\n   * Get workflow metrics (raw metrics data from daemon)\n   */\n  async getMetrics(): Promise<WorkflowMetricsData> {\n    const response = await fetch(`${this.baseUrl}/metrics`);\n    if (!response.ok) {\n      throw new Error(`Failed to get metrics: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<WorkflowMetricsData>(data);\n  }\n\n  /**\n   * Get job status with full details (jobs, steps, outputs)\n   */\n  async getJobStatus(jobId: string): Promise<JobStatusDetail> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job status: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<JobStatusDetail>(data);\n  }\n\n  /**\n   * Get job steps with outputs\n   */\n  async getJobSteps(jobId: string): Promise<JobStepsResponse> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/steps`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job steps: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<JobStepsResponse>(data);\n  }\n\n  /**\n   * Get job logs\n   */\n  async getJobLogs(jobId: string): Promise<JobLogsResponse['logs']> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/logs`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job logs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<JobLogsResponse>(data);\n    return unwrapped.logs ?? [];\n  }\n\n  /**\n   * Get active executions\n   */\n  async getExecutions(): Promise<JobStatusInfo[]> {\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs`);\n    if (!response.ok) {\n      throw new Error(`Failed to get executions: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ jobs?: JobStatusInfo[] }>(data);\n    const jobs = unwrapped.jobs ?? [];\n    return jobs.filter((job) => job.status === 'running' || job.status === 'pending');\n  }\n\n  /**\n   * Get cron jobs\n   */\n  async getCronJobs(): Promise<CronListResponse> {\n    const response = await fetch(`${this.baseUrl}/api/v1/cron`);\n    if (!response.ok) {\n      throw new Error(`Failed to get cron jobs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<CronListResponse>(data);\n  }\n\n  /**\n   * Submit a job for execution\n   */\n  async submitJob(params: {\n    handler: string;\n    input?: unknown;\n    priority?: number;\n  }): Promise<{ id: string; status: string }> {\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({\n        type: params.handler,\n        payload: params.input,\n        priority: params.priority,\n      }),\n    });\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to submit job: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<unknown>(response);\n    const data = this.unwrapData<{ jobId: string }>(payload);\n    return { id: data.jobId, status: 'pending' };\n  }\n\n  /**\n   * List workflow runs with optional status filter\n   */\n  async listRuns(params: {\n    status?: string;\n    limit?: number;\n    workflowId?: string;\n  } = {}): Promise<WorkflowRunSummary[]> {\n    const query = new URLSearchParams();\n    if (params.status) { query.set('status', params.status); }\n    if (params.limit) { query.set('limit', String(params.limit)); }\n    if (params.workflowId) { query.set('workflowId', params.workflowId); }\n\n    const qs = query.toString();\n    const response = await fetch(`${this.baseUrl}/api/v1/runs${qs ? `?${qs}` : ''}`);\n    if (!response.ok) {\n      throw new Error(`Failed to list runs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ runs?: WorkflowRunSummary[] }>(data);\n    return unwrapped.runs ?? (Array.isArray(data) ? data as WorkflowRunSummary[] : []);\n  }\n\n  /**\n   * Get a specific workflow run with full detail\n   */\n  async getRun(runId: string): Promise<WorkflowRunDetail> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}`);\n    if (response.status === 404) {\n      throw new Error(`Run ${runId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get run: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    // Response shape: { ok: true, data: { run: {...} } }\n    const unwrapped = this.unwrapData<{ run?: WorkflowRunDetail } | WorkflowRunDetail>(data);\n    return ('run' in (unwrapped as object) ? (unwrapped as { run: WorkflowRunDetail }).run : unwrapped) as WorkflowRunDetail;\n  }\n\n  /**\n   * Get run logs, optionally filtered to failed steps only\n   */\n  async getRunLogs(runId: string, params: {\n    stepId?: string;\n    level?: string;\n    limit?: number;\n    failedOnly?: boolean;\n  } = {}): Promise<Array<{ level: string; message: string; timestamp: string; stepId?: string; stepName?: string; stream?: string; [key: string]: unknown }>> {\n    const query = new URLSearchParams();\n    if (params.stepId) { query.set('stepId', params.stepId); }\n    if (params.level) { query.set('level', params.level); }\n    if (params.limit) { query.set('limit', String(params.limit)); }\n    if (params.failedOnly) { query.set('failedOnly', 'true'); }\n\n    const encodedId = encodeURIComponent(runId);\n    const qs = query.toString();\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/logs${qs ? `?${qs}` : ''}`);\n    if (response.status === 404) {\n      throw new Error(`Run ${runId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get run logs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ logs?: unknown[] }>(data);\n    return (unwrapped.logs ?? []) as Array<{ level: string; message: string; timestamp: string; [key: string]: unknown }>;\n  }\n\n  /**\n   * Stream run events via SSE (returns a ReadableStream or EventSource-compatible URL)\n   */\n  getRunEventsUrl(runId: string): string {\n    return `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/events`;\n  }\n\n  /**\n   * List pending approval steps for a run\n   */\n  async listPendingApprovals(runId: string): Promise<{\n    runId: string;\n    pending: Array<{\n      jobId: string;\n      stepId: string;\n      stepName: string;\n      specId?: string;\n      context: Record<string, unknown>;\n      waitingSince?: string;\n    }>;\n  }> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/approvals`);\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to list pending approvals: ${message || response.statusText || response.status}`);\n    }\n    const payload = await this.parseJsonResponse<{\n      ok: boolean;\n      data?: {\n        runId: string;\n        pending: Array<{\n          jobId: string;\n          stepId: string;\n          stepName: string;\n          specId?: string;\n          context: Record<string, unknown>;\n          waitingSince?: string;\n        }>;\n      };\n    }>(response);\n    return this.unwrapData(payload);\n  }\n\n  /**\n   * Resolve (approve or reject) a pending approval step\n   */\n  async resolveApproval(\n    runId: string,\n    jobId: string,\n    stepId: string,\n    action: 'approve' | 'reject',\n    comment?: string,\n    data?: Record<string, unknown>\n  ): Promise<{ runId: string; jobId: string; stepId: string; action: string; resolved: boolean }> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/approvals/resolve`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({ jobId, stepId, action, comment, data }),\n    });\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to resolve approval: ${message || response.statusText || response.status}`);\n    }\n    const payload = await this.parseJsonResponse<{\n      ok: boolean;\n      data?: { runId: string; jobId: string; stepId: string; action: string; resolved: boolean };\n    }>(response);\n    return this.unwrapData(payload);\n  }\n\n  /**\n   * Cancel a workflow run\n   */\n  async cancelRun(runId: string): Promise<void> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/cancel`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: '{}',\n    });\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to cancel run: ${message || response.statusText || response.status}`);\n    }\n  }\n\n  /**\n   * Run workflow by ID\n   */\n  async runWorkflow(\n    workflowId: string,\n    request: WorkflowRunRequest = {}\n  ): Promise<{ runId: string; status: string }> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/workflows/${encodeURIComponent(workflowId)}/runs`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      }\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to run workflow: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: { runId: string; status: string } }>(response);\n    return this.unwrapData<{ runId: string; status: string }>(payload);\n  }\n\n  /**\n   * Rerun a workflow run by ID, optionally only failed jobs\n   */\n  async rerunWorkflow(\n    runId: string,\n    request: WorkflowRerunRequest = {},\n  ): Promise<{ runId: string; status: string }> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/rerun`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      },\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to rerun workflow: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: { runId: string; status: string } }>(response);\n    return this.unwrapData<{ runId: string; status: string }>(payload);\n  }\n\n  /**\n   * Restart a run from a snapshot, optionally resuming from a specific step.\n   * Preceding steps inherit their stored outputs; only the target step and beyond are re-executed.\n   */\n  async restartRun(\n    runId: string,\n    request: WorkflowRestartRequest = {},\n  ): Promise<WorkflowRestartResponse> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/restart`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      },\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to restart run: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: WorkflowRestartResponse }>(response);\n    return this.unwrapData<WorkflowRestartResponse>(payload);\n  }\n}\n","/**\n * @module @kb-labs/workflow-cli/rest/stats-handler\n * REST handler for dashboard statistics (proxy to daemon)\n */\n\nimport { defineHandler, rethrowForRest, type RestInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport type { DashboardStatsResponse } from '@kb-labs/workflow-contracts';\nimport { getWorkflowDaemonUrl } from '../http-client';\n\nexport default defineHandler({\n  async execute(ctx: PluginContextV3, _input: RestInput<unknown>): Promise<DashboardStatsResponse> {\n    const daemonUrl = getWorkflowDaemonUrl();\n    const url = `${daemonUrl}/api/v1/stats`;\n\n    ctx.platform.logger.info(`[stats-handler] Fetching stats from ${url}`);\n\n    try {\n      const response = await fetch(url);\n\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      const result = (await response.json()) as { ok: boolean; data?: DashboardStatsResponse; error?: string };\n\n      if (!result.ok || !result.data) {\n        throw new Error(result.error || 'Failed to fetch stats');\n      }\n\n      return result.data;\n    } catch (error) {\n      ctx.platform.logger.error(\n        '[stats-handler] Error fetching stats',\n        error instanceof Error ? error : undefined\n      );\n      rethrowForRest(error);\n    }\n  },\n});\n"]}

package/dist/rest/workflow-detail-handler.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/http-client.ts","../../src/rest/workflow-detail-handler.ts"],"names":[],"mappings":";;;AAwHA,IAAM,kBAAA,GAAqB,uBAAA;AASpB,SAAS,oBAAA,GAA+B;AAC7C,EAAA,OAAO,MAAA,CAAO,qBAAqB,CAAA,IAAK,kBAAA;AAC1C;;;ACtHA,IAAO,kCAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CACJ,GAAA,EACA,KAAA,EACuB;AACvB,IAAA,MAAM,YAAY,oBAAA,EAAqB;AACvC,IAAA,MAAM,EAAE,EAAA,EAAG,GAAI,KAAA,CAAM,MAAA;AAErB,IAAA,IAAI,CAAC,EAAA,EAAI;AACP,MAAA,MAAM,IAAI,MAAM,sBAAsB,CAAA;AAAA,IACxC;AAEA,IAAA,MAAM,MAAM,CAAA,EAAG,SAAS,CAAA,kBAAA,EAAqB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA;AACnE,IAAA,GAAA,CAAI,SAAS,MAAA,CAAO,IAAA,CAAK,+CAA+C,EAAE,CAAA,MAAA,EAAS,GAAG,CAAA,CAAE,CAAA;AAExF,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAG,CAAA;AAEhC,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,QAAA,IAAI,QAAA,CAAS,WAAW,GAAA,EAAK;AAC3B,UAAA,MAAM,IAAI,MAAM,oBAAoB,CAAA;AAAA,QACtC;AACA,QAAA,MAAM,IAAI,MAAM,CAAA,KAAA,EAAQ,QAAA,CAAS,MAAM,CAAA,EAAA,EAAK,QAAA,CAAS,UAAU,CAAA,CAAE,CAAA;AAAA,MACnE;AAEA,MAAA,MAAM,MAAA,GAAU,MAAM,QAAA,CAAS,IAAA,EAAK;AAEpC,MAAA,IAAI,CAAC,MAAA,CAAO,EAAA,IAAM,CAAC,OAAO,IAAA,EAAM;AAC9B,QAAA,MAAM,IAAI,KAAA,CAAM,MAAA,CAAO,KAAA,IAAS,0BAA0B,CAAA;AAAA,MAC5D;AAEA,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,IAChB,SAAS,KAAA,EAAO;AACd,MAAA,GAAA,CAAI,SAAS,MAAA,CAAO,KAAA;AAAA,QAClB,0DAAA;AAAA,QACA,KAAA,YAAiB,QAAQ,KAAA,GAAQ;AAAA,OACnC;AACA,MAAA,cAAA,CAAe,KAAK,CAAA;AAAA,IACtB;AAAA,EACF;AACF,CAAC","file":"workflow-detail-handler.js","sourcesContent":["/**\n * HTTP client for interacting with Workflow Daemon\n */\nimport type {\n  WorkflowRerunRequest,\n  WorkflowRestartRequest,\n  WorkflowRestartResponse,\n  WorkflowRunRequest,\n  JobStatusInfo,\n  JobStepsResponse,\n  JobLogsResponse,\n  CronListResponse,\n} from '@kb-labs/workflow-contracts';\nimport { useEnv } from '@kb-labs/sdk';\n\n/** Workflow run summary returned by GET /api/v1/runs */\nexport interface WorkflowRunSummary {\n  id: string;\n  name: string;\n  version?: string;\n  status: 'queued' | 'running' | 'success' | 'failed' | 'cancelled';\n  trigger?: {\n    type: string;\n    actor?: string;\n    payload?: unknown;\n  };\n  createdAt?: string;\n  startedAt?: string;\n  finishedAt?: string;\n  durationMs?: number;\n  inputs?: Record<string, unknown>;\n  hasPendingApproval?: boolean;\n  currentStepName?: string;\n}\n\n/** Full workflow run detail returned by GET /api/v1/runs/:runId */\nexport interface WorkflowRunDetail extends WorkflowRunSummary {\n  env?: Record<string, string>;\n  metadata?: Record<string, unknown>;\n  result?: {\n    status: string;\n    summary?: string;\n    error?: { message: string; code?: string };\n    outputs?: Record<string, unknown>;\n  };\n  jobs?: Array<{\n    id: string;\n    jobName?: string;\n    status: string;\n    startedAt?: string;\n    finishedAt?: string;\n    durationMs?: number;\n    attempt?: number;\n    error?: { message: string; code?: string; stack?: string } | string;\n    steps?: Array<{\n      id: string;\n      name?: string;\n      index?: number;\n      status: string;\n      startedAt?: string;\n      finishedAt?: string;\n      durationMs?: number;\n      attempt?: number;\n      outputs?: Record<string, unknown>;\n      resolvedInputs?: Record<string, unknown>;\n      error?: { message: string; code?: string; details?: Record<string, unknown> } | string;\n      spec?: Record<string, unknown>;\n    }>;\n  }>;\n}\n\n/** Metrics data returned by GET /metrics */\nexport interface WorkflowMetricsData {\n  runs: {\n    total: number;\n    queued: number;\n    running: number;\n    completed: number;\n    failed: number;\n    cancelled: number;\n  };\n  jobs: {\n    total: number;\n    queued: number;\n    running: number;\n    completed: number;\n    failed: number;\n  };\n  [key: string]: unknown;\n}\n\n/** Extended job status returned by GET /api/v1/jobs/:id — includes nested jobs/steps */\nexport interface JobStatusDetail extends Omit<JobStatusInfo, 'result'> {\n  result?: {\n    ok: boolean;\n    summary?: string;\n    error?: { code: string; message: string };\n  };\n  jobs?: Array<{\n    id: string;\n    name: string;\n    status: string;\n    startedAt?: string;\n    finishedAt?: string;\n    durationMs?: number;\n    error?: string;\n    steps?: Array<{\n      id: string;\n      name: string;\n      status: string;\n      handler?: string;\n      startedAt?: string;\n      finishedAt?: string;\n      durationMs?: number;\n      outputs?: Record<string, unknown>;\n      error?: { message?: string } | string;\n    }>;\n  }>;\n}\n\nconst DEFAULT_DAEMON_URL = 'http://localhost:7778';\n\nexport interface DaemonClientOptions {\n  url?: string;\n}\n\n/**\n * Get workflow daemon URL from environment or default\n */\nexport function getWorkflowDaemonUrl(): string {\n  return useEnv('WORKFLOW_DAEMON_URL') ?? DEFAULT_DAEMON_URL;\n}\n\nexport class WorkflowDaemonClient {\n  private readonly baseUrl: string;\n\n  constructor(options: DaemonClientOptions = {}) {\n    this.baseUrl = options.url ?? useEnv('WORKFLOW_DAEMON_URL') ?? DEFAULT_DAEMON_URL;\n  }\n\n  /**\n   * Validate response Content-Type and parse JSON safely\n   */\n  private async parseJsonResponse<T>(response: Response): Promise<T> {\n    const contentType = response.headers.get('content-type');\n    if (!contentType?.includes('application/json')) {\n      throw new Error(`Invalid Content-Type: expected application/json, got ${contentType}`);\n    }\n    return response.json() as Promise<T>;\n  }\n\n  private unwrapData<T>(payload: unknown): T {\n    if (\n      payload\n      && typeof payload === 'object'\n      && 'ok' in payload\n      && (payload as { ok?: boolean }).ok === true\n      && 'data' in payload\n    ) {\n      return (payload as { data: T }).data;\n    }\n    return payload as T;\n  }\n\n  /**\n   * Validate and encode job ID to prevent path traversal attacks\n   */\n  private validateAndEncodeJobId(jobId: string): string {\n    // Validate job ID format (alphanumeric, hyphens, underscores only)\n    if (!/^[a-zA-Z0-9_-]+$/.test(jobId)) {\n      throw new Error(`Invalid job ID format: ${jobId}`);\n    }\n    // Encode for URL safety (defense in depth)\n    return encodeURIComponent(jobId);\n  }\n\n  /**\n   * Health check\n   */\n  async health(): Promise<{ ok: boolean; service: string }> {\n    const response = await fetch(`${this.baseUrl}/health`);\n    if (!response.ok) {\n      throw new Error(`Health check failed: ${response.statusText}`);\n    }\n    return this.parseJsonResponse(response);\n  }\n\n  /**\n   * Get workflow metrics (raw metrics data from daemon)\n   */\n  async getMetrics(): Promise<WorkflowMetricsData> {\n    const response = await fetch(`${this.baseUrl}/metrics`);\n    if (!response.ok) {\n      throw new Error(`Failed to get metrics: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<WorkflowMetricsData>(data);\n  }\n\n  /**\n   * Get job status with full details (jobs, steps, outputs)\n   */\n  async getJobStatus(jobId: string): Promise<JobStatusDetail> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job status: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<JobStatusDetail>(data);\n  }\n\n  /**\n   * Get job steps with outputs\n   */\n  async getJobSteps(jobId: string): Promise<JobStepsResponse> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/steps`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job steps: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<JobStepsResponse>(data);\n  }\n\n  /**\n   * Get job logs\n   */\n  async getJobLogs(jobId: string): Promise<JobLogsResponse['logs']> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/logs`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job logs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<JobLogsResponse>(data);\n    return unwrapped.logs ?? [];\n  }\n\n  /**\n   * Get active executions\n   */\n  async getExecutions(): Promise<JobStatusInfo[]> {\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs`);\n    if (!response.ok) {\n      throw new Error(`Failed to get executions: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ jobs?: JobStatusInfo[] }>(data);\n    const jobs = unwrapped.jobs ?? [];\n    return jobs.filter((job) => job.status === 'running' || job.status === 'pending');\n  }\n\n  /**\n   * Get cron jobs\n   */\n  async getCronJobs(): Promise<CronListResponse> {\n    const response = await fetch(`${this.baseUrl}/api/v1/cron`);\n    if (!response.ok) {\n      throw new Error(`Failed to get cron jobs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<CronListResponse>(data);\n  }\n\n  /**\n   * Submit a job for execution\n   */\n  async submitJob(params: {\n    handler: string;\n    input?: unknown;\n    priority?: number;\n  }): Promise<{ id: string; status: string }> {\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({\n        type: params.handler,\n        payload: params.input,\n        priority: params.priority,\n      }),\n    });\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to submit job: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<unknown>(response);\n    const data = this.unwrapData<{ jobId: string }>(payload);\n    return { id: data.jobId, status: 'pending' };\n  }\n\n  /**\n   * List workflow runs with optional status filter\n   */\n  async listRuns(params: {\n    status?: string;\n    limit?: number;\n    workflowId?: string;\n  } = {}): Promise<WorkflowRunSummary[]> {\n    const query = new URLSearchParams();\n    if (params.status) { query.set('status', params.status); }\n    if (params.limit) { query.set('limit', String(params.limit)); }\n    if (params.workflowId) { query.set('workflowId', params.workflowId); }\n\n    const qs = query.toString();\n    const response = await fetch(`${this.baseUrl}/api/v1/runs${qs ? `?${qs}` : ''}`);\n    if (!response.ok) {\n      throw new Error(`Failed to list runs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ runs?: WorkflowRunSummary[] }>(data);\n    return unwrapped.runs ?? (Array.isArray(data) ? data as WorkflowRunSummary[] : []);\n  }\n\n  /**\n   * Get a specific workflow run with full detail\n   */\n  async getRun(runId: string): Promise<WorkflowRunDetail> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}`);\n    if (response.status === 404) {\n      throw new Error(`Run ${runId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get run: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    // Response shape: { ok: true, data: { run: {...} } }\n    const unwrapped = this.unwrapData<{ run?: WorkflowRunDetail } | WorkflowRunDetail>(data);\n    return ('run' in (unwrapped as object) ? (unwrapped as { run: WorkflowRunDetail }).run : unwrapped) as WorkflowRunDetail;\n  }\n\n  /**\n   * Get run logs, optionally filtered to failed steps only\n   */\n  async getRunLogs(runId: string, params: {\n    stepId?: string;\n    level?: string;\n    limit?: number;\n    failedOnly?: boolean;\n  } = {}): Promise<Array<{ level: string; message: string; timestamp: string; stepId?: string; stepName?: string; stream?: string; [key: string]: unknown }>> {\n    const query = new URLSearchParams();\n    if (params.stepId) { query.set('stepId', params.stepId); }\n    if (params.level) { query.set('level', params.level); }\n    if (params.limit) { query.set('limit', String(params.limit)); }\n    if (params.failedOnly) { query.set('failedOnly', 'true'); }\n\n    const encodedId = encodeURIComponent(runId);\n    const qs = query.toString();\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/logs${qs ? `?${qs}` : ''}`);\n    if (response.status === 404) {\n      throw new Error(`Run ${runId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get run logs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ logs?: unknown[] }>(data);\n    return (unwrapped.logs ?? []) as Array<{ level: string; message: string; timestamp: string; [key: string]: unknown }>;\n  }\n\n  /**\n   * Stream run events via SSE (returns a ReadableStream or EventSource-compatible URL)\n   */\n  getRunEventsUrl(runId: string): string {\n    return `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/events`;\n  }\n\n  /**\n   * List pending approval steps for a run\n   */\n  async listPendingApprovals(runId: string): Promise<{\n    runId: string;\n    pending: Array<{\n      jobId: string;\n      stepId: string;\n      stepName: string;\n      specId?: string;\n      context: Record<string, unknown>;\n      waitingSince?: string;\n    }>;\n  }> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/approvals`);\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to list pending approvals: ${message || response.statusText || response.status}`);\n    }\n    const payload = await this.parseJsonResponse<{\n      ok: boolean;\n      data?: {\n        runId: string;\n        pending: Array<{\n          jobId: string;\n          stepId: string;\n          stepName: string;\n          specId?: string;\n          context: Record<string, unknown>;\n          waitingSince?: string;\n        }>;\n      };\n    }>(response);\n    return this.unwrapData(payload);\n  }\n\n  /**\n   * Resolve (approve or reject) a pending approval step\n   */\n  async resolveApproval(\n    runId: string,\n    jobId: string,\n    stepId: string,\n    action: 'approve' | 'reject',\n    comment?: string,\n    data?: Record<string, unknown>\n  ): Promise<{ runId: string; jobId: string; stepId: string; action: string; resolved: boolean }> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/approvals/resolve`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({ jobId, stepId, action, comment, data }),\n    });\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to resolve approval: ${message || response.statusText || response.status}`);\n    }\n    const payload = await this.parseJsonResponse<{\n      ok: boolean;\n      data?: { runId: string; jobId: string; stepId: string; action: string; resolved: boolean };\n    }>(response);\n    return this.unwrapData(payload);\n  }\n\n  /**\n   * Cancel a workflow run\n   */\n  async cancelRun(runId: string): Promise<void> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/cancel`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: '{}',\n    });\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to cancel run: ${message || response.statusText || response.status}`);\n    }\n  }\n\n  /**\n   * Run workflow by ID\n   */\n  async runWorkflow(\n    workflowId: string,\n    request: WorkflowRunRequest = {}\n  ): Promise<{ runId: string; status: string }> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/workflows/${encodeURIComponent(workflowId)}/runs`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      }\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to run workflow: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: { runId: string; status: string } }>(response);\n    return this.unwrapData<{ runId: string; status: string }>(payload);\n  }\n\n  /**\n   * Rerun a workflow run by ID, optionally only failed jobs\n   */\n  async rerunWorkflow(\n    runId: string,\n    request: WorkflowRerunRequest = {},\n  ): Promise<{ runId: string; status: string }> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/rerun`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      },\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to rerun workflow: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: { runId: string; status: string } }>(response);\n    return this.unwrapData<{ runId: string; status: string }>(payload);\n  }\n\n  /**\n   * Restart a run from a snapshot, optionally resuming from a specific step.\n   * Preceding steps inherit their stored outputs; only the target step and beyond are re-executed.\n   */\n  async restartRun(\n    runId: string,\n    request: WorkflowRestartRequest = {},\n  ): Promise<WorkflowRestartResponse> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/restart`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      },\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to restart run: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: WorkflowRestartResponse }>(response);\n    return this.unwrapData<WorkflowRestartResponse>(payload);\n  }\n}\n","/**\n * @module @kb-labs/workflow-cli/rest/workflow-detail-handler\n * REST handler for getting workflow definition details\n */\n\nimport { defineHandler, rethrowForRest, type RestInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport type { WorkflowInfo } from '@kb-labs/workflow-contracts';\nimport { getWorkflowDaemonUrl } from '../http-client';\n\ninterface WorkflowDetailParams {\n  id: string;\n}\n\nexport default defineHandler({\n  async execute(\n    ctx: PluginContextV3,\n    input: RestInput<unknown, unknown, WorkflowDetailParams>\n  ): Promise<WorkflowInfo> {\n    const daemonUrl = getWorkflowDaemonUrl();\n    const { id } = input.params!;\n\n    if (!id) {\n      throw new Error('Missing id parameter');\n    }\n\n    const url = `${daemonUrl}/api/v1/workflows/${encodeURIComponent(id)}`;\n    ctx.platform.logger.info(`[workflow-detail-handler] Fetching workflow ${id} from ${url}`);\n\n    try {\n      const response = await fetch(url);\n\n      if (!response.ok) {\n        if (response.status === 404) {\n          throw new Error('Workflow not found');\n        }\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      const result = (await response.json()) as { ok: boolean; data?: WorkflowInfo; error?: string };\n\n      if (!result.ok || !result.data) {\n        throw new Error(result.error || 'Failed to fetch workflow');\n      }\n\n      return result.data;\n    } catch (error) {\n      ctx.platform.logger.error(\n        '[workflow-detail-handler] Error fetching workflow detail',\n        error instanceof Error ? error : undefined\n      );\n      rethrowForRest(error);\n    }\n  },\n});\n"]}
+{"version":3,"sources":["../../src/http-client.ts","../../src/rest/workflow-detail-handler.ts"],"names":[],"mappings":";;;AA2HA,IAAM,kBAAA,GAAqB,uBAAA;AASpB,SAAS,oBAAA,GAA+B;AAC7C,EAAA,OAAO,MAAA,CAAO,qBAAqB,CAAA,IAAK,kBAAA;AAC1C;;;ACzHA,IAAO,kCAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CACJ,GAAA,EACA,KAAA,EACuB;AACvB,IAAA,MAAM,YAAY,oBAAA,EAAqB;AACvC,IAAA,MAAM,EAAE,EAAA,EAAG,GAAI,KAAA,CAAM,MAAA;AAErB,IAAA,IAAI,CAAC,EAAA,EAAI;AACP,MAAA,MAAM,IAAI,MAAM,sBAAsB,CAAA;AAAA,IACxC;AAEA,IAAA,MAAM,MAAM,CAAA,EAAG,SAAS,CAAA,kBAAA,EAAqB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA;AACnE,IAAA,GAAA,CAAI,SAAS,MAAA,CAAO,IAAA,CAAK,+CAA+C,EAAE,CAAA,MAAA,EAAS,GAAG,CAAA,CAAE,CAAA;AAExF,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAG,CAAA;AAEhC,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,QAAA,IAAI,QAAA,CAAS,WAAW,GAAA,EAAK;AAC3B,UAAA,MAAM,IAAI,MAAM,oBAAoB,CAAA;AAAA,QACtC;AACA,QAAA,MAAM,IAAI,MAAM,CAAA,KAAA,EAAQ,QAAA,CAAS,MAAM,CAAA,EAAA,EAAK,QAAA,CAAS,UAAU,CAAA,CAAE,CAAA;AAAA,MACnE;AAEA,MAAA,MAAM,MAAA,GAAU,MAAM,QAAA,CAAS,IAAA,EAAK;AAEpC,MAAA,IAAI,CAAC,MAAA,CAAO,EAAA,IAAM,CAAC,OAAO,IAAA,EAAM;AAC9B,QAAA,MAAM,IAAI,KAAA,CAAM,MAAA,CAAO,KAAA,IAAS,0BAA0B,CAAA;AAAA,MAC5D;AAEA,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,IAChB,SAAS,KAAA,EAAO;AACd,MAAA,GAAA,CAAI,SAAS,MAAA,CAAO,KAAA;AAAA,QAClB,0DAAA;AAAA,QACA,KAAA,YAAiB,QAAQ,KAAA,GAAQ;AAAA,OACnC;AACA,MAAA,cAAA,CAAe,KAAK,CAAA;AAAA,IACtB;AAAA,EACF;AACF,CAAC","file":"workflow-detail-handler.js","sourcesContent":["/**\n * HTTP client for interacting with Workflow Daemon\n */\nimport type {\n  WorkflowRerunRequest,\n  WorkflowRestartRequest,\n  WorkflowRestartResponse,\n  WorkflowRunRequest,\n  JobStatusInfo,\n  JobStepsResponse,\n  JobLogsResponse,\n  CronListResponse,\n} from '@kb-labs/workflow-contracts';\nimport { useEnv } from '@kb-labs/sdk';\n\n/** Workflow run summary returned by GET /api/v1/runs */\nexport interface WorkflowRunSummary {\n  id: string;\n  name: string;\n  version?: string;\n  status: 'queued' | 'running' | 'success' | 'failed' | 'cancelled';\n  trigger?: {\n    type: string;\n    actor?: string;\n    payload?: unknown;\n    parentRunId?: string;\n    parentJobId?: string;\n    parentStepId?: string;\n  };\n  createdAt?: string;\n  startedAt?: string;\n  finishedAt?: string;\n  durationMs?: number;\n  inputs?: Record<string, unknown>;\n  hasPendingApproval?: boolean;\n  currentStepName?: string;\n}\n\n/** Full workflow run detail returned by GET /api/v1/runs/:runId */\nexport interface WorkflowRunDetail extends WorkflowRunSummary {\n  env?: Record<string, string>;\n  metadata?: Record<string, unknown>;\n  result?: {\n    status: string;\n    summary?: string;\n    error?: { message: string; code?: string };\n    outputs?: Record<string, unknown>;\n  };\n  jobs?: Array<{\n    id: string;\n    jobName?: string;\n    status: string;\n    startedAt?: string;\n    finishedAt?: string;\n    durationMs?: number;\n    attempt?: number;\n    error?: { message: string; code?: string; stack?: string } | string;\n    steps?: Array<{\n      id: string;\n      name?: string;\n      index?: number;\n      status: string;\n      startedAt?: string;\n      finishedAt?: string;\n      durationMs?: number;\n      attempt?: number;\n      outputs?: Record<string, unknown>;\n      resolvedInputs?: Record<string, unknown>;\n      error?: { message: string; code?: string; details?: Record<string, unknown> } | string;\n      spec?: Record<string, unknown>;\n    }>;\n  }>;\n}\n\n/** Metrics data returned by GET /metrics */\nexport interface WorkflowMetricsData {\n  runs: {\n    total: number;\n    queued: number;\n    running: number;\n    completed: number;\n    failed: number;\n    cancelled: number;\n  };\n  jobs: {\n    total: number;\n    queued: number;\n    running: number;\n    completed: number;\n    failed: number;\n  };\n  [key: string]: unknown;\n}\n\n/** Extended job status returned by GET /api/v1/jobs/:id — includes nested jobs/steps */\nexport interface JobStatusDetail extends Omit<JobStatusInfo, 'result'> {\n  result?: {\n    ok: boolean;\n    summary?: string;\n    error?: { code: string; message: string };\n  };\n  jobs?: Array<{\n    id: string;\n    name: string;\n    status: string;\n    startedAt?: string;\n    finishedAt?: string;\n    durationMs?: number;\n    error?: string;\n    steps?: Array<{\n      id: string;\n      name: string;\n      status: string;\n      handler?: string;\n      startedAt?: string;\n      finishedAt?: string;\n      durationMs?: number;\n      outputs?: Record<string, unknown>;\n      error?: { message?: string } | string;\n    }>;\n  }>;\n}\n\nconst DEFAULT_DAEMON_URL = 'http://localhost:7778';\n\nexport interface DaemonClientOptions {\n  url?: string;\n}\n\n/**\n * Get workflow daemon URL from environment or default\n */\nexport function getWorkflowDaemonUrl(): string {\n  return useEnv('WORKFLOW_DAEMON_URL') ?? DEFAULT_DAEMON_URL;\n}\n\nexport class WorkflowDaemonClient {\n  private readonly baseUrl: string;\n\n  constructor(options: DaemonClientOptions = {}) {\n    this.baseUrl = options.url ?? useEnv('WORKFLOW_DAEMON_URL') ?? DEFAULT_DAEMON_URL;\n  }\n\n  /**\n   * Validate response Content-Type and parse JSON safely\n   */\n  private async parseJsonResponse<T>(response: Response): Promise<T> {\n    const contentType = response.headers.get('content-type');\n    if (!contentType?.includes('application/json')) {\n      throw new Error(`Invalid Content-Type: expected application/json, got ${contentType}`);\n    }\n    return response.json() as Promise<T>;\n  }\n\n  private unwrapData<T>(payload: unknown): T {\n    if (\n      payload\n      && typeof payload === 'object'\n      && 'ok' in payload\n      && (payload as { ok?: boolean }).ok === true\n      && 'data' in payload\n    ) {\n      return (payload as { data: T }).data;\n    }\n    return payload as T;\n  }\n\n  /**\n   * Validate and encode job ID to prevent path traversal attacks\n   */\n  private validateAndEncodeJobId(jobId: string): string {\n    // Validate job ID format (alphanumeric, hyphens, underscores only)\n    if (!/^[a-zA-Z0-9_-]+$/.test(jobId)) {\n      throw new Error(`Invalid job ID format: ${jobId}`);\n    }\n    // Encode for URL safety (defense in depth)\n    return encodeURIComponent(jobId);\n  }\n\n  /**\n   * Health check\n   */\n  async health(): Promise<{ ok: boolean; service: string }> {\n    const response = await fetch(`${this.baseUrl}/health`);\n    if (!response.ok) {\n      throw new Error(`Health check failed: ${response.statusText}`);\n    }\n    return this.parseJsonResponse(response);\n  }\n\n  /**\n   * Get workflow metrics (raw metrics data from daemon)\n   */\n  async getMetrics(): Promise<WorkflowMetricsData> {\n    const response = await fetch(`${this.baseUrl}/metrics`);\n    if (!response.ok) {\n      throw new Error(`Failed to get metrics: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<WorkflowMetricsData>(data);\n  }\n\n  /**\n   * Get job status with full details (jobs, steps, outputs)\n   */\n  async getJobStatus(jobId: string): Promise<JobStatusDetail> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job status: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<JobStatusDetail>(data);\n  }\n\n  /**\n   * Get job steps with outputs\n   */\n  async getJobSteps(jobId: string): Promise<JobStepsResponse> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/steps`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job steps: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<JobStepsResponse>(data);\n  }\n\n  /**\n   * Get job logs\n   */\n  async getJobLogs(jobId: string): Promise<JobLogsResponse['logs']> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/logs`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job logs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<JobLogsResponse>(data);\n    return unwrapped.logs ?? [];\n  }\n\n  /**\n   * Get active executions\n   */\n  async getExecutions(): Promise<JobStatusInfo[]> {\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs`);\n    if (!response.ok) {\n      throw new Error(`Failed to get executions: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ jobs?: JobStatusInfo[] }>(data);\n    const jobs = unwrapped.jobs ?? [];\n    return jobs.filter((job) => job.status === 'running' || job.status === 'pending');\n  }\n\n  /**\n   * Get cron jobs\n   */\n  async getCronJobs(): Promise<CronListResponse> {\n    const response = await fetch(`${this.baseUrl}/api/v1/cron`);\n    if (!response.ok) {\n      throw new Error(`Failed to get cron jobs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<CronListResponse>(data);\n  }\n\n  /**\n   * Submit a job for execution\n   */\n  async submitJob(params: {\n    handler: string;\n    input?: unknown;\n    priority?: number;\n  }): Promise<{ id: string; status: string }> {\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({\n        type: params.handler,\n        payload: params.input,\n        priority: params.priority,\n      }),\n    });\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to submit job: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<unknown>(response);\n    const data = this.unwrapData<{ jobId: string }>(payload);\n    return { id: data.jobId, status: 'pending' };\n  }\n\n  /**\n   * List workflow runs with optional status filter\n   */\n  async listRuns(params: {\n    status?: string;\n    limit?: number;\n    workflowId?: string;\n  } = {}): Promise<WorkflowRunSummary[]> {\n    const query = new URLSearchParams();\n    if (params.status) { query.set('status', params.status); }\n    if (params.limit) { query.set('limit', String(params.limit)); }\n    if (params.workflowId) { query.set('workflowId', params.workflowId); }\n\n    const qs = query.toString();\n    const response = await fetch(`${this.baseUrl}/api/v1/runs${qs ? `?${qs}` : ''}`);\n    if (!response.ok) {\n      throw new Error(`Failed to list runs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ runs?: WorkflowRunSummary[] }>(data);\n    return unwrapped.runs ?? (Array.isArray(data) ? data as WorkflowRunSummary[] : []);\n  }\n\n  /**\n   * Get a specific workflow run with full detail\n   */\n  async getRun(runId: string): Promise<WorkflowRunDetail> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}`);\n    if (response.status === 404) {\n      throw new Error(`Run ${runId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get run: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    // Response shape: { ok: true, data: { run: {...} } }\n    const unwrapped = this.unwrapData<{ run?: WorkflowRunDetail } | WorkflowRunDetail>(data);\n    return ('run' in (unwrapped as object) ? (unwrapped as { run: WorkflowRunDetail }).run : unwrapped) as WorkflowRunDetail;\n  }\n\n  /**\n   * Get run logs, optionally filtered to failed steps only\n   */\n  async getRunLogs(runId: string, params: {\n    stepId?: string;\n    level?: string;\n    limit?: number;\n    failedOnly?: boolean;\n  } = {}): Promise<Array<{ level: string; message: string; timestamp: string; stepId?: string; stepName?: string; stream?: string; [key: string]: unknown }>> {\n    const query = new URLSearchParams();\n    if (params.stepId) { query.set('stepId', params.stepId); }\n    if (params.level) { query.set('level', params.level); }\n    if (params.limit) { query.set('limit', String(params.limit)); }\n    if (params.failedOnly) { query.set('failedOnly', 'true'); }\n\n    const encodedId = encodeURIComponent(runId);\n    const qs = query.toString();\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/logs${qs ? `?${qs}` : ''}`);\n    if (response.status === 404) {\n      throw new Error(`Run ${runId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get run logs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ logs?: unknown[] }>(data);\n    return (unwrapped.logs ?? []) as Array<{ level: string; message: string; timestamp: string; [key: string]: unknown }>;\n  }\n\n  /**\n   * Stream run events via SSE (returns a ReadableStream or EventSource-compatible URL)\n   */\n  getRunEventsUrl(runId: string): string {\n    return `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/events`;\n  }\n\n  /**\n   * List pending approval steps for a run\n   */\n  async listPendingApprovals(runId: string): Promise<{\n    runId: string;\n    pending: Array<{\n      jobId: string;\n      stepId: string;\n      stepName: string;\n      specId?: string;\n      context: Record<string, unknown>;\n      waitingSince?: string;\n    }>;\n  }> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/approvals`);\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to list pending approvals: ${message || response.statusText || response.status}`);\n    }\n    const payload = await this.parseJsonResponse<{\n      ok: boolean;\n      data?: {\n        runId: string;\n        pending: Array<{\n          jobId: string;\n          stepId: string;\n          stepName: string;\n          specId?: string;\n          context: Record<string, unknown>;\n          waitingSince?: string;\n        }>;\n      };\n    }>(response);\n    return this.unwrapData(payload);\n  }\n\n  /**\n   * Resolve (approve or reject) a pending approval step\n   */\n  async resolveApproval(\n    runId: string,\n    jobId: string,\n    stepId: string,\n    action: 'approve' | 'reject',\n    comment?: string,\n    data?: Record<string, unknown>\n  ): Promise<{ runId: string; jobId: string; stepId: string; action: string; resolved: boolean }> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/approvals/resolve`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({ jobId, stepId, action, comment, data }),\n    });\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to resolve approval: ${message || response.statusText || response.status}`);\n    }\n    const payload = await this.parseJsonResponse<{\n      ok: boolean;\n      data?: { runId: string; jobId: string; stepId: string; action: string; resolved: boolean };\n    }>(response);\n    return this.unwrapData(payload);\n  }\n\n  /**\n   * Cancel a workflow run\n   */\n  async cancelRun(runId: string): Promise<void> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/cancel`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: '{}',\n    });\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to cancel run: ${message || response.statusText || response.status}`);\n    }\n  }\n\n  /**\n   * Run workflow by ID\n   */\n  async runWorkflow(\n    workflowId: string,\n    request: WorkflowRunRequest = {}\n  ): Promise<{ runId: string; status: string }> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/workflows/${encodeURIComponent(workflowId)}/runs`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      }\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to run workflow: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: { runId: string; status: string } }>(response);\n    return this.unwrapData<{ runId: string; status: string }>(payload);\n  }\n\n  /**\n   * Rerun a workflow run by ID, optionally only failed jobs\n   */\n  async rerunWorkflow(\n    runId: string,\n    request: WorkflowRerunRequest = {},\n  ): Promise<{ runId: string; status: string }> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/rerun`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      },\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to rerun workflow: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: { runId: string; status: string } }>(response);\n    return this.unwrapData<{ runId: string; status: string }>(payload);\n  }\n\n  /**\n   * Restart a run from a snapshot, optionally resuming from a specific step.\n   * Preceding steps inherit their stored outputs; only the target step and beyond are re-executed.\n   */\n  async restartRun(\n    runId: string,\n    request: WorkflowRestartRequest = {},\n  ): Promise<WorkflowRestartResponse> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/restart`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      },\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to restart run: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: WorkflowRestartResponse }>(response);\n    return this.unwrapData<WorkflowRestartResponse>(payload);\n  }\n}\n","/**\n * @module @kb-labs/workflow-cli/rest/workflow-detail-handler\n * REST handler for getting workflow definition details\n */\n\nimport { defineHandler, rethrowForRest, type RestInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport type { WorkflowInfo } from '@kb-labs/workflow-contracts';\nimport { getWorkflowDaemonUrl } from '../http-client';\n\ninterface WorkflowDetailParams {\n  id: string;\n}\n\nexport default defineHandler({\n  async execute(\n    ctx: PluginContextV3,\n    input: RestInput<unknown, unknown, WorkflowDetailParams>\n  ): Promise<WorkflowInfo> {\n    const daemonUrl = getWorkflowDaemonUrl();\n    const { id } = input.params!;\n\n    if (!id) {\n      throw new Error('Missing id parameter');\n    }\n\n    const url = `${daemonUrl}/api/v1/workflows/${encodeURIComponent(id)}`;\n    ctx.platform.logger.info(`[workflow-detail-handler] Fetching workflow ${id} from ${url}`);\n\n    try {\n      const response = await fetch(url);\n\n      if (!response.ok) {\n        if (response.status === 404) {\n          throw new Error('Workflow not found');\n        }\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      const result = (await response.json()) as { ok: boolean; data?: WorkflowInfo; error?: string };\n\n      if (!result.ok || !result.data) {\n        throw new Error(result.error || 'Failed to fetch workflow');\n      }\n\n      return result.data;\n    } catch (error) {\n      ctx.platform.logger.error(\n        '[workflow-detail-handler] Error fetching workflow detail',\n        error instanceof Error ? error : undefined\n      );\n      rethrowForRest(error);\n    }\n  },\n});\n"]}

package/dist/rest/workflow-run-cancel-handler.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/http-client.ts","../../src/rest/workflow-run-cancel-handler.ts"],"names":[],"mappings":";;;AAwHA,IAAM,kBAAA,GAAqB,uBAAA;AASpB,SAAS,oBAAA,GAA+B;AAC7C,EAAA,OAAO,MAAA,CAAO,qBAAqB,CAAA,IAAK,kBAAA;AAC1C;;;AC5GA,IAAO,sCAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CACJ,GAAA,EACA,KAAA,EAC4B;AAC5B,IAAA,MAAM,YAAY,oBAAA,EAAqB;AACvC,IAAA,MAAM,EAAE,KAAA,EAAM,GAAI,KAAA,CAAM,MAAA;AAExB,IAAA,IAAI,CAAC,KAAA,EAAO;AACV,MAAA,MAAM,IAAI,MAAM,yBAAyB,CAAA;AAAA,IAC3C;AAEA,IAAA,MAAM,MAAM,CAAA,EAAG,SAAS,CAAA,aAAA,EAAgB,kBAAA,CAAmB,KAAK,CAAC,CAAA,OAAA,CAAA;AACjE,IAAA,GAAA,CAAI,SAAS,MAAA,CAAO,IAAA,CAAK,gDAAgD,KAAK,CAAA,IAAA,EAAO,GAAG,CAAA,CAAE,CAAA;AAE1F,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,QAChC,MAAA,EAAQ,MAAA;AAAA,QACR,OAAA,EAAS,EAAE,cAAA,EAAgB,kBAAA;AAAmB,OAC/C,CAAA;AAED,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,QAAA,MAAM,SAAA,GAAY,MAAM,QAAA,CAAS,IAAA,EAAK,CAAE,MAAM,OAAO,EAAE,KAAA,EAAO,eAAA,EAAgB,CAAE,CAAA;AAChF,QAAA,MAAM,IAAI,KAAA,CAAM,SAAA,CAAU,KAAA,IAAS,CAAA,qBAAA,EAAwB,KAAK,CAAA,CAAE,CAAA;AAAA,MACpE;AAEA,MAAA,MAAM,OAAA,GAAW,MAAM,QAAA,CAAS,IAAA,EAAK;AACrC,MAAA,IAAI,CAAC,OAAA,CAAQ,EAAA,IAAM,CAAC,QAAQ,IAAA,EAAM;AAChC,QAAA,MAAM,IAAI,KAAA,CAAM,OAAA,CAAQ,KAAA,IAAS,CAAA,qBAAA,EAAwB,KAAK,CAAA,CAAE,CAAA;AAAA,MAClE;AACA,MAAA,OAAO,OAAA,CAAQ,IAAA;AAAA,IACjB,SAAS,KAAA,EAAO;AACd,MAAA,GAAA,CAAI,SAAS,MAAA,CAAO,KAAA;AAAA,QAClB,oDAAA;AAAA,QACA,KAAA,YAAiB,QAAQ,KAAA,GAAQ;AAAA,OACnC;AACA,MAAA,cAAA,CAAe,KAAK,CAAA;AAAA,IACtB;AAAA,EACF;AACF,CAAC","file":"workflow-run-cancel-handler.js","sourcesContent":["/**\n * HTTP client for interacting with Workflow Daemon\n */\nimport type {\n  WorkflowRerunRequest,\n  WorkflowRestartRequest,\n  WorkflowRestartResponse,\n  WorkflowRunRequest,\n  JobStatusInfo,\n  JobStepsResponse,\n  JobLogsResponse,\n  CronListResponse,\n} from '@kb-labs/workflow-contracts';\nimport { useEnv } from '@kb-labs/sdk';\n\n/** Workflow run summary returned by GET /api/v1/runs */\nexport interface WorkflowRunSummary {\n  id: string;\n  name: string;\n  version?: string;\n  status: 'queued' | 'running' | 'success' | 'failed' | 'cancelled';\n  trigger?: {\n    type: string;\n    actor?: string;\n    payload?: unknown;\n  };\n  createdAt?: string;\n  startedAt?: string;\n  finishedAt?: string;\n  durationMs?: number;\n  inputs?: Record<string, unknown>;\n  hasPendingApproval?: boolean;\n  currentStepName?: string;\n}\n\n/** Full workflow run detail returned by GET /api/v1/runs/:runId */\nexport interface WorkflowRunDetail extends WorkflowRunSummary {\n  env?: Record<string, string>;\n  metadata?: Record<string, unknown>;\n  result?: {\n    status: string;\n    summary?: string;\n    error?: { message: string; code?: string };\n    outputs?: Record<string, unknown>;\n  };\n  jobs?: Array<{\n    id: string;\n    jobName?: string;\n    status: string;\n    startedAt?: string;\n    finishedAt?: string;\n    durationMs?: number;\n    attempt?: number;\n    error?: { message: string; code?: string; stack?: string } | string;\n    steps?: Array<{\n      id: string;\n      name?: string;\n      index?: number;\n      status: string;\n      startedAt?: string;\n      finishedAt?: string;\n      durationMs?: number;\n      attempt?: number;\n      outputs?: Record<string, unknown>;\n      resolvedInputs?: Record<string, unknown>;\n      error?: { message: string; code?: string; details?: Record<string, unknown> } | string;\n      spec?: Record<string, unknown>;\n    }>;\n  }>;\n}\n\n/** Metrics data returned by GET /metrics */\nexport interface WorkflowMetricsData {\n  runs: {\n    total: number;\n    queued: number;\n    running: number;\n    completed: number;\n    failed: number;\n    cancelled: number;\n  };\n  jobs: {\n    total: number;\n    queued: number;\n    running: number;\n    completed: number;\n    failed: number;\n  };\n  [key: string]: unknown;\n}\n\n/** Extended job status returned by GET /api/v1/jobs/:id — includes nested jobs/steps */\nexport interface JobStatusDetail extends Omit<JobStatusInfo, 'result'> {\n  result?: {\n    ok: boolean;\n    summary?: string;\n    error?: { code: string; message: string };\n  };\n  jobs?: Array<{\n    id: string;\n    name: string;\n    status: string;\n    startedAt?: string;\n    finishedAt?: string;\n    durationMs?: number;\n    error?: string;\n    steps?: Array<{\n      id: string;\n      name: string;\n      status: string;\n      handler?: string;\n      startedAt?: string;\n      finishedAt?: string;\n      durationMs?: number;\n      outputs?: Record<string, unknown>;\n      error?: { message?: string } | string;\n    }>;\n  }>;\n}\n\nconst DEFAULT_DAEMON_URL = 'http://localhost:7778';\n\nexport interface DaemonClientOptions {\n  url?: string;\n}\n\n/**\n * Get workflow daemon URL from environment or default\n */\nexport function getWorkflowDaemonUrl(): string {\n  return useEnv('WORKFLOW_DAEMON_URL') ?? DEFAULT_DAEMON_URL;\n}\n\nexport class WorkflowDaemonClient {\n  private readonly baseUrl: string;\n\n  constructor(options: DaemonClientOptions = {}) {\n    this.baseUrl = options.url ?? useEnv('WORKFLOW_DAEMON_URL') ?? DEFAULT_DAEMON_URL;\n  }\n\n  /**\n   * Validate response Content-Type and parse JSON safely\n   */\n  private async parseJsonResponse<T>(response: Response): Promise<T> {\n    const contentType = response.headers.get('content-type');\n    if (!contentType?.includes('application/json')) {\n      throw new Error(`Invalid Content-Type: expected application/json, got ${contentType}`);\n    }\n    return response.json() as Promise<T>;\n  }\n\n  private unwrapData<T>(payload: unknown): T {\n    if (\n      payload\n      && typeof payload === 'object'\n      && 'ok' in payload\n      && (payload as { ok?: boolean }).ok === true\n      && 'data' in payload\n    ) {\n      return (payload as { data: T }).data;\n    }\n    return payload as T;\n  }\n\n  /**\n   * Validate and encode job ID to prevent path traversal attacks\n   */\n  private validateAndEncodeJobId(jobId: string): string {\n    // Validate job ID format (alphanumeric, hyphens, underscores only)\n    if (!/^[a-zA-Z0-9_-]+$/.test(jobId)) {\n      throw new Error(`Invalid job ID format: ${jobId}`);\n    }\n    // Encode for URL safety (defense in depth)\n    return encodeURIComponent(jobId);\n  }\n\n  /**\n   * Health check\n   */\n  async health(): Promise<{ ok: boolean; service: string }> {\n    const response = await fetch(`${this.baseUrl}/health`);\n    if (!response.ok) {\n      throw new Error(`Health check failed: ${response.statusText}`);\n    }\n    return this.parseJsonResponse(response);\n  }\n\n  /**\n   * Get workflow metrics (raw metrics data from daemon)\n   */\n  async getMetrics(): Promise<WorkflowMetricsData> {\n    const response = await fetch(`${this.baseUrl}/metrics`);\n    if (!response.ok) {\n      throw new Error(`Failed to get metrics: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<WorkflowMetricsData>(data);\n  }\n\n  /**\n   * Get job status with full details (jobs, steps, outputs)\n   */\n  async getJobStatus(jobId: string): Promise<JobStatusDetail> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job status: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<JobStatusDetail>(data);\n  }\n\n  /**\n   * Get job steps with outputs\n   */\n  async getJobSteps(jobId: string): Promise<JobStepsResponse> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/steps`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job steps: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<JobStepsResponse>(data);\n  }\n\n  /**\n   * Get job logs\n   */\n  async getJobLogs(jobId: string): Promise<JobLogsResponse['logs']> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/logs`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job logs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<JobLogsResponse>(data);\n    return unwrapped.logs ?? [];\n  }\n\n  /**\n   * Get active executions\n   */\n  async getExecutions(): Promise<JobStatusInfo[]> {\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs`);\n    if (!response.ok) {\n      throw new Error(`Failed to get executions: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ jobs?: JobStatusInfo[] }>(data);\n    const jobs = unwrapped.jobs ?? [];\n    return jobs.filter((job) => job.status === 'running' || job.status === 'pending');\n  }\n\n  /**\n   * Get cron jobs\n   */\n  async getCronJobs(): Promise<CronListResponse> {\n    const response = await fetch(`${this.baseUrl}/api/v1/cron`);\n    if (!response.ok) {\n      throw new Error(`Failed to get cron jobs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<CronListResponse>(data);\n  }\n\n  /**\n   * Submit a job for execution\n   */\n  async submitJob(params: {\n    handler: string;\n    input?: unknown;\n    priority?: number;\n  }): Promise<{ id: string; status: string }> {\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({\n        type: params.handler,\n        payload: params.input,\n        priority: params.priority,\n      }),\n    });\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to submit job: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<unknown>(response);\n    const data = this.unwrapData<{ jobId: string }>(payload);\n    return { id: data.jobId, status: 'pending' };\n  }\n\n  /**\n   * List workflow runs with optional status filter\n   */\n  async listRuns(params: {\n    status?: string;\n    limit?: number;\n    workflowId?: string;\n  } = {}): Promise<WorkflowRunSummary[]> {\n    const query = new URLSearchParams();\n    if (params.status) { query.set('status', params.status); }\n    if (params.limit) { query.set('limit', String(params.limit)); }\n    if (params.workflowId) { query.set('workflowId', params.workflowId); }\n\n    const qs = query.toString();\n    const response = await fetch(`${this.baseUrl}/api/v1/runs${qs ? `?${qs}` : ''}`);\n    if (!response.ok) {\n      throw new Error(`Failed to list runs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ runs?: WorkflowRunSummary[] }>(data);\n    return unwrapped.runs ?? (Array.isArray(data) ? data as WorkflowRunSummary[] : []);\n  }\n\n  /**\n   * Get a specific workflow run with full detail\n   */\n  async getRun(runId: string): Promise<WorkflowRunDetail> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}`);\n    if (response.status === 404) {\n      throw new Error(`Run ${runId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get run: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    // Response shape: { ok: true, data: { run: {...} } }\n    const unwrapped = this.unwrapData<{ run?: WorkflowRunDetail } | WorkflowRunDetail>(data);\n    return ('run' in (unwrapped as object) ? (unwrapped as { run: WorkflowRunDetail }).run : unwrapped) as WorkflowRunDetail;\n  }\n\n  /**\n   * Get run logs, optionally filtered to failed steps only\n   */\n  async getRunLogs(runId: string, params: {\n    stepId?: string;\n    level?: string;\n    limit?: number;\n    failedOnly?: boolean;\n  } = {}): Promise<Array<{ level: string; message: string; timestamp: string; stepId?: string; stepName?: string; stream?: string; [key: string]: unknown }>> {\n    const query = new URLSearchParams();\n    if (params.stepId) { query.set('stepId', params.stepId); }\n    if (params.level) { query.set('level', params.level); }\n    if (params.limit) { query.set('limit', String(params.limit)); }\n    if (params.failedOnly) { query.set('failedOnly', 'true'); }\n\n    const encodedId = encodeURIComponent(runId);\n    const qs = query.toString();\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/logs${qs ? `?${qs}` : ''}`);\n    if (response.status === 404) {\n      throw new Error(`Run ${runId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get run logs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ logs?: unknown[] }>(data);\n    return (unwrapped.logs ?? []) as Array<{ level: string; message: string; timestamp: string; [key: string]: unknown }>;\n  }\n\n  /**\n   * Stream run events via SSE (returns a ReadableStream or EventSource-compatible URL)\n   */\n  getRunEventsUrl(runId: string): string {\n    return `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/events`;\n  }\n\n  /**\n   * List pending approval steps for a run\n   */\n  async listPendingApprovals(runId: string): Promise<{\n    runId: string;\n    pending: Array<{\n      jobId: string;\n      stepId: string;\n      stepName: string;\n      specId?: string;\n      context: Record<string, unknown>;\n      waitingSince?: string;\n    }>;\n  }> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/approvals`);\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to list pending approvals: ${message || response.statusText || response.status}`);\n    }\n    const payload = await this.parseJsonResponse<{\n      ok: boolean;\n      data?: {\n        runId: string;\n        pending: Array<{\n          jobId: string;\n          stepId: string;\n          stepName: string;\n          specId?: string;\n          context: Record<string, unknown>;\n          waitingSince?: string;\n        }>;\n      };\n    }>(response);\n    return this.unwrapData(payload);\n  }\n\n  /**\n   * Resolve (approve or reject) a pending approval step\n   */\n  async resolveApproval(\n    runId: string,\n    jobId: string,\n    stepId: string,\n    action: 'approve' | 'reject',\n    comment?: string,\n    data?: Record<string, unknown>\n  ): Promise<{ runId: string; jobId: string; stepId: string; action: string; resolved: boolean }> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/approvals/resolve`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({ jobId, stepId, action, comment, data }),\n    });\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to resolve approval: ${message || response.statusText || response.status}`);\n    }\n    const payload = await this.parseJsonResponse<{\n      ok: boolean;\n      data?: { runId: string; jobId: string; stepId: string; action: string; resolved: boolean };\n    }>(response);\n    return this.unwrapData(payload);\n  }\n\n  /**\n   * Cancel a workflow run\n   */\n  async cancelRun(runId: string): Promise<void> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/cancel`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: '{}',\n    });\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to cancel run: ${message || response.statusText || response.status}`);\n    }\n  }\n\n  /**\n   * Run workflow by ID\n   */\n  async runWorkflow(\n    workflowId: string,\n    request: WorkflowRunRequest = {}\n  ): Promise<{ runId: string; status: string }> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/workflows/${encodeURIComponent(workflowId)}/runs`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      }\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to run workflow: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: { runId: string; status: string } }>(response);\n    return this.unwrapData<{ runId: string; status: string }>(payload);\n  }\n\n  /**\n   * Rerun a workflow run by ID, optionally only failed jobs\n   */\n  async rerunWorkflow(\n    runId: string,\n    request: WorkflowRerunRequest = {},\n  ): Promise<{ runId: string; status: string }> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/rerun`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      },\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to rerun workflow: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: { runId: string; status: string } }>(response);\n    return this.unwrapData<{ runId: string; status: string }>(payload);\n  }\n\n  /**\n   * Restart a run from a snapshot, optionally resuming from a specific step.\n   * Preceding steps inherit their stored outputs; only the target step and beyond are re-executed.\n   */\n  async restartRun(\n    runId: string,\n    request: WorkflowRestartRequest = {},\n  ): Promise<WorkflowRestartResponse> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/restart`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      },\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to restart run: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: WorkflowRestartResponse }>(response);\n    return this.unwrapData<WorkflowRestartResponse>(payload);\n  }\n}\n","/**\n * REST handler: POST /workflows/runs/:runId/cancel\n * Proxies to workflow daemon POST /api/v1/runs/:runId/cancel\n */\n\nimport { defineHandler, rethrowForRest, type RestInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { getWorkflowDaemonUrl } from '../http-client.js';\n\ninterface RunCancelParams {\n  runId: string;\n}\n\ninterface RunCancelResponse {\n  cancelled: boolean;\n  runId: string;\n}\n\ninterface ApiEnvelope<T> {\n  ok: boolean;\n  data?: T;\n  error?: string;\n}\n\nexport default defineHandler({\n  async execute(\n    ctx: PluginContextV3,\n    input: RestInput<unknown, unknown, RunCancelParams>\n  ): Promise<RunCancelResponse> {\n    const daemonUrl = getWorkflowDaemonUrl();\n    const { runId } = input.params!;\n\n    if (!runId) {\n      throw new Error('Missing runId parameter');\n    }\n\n    const url = `${daemonUrl}/api/v1/runs/${encodeURIComponent(runId)}/cancel`;\n    ctx.platform.logger.info(`[workflow-run-cancel-handler] Cancelling run ${runId} at ${url}`);\n\n    try {\n      const response = await fetch(url, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n      });\n\n      if (!response.ok) {\n        const errorData = await response.json().catch(() => ({ error: 'Unknown error' })) as { error?: string };\n        throw new Error(errorData.error || `Failed to cancel run ${runId}`);\n      }\n\n      const payload = (await response.json()) as ApiEnvelope<RunCancelResponse>;\n      if (!payload.ok || !payload.data) {\n        throw new Error(payload.error || `Failed to cancel run ${runId}`);\n      }\n      return payload.data;\n    } catch (error) {\n      ctx.platform.logger.error(\n        '[workflow-run-cancel-handler] Error cancelling run',\n        error instanceof Error ? error : undefined\n      );\n      rethrowForRest(error);\n    }\n  },\n});\n"]}
+{"version":3,"sources":["../../src/http-client.ts","../../src/rest/workflow-run-cancel-handler.ts"],"names":[],"mappings":";;;AA2HA,IAAM,kBAAA,GAAqB,uBAAA;AASpB,SAAS,oBAAA,GAA+B;AAC7C,EAAA,OAAO,MAAA,CAAO,qBAAqB,CAAA,IAAK,kBAAA;AAC1C;;;AC/GA,IAAO,sCAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CACJ,GAAA,EACA,KAAA,EAC4B;AAC5B,IAAA,MAAM,YAAY,oBAAA,EAAqB;AACvC,IAAA,MAAM,EAAE,KAAA,EAAM,GAAI,KAAA,CAAM,MAAA;AAExB,IAAA,IAAI,CAAC,KAAA,EAAO;AACV,MAAA,MAAM,IAAI,MAAM,yBAAyB,CAAA;AAAA,IAC3C;AAEA,IAAA,MAAM,MAAM,CAAA,EAAG,SAAS,CAAA,aAAA,EAAgB,kBAAA,CAAmB,KAAK,CAAC,CAAA,OAAA,CAAA;AACjE,IAAA,GAAA,CAAI,SAAS,MAAA,CAAO,IAAA,CAAK,gDAAgD,KAAK,CAAA,IAAA,EAAO,GAAG,CAAA,CAAE,CAAA;AAE1F,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,QAChC,MAAA,EAAQ,MAAA;AAAA,QACR,OAAA,EAAS,EAAE,cAAA,EAAgB,kBAAA;AAAmB,OAC/C,CAAA;AAED,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,QAAA,MAAM,SAAA,GAAY,MAAM,QAAA,CAAS,IAAA,EAAK,CAAE,MAAM,OAAO,EAAE,KAAA,EAAO,eAAA,EAAgB,CAAE,CAAA;AAChF,QAAA,MAAM,IAAI,KAAA,CAAM,SAAA,CAAU,KAAA,IAAS,CAAA,qBAAA,EAAwB,KAAK,CAAA,CAAE,CAAA;AAAA,MACpE;AAEA,MAAA,MAAM,OAAA,GAAW,MAAM,QAAA,CAAS,IAAA,EAAK;AACrC,MAAA,IAAI,CAAC,OAAA,CAAQ,EAAA,IAAM,CAAC,QAAQ,IAAA,EAAM;AAChC,QAAA,MAAM,IAAI,KAAA,CAAM,OAAA,CAAQ,KAAA,IAAS,CAAA,qBAAA,EAAwB,KAAK,CAAA,CAAE,CAAA;AAAA,MAClE;AACA,MAAA,OAAO,OAAA,CAAQ,IAAA;AAAA,IACjB,SAAS,KAAA,EAAO;AACd,MAAA,GAAA,CAAI,SAAS,MAAA,CAAO,KAAA;AAAA,QAClB,oDAAA;AAAA,QACA,KAAA,YAAiB,QAAQ,KAAA,GAAQ;AAAA,OACnC;AACA,MAAA,cAAA,CAAe,KAAK,CAAA;AAAA,IACtB;AAAA,EACF;AACF,CAAC","file":"workflow-run-cancel-handler.js","sourcesContent":["/**\n * HTTP client for interacting with Workflow Daemon\n */\nimport type {\n  WorkflowRerunRequest,\n  WorkflowRestartRequest,\n  WorkflowRestartResponse,\n  WorkflowRunRequest,\n  JobStatusInfo,\n  JobStepsResponse,\n  JobLogsResponse,\n  CronListResponse,\n} from '@kb-labs/workflow-contracts';\nimport { useEnv } from '@kb-labs/sdk';\n\n/** Workflow run summary returned by GET /api/v1/runs */\nexport interface WorkflowRunSummary {\n  id: string;\n  name: string;\n  version?: string;\n  status: 'queued' | 'running' | 'success' | 'failed' | 'cancelled';\n  trigger?: {\n    type: string;\n    actor?: string;\n    payload?: unknown;\n    parentRunId?: string;\n    parentJobId?: string;\n    parentStepId?: string;\n  };\n  createdAt?: string;\n  startedAt?: string;\n  finishedAt?: string;\n  durationMs?: number;\n  inputs?: Record<string, unknown>;\n  hasPendingApproval?: boolean;\n  currentStepName?: string;\n}\n\n/** Full workflow run detail returned by GET /api/v1/runs/:runId */\nexport interface WorkflowRunDetail extends WorkflowRunSummary {\n  env?: Record<string, string>;\n  metadata?: Record<string, unknown>;\n  result?: {\n    status: string;\n    summary?: string;\n    error?: { message: string; code?: string };\n    outputs?: Record<string, unknown>;\n  };\n  jobs?: Array<{\n    id: string;\n    jobName?: string;\n    status: string;\n    startedAt?: string;\n    finishedAt?: string;\n    durationMs?: number;\n    attempt?: number;\n    error?: { message: string; code?: string; stack?: string } | string;\n    steps?: Array<{\n      id: string;\n      name?: string;\n      index?: number;\n      status: string;\n      startedAt?: string;\n      finishedAt?: string;\n      durationMs?: number;\n      attempt?: number;\n      outputs?: Record<string, unknown>;\n      resolvedInputs?: Record<string, unknown>;\n      error?: { message: string; code?: string; details?: Record<string, unknown> } | string;\n      spec?: Record<string, unknown>;\n    }>;\n  }>;\n}\n\n/** Metrics data returned by GET /metrics */\nexport interface WorkflowMetricsData {\n  runs: {\n    total: number;\n    queued: number;\n    running: number;\n    completed: number;\n    failed: number;\n    cancelled: number;\n  };\n  jobs: {\n    total: number;\n    queued: number;\n    running: number;\n    completed: number;\n    failed: number;\n  };\n  [key: string]: unknown;\n}\n\n/** Extended job status returned by GET /api/v1/jobs/:id — includes nested jobs/steps */\nexport interface JobStatusDetail extends Omit<JobStatusInfo, 'result'> {\n  result?: {\n    ok: boolean;\n    summary?: string;\n    error?: { code: string; message: string };\n  };\n  jobs?: Array<{\n    id: string;\n    name: string;\n    status: string;\n    startedAt?: string;\n    finishedAt?: string;\n    durationMs?: number;\n    error?: string;\n    steps?: Array<{\n      id: string;\n      name: string;\n      status: string;\n      handler?: string;\n      startedAt?: string;\n      finishedAt?: string;\n      durationMs?: number;\n      outputs?: Record<string, unknown>;\n      error?: { message?: string } | string;\n    }>;\n  }>;\n}\n\nconst DEFAULT_DAEMON_URL = 'http://localhost:7778';\n\nexport interface DaemonClientOptions {\n  url?: string;\n}\n\n/**\n * Get workflow daemon URL from environment or default\n */\nexport function getWorkflowDaemonUrl(): string {\n  return useEnv('WORKFLOW_DAEMON_URL') ?? DEFAULT_DAEMON_URL;\n}\n\nexport class WorkflowDaemonClient {\n  private readonly baseUrl: string;\n\n  constructor(options: DaemonClientOptions = {}) {\n    this.baseUrl = options.url ?? useEnv('WORKFLOW_DAEMON_URL') ?? DEFAULT_DAEMON_URL;\n  }\n\n  /**\n   * Validate response Content-Type and parse JSON safely\n   */\n  private async parseJsonResponse<T>(response: Response): Promise<T> {\n    const contentType = response.headers.get('content-type');\n    if (!contentType?.includes('application/json')) {\n      throw new Error(`Invalid Content-Type: expected application/json, got ${contentType}`);\n    }\n    return response.json() as Promise<T>;\n  }\n\n  private unwrapData<T>(payload: unknown): T {\n    if (\n      payload\n      && typeof payload === 'object'\n      && 'ok' in payload\n      && (payload as { ok?: boolean }).ok === true\n      && 'data' in payload\n    ) {\n      return (payload as { data: T }).data;\n    }\n    return payload as T;\n  }\n\n  /**\n   * Validate and encode job ID to prevent path traversal attacks\n   */\n  private validateAndEncodeJobId(jobId: string): string {\n    // Validate job ID format (alphanumeric, hyphens, underscores only)\n    if (!/^[a-zA-Z0-9_-]+$/.test(jobId)) {\n      throw new Error(`Invalid job ID format: ${jobId}`);\n    }\n    // Encode for URL safety (defense in depth)\n    return encodeURIComponent(jobId);\n  }\n\n  /**\n   * Health check\n   */\n  async health(): Promise<{ ok: boolean; service: string }> {\n    const response = await fetch(`${this.baseUrl}/health`);\n    if (!response.ok) {\n      throw new Error(`Health check failed: ${response.statusText}`);\n    }\n    return this.parseJsonResponse(response);\n  }\n\n  /**\n   * Get workflow metrics (raw metrics data from daemon)\n   */\n  async getMetrics(): Promise<WorkflowMetricsData> {\n    const response = await fetch(`${this.baseUrl}/metrics`);\n    if (!response.ok) {\n      throw new Error(`Failed to get metrics: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<WorkflowMetricsData>(data);\n  }\n\n  /**\n   * Get job status with full details (jobs, steps, outputs)\n   */\n  async getJobStatus(jobId: string): Promise<JobStatusDetail> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job status: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<JobStatusDetail>(data);\n  }\n\n  /**\n   * Get job steps with outputs\n   */\n  async getJobSteps(jobId: string): Promise<JobStepsResponse> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/steps`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job steps: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<JobStepsResponse>(data);\n  }\n\n  /**\n   * Get job logs\n   */\n  async getJobLogs(jobId: string): Promise<JobLogsResponse['logs']> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/logs`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job logs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<JobLogsResponse>(data);\n    return unwrapped.logs ?? [];\n  }\n\n  /**\n   * Get active executions\n   */\n  async getExecutions(): Promise<JobStatusInfo[]> {\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs`);\n    if (!response.ok) {\n      throw new Error(`Failed to get executions: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ jobs?: JobStatusInfo[] }>(data);\n    const jobs = unwrapped.jobs ?? [];\n    return jobs.filter((job) => job.status === 'running' || job.status === 'pending');\n  }\n\n  /**\n   * Get cron jobs\n   */\n  async getCronJobs(): Promise<CronListResponse> {\n    const response = await fetch(`${this.baseUrl}/api/v1/cron`);\n    if (!response.ok) {\n      throw new Error(`Failed to get cron jobs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<CronListResponse>(data);\n  }\n\n  /**\n   * Submit a job for execution\n   */\n  async submitJob(params: {\n    handler: string;\n    input?: unknown;\n    priority?: number;\n  }): Promise<{ id: string; status: string }> {\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({\n        type: params.handler,\n        payload: params.input,\n        priority: params.priority,\n      }),\n    });\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to submit job: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<unknown>(response);\n    const data = this.unwrapData<{ jobId: string }>(payload);\n    return { id: data.jobId, status: 'pending' };\n  }\n\n  /**\n   * List workflow runs with optional status filter\n   */\n  async listRuns(params: {\n    status?: string;\n    limit?: number;\n    workflowId?: string;\n  } = {}): Promise<WorkflowRunSummary[]> {\n    const query = new URLSearchParams();\n    if (params.status) { query.set('status', params.status); }\n    if (params.limit) { query.set('limit', String(params.limit)); }\n    if (params.workflowId) { query.set('workflowId', params.workflowId); }\n\n    const qs = query.toString();\n    const response = await fetch(`${this.baseUrl}/api/v1/runs${qs ? `?${qs}` : ''}`);\n    if (!response.ok) {\n      throw new Error(`Failed to list runs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ runs?: WorkflowRunSummary[] }>(data);\n    return unwrapped.runs ?? (Array.isArray(data) ? data as WorkflowRunSummary[] : []);\n  }\n\n  /**\n   * Get a specific workflow run with full detail\n   */\n  async getRun(runId: string): Promise<WorkflowRunDetail> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}`);\n    if (response.status === 404) {\n      throw new Error(`Run ${runId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get run: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    // Response shape: { ok: true, data: { run: {...} } }\n    const unwrapped = this.unwrapData<{ run?: WorkflowRunDetail } | WorkflowRunDetail>(data);\n    return ('run' in (unwrapped as object) ? (unwrapped as { run: WorkflowRunDetail }).run : unwrapped) as WorkflowRunDetail;\n  }\n\n  /**\n   * Get run logs, optionally filtered to failed steps only\n   */\n  async getRunLogs(runId: string, params: {\n    stepId?: string;\n    level?: string;\n    limit?: number;\n    failedOnly?: boolean;\n  } = {}): Promise<Array<{ level: string; message: string; timestamp: string; stepId?: string; stepName?: string; stream?: string; [key: string]: unknown }>> {\n    const query = new URLSearchParams();\n    if (params.stepId) { query.set('stepId', params.stepId); }\n    if (params.level) { query.set('level', params.level); }\n    if (params.limit) { query.set('limit', String(params.limit)); }\n    if (params.failedOnly) { query.set('failedOnly', 'true'); }\n\n    const encodedId = encodeURIComponent(runId);\n    const qs = query.toString();\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/logs${qs ? `?${qs}` : ''}`);\n    if (response.status === 404) {\n      throw new Error(`Run ${runId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get run logs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ logs?: unknown[] }>(data);\n    return (unwrapped.logs ?? []) as Array<{ level: string; message: string; timestamp: string; [key: string]: unknown }>;\n  }\n\n  /**\n   * Stream run events via SSE (returns a ReadableStream or EventSource-compatible URL)\n   */\n  getRunEventsUrl(runId: string): string {\n    return `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/events`;\n  }\n\n  /**\n   * List pending approval steps for a run\n   */\n  async listPendingApprovals(runId: string): Promise<{\n    runId: string;\n    pending: Array<{\n      jobId: string;\n      stepId: string;\n      stepName: string;\n      specId?: string;\n      context: Record<string, unknown>;\n      waitingSince?: string;\n    }>;\n  }> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/approvals`);\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to list pending approvals: ${message || response.statusText || response.status}`);\n    }\n    const payload = await this.parseJsonResponse<{\n      ok: boolean;\n      data?: {\n        runId: string;\n        pending: Array<{\n          jobId: string;\n          stepId: string;\n          stepName: string;\n          specId?: string;\n          context: Record<string, unknown>;\n          waitingSince?: string;\n        }>;\n      };\n    }>(response);\n    return this.unwrapData(payload);\n  }\n\n  /**\n   * Resolve (approve or reject) a pending approval step\n   */\n  async resolveApproval(\n    runId: string,\n    jobId: string,\n    stepId: string,\n    action: 'approve' | 'reject',\n    comment?: string,\n    data?: Record<string, unknown>\n  ): Promise<{ runId: string; jobId: string; stepId: string; action: string; resolved: boolean }> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/approvals/resolve`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({ jobId, stepId, action, comment, data }),\n    });\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to resolve approval: ${message || response.statusText || response.status}`);\n    }\n    const payload = await this.parseJsonResponse<{\n      ok: boolean;\n      data?: { runId: string; jobId: string; stepId: string; action: string; resolved: boolean };\n    }>(response);\n    return this.unwrapData(payload);\n  }\n\n  /**\n   * Cancel a workflow run\n   */\n  async cancelRun(runId: string): Promise<void> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/cancel`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: '{}',\n    });\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to cancel run: ${message || response.statusText || response.status}`);\n    }\n  }\n\n  /**\n   * Run workflow by ID\n   */\n  async runWorkflow(\n    workflowId: string,\n    request: WorkflowRunRequest = {}\n  ): Promise<{ runId: string; status: string }> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/workflows/${encodeURIComponent(workflowId)}/runs`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      }\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to run workflow: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: { runId: string; status: string } }>(response);\n    return this.unwrapData<{ runId: string; status: string }>(payload);\n  }\n\n  /**\n   * Rerun a workflow run by ID, optionally only failed jobs\n   */\n  async rerunWorkflow(\n    runId: string,\n    request: WorkflowRerunRequest = {},\n  ): Promise<{ runId: string; status: string }> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/rerun`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      },\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to rerun workflow: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: { runId: string; status: string } }>(response);\n    return this.unwrapData<{ runId: string; status: string }>(payload);\n  }\n\n  /**\n   * Restart a run from a snapshot, optionally resuming from a specific step.\n   * Preceding steps inherit their stored outputs; only the target step and beyond are re-executed.\n   */\n  async restartRun(\n    runId: string,\n    request: WorkflowRestartRequest = {},\n  ): Promise<WorkflowRestartResponse> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/restart`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      },\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to restart run: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: WorkflowRestartResponse }>(response);\n    return this.unwrapData<WorkflowRestartResponse>(payload);\n  }\n}\n","/**\n * REST handler: POST /workflows/runs/:runId/cancel\n * Proxies to workflow daemon POST /api/v1/runs/:runId/cancel\n */\n\nimport { defineHandler, rethrowForRest, type RestInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { getWorkflowDaemonUrl } from '../http-client.js';\n\ninterface RunCancelParams {\n  runId: string;\n}\n\ninterface RunCancelResponse {\n  cancelled: boolean;\n  runId: string;\n}\n\ninterface ApiEnvelope<T> {\n  ok: boolean;\n  data?: T;\n  error?: string;\n}\n\nexport default defineHandler({\n  async execute(\n    ctx: PluginContextV3,\n    input: RestInput<unknown, unknown, RunCancelParams>\n  ): Promise<RunCancelResponse> {\n    const daemonUrl = getWorkflowDaemonUrl();\n    const { runId } = input.params!;\n\n    if (!runId) {\n      throw new Error('Missing runId parameter');\n    }\n\n    const url = `${daemonUrl}/api/v1/runs/${encodeURIComponent(runId)}/cancel`;\n    ctx.platform.logger.info(`[workflow-run-cancel-handler] Cancelling run ${runId} at ${url}`);\n\n    try {\n      const response = await fetch(url, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n      });\n\n      if (!response.ok) {\n        const errorData = await response.json().catch(() => ({ error: 'Unknown error' })) as { error?: string };\n        throw new Error(errorData.error || `Failed to cancel run ${runId}`);\n      }\n\n      const payload = (await response.json()) as ApiEnvelope<RunCancelResponse>;\n      if (!payload.ok || !payload.data) {\n        throw new Error(payload.error || `Failed to cancel run ${runId}`);\n      }\n      return payload.data;\n    } catch (error) {\n      ctx.platform.logger.error(\n        '[workflow-run-cancel-handler] Error cancelling run',\n        error instanceof Error ? error : undefined\n      );\n      rethrowForRest(error);\n    }\n  },\n});\n"]}

package/dist/rest/workflow-run-handler.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/http-client.ts","../../src/rest/workflow-run-handler.ts"],"names":[],"mappings":";;;AAwHA,IAAM,kBAAA,GAAqB,uBAAA;AASpB,SAAS,oBAAA,GAA+B;AAC7C,EAAA,OAAO,MAAA,CAAO,qBAAqB,CAAA,IAAK,kBAAA;AAC1C;;;ACjHA,IAAO,+BAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CACJ,GAAA,EACA,KAAA,EAC4B;AAC5B,IAAA,MAAM,YAAY,oBAAA,EAAqB;AACvC,IAAA,MAAM,EAAE,EAAA,EAAG,GAAI,KAAA,CAAM,MAAA;AAErB,IAAA,IAAI,CAAC,EAAA,EAAI;AACP,MAAA,MAAM,IAAI,MAAM,sBAAsB,CAAA;AAAA,IACxC;AAEA,IAAA,MAAM,IAAA,GAA2B,KAAA,CAAM,IAAA,IAAQ,EAAC;AAEhD,IAAA,MAAM,MAAM,CAAA,EAAG,SAAS,CAAA,kBAAA,EAAqB,kBAAA,CAAmB,EAAE,CAAC,CAAA,IAAA,CAAA;AACnE,IAAA,GAAA,CAAI,SAAS,MAAA,CAAO,IAAA,CAAK,2CAA2C,EAAE,CAAA,KAAA,EAAQ,GAAG,CAAA,CAAE,CAAA;AAEnF,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,QAChC,MAAA,EAAQ,MAAA;AAAA,QACR,OAAA,EAAS;AAAA,UACP,cAAA,EAAgB;AAAA,SAClB;AAAA,QACA,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI;AAAA,OAC1B,CAAA;AAED,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,QAAA,IAAI,QAAA,CAAS,WAAW,GAAA,EAAK;AAC3B,UAAA,MAAM,IAAI,MAAM,oBAAoB,CAAA;AAAA,QACtC;AACA,QAAA,MAAM,IAAI,MAAM,CAAA,KAAA,EAAQ,QAAA,CAAS,MAAM,CAAA,EAAA,EAAK,QAAA,CAAS,UAAU,CAAA,CAAE,CAAA;AAAA,MACnE;AAEA,MAAA,MAAM,MAAA,GAAU,MAAM,QAAA,CAAS,IAAA,EAAK;AAEpC,MAAA,IAAI,CAAC,MAAA,CAAO,EAAA,IAAM,CAAC,OAAO,IAAA,EAAM;AAC9B,QAAA,MAAM,IAAI,KAAA,CAAM,MAAA,CAAO,KAAA,IAAS,wBAAwB,CAAA;AAAA,MAC1D;AAEA,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,IAChB,SAAS,KAAA,EAAO;AACd,MAAA,GAAA,CAAI,SAAS,MAAA,CAAO,KAAA;AAAA,QAClB,+CAAA;AAAA,QACA,KAAA,YAAiB,QAAQ,KAAA,GAAQ;AAAA,OACnC;AACA,MAAA,cAAA,CAAe,KAAK,CAAA;AAAA,IACtB;AAAA,EACF;AACF,CAAC","file":"workflow-run-handler.js","sourcesContent":["/**\n * HTTP client for interacting with Workflow Daemon\n */\nimport type {\n  WorkflowRerunRequest,\n  WorkflowRestartRequest,\n  WorkflowRestartResponse,\n  WorkflowRunRequest,\n  JobStatusInfo,\n  JobStepsResponse,\n  JobLogsResponse,\n  CronListResponse,\n} from '@kb-labs/workflow-contracts';\nimport { useEnv } from '@kb-labs/sdk';\n\n/** Workflow run summary returned by GET /api/v1/runs */\nexport interface WorkflowRunSummary {\n  id: string;\n  name: string;\n  version?: string;\n  status: 'queued' | 'running' | 'success' | 'failed' | 'cancelled';\n  trigger?: {\n    type: string;\n    actor?: string;\n    payload?: unknown;\n  };\n  createdAt?: string;\n  startedAt?: string;\n  finishedAt?: string;\n  durationMs?: number;\n  inputs?: Record<string, unknown>;\n  hasPendingApproval?: boolean;\n  currentStepName?: string;\n}\n\n/** Full workflow run detail returned by GET /api/v1/runs/:runId */\nexport interface WorkflowRunDetail extends WorkflowRunSummary {\n  env?: Record<string, string>;\n  metadata?: Record<string, unknown>;\n  result?: {\n    status: string;\n    summary?: string;\n    error?: { message: string; code?: string };\n    outputs?: Record<string, unknown>;\n  };\n  jobs?: Array<{\n    id: string;\n    jobName?: string;\n    status: string;\n    startedAt?: string;\n    finishedAt?: string;\n    durationMs?: number;\n    attempt?: number;\n    error?: { message: string; code?: string; stack?: string } | string;\n    steps?: Array<{\n      id: string;\n      name?: string;\n      index?: number;\n      status: string;\n      startedAt?: string;\n      finishedAt?: string;\n      durationMs?: number;\n      attempt?: number;\n      outputs?: Record<string, unknown>;\n      resolvedInputs?: Record<string, unknown>;\n      error?: { message: string; code?: string; details?: Record<string, unknown> } | string;\n      spec?: Record<string, unknown>;\n    }>;\n  }>;\n}\n\n/** Metrics data returned by GET /metrics */\nexport interface WorkflowMetricsData {\n  runs: {\n    total: number;\n    queued: number;\n    running: number;\n    completed: number;\n    failed: number;\n    cancelled: number;\n  };\n  jobs: {\n    total: number;\n    queued: number;\n    running: number;\n    completed: number;\n    failed: number;\n  };\n  [key: string]: unknown;\n}\n\n/** Extended job status returned by GET /api/v1/jobs/:id — includes nested jobs/steps */\nexport interface JobStatusDetail extends Omit<JobStatusInfo, 'result'> {\n  result?: {\n    ok: boolean;\n    summary?: string;\n    error?: { code: string; message: string };\n  };\n  jobs?: Array<{\n    id: string;\n    name: string;\n    status: string;\n    startedAt?: string;\n    finishedAt?: string;\n    durationMs?: number;\n    error?: string;\n    steps?: Array<{\n      id: string;\n      name: string;\n      status: string;\n      handler?: string;\n      startedAt?: string;\n      finishedAt?: string;\n      durationMs?: number;\n      outputs?: Record<string, unknown>;\n      error?: { message?: string } | string;\n    }>;\n  }>;\n}\n\nconst DEFAULT_DAEMON_URL = 'http://localhost:7778';\n\nexport interface DaemonClientOptions {\n  url?: string;\n}\n\n/**\n * Get workflow daemon URL from environment or default\n */\nexport function getWorkflowDaemonUrl(): string {\n  return useEnv('WORKFLOW_DAEMON_URL') ?? DEFAULT_DAEMON_URL;\n}\n\nexport class WorkflowDaemonClient {\n  private readonly baseUrl: string;\n\n  constructor(options: DaemonClientOptions = {}) {\n    this.baseUrl = options.url ?? useEnv('WORKFLOW_DAEMON_URL') ?? DEFAULT_DAEMON_URL;\n  }\n\n  /**\n   * Validate response Content-Type and parse JSON safely\n   */\n  private async parseJsonResponse<T>(response: Response): Promise<T> {\n    const contentType = response.headers.get('content-type');\n    if (!contentType?.includes('application/json')) {\n      throw new Error(`Invalid Content-Type: expected application/json, got ${contentType}`);\n    }\n    return response.json() as Promise<T>;\n  }\n\n  private unwrapData<T>(payload: unknown): T {\n    if (\n      payload\n      && typeof payload === 'object'\n      && 'ok' in payload\n      && (payload as { ok?: boolean }).ok === true\n      && 'data' in payload\n    ) {\n      return (payload as { data: T }).data;\n    }\n    return payload as T;\n  }\n\n  /**\n   * Validate and encode job ID to prevent path traversal attacks\n   */\n  private validateAndEncodeJobId(jobId: string): string {\n    // Validate job ID format (alphanumeric, hyphens, underscores only)\n    if (!/^[a-zA-Z0-9_-]+$/.test(jobId)) {\n      throw new Error(`Invalid job ID format: ${jobId}`);\n    }\n    // Encode for URL safety (defense in depth)\n    return encodeURIComponent(jobId);\n  }\n\n  /**\n   * Health check\n   */\n  async health(): Promise<{ ok: boolean; service: string }> {\n    const response = await fetch(`${this.baseUrl}/health`);\n    if (!response.ok) {\n      throw new Error(`Health check failed: ${response.statusText}`);\n    }\n    return this.parseJsonResponse(response);\n  }\n\n  /**\n   * Get workflow metrics (raw metrics data from daemon)\n   */\n  async getMetrics(): Promise<WorkflowMetricsData> {\n    const response = await fetch(`${this.baseUrl}/metrics`);\n    if (!response.ok) {\n      throw new Error(`Failed to get metrics: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<WorkflowMetricsData>(data);\n  }\n\n  /**\n   * Get job status with full details (jobs, steps, outputs)\n   */\n  async getJobStatus(jobId: string): Promise<JobStatusDetail> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job status: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<JobStatusDetail>(data);\n  }\n\n  /**\n   * Get job steps with outputs\n   */\n  async getJobSteps(jobId: string): Promise<JobStepsResponse> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/steps`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job steps: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<JobStepsResponse>(data);\n  }\n\n  /**\n   * Get job logs\n   */\n  async getJobLogs(jobId: string): Promise<JobLogsResponse['logs']> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/logs`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job logs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<JobLogsResponse>(data);\n    return unwrapped.logs ?? [];\n  }\n\n  /**\n   * Get active executions\n   */\n  async getExecutions(): Promise<JobStatusInfo[]> {\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs`);\n    if (!response.ok) {\n      throw new Error(`Failed to get executions: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ jobs?: JobStatusInfo[] }>(data);\n    const jobs = unwrapped.jobs ?? [];\n    return jobs.filter((job) => job.status === 'running' || job.status === 'pending');\n  }\n\n  /**\n   * Get cron jobs\n   */\n  async getCronJobs(): Promise<CronListResponse> {\n    const response = await fetch(`${this.baseUrl}/api/v1/cron`);\n    if (!response.ok) {\n      throw new Error(`Failed to get cron jobs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<CronListResponse>(data);\n  }\n\n  /**\n   * Submit a job for execution\n   */\n  async submitJob(params: {\n    handler: string;\n    input?: unknown;\n    priority?: number;\n  }): Promise<{ id: string; status: string }> {\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({\n        type: params.handler,\n        payload: params.input,\n        priority: params.priority,\n      }),\n    });\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to submit job: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<unknown>(response);\n    const data = this.unwrapData<{ jobId: string }>(payload);\n    return { id: data.jobId, status: 'pending' };\n  }\n\n  /**\n   * List workflow runs with optional status filter\n   */\n  async listRuns(params: {\n    status?: string;\n    limit?: number;\n    workflowId?: string;\n  } = {}): Promise<WorkflowRunSummary[]> {\n    const query = new URLSearchParams();\n    if (params.status) { query.set('status', params.status); }\n    if (params.limit) { query.set('limit', String(params.limit)); }\n    if (params.workflowId) { query.set('workflowId', params.workflowId); }\n\n    const qs = query.toString();\n    const response = await fetch(`${this.baseUrl}/api/v1/runs${qs ? `?${qs}` : ''}`);\n    if (!response.ok) {\n      throw new Error(`Failed to list runs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ runs?: WorkflowRunSummary[] }>(data);\n    return unwrapped.runs ?? (Array.isArray(data) ? data as WorkflowRunSummary[] : []);\n  }\n\n  /**\n   * Get a specific workflow run with full detail\n   */\n  async getRun(runId: string): Promise<WorkflowRunDetail> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}`);\n    if (response.status === 404) {\n      throw new Error(`Run ${runId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get run: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    // Response shape: { ok: true, data: { run: {...} } }\n    const unwrapped = this.unwrapData<{ run?: WorkflowRunDetail } | WorkflowRunDetail>(data);\n    return ('run' in (unwrapped as object) ? (unwrapped as { run: WorkflowRunDetail }).run : unwrapped) as WorkflowRunDetail;\n  }\n\n  /**\n   * Get run logs, optionally filtered to failed steps only\n   */\n  async getRunLogs(runId: string, params: {\n    stepId?: string;\n    level?: string;\n    limit?: number;\n    failedOnly?: boolean;\n  } = {}): Promise<Array<{ level: string; message: string; timestamp: string; stepId?: string; stepName?: string; stream?: string; [key: string]: unknown }>> {\n    const query = new URLSearchParams();\n    if (params.stepId) { query.set('stepId', params.stepId); }\n    if (params.level) { query.set('level', params.level); }\n    if (params.limit) { query.set('limit', String(params.limit)); }\n    if (params.failedOnly) { query.set('failedOnly', 'true'); }\n\n    const encodedId = encodeURIComponent(runId);\n    const qs = query.toString();\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/logs${qs ? `?${qs}` : ''}`);\n    if (response.status === 404) {\n      throw new Error(`Run ${runId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get run logs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ logs?: unknown[] }>(data);\n    return (unwrapped.logs ?? []) as Array<{ level: string; message: string; timestamp: string; [key: string]: unknown }>;\n  }\n\n  /**\n   * Stream run events via SSE (returns a ReadableStream or EventSource-compatible URL)\n   */\n  getRunEventsUrl(runId: string): string {\n    return `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/events`;\n  }\n\n  /**\n   * List pending approval steps for a run\n   */\n  async listPendingApprovals(runId: string): Promise<{\n    runId: string;\n    pending: Array<{\n      jobId: string;\n      stepId: string;\n      stepName: string;\n      specId?: string;\n      context: Record<string, unknown>;\n      waitingSince?: string;\n    }>;\n  }> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/approvals`);\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to list pending approvals: ${message || response.statusText || response.status}`);\n    }\n    const payload = await this.parseJsonResponse<{\n      ok: boolean;\n      data?: {\n        runId: string;\n        pending: Array<{\n          jobId: string;\n          stepId: string;\n          stepName: string;\n          specId?: string;\n          context: Record<string, unknown>;\n          waitingSince?: string;\n        }>;\n      };\n    }>(response);\n    return this.unwrapData(payload);\n  }\n\n  /**\n   * Resolve (approve or reject) a pending approval step\n   */\n  async resolveApproval(\n    runId: string,\n    jobId: string,\n    stepId: string,\n    action: 'approve' | 'reject',\n    comment?: string,\n    data?: Record<string, unknown>\n  ): Promise<{ runId: string; jobId: string; stepId: string; action: string; resolved: boolean }> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/approvals/resolve`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({ jobId, stepId, action, comment, data }),\n    });\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to resolve approval: ${message || response.statusText || response.status}`);\n    }\n    const payload = await this.parseJsonResponse<{\n      ok: boolean;\n      data?: { runId: string; jobId: string; stepId: string; action: string; resolved: boolean };\n    }>(response);\n    return this.unwrapData(payload);\n  }\n\n  /**\n   * Cancel a workflow run\n   */\n  async cancelRun(runId: string): Promise<void> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/cancel`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: '{}',\n    });\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to cancel run: ${message || response.statusText || response.status}`);\n    }\n  }\n\n  /**\n   * Run workflow by ID\n   */\n  async runWorkflow(\n    workflowId: string,\n    request: WorkflowRunRequest = {}\n  ): Promise<{ runId: string; status: string }> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/workflows/${encodeURIComponent(workflowId)}/runs`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      }\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to run workflow: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: { runId: string; status: string } }>(response);\n    return this.unwrapData<{ runId: string; status: string }>(payload);\n  }\n\n  /**\n   * Rerun a workflow run by ID, optionally only failed jobs\n   */\n  async rerunWorkflow(\n    runId: string,\n    request: WorkflowRerunRequest = {},\n  ): Promise<{ runId: string; status: string }> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/rerun`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      },\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to rerun workflow: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: { runId: string; status: string } }>(response);\n    return this.unwrapData<{ runId: string; status: string }>(payload);\n  }\n\n  /**\n   * Restart a run from a snapshot, optionally resuming from a specific step.\n   * Preceding steps inherit their stored outputs; only the target step and beyond are re-executed.\n   */\n  async restartRun(\n    runId: string,\n    request: WorkflowRestartRequest = {},\n  ): Promise<WorkflowRestartResponse> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/restart`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      },\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to restart run: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: WorkflowRestartResponse }>(response);\n    return this.unwrapData<WorkflowRestartResponse>(payload);\n  }\n}\n","/**\n * @module @kb-labs/workflow-cli/rest/workflow-run-handler\n * REST handler for running a workflow\n */\n\nimport { defineHandler, rethrowForRest, type RestInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport type { WorkflowRunRequest } from '@kb-labs/workflow-contracts';\nimport { getWorkflowDaemonUrl } from '../http-client';\n\ninterface WorkflowRunParams {\n  id: string;\n}\n\ninterface WorkflowRunResult {\n  runId: string;\n  status: string;\n}\n\nexport default defineHandler({\n  async execute(\n    ctx: PluginContextV3,\n    input: RestInput<WorkflowRunRequest, unknown, WorkflowRunParams>\n  ): Promise<WorkflowRunResult> {\n    const daemonUrl = getWorkflowDaemonUrl();\n    const { id } = input.params!;\n\n    if (!id) {\n      throw new Error('Missing id parameter');\n    }\n\n    const body: WorkflowRunRequest = input.body || {};\n\n    const url = `${daemonUrl}/api/v1/workflows/${encodeURIComponent(id)}/run`;\n    ctx.platform.logger.info(`[workflow-run-handler] Running workflow ${id} via ${url}`);\n\n    try {\n      const response = await fetch(url, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(body),\n      });\n\n      if (!response.ok) {\n        if (response.status === 404) {\n          throw new Error('Workflow not found');\n        }\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      const result = (await response.json()) as { ok: boolean; data?: WorkflowRunResult; error?: string };\n\n      if (!result.ok || !result.data) {\n        throw new Error(result.error || 'Failed to run workflow');\n      }\n\n      return result.data;\n    } catch (error) {\n      ctx.platform.logger.error(\n        '[workflow-run-handler] Error running workflow',\n        error instanceof Error ? error : undefined\n      );\n      rethrowForRest(error);\n    }\n  },\n});\n"]}
+{"version":3,"sources":["../../src/http-client.ts","../../src/rest/workflow-run-handler.ts"],"names":[],"mappings":";;;AA2HA,IAAM,kBAAA,GAAqB,uBAAA;AASpB,SAAS,oBAAA,GAA+B;AAC7C,EAAA,OAAO,MAAA,CAAO,qBAAqB,CAAA,IAAK,kBAAA;AAC1C;;;ACpHA,IAAO,+BAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CACJ,GAAA,EACA,KAAA,EAC4B;AAC5B,IAAA,MAAM,YAAY,oBAAA,EAAqB;AACvC,IAAA,MAAM,EAAE,EAAA,EAAG,GAAI,KAAA,CAAM,MAAA;AAErB,IAAA,IAAI,CAAC,EAAA,EAAI;AACP,MAAA,MAAM,IAAI,MAAM,sBAAsB,CAAA;AAAA,IACxC;AAEA,IAAA,MAAM,IAAA,GAA2B,KAAA,CAAM,IAAA,IAAQ,EAAC;AAEhD,IAAA,MAAM,MAAM,CAAA,EAAG,SAAS,CAAA,kBAAA,EAAqB,kBAAA,CAAmB,EAAE,CAAC,CAAA,IAAA,CAAA;AACnE,IAAA,GAAA,CAAI,SAAS,MAAA,CAAO,IAAA,CAAK,2CAA2C,EAAE,CAAA,KAAA,EAAQ,GAAG,CAAA,CAAE,CAAA;AAEnF,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,QAChC,MAAA,EAAQ,MAAA;AAAA,QACR,OAAA,EAAS;AAAA,UACP,cAAA,EAAgB;AAAA,SAClB;AAAA,QACA,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI;AAAA,OAC1B,CAAA;AAED,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,QAAA,IAAI,QAAA,CAAS,WAAW,GAAA,EAAK;AAC3B,UAAA,MAAM,IAAI,MAAM,oBAAoB,CAAA;AAAA,QACtC;AACA,QAAA,MAAM,IAAI,MAAM,CAAA,KAAA,EAAQ,QAAA,CAAS,MAAM,CAAA,EAAA,EAAK,QAAA,CAAS,UAAU,CAAA,CAAE,CAAA;AAAA,MACnE;AAEA,MAAA,MAAM,MAAA,GAAU,MAAM,QAAA,CAAS,IAAA,EAAK;AAEpC,MAAA,IAAI,CAAC,MAAA,CAAO,EAAA,IAAM,CAAC,OAAO,IAAA,EAAM;AAC9B,QAAA,MAAM,IAAI,KAAA,CAAM,MAAA,CAAO,KAAA,IAAS,wBAAwB,CAAA;AAAA,MAC1D;AAEA,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,IAChB,SAAS,KAAA,EAAO;AACd,MAAA,GAAA,CAAI,SAAS,MAAA,CAAO,KAAA;AAAA,QAClB,+CAAA;AAAA,QACA,KAAA,YAAiB,QAAQ,KAAA,GAAQ;AAAA,OACnC;AACA,MAAA,cAAA,CAAe,KAAK,CAAA;AAAA,IACtB;AAAA,EACF;AACF,CAAC","file":"workflow-run-handler.js","sourcesContent":["/**\n * HTTP client for interacting with Workflow Daemon\n */\nimport type {\n  WorkflowRerunRequest,\n  WorkflowRestartRequest,\n  WorkflowRestartResponse,\n  WorkflowRunRequest,\n  JobStatusInfo,\n  JobStepsResponse,\n  JobLogsResponse,\n  CronListResponse,\n} from '@kb-labs/workflow-contracts';\nimport { useEnv } from '@kb-labs/sdk';\n\n/** Workflow run summary returned by GET /api/v1/runs */\nexport interface WorkflowRunSummary {\n  id: string;\n  name: string;\n  version?: string;\n  status: 'queued' | 'running' | 'success' | 'failed' | 'cancelled';\n  trigger?: {\n    type: string;\n    actor?: string;\n    payload?: unknown;\n    parentRunId?: string;\n    parentJobId?: string;\n    parentStepId?: string;\n  };\n  createdAt?: string;\n  startedAt?: string;\n  finishedAt?: string;\n  durationMs?: number;\n  inputs?: Record<string, unknown>;\n  hasPendingApproval?: boolean;\n  currentStepName?: string;\n}\n\n/** Full workflow run detail returned by GET /api/v1/runs/:runId */\nexport interface WorkflowRunDetail extends WorkflowRunSummary {\n  env?: Record<string, string>;\n  metadata?: Record<string, unknown>;\n  result?: {\n    status: string;\n    summary?: string;\n    error?: { message: string; code?: string };\n    outputs?: Record<string, unknown>;\n  };\n  jobs?: Array<{\n    id: string;\n    jobName?: string;\n    status: string;\n    startedAt?: string;\n    finishedAt?: string;\n    durationMs?: number;\n    attempt?: number;\n    error?: { message: string; code?: string; stack?: string } | string;\n    steps?: Array<{\n      id: string;\n      name?: string;\n      index?: number;\n      status: string;\n      startedAt?: string;\n      finishedAt?: string;\n      durationMs?: number;\n      attempt?: number;\n      outputs?: Record<string, unknown>;\n      resolvedInputs?: Record<string, unknown>;\n      error?: { message: string; code?: string; details?: Record<string, unknown> } | string;\n      spec?: Record<string, unknown>;\n    }>;\n  }>;\n}\n\n/** Metrics data returned by GET /metrics */\nexport interface WorkflowMetricsData {\n  runs: {\n    total: number;\n    queued: number;\n    running: number;\n    completed: number;\n    failed: number;\n    cancelled: number;\n  };\n  jobs: {\n    total: number;\n    queued: number;\n    running: number;\n    completed: number;\n    failed: number;\n  };\n  [key: string]: unknown;\n}\n\n/** Extended job status returned by GET /api/v1/jobs/:id — includes nested jobs/steps */\nexport interface JobStatusDetail extends Omit<JobStatusInfo, 'result'> {\n  result?: {\n    ok: boolean;\n    summary?: string;\n    error?: { code: string; message: string };\n  };\n  jobs?: Array<{\n    id: string;\n    name: string;\n    status: string;\n    startedAt?: string;\n    finishedAt?: string;\n    durationMs?: number;\n    error?: string;\n    steps?: Array<{\n      id: string;\n      name: string;\n      status: string;\n      handler?: string;\n      startedAt?: string;\n      finishedAt?: string;\n      durationMs?: number;\n      outputs?: Record<string, unknown>;\n      error?: { message?: string } | string;\n    }>;\n  }>;\n}\n\nconst DEFAULT_DAEMON_URL = 'http://localhost:7778';\n\nexport interface DaemonClientOptions {\n  url?: string;\n}\n\n/**\n * Get workflow daemon URL from environment or default\n */\nexport function getWorkflowDaemonUrl(): string {\n  return useEnv('WORKFLOW_DAEMON_URL') ?? DEFAULT_DAEMON_URL;\n}\n\nexport class WorkflowDaemonClient {\n  private readonly baseUrl: string;\n\n  constructor(options: DaemonClientOptions = {}) {\n    this.baseUrl = options.url ?? useEnv('WORKFLOW_DAEMON_URL') ?? DEFAULT_DAEMON_URL;\n  }\n\n  /**\n   * Validate response Content-Type and parse JSON safely\n   */\n  private async parseJsonResponse<T>(response: Response): Promise<T> {\n    const contentType = response.headers.get('content-type');\n    if (!contentType?.includes('application/json')) {\n      throw new Error(`Invalid Content-Type: expected application/json, got ${contentType}`);\n    }\n    return response.json() as Promise<T>;\n  }\n\n  private unwrapData<T>(payload: unknown): T {\n    if (\n      payload\n      && typeof payload === 'object'\n      && 'ok' in payload\n      && (payload as { ok?: boolean }).ok === true\n      && 'data' in payload\n    ) {\n      return (payload as { data: T }).data;\n    }\n    return payload as T;\n  }\n\n  /**\n   * Validate and encode job ID to prevent path traversal attacks\n   */\n  private validateAndEncodeJobId(jobId: string): string {\n    // Validate job ID format (alphanumeric, hyphens, underscores only)\n    if (!/^[a-zA-Z0-9_-]+$/.test(jobId)) {\n      throw new Error(`Invalid job ID format: ${jobId}`);\n    }\n    // Encode for URL safety (defense in depth)\n    return encodeURIComponent(jobId);\n  }\n\n  /**\n   * Health check\n   */\n  async health(): Promise<{ ok: boolean; service: string }> {\n    const response = await fetch(`${this.baseUrl}/health`);\n    if (!response.ok) {\n      throw new Error(`Health check failed: ${response.statusText}`);\n    }\n    return this.parseJsonResponse(response);\n  }\n\n  /**\n   * Get workflow metrics (raw metrics data from daemon)\n   */\n  async getMetrics(): Promise<WorkflowMetricsData> {\n    const response = await fetch(`${this.baseUrl}/metrics`);\n    if (!response.ok) {\n      throw new Error(`Failed to get metrics: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<WorkflowMetricsData>(data);\n  }\n\n  /**\n   * Get job status with full details (jobs, steps, outputs)\n   */\n  async getJobStatus(jobId: string): Promise<JobStatusDetail> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job status: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<JobStatusDetail>(data);\n  }\n\n  /**\n   * Get job steps with outputs\n   */\n  async getJobSteps(jobId: string): Promise<JobStepsResponse> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/steps`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job steps: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<JobStepsResponse>(data);\n  }\n\n  /**\n   * Get job logs\n   */\n  async getJobLogs(jobId: string): Promise<JobLogsResponse['logs']> {\n    const encodedJobId = this.validateAndEncodeJobId(jobId);\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/logs`);\n    if (response.status === 404) {\n      throw new Error(`Job ${jobId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get job logs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<JobLogsResponse>(data);\n    return unwrapped.logs ?? [];\n  }\n\n  /**\n   * Get active executions\n   */\n  async getExecutions(): Promise<JobStatusInfo[]> {\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs`);\n    if (!response.ok) {\n      throw new Error(`Failed to get executions: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ jobs?: JobStatusInfo[] }>(data);\n    const jobs = unwrapped.jobs ?? [];\n    return jobs.filter((job) => job.status === 'running' || job.status === 'pending');\n  }\n\n  /**\n   * Get cron jobs\n   */\n  async getCronJobs(): Promise<CronListResponse> {\n    const response = await fetch(`${this.baseUrl}/api/v1/cron`);\n    if (!response.ok) {\n      throw new Error(`Failed to get cron jobs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    return this.unwrapData<CronListResponse>(data);\n  }\n\n  /**\n   * Submit a job for execution\n   */\n  async submitJob(params: {\n    handler: string;\n    input?: unknown;\n    priority?: number;\n  }): Promise<{ id: string; status: string }> {\n    const response = await fetch(`${this.baseUrl}/api/v1/jobs`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({\n        type: params.handler,\n        payload: params.input,\n        priority: params.priority,\n      }),\n    });\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to submit job: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<unknown>(response);\n    const data = this.unwrapData<{ jobId: string }>(payload);\n    return { id: data.jobId, status: 'pending' };\n  }\n\n  /**\n   * List workflow runs with optional status filter\n   */\n  async listRuns(params: {\n    status?: string;\n    limit?: number;\n    workflowId?: string;\n  } = {}): Promise<WorkflowRunSummary[]> {\n    const query = new URLSearchParams();\n    if (params.status) { query.set('status', params.status); }\n    if (params.limit) { query.set('limit', String(params.limit)); }\n    if (params.workflowId) { query.set('workflowId', params.workflowId); }\n\n    const qs = query.toString();\n    const response = await fetch(`${this.baseUrl}/api/v1/runs${qs ? `?${qs}` : ''}`);\n    if (!response.ok) {\n      throw new Error(`Failed to list runs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ runs?: WorkflowRunSummary[] }>(data);\n    return unwrapped.runs ?? (Array.isArray(data) ? data as WorkflowRunSummary[] : []);\n  }\n\n  /**\n   * Get a specific workflow run with full detail\n   */\n  async getRun(runId: string): Promise<WorkflowRunDetail> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}`);\n    if (response.status === 404) {\n      throw new Error(`Run ${runId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get run: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    // Response shape: { ok: true, data: { run: {...} } }\n    const unwrapped = this.unwrapData<{ run?: WorkflowRunDetail } | WorkflowRunDetail>(data);\n    return ('run' in (unwrapped as object) ? (unwrapped as { run: WorkflowRunDetail }).run : unwrapped) as WorkflowRunDetail;\n  }\n\n  /**\n   * Get run logs, optionally filtered to failed steps only\n   */\n  async getRunLogs(runId: string, params: {\n    stepId?: string;\n    level?: string;\n    limit?: number;\n    failedOnly?: boolean;\n  } = {}): Promise<Array<{ level: string; message: string; timestamp: string; stepId?: string; stepName?: string; stream?: string; [key: string]: unknown }>> {\n    const query = new URLSearchParams();\n    if (params.stepId) { query.set('stepId', params.stepId); }\n    if (params.level) { query.set('level', params.level); }\n    if (params.limit) { query.set('limit', String(params.limit)); }\n    if (params.failedOnly) { query.set('failedOnly', 'true'); }\n\n    const encodedId = encodeURIComponent(runId);\n    const qs = query.toString();\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/logs${qs ? `?${qs}` : ''}`);\n    if (response.status === 404) {\n      throw new Error(`Run ${runId} not found`);\n    }\n    if (!response.ok) {\n      throw new Error(`Failed to get run logs: ${response.statusText}`);\n    }\n    const data = await this.parseJsonResponse<unknown>(response);\n    const unwrapped = this.unwrapData<{ logs?: unknown[] }>(data);\n    return (unwrapped.logs ?? []) as Array<{ level: string; message: string; timestamp: string; [key: string]: unknown }>;\n  }\n\n  /**\n   * Stream run events via SSE (returns a ReadableStream or EventSource-compatible URL)\n   */\n  getRunEventsUrl(runId: string): string {\n    return `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/events`;\n  }\n\n  /**\n   * List pending approval steps for a run\n   */\n  async listPendingApprovals(runId: string): Promise<{\n    runId: string;\n    pending: Array<{\n      jobId: string;\n      stepId: string;\n      stepName: string;\n      specId?: string;\n      context: Record<string, unknown>;\n      waitingSince?: string;\n    }>;\n  }> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/approvals`);\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to list pending approvals: ${message || response.statusText || response.status}`);\n    }\n    const payload = await this.parseJsonResponse<{\n      ok: boolean;\n      data?: {\n        runId: string;\n        pending: Array<{\n          jobId: string;\n          stepId: string;\n          stepName: string;\n          specId?: string;\n          context: Record<string, unknown>;\n          waitingSince?: string;\n        }>;\n      };\n    }>(response);\n    return this.unwrapData(payload);\n  }\n\n  /**\n   * Resolve (approve or reject) a pending approval step\n   */\n  async resolveApproval(\n    runId: string,\n    jobId: string,\n    stepId: string,\n    action: 'approve' | 'reject',\n    comment?: string,\n    data?: Record<string, unknown>\n  ): Promise<{ runId: string; jobId: string; stepId: string; action: string; resolved: boolean }> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/approvals/resolve`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({ jobId, stepId, action, comment, data }),\n    });\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to resolve approval: ${message || response.statusText || response.status}`);\n    }\n    const payload = await this.parseJsonResponse<{\n      ok: boolean;\n      data?: { runId: string; jobId: string; stepId: string; action: string; resolved: boolean };\n    }>(response);\n    return this.unwrapData(payload);\n  }\n\n  /**\n   * Cancel a workflow run\n   */\n  async cancelRun(runId: string): Promise<void> {\n    const encodedId = encodeURIComponent(runId);\n    const response = await fetch(`${this.baseUrl}/api/v1/runs/${encodedId}/cancel`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: '{}',\n    });\n    if (!response.ok) {\n      const message = await response\n        .json()\n        .then((j: { error?: string }) => j?.error ?? '')\n        .catch(() => response.text().catch(() => ''));\n      throw new Error(`Failed to cancel run: ${message || response.statusText || response.status}`);\n    }\n  }\n\n  /**\n   * Run workflow by ID\n   */\n  async runWorkflow(\n    workflowId: string,\n    request: WorkflowRunRequest = {}\n  ): Promise<{ runId: string; status: string }> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/workflows/${encodeURIComponent(workflowId)}/runs`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      }\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to run workflow: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: { runId: string; status: string } }>(response);\n    return this.unwrapData<{ runId: string; status: string }>(payload);\n  }\n\n  /**\n   * Rerun a workflow run by ID, optionally only failed jobs\n   */\n  async rerunWorkflow(\n    runId: string,\n    request: WorkflowRerunRequest = {},\n  ): Promise<{ runId: string; status: string }> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/rerun`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      },\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to rerun workflow: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: { runId: string; status: string } }>(response);\n    return this.unwrapData<{ runId: string; status: string }>(payload);\n  }\n\n  /**\n   * Restart a run from a snapshot, optionally resuming from a specific step.\n   * Preceding steps inherit their stored outputs; only the target step and beyond are re-executed.\n   */\n  async restartRun(\n    runId: string,\n    request: WorkflowRestartRequest = {},\n  ): Promise<WorkflowRestartResponse> {\n    const response = await fetch(\n      `${this.baseUrl}/api/v1/runs/${encodeURIComponent(runId)}/restart`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(request),\n      },\n    );\n\n    if (!response.ok) {\n      const error = (await response.json().catch(() => ({ error: response.statusText }))) as {\n        error?: string;\n      };\n      throw new Error(error.error || `Failed to restart run: ${response.statusText}`);\n    }\n\n    const payload = await this.parseJsonResponse<{ ok: boolean; data?: WorkflowRestartResponse }>(response);\n    return this.unwrapData<WorkflowRestartResponse>(payload);\n  }\n}\n","/**\n * @module @kb-labs/workflow-cli/rest/workflow-run-handler\n * REST handler for running a workflow\n */\n\nimport { defineHandler, rethrowForRest, type RestInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport type { WorkflowRunRequest } from '@kb-labs/workflow-contracts';\nimport { getWorkflowDaemonUrl } from '../http-client';\n\ninterface WorkflowRunParams {\n  id: string;\n}\n\ninterface WorkflowRunResult {\n  runId: string;\n  status: string;\n}\n\nexport default defineHandler({\n  async execute(\n    ctx: PluginContextV3,\n    input: RestInput<WorkflowRunRequest, unknown, WorkflowRunParams>\n  ): Promise<WorkflowRunResult> {\n    const daemonUrl = getWorkflowDaemonUrl();\n    const { id } = input.params!;\n\n    if (!id) {\n      throw new Error('Missing id parameter');\n    }\n\n    const body: WorkflowRunRequest = input.body || {};\n\n    const url = `${daemonUrl}/api/v1/workflows/${encodeURIComponent(id)}/run`;\n    ctx.platform.logger.info(`[workflow-run-handler] Running workflow ${id} via ${url}`);\n\n    try {\n      const response = await fetch(url, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(body),\n      });\n\n      if (!response.ok) {\n        if (response.status === 404) {\n          throw new Error('Workflow not found');\n        }\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      const result = (await response.json()) as { ok: boolean; data?: WorkflowRunResult; error?: string };\n\n      if (!result.ok || !result.data) {\n        throw new Error(result.error || 'Failed to run workflow');\n      }\n\n      return result.data;\n    } catch (error) {\n      ctx.platform.logger.error(\n        '[workflow-run-handler] Error running workflow',\n        error instanceof Error ? error : undefined\n      );\n      rethrowForRest(error);\n    }\n  },\n});\n"]}