@kb-labs/workflow-entry 2.47.0 → 2.53.0

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

@@ -13,7 +13,7 @@ var runs_list_handler_default = defineHandler({
     const { status, limit, offset } = input.query || {};
     const validatedLimit = limit ? Math.min(Math.max(parseInt(limit, 10) || 50, 1), 1e3) : 50;
     const validatedOffset = offset ? Math.max(parseInt(offset, 10) || 0, 0) : 0;
-    const validStatuses = ["queued", "running", "success", "failed", "cancelled"];
+    const validStatuses = ["queued", "running", "success", "failed", "cancelled", "dlq", "skipped"];
     const validatedStatus = status && validStatuses.includes(status) ? status : void 0;
     const params = new URLSearchParams();
     params.append("limit", String(validatedLimit));

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/http-client.ts","../../src/rest/runs-list-handler.ts"],"names":[],"mappings":";;;AAMA,IAAM,kBAAA,GAAqB,uBAAA;AASpB,SAAS,oBAAA,GAA+B;AAC7C,EAAA,OAAO,MAAA,CAAO,qBAAqB,CAAA,IAAK,kBAAA;AAC1C;;;ACIA,IAAO,4BAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CACJ,GAAA,EACA,KAAA,EACkB;AAClB,IAAA,MAAM,YAAY,oBAAA,EAAqB;AACvC,IAAA,MAAM,EAAE,MAAA,EAAQ,KAAA,EAAO,QAAO,GAAI,KAAA,CAAM,SAAS,EAAC;AAElD,IAAA,MAAM,cAAA,GAAiB,KAAA,GAAQ,IAAA,CAAK,GAAA,CAAI,KAAK,GAAA,CAAI,QAAA,CAAS,KAAA,EAAO,EAAE,CAAA,IAAK,EAAA,EAAI,CAAC,CAAA,EAAG,GAAI,CAAA,GAAI,EAAA;AACxF,IAAA,MAAM,eAAA,GAAkB,MAAA,GAAS,IAAA,CAAK,GAAA,CAAI,QAAA,CAAS,QAAQ,EAAE,CAAA,IAAK,CAAA,EAAG,CAAC,CAAA,GAAI,CAAA;AAC1E,IAAA,MAAM,gBAAgB,CAAC,QAAA,EAAU,SAAA,EAAW,SAAA,EAAW,UAAU,WAAW,CAAA;AAC5E,IAAA,MAAM,kBAAkB,MAAA,IAAU,aAAA,CAAc,QAAA,CAAS,MAAM,IAAI,MAAA,GAAS,MAAA;AAE5E,IAAA,MAAM,MAAA,GAAS,IAAI,eAAA,EAAgB;AACnC,IAAA,MAAA,CAAO,MAAA,CAAO,OAAA,EAAS,MAAA,CAAO,cAAc,CAAC,CAAA;AAC7C,IAAA,MAAA,CAAO,MAAA,CAAO,QAAA,EAAU,MAAA,CAAO,eAAe,CAAC,CAAA;AAC/C,IAAA,IAAI,eAAA,EAAiB;AACnB,MAAA,MAAA,CAAO,MAAA,CAAO,UAAU,eAAe,CAAA;AAAA,IACzC;AAEA,IAAA,MAAM,GAAA,GAAM,CAAA,EAAG,SAAS,CAAA,aAAA,EAAgB,MAAM,CAAA,CAAA;AAE9C,IAAA,GAAA,CAAI,QAAA,CAAS,MAAA,CAAO,IAAA,CAAK,CAAA,uCAAA,EAA0C,GAAG,CAAA,CAAE,CAAA;AAExE,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAG,CAAA;AAEhC,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,QAAA,MAAM,IAAI,MAAM,CAAA,KAAA,EAAQ,QAAA,CAAS,MAAM,CAAA,EAAA,EAAK,QAAA,CAAS,UAAU,CAAA,CAAE,CAAA;AAAA,MACnE;AAEA,MAAA,MAAM,MAAA,GAAU,MAAM,QAAA,CAAS,IAAA,EAAK;AAEpC,MAAA,IAAI,CAAC,MAAA,CAAO,EAAA,IAAM,CAAC,OAAO,IAAA,EAAM;AAC9B,QAAA,MAAM,IAAI,KAAA,CAAM,MAAA,CAAO,KAAA,IAAS,sBAAsB,CAAA;AAAA,MACxD;AAEA,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,IAChB,SAAS,KAAA,EAAO;AACd,MAAA,GAAA,CAAI,SAAS,MAAA,CAAO,KAAA;AAAA,QAClB,yCAAA;AAAA,QACA,KAAA,YAAiB,QAAQ,KAAA,GAAQ;AAAA,OACnC;AACA,MAAA,MAAM,KAAA;AAAA,IACR;AAAA,EACF;AACF,CAAC","file":"runs-list-handler.js","sourcesContent":["/**\n * HTTP client for interacting with Workflow Daemon\n */\nimport type { WorkflowRunRequest } from '@kb-labs/workflow-contracts';\nimport { useEnv } from '@kb-labs/sdk';\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 any).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\n   */\n  async getMetrics(): Promise<any> {\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<any>(response);\n    return this.unwrapData(data);\n  }\n\n  /**\n   * Get job status with full details (jobs, steps, outputs)\n   */\n  async getJobStatus(jobId: string): Promise<any> {\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<any>(response);\n    return this.unwrapData(data);\n  }\n\n  /**\n   * Get job steps with outputs\n   */\n  async getJobSteps(jobId: string): Promise<any> {\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<any>(response);\n    return this.unwrapData(data);\n  }\n\n  /**\n   * Get job logs\n   */\n  async getJobLogs(jobId: string): Promise<any[]> {\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<any>(response);\n    const unwrapped = this.unwrapData<{ logs: any[] }>(data);\n    return unwrapped.logs ?? [];\n  }\n\n  /**\n   * Get active executions\n   */\n  async getExecutions(): Promise<any[]> {\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<any>(response);\n    const unwrapped = this.unwrapData<{ jobs?: any[] }>(data);\n    const jobs = unwrapped.jobs ?? [];\n    return jobs.filter((job: any) => job.status === 'running' || job.status === 'pending');\n  }\n\n  /**\n   * Get cron jobs\n   */\n  async getCronJobs(): Promise<{\n    crons: any[];\n  }> {\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<any>(response);\n    return this.unwrapData(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<any>(response);\n    const data = this.unwrapData<{ jobId: string }>(payload);\n    return { id: data.jobId, status: 'pending' };\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 * REST handler: GET /runs\n * Proxies to workflow daemon GET /api/v1/runs\n * Lists all workflow runs across all workflows.\n */\n\nimport { defineHandler, type RestInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { getWorkflowDaemonUrl } from '../http-client.js';\n\ninterface RunsListQuery {\n  status?: string;\n  limit?: string;\n  offset?: string;\n}\n\ninterface ApiEnvelope<T> {\n  ok: boolean;\n  data?: T;\n  error?: string;\n}\n\nexport default defineHandler({\n  async execute(\n    ctx: PluginContextV3,\n    input: RestInput<RunsListQuery>\n  ): Promise<unknown> {\n    const daemonUrl = getWorkflowDaemonUrl();\n    const { status, limit, offset } = input.query || {};\n\n    const validatedLimit = limit ? Math.min(Math.max(parseInt(limit, 10) || 50, 1), 1000) : 50;\n    const validatedOffset = offset ? Math.max(parseInt(offset, 10) || 0, 0) : 0;\n    const validStatuses = ['queued', 'running', 'success', 'failed', 'cancelled'];\n    const validatedStatus = status && validStatuses.includes(status) ? status : undefined;\n\n    const params = new URLSearchParams();\n    params.append('limit', String(validatedLimit));\n    params.append('offset', String(validatedOffset));\n    if (validatedStatus) {\n      params.append('status', validatedStatus);\n    }\n\n    const url = `${daemonUrl}/api/v1/runs?${params}`;\n\n    ctx.platform.logger.info(`[runs-list-handler] Fetching runs from ${url}`);\n\n    try {\n      const response = await fetch(url);\n\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      const result = (await response.json()) as ApiEnvelope<unknown>;\n\n      if (!result.ok || !result.data) {\n        throw new Error(result.error || 'Failed to fetch runs');\n      }\n\n      return result.data;\n    } catch (error) {\n      ctx.platform.logger.error(\n        '[runs-list-handler] Error fetching runs',\n        error instanceof Error ? error : undefined\n      );\n      throw error;\n    }\n  },\n});\n"]}
+{"version":3,"sources":["../../src/http-client.ts","../../src/rest/runs-list-handler.ts"],"names":[],"mappings":";;;AAMA,IAAM,kBAAA,GAAqB,uBAAA;AASpB,SAAS,oBAAA,GAA+B;AAC7C,EAAA,OAAO,MAAA,CAAO,qBAAqB,CAAA,IAAK,kBAAA;AAC1C;;;ACIA,IAAO,4BAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CACJ,GAAA,EACA,KAAA,EACkB;AAClB,IAAA,MAAM,YAAY,oBAAA,EAAqB;AACvC,IAAA,MAAM,EAAE,MAAA,EAAQ,KAAA,EAAO,QAAO,GAAI,KAAA,CAAM,SAAS,EAAC;AAElD,IAAA,MAAM,cAAA,GAAiB,KAAA,GAAQ,IAAA,CAAK,GAAA,CAAI,KAAK,GAAA,CAAI,QAAA,CAAS,KAAA,EAAO,EAAE,CAAA,IAAK,EAAA,EAAI,CAAC,CAAA,EAAG,GAAI,CAAA,GAAI,EAAA;AACxF,IAAA,MAAM,eAAA,GAAkB,MAAA,GAAS,IAAA,CAAK,GAAA,CAAI,QAAA,CAAS,QAAQ,EAAE,CAAA,IAAK,CAAA,EAAG,CAAC,CAAA,GAAI,CAAA;AAC1E,IAAA,MAAM,aAAA,GAAgB,CAAC,QAAA,EAAU,SAAA,EAAW,WAAW,QAAA,EAAU,WAAA,EAAa,OAAO,SAAS,CAAA;AAC9F,IAAA,MAAM,kBAAkB,MAAA,IAAU,aAAA,CAAc,QAAA,CAAS,MAAM,IAAI,MAAA,GAAS,MAAA;AAE5E,IAAA,MAAM,MAAA,GAAS,IAAI,eAAA,EAAgB;AACnC,IAAA,MAAA,CAAO,MAAA,CAAO,OAAA,EAAS,MAAA,CAAO,cAAc,CAAC,CAAA;AAC7C,IAAA,MAAA,CAAO,MAAA,CAAO,QAAA,EAAU,MAAA,CAAO,eAAe,CAAC,CAAA;AAC/C,IAAA,IAAI,eAAA,EAAiB;AACnB,MAAA,MAAA,CAAO,MAAA,CAAO,UAAU,eAAe,CAAA;AAAA,IACzC;AAEA,IAAA,MAAM,GAAA,GAAM,CAAA,EAAG,SAAS,CAAA,aAAA,EAAgB,MAAM,CAAA,CAAA;AAE9C,IAAA,GAAA,CAAI,QAAA,CAAS,MAAA,CAAO,IAAA,CAAK,CAAA,uCAAA,EAA0C,GAAG,CAAA,CAAE,CAAA;AAExE,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAG,CAAA;AAEhC,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,QAAA,MAAM,IAAI,MAAM,CAAA,KAAA,EAAQ,QAAA,CAAS,MAAM,CAAA,EAAA,EAAK,QAAA,CAAS,UAAU,CAAA,CAAE,CAAA;AAAA,MACnE;AAEA,MAAA,MAAM,MAAA,GAAU,MAAM,QAAA,CAAS,IAAA,EAAK;AAEpC,MAAA,IAAI,CAAC,MAAA,CAAO,EAAA,IAAM,CAAC,OAAO,IAAA,EAAM;AAC9B,QAAA,MAAM,IAAI,KAAA,CAAM,MAAA,CAAO,KAAA,IAAS,sBAAsB,CAAA;AAAA,MACxD;AAEA,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,IAChB,SAAS,KAAA,EAAO;AACd,MAAA,GAAA,CAAI,SAAS,MAAA,CAAO,KAAA;AAAA,QAClB,yCAAA;AAAA,QACA,KAAA,YAAiB,QAAQ,KAAA,GAAQ;AAAA,OACnC;AACA,MAAA,MAAM,KAAA;AAAA,IACR;AAAA,EACF;AACF,CAAC","file":"runs-list-handler.js","sourcesContent":["/**\n * HTTP client for interacting with Workflow Daemon\n */\nimport type { WorkflowRunRequest } from '@kb-labs/workflow-contracts';\nimport { useEnv } from '@kb-labs/sdk';\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 any).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\n   */\n  async getMetrics(): Promise<any> {\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<any>(response);\n    return this.unwrapData(data);\n  }\n\n  /**\n   * Get job status with full details (jobs, steps, outputs)\n   */\n  async getJobStatus(jobId: string): Promise<any> {\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<any>(response);\n    return this.unwrapData(data);\n  }\n\n  /**\n   * Get job steps with outputs\n   */\n  async getJobSteps(jobId: string): Promise<any> {\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<any>(response);\n    return this.unwrapData(data);\n  }\n\n  /**\n   * Get job logs\n   */\n  async getJobLogs(jobId: string): Promise<any[]> {\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<any>(response);\n    const unwrapped = this.unwrapData<{ logs: any[] }>(data);\n    return unwrapped.logs ?? [];\n  }\n\n  /**\n   * Get active executions\n   */\n  async getExecutions(): Promise<any[]> {\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<any>(response);\n    const unwrapped = this.unwrapData<{ jobs?: any[] }>(data);\n    const jobs = unwrapped.jobs ?? [];\n    return jobs.filter((job: any) => job.status === 'running' || job.status === 'pending');\n  }\n\n  /**\n   * Get cron jobs\n   */\n  async getCronJobs(): Promise<{\n    crons: any[];\n  }> {\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<any>(response);\n    return this.unwrapData(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<any>(response);\n    const data = this.unwrapData<{ jobId: string }>(payload);\n    return { id: data.jobId, status: 'pending' };\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 * REST handler: GET /runs\n * Proxies to workflow daemon GET /api/v1/runs\n * Lists all workflow runs across all workflows.\n */\n\nimport { defineHandler, type RestInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { getWorkflowDaemonUrl } from '../http-client.js';\n\ninterface RunsListQuery {\n  status?: string;\n  limit?: string;\n  offset?: string;\n}\n\ninterface ApiEnvelope<T> {\n  ok: boolean;\n  data?: T;\n  error?: string;\n}\n\nexport default defineHandler({\n  async execute(\n    ctx: PluginContextV3,\n    input: RestInput<RunsListQuery>\n  ): Promise<unknown> {\n    const daemonUrl = getWorkflowDaemonUrl();\n    const { status, limit, offset } = input.query || {};\n\n    const validatedLimit = limit ? Math.min(Math.max(parseInt(limit, 10) || 50, 1), 1000) : 50;\n    const validatedOffset = offset ? Math.max(parseInt(offset, 10) || 0, 0) : 0;\n    const validStatuses = ['queued', 'running', 'success', 'failed', 'cancelled', 'dlq', 'skipped'];\n    const validatedStatus = status && validStatuses.includes(status) ? status : undefined;\n\n    const params = new URLSearchParams();\n    params.append('limit', String(validatedLimit));\n    params.append('offset', String(validatedOffset));\n    if (validatedStatus) {\n      params.append('status', validatedStatus);\n    }\n\n    const url = `${daemonUrl}/api/v1/runs?${params}`;\n\n    ctx.platform.logger.info(`[runs-list-handler] Fetching runs from ${url}`);\n\n    try {\n      const response = await fetch(url);\n\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      const result = (await response.json()) as ApiEnvelope<unknown>;\n\n      if (!result.ok || !result.data) {\n        throw new Error(result.error || 'Failed to fetch runs');\n      }\n\n      return result.data;\n    } catch (error) {\n      ctx.platform.logger.error(\n        '[runs-list-handler] Error fetching runs',\n        error instanceof Error ? error : undefined\n      );\n      throw error;\n    }\n  },\n});\n"]}