@kb-labs/rest-api-app 1.3.0

package/.kb/runtime/workspaces/ws_f0f301b8-388d-4dc4-b301-475f2bc95f02/flags-WLdpSZl4.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Flags for workflow:job-run command
+ */
+declare const runFlags: {
+    readonly json: {
+        readonly type: "boolean";
+        readonly description: "Output result as JSON";
+        readonly default: false;
+    };
+    readonly handler: {
+        readonly type: "string";
+        readonly description: "Plugin handler to run (e.g., \"mind:rag-query\")";
+    };
+    readonly input: {
+        readonly type: "string";
+        readonly description: "JSON string of input parameters";
+    };
+    readonly priority: {
+        readonly type: "number";
+        readonly description: "Job priority (1-10, default: 5)";
+    };
+    readonly wait: {
+        readonly type: "boolean";
+        readonly description: "Wait for job completion";
+        readonly default: false;
+    };
+};
+type RunFlags = typeof runFlags;
+/**
+ * Flags for workflow:run command
+ */
+declare const workflowRunFlags: {
+    readonly json: {
+        readonly type: "boolean";
+        readonly description: "Output result as JSON";
+        readonly default: false;
+    };
+    readonly 'workflow-id': {
+        readonly type: "string";
+        readonly description: "Workflow ID to run (e.g., \"release-manager/create-release\")";
+    };
+    readonly input: {
+        readonly type: "string";
+        readonly description: "JSON string of workflow input payload";
+    };
+    readonly isolation: {
+        readonly type: "string";
+        readonly description: "Isolation profile: strict, balanced, or relaxed";
+    };
+    readonly 'target-namespace': {
+        readonly type: "string";
+        readonly description: "Execution target namespace";
+    };
+    readonly 'target-environment-id': {
+        readonly type: "string";
+        readonly description: "Execution target environment ID";
+    };
+    readonly 'target-workspace-id': {
+        readonly type: "string";
+        readonly description: "Execution target workspace ID";
+    };
+    readonly 'target-workdir': {
+        readonly type: "string";
+        readonly description: "Execution target workdir override";
+    };
+    readonly 'trigger-type': {
+        readonly type: "string";
+        readonly description: "Trigger type: manual, api, or cron";
+    };
+    readonly 'trigger-user': {
+        readonly type: "string";
+        readonly description: "Trigger user";
+    };
+};
+type WorkflowRunFlags = typeof workflowRunFlags;
+
+export type { RunFlags as R, WorkflowRunFlags as W };

package/.kb/runtime/workspaces/ws_f0f301b8-388d-4dc4-b301-475f2bc95f02/index.d.ts

@@ -0,0 +1,2 @@
+export { manifest } from './manifest.js';
+import '@kb-labs/perm-presets';

package/.kb/runtime/workspaces/ws_f0f301b8-388d-4dc4-b301-475f2bc95f02/index.js

