@kb-labs/workflow-entry 2.116.13 → 2.117.0

package/dist/ws/logs-channel.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/http-client.ts","../../src/ws/logs-channel.ts"],"names":[],"mappings":"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","file":"logs-channel.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/ws/logs-channel\n * WebSocket channel for real-time job logs streaming.\n *\n * Polls the workflow daemon REST API to stream logs to the client.\n * Uses HTTP polling instead of in-process ring buffer because the daemon\n * runs in a separate process and its logs are not shared via the ring buffer.\n */\n\nimport { defineWebSocket, defineMessage, MessageRouter } from '@kb-labs/sdk';\nimport type { WSMessage } from '@kb-labs/sdk';\nimport { getWorkflowDaemonUrl } from '../http-client.js';\n\nconst POLL_INTERVAL_MS = 1_500;\n\n// Define typed messages\nconst SubscribeMsg = defineMessage<{ jobId: string; level?: string }>('subscribe');\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nconst UnsubscribeMsg = defineMessage<{}>('unsubscribe');\n\nconst LogMsg = defineMessage<{\n  timestamp: string;\n  level: 'info' | 'warn' | 'error' | 'debug';\n  message: string;\n  context?: Record<string, unknown>;\n}>('log');\n\nconst ErrorMsg = defineMessage<{ error: string }>('error');\n\ntype Incoming = ReturnType<typeof SubscribeMsg.create> | ReturnType<typeof UnsubscribeMsg.create>;\n\ntype Outgoing =\n  | ReturnType<typeof LogMsg.create>\n  | ReturnType<typeof ErrorMsg.create>;\n\n// Module-level state keyed by ctx.requestId (stable per WS connection)\nconst pollingTimers = new Map<string, ReturnType<typeof setInterval>>();\nconst logOffsets = new Map<string, number>();\n// \"active\" gate. Set on subscribe, cleared on unsubscribe/disconnect. The\n// polling callback is async — clearInterval stops future ticks but cannot\n// cancel an in-flight `await fetchLogs(...)`. The poll body must consult\n// this gate before sending so a late-resolving fetch from a just-stopped\n// subscription doesn't emit one stray log after unsubscribe (WS-L04).\nconst activeSubscriptions = new Set<string>();\n\ntype DaemonLog = {\n  timestamp: string;\n  level: string;\n  message: string;\n  context?: Record<string, unknown>;\n};\n\nfunction normalizeLevel(level: string): 'info' | 'warn' | 'error' | 'debug' {\n  switch (level) {\n    case 'trace':\n    case 'debug':\n      return 'debug';\n    case 'warn':\n      return 'warn';\n    case 'error':\n    case 'fatal':\n      return 'error';\n    default:\n      return 'info';\n  }\n}\n\nfunction levelMatches(logLevel: string, filterLevel?: string): boolean {\n  if (!filterLevel || filterLevel === 'all') { return true; }\n  const levelOrder: Record<string, number> = { debug: 0, trace: 0, info: 1, warn: 2, error: 3, fatal: 3 };\n  return (levelOrder[logLevel] ?? 1) >= (levelOrder[filterLevel] ?? 0);\n}\n\nasync function fetchLogs(runId: string, offset: number, level?: string): Promise<DaemonLog[]> {\n  const daemonUrl = getWorkflowDaemonUrl();\n  const params = new URLSearchParams({ limit: '200', offset: String(offset) });\n  if (level) { params.set('level', level); }\n  const url = `${daemonUrl}/api/v1/runs/${encodeURIComponent(runId)}/logs?${params}`;\n  const res = await fetch(url);\n  if (!res.ok) { return []; }\n  const body = await res.json() as { ok?: boolean; data?: { logs?: DaemonLog[] } };\n  return body?.data?.logs ?? [];\n}\n\nasync function checkRunExists(runId: string): Promise<boolean> {\n  const daemonUrl = getWorkflowDaemonUrl();\n  const res = await fetch(`${daemonUrl}/api/v1/runs/${encodeURIComponent(runId)}`);\n  return res.status !== 404;\n}\n\nfunction clearConnection(connectionId: string): void {\n  activeSubscriptions.delete(connectionId);\n  const timer = pollingTimers.get(connectionId);\n  if (timer) { clearInterval(timer); pollingTimers.delete(connectionId); }\n  logOffsets.delete(connectionId);\n}\n\nexport default defineWebSocket<unknown, Incoming, Outgoing>({\n  path: '/logs/:jobId',\n  description: 'Real-time job logs streaming',\n\n  handler: {\n    async onConnect(ctx, _sender) {\n      ctx.platform.logger.info('[logs-channel] Client connected', { connectionId: ctx.requestId });\n    },\n\n    async onMessage(ctx, message, sender) {\n      const connectionId = ctx.requestId;\n\n      const router = new MessageRouter()\n        .on(SubscribeMsg, async (_ctx, payload) => {\n          const { jobId: runId, level } = payload;\n\n          // Validate run exists before subscribing\n          const exists = await checkRunExists(runId).catch(() => true);\n          if (!exists) {\n            await sender.send(ErrorMsg.create({ error: `Run ${runId} not found` }));\n            sender.close(1008, 'Run not found');\n            return;\n          }\n\n          // Clear any existing subscription, then mark active.\n          clearConnection(connectionId);\n          logOffsets.set(connectionId, 0);\n          activeSubscriptions.add(connectionId);\n\n          // Backfill semantics: send only the MOST RECENT existing log as a\n          // \"current state\" hint, then advance offset past all existing logs\n          // so polling streams strictly new entries.\n          //\n          // Why not replay everything: callers that immediately unsubscribe\n          // after the first log (WS-L04 pattern: \"verify unsubscribe stops\n          // the stream\") would otherwise see additional pre-buffered logs\n          // arrive after unsubscribe — the bytes already left the socket\n          // before activeSubscriptions could gate them out. A single-entry\n          // backfill aligns with `tail -f` semantics and keeps the\n          // subscribe-then-unsubscribe contract deterministic. Consumers\n          // that need full history can fetch it via the daemon's REST\n          // /api/v1/runs/:runId/logs endpoint directly.\n          const initialLogs = await fetchLogs(runId, 0, level).catch(() => [] as DaemonLog[]);\n          if (!activeSubscriptions.has(connectionId)) { return; }\n          const tail = initialLogs.slice(-1);\n          for (const log of tail) {\n            if (!levelMatches(log.level, level)) { continue; }\n            if (!activeSubscriptions.has(connectionId)) { return; }\n            await sender.send(LogMsg.create({\n              timestamp: log.timestamp,\n              level: normalizeLevel(log.level),\n              message: log.message,\n              context: log.context,\n            }));\n          }\n          logOffsets.set(connectionId, initialLogs.length);\n\n          // Poll for new logs. The poll body is async, so clearInterval cannot\n          // cancel an in-flight tick — gate every send on activeSubscriptions\n          // so a late fetch resolving after unsubscribe stays silent.\n          const timer = setInterval(async () => {\n            if (!activeSubscriptions.has(connectionId)) { return; }\n            const currentOffset = logOffsets.get(connectionId) ?? 0;\n            const newLogs = await fetchLogs(runId, currentOffset, level).catch(() => [] as DaemonLog[]);\n            if (!activeSubscriptions.has(connectionId)) { return; }\n            if (newLogs.length === 0) { return; }\n            for (const log of newLogs) {\n              if (!levelMatches(log.level, level)) { continue; }\n              if (!activeSubscriptions.has(connectionId)) { return; }\n              await sender.send(LogMsg.create({\n                timestamp: log.timestamp,\n                level: normalizeLevel(log.level),\n                message: log.message,\n                context: log.context,\n              })).catch(() => { /* socket may have closed */ });\n            }\n            logOffsets.set(connectionId, currentOffset + newLogs.length);\n          }, POLL_INTERVAL_MS);\n\n          pollingTimers.set(connectionId, timer);\n        })\n        .on(UnsubscribeMsg, async (_ctx) => {\n          // Stop the polling timer and clear offsets. No confirmation\n          // message is emitted on purpose: clients use unsubscribe to\n          // expect a quiet stream, and emitting a synthetic LogMsg here\n          // would surface as a new log to consumers like WS-L04.\n          clearConnection(connectionId);\n        });\n\n      await router.handle(ctx, message as WSMessage, sender.raw);\n    },\n\n    async onDisconnect(ctx, _code, _reason) {\n      clearConnection(ctx.requestId);\n      ctx.platform.logger.info('[logs-channel] Client disconnected', { connectionId: ctx.requestId });\n    },\n\n    async onError(ctx, error, sender) {\n      ctx.platform.logger.error('[logs-channel] Error', error);\n      clearConnection(ctx.requestId);\n      try {\n        await sender.send(ErrorMsg.create({ error: error.message }));\n      } catch {\n        // socket may be closed\n      }\n    },\n  },\n});\n\nexport { normalizeLevel, levelMatches };\n"]}
+{"version":3,"sources":["../../src/http-client.ts","../../src/ws/logs-channel.ts"],"names":[],"mappings":"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","file":"logs-channel.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/ws/logs-channel\n * WebSocket channel for real-time job logs streaming.\n *\n * Polls the workflow daemon REST API to stream logs to the client.\n * Uses HTTP polling instead of in-process ring buffer because the daemon\n * runs in a separate process and its logs are not shared via the ring buffer.\n */\n\nimport { defineWebSocket, defineMessage, MessageRouter } from '@kb-labs/sdk';\nimport type { WSMessage } from '@kb-labs/sdk';\nimport { getWorkflowDaemonUrl } from '../http-client.js';\n\nconst POLL_INTERVAL_MS = 1_500;\n\n// Define typed messages\nconst SubscribeMsg = defineMessage<{ jobId: string; level?: string }>('subscribe');\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nconst UnsubscribeMsg = defineMessage<{}>('unsubscribe');\n\nconst LogMsg = defineMessage<{\n  timestamp: string;\n  level: 'info' | 'warn' | 'error' | 'debug';\n  message: string;\n  context?: Record<string, unknown>;\n}>('log');\n\nconst ErrorMsg = defineMessage<{ error: string }>('error');\n\ntype Incoming = ReturnType<typeof SubscribeMsg.create> | ReturnType<typeof UnsubscribeMsg.create>;\n\ntype Outgoing =\n  | ReturnType<typeof LogMsg.create>\n  | ReturnType<typeof ErrorMsg.create>;\n\n// Module-level state keyed by ctx.requestId (stable per WS connection)\nconst pollingTimers = new Map<string, ReturnType<typeof setInterval>>();\nconst logOffsets = new Map<string, number>();\n// \"active\" gate. Set on subscribe, cleared on unsubscribe/disconnect. The\n// polling callback is async — clearInterval stops future ticks but cannot\n// cancel an in-flight `await fetchLogs(...)`. The poll body must consult\n// this gate before sending so a late-resolving fetch from a just-stopped\n// subscription doesn't emit one stray log after unsubscribe (WS-L04).\nconst activeSubscriptions = new Set<string>();\n\ntype DaemonLog = {\n  timestamp: string;\n  level: string;\n  message: string;\n  context?: Record<string, unknown>;\n};\n\nfunction normalizeLevel(level: string): 'info' | 'warn' | 'error' | 'debug' {\n  switch (level) {\n    case 'trace':\n    case 'debug':\n      return 'debug';\n    case 'warn':\n      return 'warn';\n    case 'error':\n    case 'fatal':\n      return 'error';\n    default:\n      return 'info';\n  }\n}\n\nfunction levelMatches(logLevel: string, filterLevel?: string): boolean {\n  if (!filterLevel || filterLevel === 'all') { return true; }\n  const levelOrder: Record<string, number> = { debug: 0, trace: 0, info: 1, warn: 2, error: 3, fatal: 3 };\n  return (levelOrder[logLevel] ?? 1) >= (levelOrder[filterLevel] ?? 0);\n}\n\nasync function fetchLogs(runId: string, offset: number, level?: string): Promise<DaemonLog[]> {\n  const daemonUrl = getWorkflowDaemonUrl();\n  const params = new URLSearchParams({ limit: '200', offset: String(offset) });\n  if (level) { params.set('level', level); }\n  const url = `${daemonUrl}/api/v1/runs/${encodeURIComponent(runId)}/logs?${params}`;\n  const res = await fetch(url);\n  if (!res.ok) { return []; }\n  const body = await res.json() as { ok?: boolean; data?: { logs?: DaemonLog[] } };\n  return body?.data?.logs ?? [];\n}\n\nasync function checkRunExists(runId: string): Promise<boolean> {\n  const daemonUrl = getWorkflowDaemonUrl();\n  const res = await fetch(`${daemonUrl}/api/v1/runs/${encodeURIComponent(runId)}`);\n  return res.status !== 404;\n}\n\nfunction clearConnection(connectionId: string): void {\n  activeSubscriptions.delete(connectionId);\n  const timer = pollingTimers.get(connectionId);\n  if (timer) { clearInterval(timer); pollingTimers.delete(connectionId); }\n  logOffsets.delete(connectionId);\n}\n\nexport default defineWebSocket<unknown, Incoming, Outgoing>({\n  path: '/logs/:jobId',\n  description: 'Real-time job logs streaming',\n\n  handler: {\n    async onConnect(ctx, _sender) {\n      ctx.platform.logger.info('[logs-channel] Client connected', { connectionId: ctx.requestId });\n    },\n\n    async onMessage(ctx, message, sender) {\n      const connectionId = ctx.requestId;\n\n      const router = new MessageRouter()\n        .on(SubscribeMsg, async (_ctx, payload) => {\n          const { jobId: runId, level } = payload;\n\n          // Validate run exists before subscribing\n          const exists = await checkRunExists(runId).catch(() => true);\n          if (!exists) {\n            await sender.send(ErrorMsg.create({ error: `Run ${runId} not found` }));\n            sender.close(1008, 'Run not found');\n            return;\n          }\n\n          // Clear any existing subscription, then mark active.\n          clearConnection(connectionId);\n          logOffsets.set(connectionId, 0);\n          activeSubscriptions.add(connectionId);\n\n          // Backfill semantics: send only the MOST RECENT existing log as a\n          // \"current state\" hint, then advance offset past all existing logs\n          // so polling streams strictly new entries.\n          //\n          // Why not replay everything: callers that immediately unsubscribe\n          // after the first log (WS-L04 pattern: \"verify unsubscribe stops\n          // the stream\") would otherwise see additional pre-buffered logs\n          // arrive after unsubscribe — the bytes already left the socket\n          // before activeSubscriptions could gate them out. A single-entry\n          // backfill aligns with `tail -f` semantics and keeps the\n          // subscribe-then-unsubscribe contract deterministic. Consumers\n          // that need full history can fetch it via the daemon's REST\n          // /api/v1/runs/:runId/logs endpoint directly.\n          const initialLogs = await fetchLogs(runId, 0, level).catch(() => [] as DaemonLog[]);\n          if (!activeSubscriptions.has(connectionId)) { return; }\n          const tail = initialLogs.slice(-1);\n          for (const log of tail) {\n            if (!levelMatches(log.level, level)) { continue; }\n            if (!activeSubscriptions.has(connectionId)) { return; }\n            await sender.send(LogMsg.create({\n              timestamp: log.timestamp,\n              level: normalizeLevel(log.level),\n              message: log.message,\n              context: log.context,\n            }));\n          }\n          logOffsets.set(connectionId, initialLogs.length);\n\n          // Poll for new logs. The poll body is async, so clearInterval cannot\n          // cancel an in-flight tick — gate every send on activeSubscriptions\n          // so a late fetch resolving after unsubscribe stays silent.\n          const timer = setInterval(async () => {\n            if (!activeSubscriptions.has(connectionId)) { return; }\n            const currentOffset = logOffsets.get(connectionId) ?? 0;\n            const newLogs = await fetchLogs(runId, currentOffset, level).catch(() => [] as DaemonLog[]);\n            if (!activeSubscriptions.has(connectionId)) { return; }\n            if (newLogs.length === 0) { return; }\n            for (const log of newLogs) {\n              if (!levelMatches(log.level, level)) { continue; }\n              if (!activeSubscriptions.has(connectionId)) { return; }\n              await sender.send(LogMsg.create({\n                timestamp: log.timestamp,\n                level: normalizeLevel(log.level),\n                message: log.message,\n                context: log.context,\n              })).catch(() => { /* socket may have closed */ });\n            }\n            logOffsets.set(connectionId, currentOffset + newLogs.length);\n          }, POLL_INTERVAL_MS);\n\n          pollingTimers.set(connectionId, timer);\n        })\n        .on(UnsubscribeMsg, async (_ctx) => {\n          // Stop the polling timer and clear offsets. No confirmation\n          // message is emitted on purpose: clients use unsubscribe to\n          // expect a quiet stream, and emitting a synthetic LogMsg here\n          // would surface as a new log to consumers like WS-L04.\n          clearConnection(connectionId);\n        });\n\n      await router.handle(ctx, message as WSMessage, sender.raw);\n    },\n\n    async onDisconnect(ctx, _code, _reason) {\n      clearConnection(ctx.requestId);\n      ctx.platform.logger.info('[logs-channel] Client disconnected', { connectionId: ctx.requestId });\n    },\n\n    async onError(ctx, error, sender) {\n      ctx.platform.logger.error('[logs-channel] Error', error);\n      clearConnection(ctx.requestId);\n      try {\n        await sender.send(ErrorMsg.create({ error: error.message }));\n      } catch {\n        // socket may be closed\n      }\n    },\n  },\n});\n\nexport { normalizeLevel, levelMatches };\n"]}

