@kb-labs/rest-api-app 1.3.0

package/.kb/commit/current/status.json

@@ -0,0 +1,472 @@
+{
+  "schemaVersion": "1.0",
+  "createdAt": "2026-01-02T14:08:23.750Z",
+  "status": {
+    "staged": [],
+    "unstaged": [
+      ".gitignore",
+      "apps/rest-api/package.json",
+      "apps/rest-api/src/bootstrap.ts",
+      "apps/rest-api/src/events/index.ts",
+      "apps/rest-api/src/middleware/envelope.ts",
+      "apps/rest-api/src/middleware/index.ts",
+      "apps/rest-api/src/middleware/metrics.ts",
+      "apps/rest-api/src/middleware/request-id.ts",
+      "apps/rest-api/src/routes/__tests__/workflows.spec.ts",
+      "apps/rest-api/src/routes/events.ts",
+      "apps/rest-api/src/routes/health.ts",
+      "apps/rest-api/src/routes/index.ts",
+      "apps/rest-api/src/routes/metrics.ts",
+      "apps/rest-api/src/routes/plugins.ts",
+      "apps/rest-api/src/server.ts",
+      "packages/rest-api-contracts/package.json",
+      "packages/rest-api-contracts/src/index.ts",
+      "packages/rest-api-contracts/src/studio.ts",
+      "packages/rest-api-core/package.json",
+      "packages/rest-api-core/src/config/loader.ts",
+      "packages/rest-api-core/src/index.ts",
+      "pnpm-lock.yaml",
+      "tsconfig.paths.json",
+      "apps/rest-api/src/events/sse-event-bridge.ts",
+      "apps/rest-api/src/middleware/__tests__/header-policy.spec.ts",
+      "apps/rest-api/src/middleware/header-policy.ts",
+      "apps/rest-api/src/plugins/cli-discovery.ts",
+      "apps/rest-api/src/plugins/compat.ts",
+      "apps/rest-api/src/plugins/discovery.ts"
+    ],
+    "untracked": [
+      "apps/rest-api/.kb/commit/current/plan.json",
+      "apps/rest-api/.kb/commit/current/status.json",
+      "apps/rest-api/src/middleware/__tests__/cache.spec.ts",
+      "apps/rest-api/src/middleware/__tests__/envelope.spec.ts",
+      "apps/rest-api/src/middleware/__tests__/rate-limit.spec.ts",
+      "apps/rest-api/src/middleware/__tests__/request-id.spec.ts",
+      "apps/rest-api/src/middleware/prom-metrics.ts",
+      "apps/rest-api/src/platform.ts",
+      "apps/rest-api/src/routes/__tests__/adapters-date-helpers.spec.ts",
+      "apps/rest-api/src/routes/__tests__/adapters.spec.ts",
+      "apps/rest-api/src/routes/adapters.ts",
+      "apps/rest-api/src/routes/analytics.ts",
+      "apps/rest-api/src/routes/cache.ts",
+      "apps/rest-api/src/routes/logs.ts",
+      "apps/rest-api/src/routes/observability.ts",
+      "apps/rest-api/src/routes/platform.ts",
+      "apps/rest-api/src/routes/workflow-management.ts",
+      "packages/rest-api-contracts/src/observability.ts",
+      "packages/rest-api-contracts/src/platform.ts",
+      "packages/rest-api-core/src/__tests__/config-schema.spec.ts",
+      "packages/rest-api-core/src/__tests__/studio-registry.spec.ts",
+      "packages/rest-api-core/src/studio-registry.ts"
+    ]
+  },
+  "summaries": [
+    {
+      "path": ".gitignore",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/package.json",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/bootstrap.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/events/index.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/middleware/envelope.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/middleware/index.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/middleware/metrics.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/middleware/request-id.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/routes/__tests__/workflows.spec.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/routes/events.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/routes/health.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/routes/index.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/routes/metrics.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/routes/plugins.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/server.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "packages/rest-api-contracts/package.json",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "packages/rest-api-contracts/src/index.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "packages/rest-api-contracts/src/studio.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "packages/rest-api-core/package.json",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "packages/rest-api-core/src/config/loader.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "packages/rest-api-core/src/index.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "pnpm-lock.yaml",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "tsconfig.paths.json",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/events/sse-event-bridge.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/middleware/__tests__/header-policy.spec.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/middleware/header-policy.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/plugins/cli-discovery.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/plugins/compat.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/plugins/discovery.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/.kb/commit/current/plan.json",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/.kb/commit/current/status.json",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/middleware/__tests__/cache.spec.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/middleware/__tests__/envelope.spec.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/middleware/__tests__/rate-limit.spec.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/middleware/__tests__/request-id.spec.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/middleware/prom-metrics.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/platform.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/routes/__tests__/adapters-date-helpers.spec.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/routes/__tests__/adapters.spec.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/routes/adapters.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/routes/analytics.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/routes/cache.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/routes/logs.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/routes/observability.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/routes/platform.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "apps/rest-api/src/routes/workflow-management.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "packages/rest-api-contracts/src/observability.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "packages/rest-api-contracts/src/platform.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "packages/rest-api-core/src/__tests__/config-schema.spec.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "packages/rest-api-core/src/__tests__/studio-registry.spec.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    },
+    {
+      "path": "packages/rest-api-core/src/studio-registry.ts",
+      "status": "added",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "isNewFile": true
+    }
+  ]
+}