@@ -0,0 +1,441 @@
+import { combinePermissions, defineCommandFlags } from '@kb-labs/sdk';
+import { WORKFLOW_ROUTES, WORKFLOW_BASE_PATH } from '@kb-labs/workflow-contracts';
+
+// src/manifest.ts
+
+// src/flags.ts
+var OUTPUT_JSON_DESCRIPTION = "Output result as JSON";
+var healthFlags = {
+  json: {
+    type: "boolean",
+    description: OUTPUT_JSON_DESCRIPTION,
+    default: false
+  }
+};
+var metricsFlags = {
+  json: {
+    type: "boolean",
+    description: OUTPUT_JSON_DESCRIPTION,
+    default: false
+  }
+};
+var statusFlags = {
+  json: {
+    type: "boolean",
+    description: OUTPUT_JSON_DESCRIPTION,
+    default: false
+  },
+  "job-id": {
+    type: "string",
+    description: "Job ID to get status for"
+  }
+};
+var logsFlags = {
+  json: {
+    type: "boolean",
+    description: OUTPUT_JSON_DESCRIPTION,
+    default: false
+  },
+  "job-id": {
+    type: "string",
+    description: "Job ID to get logs for (required)"
+  },
+  follow: {
+    type: "boolean",
+    description: "Follow log output (stream new logs)",
+    default: false
+  }
+};
+var listFlags = {
+  json: {
+    type: "boolean",
+    description: OUTPUT_JSON_DESCRIPTION,
+    default: false
+  },
+  status: {
+    type: "string",
+    description: "Filter by status (running, completed, failed)"
+  },
+  type: {
+    type: "string",
+    description: 'Filter by type: "runs" (active executions), "cron" (scheduled jobs)'
+  }
+};
+var runFlags = {
+  json: {
+    type: "boolean",
+    description: OUTPUT_JSON_DESCRIPTION,
+    default: false
+  },
+  handler: {
+    type: "string",
+    description: 'Plugin handler to run (e.g., "mind:rag-query")'
+  },
+  input: {
+    type: "string",
+    description: "JSON string of input parameters"
+  },
+  priority: {
+    type: "number",
+    description: "Job priority (1-10, default: 5)"
+  },
+  wait: {
+    type: "boolean",
+    description: "Wait for job completion",
+    default: false
+  }
+};
+var workflowRunFlags = {
+  json: {
+    type: "boolean",
+    description: OUTPUT_JSON_DESCRIPTION,
+    default: false
+  },
+  "workflow-id": {
+    type: "string",
+    description: 'Workflow ID to run (e.g., "release-manager/create-release")'
+  },
+  input: {
+    type: "string",
+    description: "JSON string of workflow input payload"
+  },
+  isolation: {
+    type: "string",
+    description: "Isolation profile: strict, balanced, or relaxed"
+  },
+  "target-namespace": {
+    type: "string",
+    description: "Execution target namespace"
+  },
+  "target-environment-id": {
+    type: "string",
+    description: "Execution target environment ID"
+  },
+  "target-workspace-id": {
+    type: "string",
+    description: "Execution target workspace ID"
+  },
+  "target-workdir": {
+    type: "string",
+    description: "Execution target workdir override"
+  },
+  "trigger-type": {
+    type: "string",
+    description: "Trigger type: manual, api, or cron"
+  },
+  "trigger-user": {
+    type: "string",
+    description: "Trigger user"
+  }
+};
+var pluginPermissions = combinePermissions().withEnv(["WORKFLOW_DAEMON_URL"]).withNetwork({
+  fetch: ["http://localhost:*", "http://127.0.0.1:*"]
+}).withQuotas({
+  timeoutMs: 3e4,
+  // 30 seconds for HTTP requests
+  memoryMb: 128
+}).build();
+var manifest = {
+  schema: "kb.plugin/3",
+  id: "@kb-labs/workflow",
+  version: "1.0.0",
+  display: {
+    name: "Workflow CLI",
+    description: "CLI commands for interacting with KB Labs Workflow Daemon.",
+    tags: ["workflow", "daemon", "jobs", "orchestration"]
+  },
+  // No platform requirements - just HTTP client
+  platform: {
+    requires: [],
+    optional: []
+  },
+  cli: {
+    commands: [
+      // workflow:health - Check daemon health
+      {
+        id: "workflow:health",
+        group: "workflow",
+        describe: "Check workflow daemon health status.",
+        longDescription: "Performs a health check on the workflow daemon by making an HTTP request to /health endpoint. Use this to verify the daemon is running and responding.",
+        handler: "./commands/health.js#default",
+        handlerPath: "./commands/health.js",
+        flags: defineCommandFlags(healthFlags),
+        examples: [
+          "kb workflow health",
+          "kb workflow health --json"
+        ]
+      },
+      // workflow:metrics - Get metrics
+      {
+        id: "workflow:metrics",
+        group: "workflow",
+        describe: "Get workflow daemon metrics.",
+        longDescription: "Fetches comprehensive metrics from the workflow daemon including total runs, queued jobs, running jobs, completed jobs, and failure counts.",
+        handler: "./commands/metrics.js#default",
+        handlerPath: "./commands/metrics.js",
+        flags: defineCommandFlags(metricsFlags),
+        examples: [
+          "kb workflow metrics",
+          "kb workflow metrics --json"
+        ]
+      },
+      // workflow:status - Get job status
+      {
+        id: "workflow:status",
+        group: "workflow",
+        describe: "Get status of a specific workflow job.",
+        longDescription: "Retrieves detailed status information for a specific job by ID, including current state, start time, and completion time if finished.",
+        handler: "./commands/status.js#default",
+        handlerPath: "./commands/status.js",
+        flags: defineCommandFlags(statusFlags),
+        examples: [
+          "kb workflow status --job-id=abc123",
+          "kb workflow status --job-id=abc123 --json"
+        ]
+      },
+      // workflow:logs - Get job logs
+      {
+        id: "workflow:logs",
+        group: "workflow",
+        describe: "Get logs for a specific workflow job.",
+        longDescription: "Fetches execution logs for a specific job by ID. Note: Log integration with platform.logger is pending, currently returns placeholder data.",
+        handler: "./commands/logs.js#default",
+        handlerPath: "./commands/logs.js",
+        flags: defineCommandFlags(logsFlags),
+        examples: [
+          "kb workflow logs --job-id=abc123",
+          "kb workflow logs --job-id=abc123 --json",
+          "kb workflow logs --job-id=abc123 --follow"
+        ]
+      },
+      // workflow:list - List active executions
+      {
+        id: "workflow:list",
+        group: "workflow",
+        describe: "List active workflow executions.",
+        longDescription: "Lists all currently active workflow executions or cron jobs. Can be filtered by status (running, queued, completed, failed, cancelled) or type (runs, cron).",
+        handler: "./commands/list.js#default",
+        handlerPath: "./commands/list.js",
+        flags: defineCommandFlags(listFlags),
+        examples: [
+          "kb workflow list",
+          "kb workflow list --status=running",
+          "kb workflow list --type=cron",
+          "kb workflow list --json"
+        ]
+      },
+      // workflow:job-run - Submit raw job for execution
+      {
+        id: "workflow:job-run",
+        group: "workflow",
+        describe: "Submit a raw job for execution.",
+        longDescription: "Submits a job to the workflow daemon for execution. Requires a handler (plugin command) and optionally accepts input parameters as JSON. Can wait for job completion with --wait flag.",
+        handler: "./commands/run.js#default",
+        handlerPath: "./commands/run.js",
+        flags: defineCommandFlags(runFlags),
+        examples: [
+          `kb workflow job-run --handler=mind:rag-query --input='{"text":"test"}'`,
+          `kb workflow job-run --handler=mind:rag-query --input='{"text":"test"}' --wait`,
+          `kb workflow job-run --handler=mind:rag-query --input='{"text":"test"}' --priority=8`,
+          `kb workflow job-run --handler=mind:rag-query --input='{"text":"test"}' --json`
+        ]
+      },
+      // workflow:run - Run workflow by workflow ID
+      {
+        id: "workflow:run",
+        group: "workflow",
+        describe: "Run workflow by ID.",
+        longDescription: "Runs a workflow definition by workflow ID via /api/v1/workflows/:id/run endpoint. Supports request-level target and isolation overrides.",
+        handler: "./commands/workflow-run.js#default",
+        handlerPath: "./commands/workflow-run.js",
+        flags: defineCommandFlags(workflowRunFlags),
+        examples: [
+          "kb workflow run --workflow-id=release-manager/create-release",
+          "kb workflow run --workflow-id=release-manager/create-release --isolation=strict --target-namespace=team-a/prod",
+          "kb workflow run --workflow-id=release-manager/create-release --target-environment-id=env-123 --json"
+        ]
+      }
+    ]
+  },
+  // REST API routes (proxy to workflow daemon)
+  rest: {
+    basePath: WORKFLOW_BASE_PATH,
+    routes: [
+      // GET /stats - Dashboard statistics
+      {
+        method: "GET",
+        path: WORKFLOW_ROUTES.STATS,
+        handler: "./rest/stats-handler.js#default",
+        describe: "Get dashboard statistics",
+        output: {
+          zod: "@kb-labs/workflow-contracts#DashboardStatsResponseSchema"
+        }
+      },
+      // GET /workflows - List workflow definitions
+      {
+        method: "GET",
+        path: WORKFLOW_ROUTES.WORKFLOWS,
+        handler: "./rest/workflows-list-handler.js#default",
+        describe: "List all workflow definitions",
+        output: {
+          zod: "@kb-labs/workflow-contracts#WorkflowListResponseSchema"
+        }
+      },
+      // GET /workflows/:id - Get workflow detail
+      {
+        method: "GET",
+        path: WORKFLOW_ROUTES.WORKFLOW_DETAIL,
+        handler: "./rest/workflow-detail-handler.js#default",
+        describe: "Get workflow definition details",
+        output: {
+          zod: "@kb-labs/workflow-contracts#WorkflowInfoSchema"
+        }
+      },
+      // POST /workflows/:id/run - Run workflow
+      {
+        method: "POST",
+        path: WORKFLOW_ROUTES.WORKFLOW_RUN,
+        handler: "./rest/workflow-run-handler.js#default",
+        describe: "Run a workflow",
+        input: {
+          zod: "@kb-labs/workflow-contracts#WorkflowRunRequestSchema"
+        }
+      },
+      // GET /workflows/:workflowId/runs - Get workflow run history
+      {
+        method: "GET",
+        path: WORKFLOW_ROUTES.WORKFLOW_RUNS,
+        handler: "./rest/workflow-runs-handler.js#default",
+        describe: "Get workflow run history with pagination",
+        output: {
+          zod: "@kb-labs/workflow-contracts#WorkflowRunHistoryResponseSchema"
+        }
+      },
+      // POST /workflows/runs/:runId/cancel - Cancel a workflow run
+      {
+        method: "POST",
+        path: WORKFLOW_ROUTES.WORKFLOW_RUN_CANCEL,
+        handler: "./rest/workflow-run-cancel-handler.js#default",
+        describe: "Cancel a running or queued workflow run"
+      },
+      // GET /runs - List all workflow runs
+      {
+        method: "GET",
+        path: WORKFLOW_ROUTES.RUNS,
+        handler: "./rest/runs-list-handler.js#default",
+        describe: "List all workflow runs across all workflows"
+      },
+      // GET /runs/:runId - Get a specific workflow run
+      {
+        method: "GET",
+        path: WORKFLOW_ROUTES.RUN_DETAIL,
+        handler: "./rest/run-detail-handler.js#default",
+        describe: "Get detailed information about a specific workflow run"
+      },
+      // GET /workflows/jobs - List jobs
+      {
+        method: "GET",
+        path: WORKFLOW_ROUTES.JOBS,
+        handler: "./rest/jobs-list-handler.js#default",
+        describe: "List workflow jobs with optional filters",
+        output: {
+          zod: "@kb-labs/workflow-contracts#JobListResponseSchema"
+        }
+      },
+      // GET /workflows/jobs/:jobId - Get job detail
+      {
+        method: "GET",
+        path: WORKFLOW_ROUTES.JOB_DETAIL,
+        handler: "./rest/job-detail-handler.js#default",
+        describe: "Get detailed information about a specific job",
+        output: {
+          zod: "@kb-labs/workflow-contracts#JobStatusInfoSchema"
+        }
+      },
+      // GET /workflows/jobs/:jobId/logs - Get job logs
+      {
+        method: "GET",
+        path: WORKFLOW_ROUTES.JOB_LOGS,
+        handler: "./rest/job-logs-handler.js#default",
+        describe: "Get execution logs for a specific job",
+        output: {
+          zod: "@kb-labs/workflow-contracts#JobLogsResponseSchema"
+        }
+      },
+      // GET /workflows/jobs/:jobId/steps - Get job steps
+      {
+        method: "GET",
+        path: WORKFLOW_ROUTES.JOB_STEPS,
+        handler: "./rest/job-steps-handler.js#default",
+        describe: "Get execution steps and progress for a specific job",
+        output: {
+          zod: "@kb-labs/workflow-contracts#JobStepsResponseSchema"
+        }
+      },
+      // POST /workflows/jobs/:jobId/cancel - Cancel job
+      {
+        method: "POST",
+        path: WORKFLOW_ROUTES.JOB_CANCEL,
+        handler: "./rest/job-cancel-handler.js#default",
+        describe: "Cancel a running or pending job",
+        output: {
+          zod: "@kb-labs/workflow-contracts#JobCancelResponseSchema"
+        }
+      },
+      // GET /workflows/cron - List cron jobs
+      {
+        method: "GET",
+        path: WORKFLOW_ROUTES.CRON,
+        handler: "./rest/cron-list-handler.js#default",
+        describe: "List all registered cron jobs",
+        output: {
+          zod: "@kb-labs/workflow-contracts#CronListResponseSchema"
+        }
+      },
+      // GET /runs/:runId/pending-approvals - List pending approvals
+      {
+        method: "GET",
+        path: WORKFLOW_ROUTES.PENDING_APPROVALS,
+        handler: "./rest/pending-approvals-handler.js#default",
+        describe: "List steps waiting for approval in a workflow run"
+      },
+      // POST /runs/:runId/approve - Resolve approval
+      {
+        method: "POST",
+        path: WORKFLOW_ROUTES.RESOLVE_APPROVAL,
+        handler: "./rest/resolve-approval-handler.js#default",
+        describe: "Approve or reject a pending approval step"
+      }
+    ]
+  },
+  // WebSocket channels for real-time updates
+  ws: {
+    basePath: "/v1/ws/plugins/workflow",
+    defaults: {
+      timeoutMs: 6e5,
+      // 10 minutes
+      maxMessageSize: 1048576,
+      // 1MB
+      auth: "none",
+      idleTimeoutMs: 3e5
+      // 5 minutes
+    },
+    channels: [
+      {
+        path: "/logs/:jobId",
+        handler: "./ws/logs-channel.js#default",
+        description: "Real-time job logs streaming"
+      },
+      {
+        path: "/progress/:jobId",
+        handler: "./ws/progress-channel.js#default",
+        description: "Real-time job progress updates"
+      }
+    ]
+  },
+  permissions: pluginPermissions
+};
+
+export { manifest };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/.kb/runtime/workspaces/ws_f0f301b8-388d-4dc4-b301-475f2bc95f02/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/flags.ts","../src/manifest.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Shared command flags definitions\n *\n * DRY pattern: Define flags once, use in both manifest and command handlers.\n */\n\nconst OUTPUT_JSON_DESCRIPTION = 'Output result as JSON';\n\n/**\n * Flags for workflow:health command\n */\nexport const healthFlags = {\n  json: {\n    type: 'boolean',\n    description: OUTPUT_JSON_DESCRIPTION,\n    default: false,\n  },\n} as const;\n\nexport type HealthFlags = typeof healthFlags;\n\n/**\n * Flags for workflow:metrics command\n */\nexport const metricsFlags = {\n  json: {\n    type: 'boolean',\n    description: OUTPUT_JSON_DESCRIPTION,\n    default: false,\n  },\n} as const;\n\nexport type MetricsFlags = typeof metricsFlags;\n\n/**\n * Flags for workflow:status command\n */\nexport const statusFlags = {\n  json: {\n    type: 'boolean',\n    description: OUTPUT_JSON_DESCRIPTION,\n    default: false,\n  },\n  'job-id': {\n    type: 'string',\n    description: 'Job ID to get status for',\n  },\n} as const;\n\nexport type StatusFlags = typeof statusFlags;\n\n/**\n * Flags for workflow:logs command\n */\nexport const logsFlags = {\n  json: {\n    type: 'boolean',\n    description: OUTPUT_JSON_DESCRIPTION,\n    default: false,\n  },\n  'job-id': {\n    type: 'string',\n    description: 'Job ID to get logs for (required)',\n  },\n  follow: {\n    type: 'boolean',\n    description: 'Follow log output (stream new logs)',\n    default: false,\n  },\n} as const;\n\nexport type LogsFlags = typeof logsFlags;\n\n/**\n * Flags for workflow:list command\n */\nexport const listFlags = {\n  json: {\n    type: 'boolean',\n    description: OUTPUT_JSON_DESCRIPTION,\n    default: false,\n  },\n  status: {\n    type: 'string',\n    description: 'Filter by status (running, completed, failed)',\n  },\n  type: {\n    type: 'string',\n    description: 'Filter by type: \"runs\" (active executions), \"cron\" (scheduled jobs)',\n  },\n} as const;\n\nexport type ListFlags = typeof listFlags;\n\n/**\n * Flags for workflow:job-run command\n */\nexport const runFlags = {\n  json: {\n    type: 'boolean',\n    description: OUTPUT_JSON_DESCRIPTION,\n    default: false,\n  },\n  handler: {\n    type: 'string',\n    description: 'Plugin handler to run (e.g., \"mind:rag-query\")',\n  },\n  input: {\n    type: 'string',\n    description: 'JSON string of input parameters',\n  },\n  priority: {\n    type: 'number',\n    description: 'Job priority (1-10, default: 5)',\n  },\n  wait: {\n    type: 'boolean',\n    description: 'Wait for job completion',\n    default: false,\n  },\n} as const;\n\nexport type RunFlags = typeof runFlags;\n\n/**\n * Flags for workflow:run command\n */\nexport const workflowRunFlags = {\n  json: {\n    type: 'boolean',\n    description: OUTPUT_JSON_DESCRIPTION,\n    default: false,\n  },\n  'workflow-id': {\n    type: 'string',\n    description: 'Workflow ID to run (e.g., \"release-manager/create-release\")',\n  },\n  input: {\n    type: 'string',\n    description: 'JSON string of workflow input payload',\n  },\n  isolation: {\n    type: 'string',\n    description: 'Isolation profile: strict, balanced, or relaxed',\n  },\n  'target-namespace': {\n    type: 'string',\n    description: 'Execution target namespace',\n  },\n  'target-environment-id': {\n    type: 'string',\n    description: 'Execution target environment ID',\n  },\n  'target-workspace-id': {\n    type: 'string',\n    description: 'Execution target workspace ID',\n  },\n  'target-workdir': {\n    type: 'string',\n    description: 'Execution target workdir override',\n  },\n  'trigger-type': {\n    type: 'string',\n    description: 'Trigger type: manual, api, or cron',\n  },\n  'trigger-user': {\n    type: 'string',\n    description: 'Trigger user',\n  },\n} as const;\n\nexport type WorkflowRunFlags = typeof workflowRunFlags;\n","/**\n * KB Labs Workflow CLI - Manifest V3\n *\n * Provides CLI commands for interacting with Workflow Daemon via HTTP API.\n */\n\nimport { defineCommandFlags, combinePermissions } from '@kb-labs/sdk';\nimport {\n  healthFlags,\n  metricsFlags,\n  statusFlags,\n  logsFlags,\n  listFlags,\n  runFlags,\n  workflowRunFlags,\n} from './flags';\nimport {\n  WORKFLOW_BASE_PATH,\n  WORKFLOW_ROUTES,\n} from '@kb-labs/workflow-contracts';\n\n/**\n * Minimal permissions - workflow-cli only makes HTTP requests\n * No file system or git access needed\n */\nconst pluginPermissions = combinePermissions()\n  .withEnv(['WORKFLOW_DAEMON_URL'])\n  .withNetwork({\n    fetch: ['http://localhost:*', 'http://127.0.0.1:*'],\n  })\n  .withQuotas({\n    timeoutMs: 30000, // 30 seconds for HTTP requests\n    memoryMb: 128,\n  })\n  .build();\n\nexport const manifest = {\n  schema: 'kb.plugin/3',\n  id: '@kb-labs/workflow',\n  version: '1.0.0',\n\n  display: {\n    name: 'Workflow CLI',\n    description: 'CLI commands for interacting with KB Labs Workflow Daemon.',\n    tags: ['workflow', 'daemon', 'jobs', 'orchestration'],\n  },\n\n  // No platform requirements - just HTTP client\n  platform: {\n    requires: [],\n    optional: [],\n  },\n\n  cli: {\n    commands: [\n      // workflow:health - Check daemon health\n      {\n        id: 'workflow:health',\n        group: 'workflow',\n        describe: 'Check workflow daemon health status.',\n        longDescription:\n          'Performs a health check on the workflow daemon by making an HTTP request to /health endpoint. ' +\n          'Use this to verify the daemon is running and responding.',\n\n        handler: './commands/health.js#default',\n        handlerPath: './commands/health.js',\n\n        flags: defineCommandFlags(healthFlags),\n\n        examples: [\n          'kb workflow health',\n          'kb workflow health --json',\n        ],\n      },\n\n      // workflow:metrics - Get metrics\n      {\n        id: 'workflow:metrics',\n        group: 'workflow',\n        describe: 'Get workflow daemon metrics.',\n        longDescription:\n          'Fetches comprehensive metrics from the workflow daemon including total runs, queued jobs, ' +\n          'running jobs, completed jobs, and failure counts.',\n\n        handler: './commands/metrics.js#default',\n        handlerPath: './commands/metrics.js',\n\n        flags: defineCommandFlags(metricsFlags),\n\n        examples: [\n          'kb workflow metrics',\n          'kb workflow metrics --json',\n        ],\n      },\n\n      // workflow:status - Get job status\n      {\n        id: 'workflow:status',\n        group: 'workflow',\n        describe: 'Get status of a specific workflow job.',\n        longDescription:\n          'Retrieves detailed status information for a specific job by ID, including current state, ' +\n          'start time, and completion time if finished.',\n\n        handler: './commands/status.js#default',\n        handlerPath: './commands/status.js',\n\n        flags: defineCommandFlags(statusFlags),\n\n        examples: [\n          'kb workflow status --job-id=abc123',\n          'kb workflow status --job-id=abc123 --json',\n        ],\n      },\n\n      // workflow:logs - Get job logs\n      {\n        id: 'workflow:logs',\n        group: 'workflow',\n        describe: 'Get logs for a specific workflow job.',\n        longDescription:\n          'Fetches execution logs for a specific job by ID. Note: Log integration with platform.logger ' +\n          'is pending, currently returns placeholder data.',\n\n        handler: './commands/logs.js#default',\n        handlerPath: './commands/logs.js',\n\n        flags: defineCommandFlags(logsFlags),\n\n        examples: [\n          'kb workflow logs --job-id=abc123',\n          'kb workflow logs --job-id=abc123 --json',\n          'kb workflow logs --job-id=abc123 --follow',\n        ],\n      },\n\n      // workflow:list - List active executions\n      {\n        id: 'workflow:list',\n        group: 'workflow',\n        describe: 'List active workflow executions.',\n        longDescription:\n          'Lists all currently active workflow executions or cron jobs. Can be filtered by status (running, queued, ' +\n          'completed, failed, cancelled) or type (runs, cron).',\n\n        handler: './commands/list.js#default',\n        handlerPath: './commands/list.js',\n\n        flags: defineCommandFlags(listFlags),\n\n        examples: [\n          'kb workflow list',\n          'kb workflow list --status=running',\n          'kb workflow list --type=cron',\n          'kb workflow list --json',\n        ],\n      },\n\n      // workflow:job-run - Submit raw job for execution\n      {\n        id: 'workflow:job-run',\n        group: 'workflow',\n        describe: 'Submit a raw job for execution.',\n        longDescription:\n          'Submits a job to the workflow daemon for execution. Requires a handler (plugin command) and ' +\n          'optionally accepts input parameters as JSON. Can wait for job completion with --wait flag.',\n\n        handler: './commands/run.js#default',\n        handlerPath: './commands/run.js',\n\n        flags: defineCommandFlags(runFlags),\n\n        examples: [\n          'kb workflow job-run --handler=mind:rag-query --input=\\'{\"text\":\"test\"}\\'',\n          'kb workflow job-run --handler=mind:rag-query --input=\\'{\"text\":\"test\"}\\' --wait',\n          'kb workflow job-run --handler=mind:rag-query --input=\\'{\"text\":\"test\"}\\' --priority=8',\n          'kb workflow job-run --handler=mind:rag-query --input=\\'{\"text\":\"test\"}\\' --json',\n        ],\n      },\n\n      // workflow:run - Run workflow by workflow ID\n      {\n        id: 'workflow:run',\n        group: 'workflow',\n        describe: 'Run workflow by ID.',\n        longDescription:\n          'Runs a workflow definition by workflow ID via /api/v1/workflows/:id/run endpoint. ' +\n          'Supports request-level target and isolation overrides.',\n\n        handler: './commands/workflow-run.js#default',\n        handlerPath: './commands/workflow-run.js',\n\n        flags: defineCommandFlags(workflowRunFlags),\n\n        examples: [\n          'kb workflow run --workflow-id=release-manager/create-release',\n          'kb workflow run --workflow-id=release-manager/create-release --isolation=strict --target-namespace=team-a/prod',\n          'kb workflow run --workflow-id=release-manager/create-release --target-environment-id=env-123 --json',\n        ],\n      },\n    ],\n  },\n\n  // REST API routes (proxy to workflow daemon)\n  rest: {\n    basePath: WORKFLOW_BASE_PATH,\n    routes: [\n      // GET /stats - Dashboard statistics\n      {\n        method: 'GET',\n        path: WORKFLOW_ROUTES.STATS,\n        handler: './rest/stats-handler.js#default',\n        describe: 'Get dashboard statistics',\n        output: {\n          zod: '@kb-labs/workflow-contracts#DashboardStatsResponseSchema',\n        },\n      },\n      // GET /workflows - List workflow definitions\n      {\n        method: 'GET',\n        path: WORKFLOW_ROUTES.WORKFLOWS,\n        handler: './rest/workflows-list-handler.js#default',\n        describe: 'List all workflow definitions',\n        output: {\n          zod: '@kb-labs/workflow-contracts#WorkflowListResponseSchema',\n        },\n      },\n      // GET /workflows/:id - Get workflow detail\n      {\n        method: 'GET',\n        path: WORKFLOW_ROUTES.WORKFLOW_DETAIL,\n        handler: './rest/workflow-detail-handler.js#default',\n        describe: 'Get workflow definition details',\n        output: {\n          zod: '@kb-labs/workflow-contracts#WorkflowInfoSchema',\n        },\n      },\n      // POST /workflows/:id/run - Run workflow\n      {\n        method: 'POST',\n        path: WORKFLOW_ROUTES.WORKFLOW_RUN,\n        handler: './rest/workflow-run-handler.js#default',\n        describe: 'Run a workflow',\n        input: {\n          zod: '@kb-labs/workflow-contracts#WorkflowRunRequestSchema',\n        },\n      },\n      // GET /workflows/:workflowId/runs - Get workflow run history\n      {\n        method: 'GET',\n        path: WORKFLOW_ROUTES.WORKFLOW_RUNS,\n        handler: './rest/workflow-runs-handler.js#default',\n        describe: 'Get workflow run history with pagination',\n        output: {\n          zod: '@kb-labs/workflow-contracts#WorkflowRunHistoryResponseSchema',\n        },\n      },\n      // POST /workflows/runs/:runId/cancel - Cancel a workflow run\n      {\n        method: 'POST',\n        path: WORKFLOW_ROUTES.WORKFLOW_RUN_CANCEL,\n        handler: './rest/workflow-run-cancel-handler.js#default',\n        describe: 'Cancel a running or queued workflow run',\n      },\n      // GET /runs - List all workflow runs\n      {\n        method: 'GET',\n        path: WORKFLOW_ROUTES.RUNS,\n        handler: './rest/runs-list-handler.js#default',\n        describe: 'List all workflow runs across all workflows',\n      },\n      // GET /runs/:runId - Get a specific workflow run\n      {\n        method: 'GET',\n        path: WORKFLOW_ROUTES.RUN_DETAIL,\n        handler: './rest/run-detail-handler.js#default',\n        describe: 'Get detailed information about a specific workflow run',\n      },\n      // GET /workflows/jobs - List jobs\n      {\n        method: 'GET',\n        path: WORKFLOW_ROUTES.JOBS,\n        handler: './rest/jobs-list-handler.js#default',\n        describe: 'List workflow jobs with optional filters',\n        output: {\n          zod: '@kb-labs/workflow-contracts#JobListResponseSchema',\n        },\n      },\n      // GET /workflows/jobs/:jobId - Get job detail\n      {\n        method: 'GET',\n        path: WORKFLOW_ROUTES.JOB_DETAIL,\n        handler: './rest/job-detail-handler.js#default',\n        describe: 'Get detailed information about a specific job',\n        output: {\n          zod: '@kb-labs/workflow-contracts#JobStatusInfoSchema',\n        },\n      },\n      // GET /workflows/jobs/:jobId/logs - Get job logs\n      {\n        method: 'GET',\n        path: WORKFLOW_ROUTES.JOB_LOGS,\n        handler: './rest/job-logs-handler.js#default',\n        describe: 'Get execution logs for a specific job',\n        output: {\n          zod: '@kb-labs/workflow-contracts#JobLogsResponseSchema',\n        },\n      },\n      // GET /workflows/jobs/:jobId/steps - Get job steps\n      {\n        method: 'GET',\n        path: WORKFLOW_ROUTES.JOB_STEPS,\n        handler: './rest/job-steps-handler.js#default',\n        describe: 'Get execution steps and progress for a specific job',\n        output: {\n          zod: '@kb-labs/workflow-contracts#JobStepsResponseSchema',\n        },\n      },\n      // POST /workflows/jobs/:jobId/cancel - Cancel job\n      {\n        method: 'POST',\n        path: WORKFLOW_ROUTES.JOB_CANCEL,\n        handler: './rest/job-cancel-handler.js#default',\n        describe: 'Cancel a running or pending job',\n        output: {\n          zod: '@kb-labs/workflow-contracts#JobCancelResponseSchema',\n        },\n      },\n      // GET /workflows/cron - List cron jobs\n      {\n        method: 'GET',\n        path: WORKFLOW_ROUTES.CRON,\n        handler: './rest/cron-list-handler.js#default',\n        describe: 'List all registered cron jobs',\n        output: {\n          zod: '@kb-labs/workflow-contracts#CronListResponseSchema',\n        },\n      },\n      // GET /runs/:runId/pending-approvals - List pending approvals\n      {\n        method: 'GET',\n        path: WORKFLOW_ROUTES.PENDING_APPROVALS,\n        handler: './rest/pending-approvals-handler.js#default',\n        describe: 'List steps waiting for approval in a workflow run',\n      },\n      // POST /runs/:runId/approve - Resolve approval\n      {\n        method: 'POST',\n        path: WORKFLOW_ROUTES.RESOLVE_APPROVAL,\n        handler: './rest/resolve-approval-handler.js#default',\n        describe: 'Approve or reject a pending approval step',\n      },\n    ],\n  },\n\n  // WebSocket channels for real-time updates\n  ws: {\n    basePath: '/v1/ws/plugins/workflow',\n    defaults: {\n      timeoutMs: 600000, // 10 minutes\n      maxMessageSize: 1048576, // 1MB\n      auth: 'none',\n      idleTimeoutMs: 300000, // 5 minutes\n    },\n    channels: [\n      {\n        path: '/logs/:jobId',\n        handler: './ws/logs-channel.js#default',\n        description: 'Real-time job logs streaming',\n      },\n      {\n        path: '/progress/:jobId',\n        handler: './ws/progress-channel.js#default',\n        description: 'Real-time job progress updates',\n      },\n    ],\n  },\n\n  permissions: pluginPermissions,\n};\n"]}