package/dist/ws/progress-channel.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/http-client.ts","../../src/ws/progress-channel.ts"],"names":[],"mappings":"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","file":"progress-channel.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/ws/progress-channel\n * WebSocket channel for real-time job progress updates.\n *\n * WS-P01 (actual step-level progress streaming) is a planned feature.\n * WS-P02 (unknown jobId → error) is implemented via job existence check.\n */\n\nimport { defineWebSocket, defineMessage, MessageRouter } from '@kb-labs/sdk';\nimport type { WSMessage } from '@kb-labs/sdk';\nimport { getWorkflowDaemonUrl } from '../http-client.js';\n\nconst SubscribeMsg = defineMessage<{ jobId: string }>('subscribe');\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nconst UnsubscribeMsg = defineMessage<{}>('unsubscribe');\nconst ErrorMsg = defineMessage<{ error: string }>('error');\nconst StepStartMsg = defineMessage<{ stepName: string; stepIndex: number }>('step_start');\n\ntype Incoming = ReturnType<typeof SubscribeMsg.create> | ReturnType<typeof UnsubscribeMsg.create>;\ntype Outgoing = ReturnType<typeof StepStartMsg.create> | ReturnType<typeof ErrorMsg.create>;\n\nasync function checkJobExists(jobId: string): Promise<boolean> {\n  const daemonUrl = getWorkflowDaemonUrl();\n  const res = await fetch(`${daemonUrl}/api/v1/jobs/${encodeURIComponent(jobId)}`);\n  return res.status !== 404;\n}\n\nexport default defineWebSocket<unknown, Incoming, Outgoing>({\n  path: '/progress/:jobId',\n  description: 'Real-time job progress updates',\n\n  handler: {\n    async onConnect(ctx, _sender) {\n      ctx.platform.logger.info('[progress-channel] Client connected', { connectionId: ctx.requestId });\n    },\n\n    async onMessage(ctx, message, sender) {\n      const router = new MessageRouter()\n        .on(SubscribeMsg, async (_ctx, payload) => {\n          const { jobId } = payload;\n\n          const exists = await checkJobExists(jobId).catch(() => true);\n          if (!exists) {\n            await sender.send(ErrorMsg.create({ error: `Job ${jobId} not found` }));\n            sender.close(1008, 'Job not found');\n            return;\n          }\n\n          ctx.platform.logger.info('[progress-channel] Subscribed to progress', { jobId });\n          // Progress streaming is not yet implemented — send acknowledgement only\n          await sender.send(StepStartMsg.create({ stepName: 'initialization', stepIndex: 0 }));\n        })\n        .on(UnsubscribeMsg, async (_ctx) => {\n          ctx.platform.logger.info('[progress-channel] Unsubscribed');\n        });\n\n      await router.handle(ctx, message as WSMessage, sender.raw);\n    },\n\n    async onDisconnect(ctx, _code, _reason) {\n      ctx.platform.logger.info('[progress-channel] Client disconnected', { connectionId: ctx.requestId });\n    },\n\n    async onError(ctx, error, sender) {\n      ctx.platform.logger.error('[progress-channel] Error', error);\n      try {\n        await sender.send(ErrorMsg.create({ error: error.message }));\n      } catch {\n        // socket may be closed\n      }\n    },\n  },\n});\n"]}
+{"version":3,"sources":["../../src/http-client.ts","../../src/ws/progress-channel.ts"],"names":[],"mappings":"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","file":"progress-channel.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/ws/progress-channel\n * WebSocket channel for real-time job progress updates.\n *\n * WS-P01 (actual step-level progress streaming) is a planned feature.\n * WS-P02 (unknown jobId → error) is implemented via job existence check.\n */\n\nimport { defineWebSocket, defineMessage, MessageRouter } from '@kb-labs/sdk';\nimport type { WSMessage } from '@kb-labs/sdk';\nimport { getWorkflowDaemonUrl } from '../http-client.js';\n\nconst SubscribeMsg = defineMessage<{ jobId: string }>('subscribe');\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nconst UnsubscribeMsg = defineMessage<{}>('unsubscribe');\nconst ErrorMsg = defineMessage<{ error: string }>('error');\nconst StepStartMsg = defineMessage<{ stepName: string; stepIndex: number }>('step_start');\n\ntype Incoming = ReturnType<typeof SubscribeMsg.create> | ReturnType<typeof UnsubscribeMsg.create>;\ntype Outgoing = ReturnType<typeof StepStartMsg.create> | ReturnType<typeof ErrorMsg.create>;\n\nasync function checkJobExists(jobId: string): Promise<boolean> {\n  const daemonUrl = getWorkflowDaemonUrl();\n  const res = await fetch(`${daemonUrl}/api/v1/jobs/${encodeURIComponent(jobId)}`);\n  return res.status !== 404;\n}\n\nexport default defineWebSocket<unknown, Incoming, Outgoing>({\n  path: '/progress/:jobId',\n  description: 'Real-time job progress updates',\n\n  handler: {\n    async onConnect(ctx, _sender) {\n      ctx.platform.logger.info('[progress-channel] Client connected', { connectionId: ctx.requestId });\n    },\n\n    async onMessage(ctx, message, sender) {\n      const router = new MessageRouter()\n        .on(SubscribeMsg, async (_ctx, payload) => {\n          const { jobId } = payload;\n\n          const exists = await checkJobExists(jobId).catch(() => true);\n          if (!exists) {\n            await sender.send(ErrorMsg.create({ error: `Job ${jobId} not found` }));\n            sender.close(1008, 'Job not found');\n            return;\n          }\n\n          ctx.platform.logger.info('[progress-channel] Subscribed to progress', { jobId });\n          // Progress streaming is not yet implemented — send acknowledgement only\n          await sender.send(StepStartMsg.create({ stepName: 'initialization', stepIndex: 0 }));\n        })\n        .on(UnsubscribeMsg, async (_ctx) => {\n          ctx.platform.logger.info('[progress-channel] Unsubscribed');\n        });\n\n      await router.handle(ctx, message as WSMessage, sender.raw);\n    },\n\n    async onDisconnect(ctx, _code, _reason) {\n      ctx.platform.logger.info('[progress-channel] Client disconnected', { connectionId: ctx.requestId });\n    },\n\n    async onError(ctx, error, sender) {\n      ctx.platform.logger.error('[progress-channel] Error', error);\n      try {\n        await sender.send(ErrorMsg.create({ error: error.message }));\n      } catch {\n        // socket may be closed\n      }\n    },\n  },\n});\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kb-labs/workflow-entry",
   "description": "CLI commands for KB Labs Workflow Daemon - interact with workflow daemon via HTTP API.",
-  "version": "2.116.13",
+  "version": "2.117.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -21,10 +21,10 @@
     "README.md"
   ],
   "dependencies": {
-    "@kb-labs/core-platform": "2.116.13",
-    "@kb-labs/workflow-contracts": "2.116.13",
-    "@kb-labs/sdk": "2.115.1",
-    "@kb-labs/workflow-runtime": "2.116.13"
+    "@kb-labs/core-platform": "2.117.0",
+    "@kb-labs/workflow-runtime": "2.117.0",
+    "@kb-labs/sdk": "2.115.2",
+    "@kb-labs/workflow-contracts": "2.117.0"
   },
   "devDependencies": {
     "@rspack/cli": "^2.1.2",
@@ -38,9 +38,9 @@
     "tsup": "^8.5.0",
     "typescript": "^5.6.3",
     "vitest": "^3.2.6",
-    "@kb-labs/devkit": "2.116.13",
-    "@kb-labs/shared-testing-e2e": "2.116.13",
-    "@kb-labs/studio-plugin-tools": "2.116.13"
+    "@kb-labs/shared-testing-e2e": "2.117.0",
+    "@kb-labs/studio-plugin-tools": "2.117.0",
+    "@kb-labs/devkit": "2.117.0"
   },
   "engines": {
     "node": ">=22.0.0",