package/.kb/runtime/workspaces/ws_94c2deab-4cf9-49cb-94ac-3958062754a1/commands/health.d.ts

@@ -0,0 +1,10 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+
+/**
+ * workflow:health command - Check daemon health
+ */
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, any, {
+    exitCode: number;
+}>;
+
+export { _default as default };

package/.kb/runtime/workspaces/ws_94c2deab-4cf9-49cb-94ac-3958062754a1/commands/health.js

@@ -0,0 +1,215 @@
+import { defineCommand } from '@kb-labs/sdk';
+
+// src/commands/health.ts
+
+// src/http-client.ts
+var DEFAULT_DAEMON_URL = "http://localhost:7778";
+var WorkflowDaemonClient = class {
+  baseUrl;
+  constructor(options = {}) {
+    this.baseUrl = options.url ?? process.env.WORKFLOW_DAEMON_URL ?? DEFAULT_DAEMON_URL;
+  }
+  /**
+   * Validate response Content-Type and parse JSON safely
+   */
+  async parseJsonResponse(response) {
+    const contentType = response.headers.get("content-type");
+    if (!contentType?.includes("application/json")) {
+      throw new Error(`Invalid Content-Type: expected application/json, got ${contentType}`);
+    }
+    return response.json();
+  }
+  unwrapData(payload) {
+    if (payload && typeof payload === "object" && "ok" in payload && payload.ok === true && "data" in payload) {
+      return payload.data;
+    }
+    return payload;
+  }
+  /**
+   * Validate and encode job ID to prevent path traversal attacks
+   */
+  validateAndEncodeJobId(jobId) {
+    if (!/^[a-zA-Z0-9_-]+$/.test(jobId)) {
+      throw new Error(`Invalid job ID format: ${jobId}`);
+    }
+    return encodeURIComponent(jobId);
+  }
+  /**
+   * Health check
+   */
+  async health() {
+    const response = await fetch(`${this.baseUrl}/health`);
+    if (!response.ok) {
+      throw new Error(`Health check failed: ${response.statusText}`);
+    }
+    return this.parseJsonResponse(response);
+  }
+  /**
+   * Get workflow metrics
+   */
+  async getMetrics() {
+    const response = await fetch(`${this.baseUrl}/metrics`);
+    if (!response.ok) {
+      throw new Error(`Failed to get metrics: ${response.statusText}`);
+    }
+    const data = await this.parseJsonResponse(response);
+    return this.unwrapData(data);
+  }
+  /**
+   * Get job status with full details (jobs, steps, outputs)
+   */
+  async getJobStatus(jobId) {
+    const encodedJobId = this.validateAndEncodeJobId(jobId);
+    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}`);
+    if (response.status === 404) {
+      throw new Error(`Job ${jobId} not found`);
+    }
+    if (!response.ok) {
+      throw new Error(`Failed to get job status: ${response.statusText}`);
+    }
+    const data = await this.parseJsonResponse(response);
+    return this.unwrapData(data);
+  }
+  /**
+   * Get job steps with outputs
+   */
+  async getJobSteps(jobId) {
+    const encodedJobId = this.validateAndEncodeJobId(jobId);
+    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/steps`);
+    if (response.status === 404) {
+      throw new Error(`Job ${jobId} not found`);
+    }
+    if (!response.ok) {
+      throw new Error(`Failed to get job steps: ${response.statusText}`);
+    }
+    const data = await this.parseJsonResponse(response);
+    return this.unwrapData(data);
+  }
+  /**
+   * Get job logs
+   */
+  async getJobLogs(jobId) {
+    const encodedJobId = this.validateAndEncodeJobId(jobId);
+    const response = await fetch(`${this.baseUrl}/api/v1/jobs/${encodedJobId}/logs`);
+    if (response.status === 404) {
+      throw new Error(`Job ${jobId} not found`);
+    }
+    if (!response.ok) {
+      throw new Error(`Failed to get job logs: ${response.statusText}`);
+    }
+    const data = await this.parseJsonResponse(response);
+    const unwrapped = this.unwrapData(data);
+    return unwrapped.logs ?? [];
+  }
+  /**
+   * Get active executions
+   */
+  async getExecutions() {
+    const response = await fetch(`${this.baseUrl}/api/v1/jobs`);
+    if (!response.ok) {
+      throw new Error(`Failed to get executions: ${response.statusText}`);
+    }
+    const data = await this.parseJsonResponse(response);
+    const unwrapped = this.unwrapData(data);
+    const jobs = unwrapped.jobs ?? [];
+    return jobs.filter((job) => job.status === "running" || job.status === "pending");
+  }
+  /**
+   * Get cron jobs
+   */
+  async getCronJobs() {
+    const response = await fetch(`${this.baseUrl}/api/v1/cron`);
+    if (!response.ok) {
+      throw new Error(`Failed to get cron jobs: ${response.statusText}`);
+    }
+    const data = await this.parseJsonResponse(response);
+    return this.unwrapData(data);
+  }
+  /**
+   * Submit a job for execution
+   */
+  async submitJob(params) {
+    const response = await fetch(`${this.baseUrl}/api/v1/jobs`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        type: params.handler,
+        payload: params.input,
+        priority: params.priority
+      })
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ error: response.statusText }));
+      throw new Error(error.error || `Failed to submit job: ${response.statusText}`);
+    }
+    const payload = await this.parseJsonResponse(response);
+    const data = this.unwrapData(payload);
+    return { id: data.jobId, status: "pending" };
+  }
+  /**
+   * Run workflow by ID
+   */
+  async runWorkflow(workflowId, request = {}) {
+    const response = await fetch(
+      `${this.baseUrl}/api/v1/workflows/${encodeURIComponent(workflowId)}/run`,
+      {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify(request)
+      }
+    );
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ error: response.statusText }));
+      throw new Error(error.error || `Failed to run workflow: ${response.statusText}`);
+    }
+    const payload = await this.parseJsonResponse(response);
+    return this.unwrapData(payload);
+  }
+};
+
+// src/commands/health.ts
+var health_default = defineCommand({
+  id: "workflow:health",
+  description: "Check workflow daemon health status",
+  handler: {
+    async execute(ctx, input) {
+      const flags = input.flags ?? input;
+      const outputJson = flags.json ?? false;
+      try {
+        const client = new WorkflowDaemonClient();
+        const health = await client.health();
+        if (outputJson) {
+          ctx.ui?.json?.({ ok: true, data: health });
+        } else {
+          ctx.ui?.success?.("Daemon is healthy", {
+            title: "Workflow Daemon",
+            sections: [
+              {
+                header: "Status",
+                items: [`Service: ${health.service}`, "Health: OK"]
+              }
+            ]
+          });
+        }
+        return { exitCode: 0 };
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (outputJson) {
+          ctx.ui?.json?.({ ok: false, error: message });
+        } else {
+          ctx.ui?.error?.(`Failed to check daemon health: ${message}`);
+          ctx.ui?.warn?.(`Make sure workflow daemon is running: kb-workflow`);
+        }
+        return { exitCode: 1 };
+      }
+    }
+  }
+});
+
+export { health_default as default };
+//# sourceMappingURL=health.js.map
+//# sourceMappingURL=health.js.map