octoflow-core 1.0.0

package/dist/cli/commands/dev.js

@@ -0,0 +1,83 @@
+import { createA2AServer } from "../../adapters/transport/server.js";
+import { errorToExitCode } from "../contracts/errors.js";
+import { printOutput } from "../format/output.js";
+import { buildFrameworkManifest } from "../framework-workspace.js";
+import {
+  parseInteger,
+  resolveCliFrameworkWorkspaceOptions,
+  resolveCliServerRuntimeOptions
+} from "../lifecycle/runtime-options.js";
+import {
+  isServerNotRunningError,
+  listenOnServer,
+  waitForServerExit
+} from "../lifecycle/server-listen.js";
+function registerDevCommand(program) {
+  program.command("dev").description(
+    "Build the framework manifest and start a local A2A development server"
+  ).option("--dir <path>", "workspace directory for agents, roles, and skills").option("--out <path>", "output directory for build artifacts").option("--host <host>", "bind host").option("--port <port>", "bind port", parseInteger).option("--json", "output startup details as JSON", false).action(
+    async (opts) => {
+      const workspace = resolveCliFrameworkWorkspaceOptions(program, opts, {
+        dir: ".octoflow",
+        outDir: ".octoflow/dist"
+      });
+      const runtime = resolveCliServerRuntimeOptions(program, opts, {
+        host: "127.0.0.1",
+        port: 3583
+      });
+      let handle = null;
+      try {
+        const manifest = await buildFrameworkManifest({
+          dir: workspace.dir,
+          outDir: workspace.outDir ?? ".octoflow/dist"
+        });
+        handle = await createA2AServer({
+          config: runtime.config,
+          host: runtime.host,
+          port: runtime.port
+        });
+        await listenOnServer(handle.server, runtime.host, runtime.port);
+        printOutput(
+          {
+            agents: manifest.agents.length,
+            manifestPath: manifest.manifestPath,
+            url: handle.url,
+            workspaceDir: manifest.workspaceDir
+          },
+          { json: opts.json, label: "Dev" }
+        );
+        const signal = runtime.signal;
+        if (signal) {
+          signal.addEventListener(
+            "abort",
+            () => {
+              process.stdout.write("Shutting down...\\n");
+              void handle?.close();
+            },
+            { once: true }
+          );
+        }
+        const exitError = await waitForServerExit(handle.server);
+        if (exitError) throw exitError;
+      } catch (error) {
+        process.exitCode = errorToExitCode(error);
+        printOutput(
+          { error: error instanceof Error ? error.message : String(error) },
+          { json: opts.json, label: "Error" }
+        );
+      } finally {
+        await handle?.close().catch((error) => {
+          if (!isServerNotRunningError(error)) {
+            process.stderr.write(
+              `Dev server cleanup error: ${error instanceof Error ? error.message : String(error)}\\n`
+            );
+          }
+        });
+      }
+    }
+  );
+}
+export {
+  registerDevCommand
+};
+//# sourceMappingURL=dev.js.map

package/dist/cli/commands/dev.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/cli/commands/dev.ts"],
+  "sourcesContent": ["import type { Command } from 'commander';\n\nimport { createA2AServer } from '../../adapters/transport/server.js';\nimport { errorToExitCode } from '../contracts/errors.js';\nimport { printOutput } from '../format/output.js';\nimport { buildFrameworkManifest } from '../framework-workspace.js';\nimport {\n  parseInteger,\n  resolveCliFrameworkWorkspaceOptions,\n  resolveCliServerRuntimeOptions,\n} from '../lifecycle/runtime-options.js';\nimport {\n  isServerNotRunningError,\n  listenOnServer,\n  waitForServerExit,\n} from '../lifecycle/server-listen.js';\n\nexport function registerDevCommand(program: Command): void {\n  program\n    .command('dev')\n    .description(\n      'Build the framework manifest and start a local A2A development server'\n    )\n    .option('--dir <path>', 'workspace directory for agents, roles, and skills')\n    .option('--out <path>', 'output directory for build artifacts')\n    .option('--host <host>', 'bind host')\n    .option('--port <port>', 'bind port', parseInteger)\n    .option('--json', 'output startup details as JSON', false)\n    .action(\n      async (opts: {\n        dir?: string;\n        host?: string;\n        json: boolean;\n        out?: string;\n        port?: number;\n      }) => {\n        const workspace = resolveCliFrameworkWorkspaceOptions(program, opts, {\n          dir: '.octoflow',\n          outDir: '.octoflow/dist',\n        });\n        const runtime = resolveCliServerRuntimeOptions(program, opts, {\n          host: '127.0.0.1',\n          port: 3583,\n        });\n        let handle: Awaited<ReturnType<typeof createA2AServer>> | null = null;\n\n        try {\n          const manifest = await buildFrameworkManifest({\n            dir: workspace.dir,\n            outDir: workspace.outDir ?? '.octoflow/dist',\n          });\n\n          handle = await createA2AServer({\n            config: runtime.config,\n            host: runtime.host,\n            port: runtime.port,\n          });\n\n          await listenOnServer(handle.server, runtime.host, runtime.port);\n          printOutput(\n            {\n              agents: manifest.agents.length,\n              manifestPath: manifest.manifestPath,\n              url: handle.url,\n              workspaceDir: manifest.workspaceDir,\n            },\n            { json: opts.json, label: 'Dev' }\n          );\n\n          const signal: AbortSignal | undefined = runtime.signal;\n          if (signal) {\n            signal.addEventListener(\n              'abort',\n              () => {\n                process.stdout.write('Shutting down...\\\\n');\n                void handle?.close();\n              },\n              { once: true }\n            );\n          }\n\n          const exitError = await waitForServerExit(handle.server);\n          if (exitError) throw exitError;\n        } catch (error) {\n          process.exitCode = errorToExitCode(error);\n          printOutput(\n            { error: error instanceof Error ? error.message : String(error) },\n            { json: opts.json, label: 'Error' }\n          );\n        } finally {\n          await handle?.close().catch((error) => {\n            if (!isServerNotRunningError(error)) {\n              process.stderr.write(\n                `Dev server cleanup error: ${error instanceof Error ? error.message : String(error)}\\\\n`\n              );\n            }\n          });\n        }\n      }\n    );\n}\n"],
+  "mappings": "AAEA,SAAS,uBAAuB;AAChC,SAAS,uBAAuB;AAChC,SAAS,mBAAmB;AAC5B,SAAS,8BAA8B;AACvC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,SAAS,mBAAmB,SAAwB;AACzD,UACG,QAAQ,KAAK,EACb;AAAA,IACC;AAAA,EACF,EACC,OAAO,gBAAgB,mDAAmD,EAC1E,OAAO,gBAAgB,sCAAsC,EAC7D,OAAO,iBAAiB,WAAW,EACnC,OAAO,iBAAiB,aAAa,YAAY,EACjD,OAAO,UAAU,kCAAkC,KAAK,EACxD;AAAA,IACC,OAAO,SAMD;AACJ,YAAM,YAAY,oCAAoC,SAAS,MAAM;AAAA,QACnE,KAAK;AAAA,QACL,QAAQ;AAAA,MACV,CAAC;AACD,YAAM,UAAU,+BAA+B,SAAS,MAAM;AAAA,QAC5D,MAAM;AAAA,QACN,MAAM;AAAA,MACR,CAAC;AACD,UAAI,SAA6D;AAEjE,UAAI;AACF,cAAM,WAAW,MAAM,uBAAuB;AAAA,UAC5C,KAAK,UAAU;AAAA,UACf,QAAQ,UAAU,UAAU;AAAA,QAC9B,CAAC;AAED,iBAAS,MAAM,gBAAgB;AAAA,UAC7B,QAAQ,QAAQ;AAAA,UAChB,MAAM,QAAQ;AAAA,UACd,MAAM,QAAQ;AAAA,QAChB,CAAC;AAED,cAAM,eAAe,OAAO,QAAQ,QAAQ,MAAM,QAAQ,IAAI;AAC9D;AAAA,UACE;AAAA,YACE,QAAQ,SAAS,OAAO;AAAA,YACxB,cAAc,SAAS;AAAA,YACvB,KAAK,OAAO;AAAA,YACZ,cAAc,SAAS;AAAA,UACzB;AAAA,UACA,EAAE,MAAM,KAAK,MAAM,OAAO,MAAM;AAAA,QAClC;AAEA,cAAM,SAAkC,QAAQ;AAChD,YAAI,QAAQ;AACV,iBAAO;AAAA,YACL;AAAA,YACA,MAAM;AACJ,sBAAQ,OAAO,MAAM,qBAAqB;AAC1C,mBAAK,QAAQ,MAAM;AAAA,YACrB;AAAA,YACA,EAAE,MAAM,KAAK;AAAA,UACf;AAAA,QACF;AAEA,cAAM,YAAY,MAAM,kBAAkB,OAAO,MAAM;AACvD,YAAI,UAAW,OAAM;AAAA,MACvB,SAAS,OAAO;AACd,gBAAQ,WAAW,gBAAgB,KAAK;AACxC;AAAA,UACE,EAAE,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,EAAE;AAAA,UAChE,EAAE,MAAM,KAAK,MAAM,OAAO,QAAQ;AAAA,QACpC;AAAA,MACF,UAAE;AACA,cAAM,QAAQ,MAAM,EAAE,MAAM,CAAC,UAAU;AACrC,cAAI,CAAC,wBAAwB,KAAK,GAAG;AACnC,oBAAQ,OAAO;AAAA,cACb,6BAA6B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,YACrF;AAAA,UACF;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AACJ;",
+  "names": []
+}

package/dist/cli/commands/doctor.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerDoctorCommand(program: Command): void;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoCzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwE5D"}

package/dist/cli/commands/doctor.js

@@ -0,0 +1,97 @@
+import { createInterface } from "node:readline";
+import {
+  DEFAULT_PRIORITY,
+  resolveConfig,
+  resolveProfile
+} from "../../config/config.js";
+import { runBackendCheck } from "../checks/backend-check.js";
+import { runCapabilityChecks } from "../checks/capability-check.js";
+import { runConfigCheck } from "../checks/config-check.js";
+import { runDeploymentCheck } from "../checks/deployment-check.js";
+import { runNetworkCheck } from "../checks/network-check.js";
+import { runProfileCheck } from "../checks/profile-check.js";
+import { printOutput } from "../format/output.js";
+function confirmRepair(name) {
+  return new Promise((resolve) => {
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+    rl.question(`Repair "${name}"? [y/N] `, (answer) => {
+      rl.close();
+      resolve(answer.trim().toLowerCase() === "y");
+    });
+  });
+}
+const STATUS_ICON = {
+  pass: "\u2705",
+  warn: "\u26A0\uFE0F",
+  fail: "\u274C"
+};
+function registerDoctorCommand(program) {
+  program.command("doctor").description("Run diagnostic checks across all connection families").option("--json", "output as JSON", false).option("--repair", "attempt to repair failed checks", false).option("--yes", "skip repair confirmation prompts", false).action(async (opts) => {
+    const globalOpts = program.opts();
+    const config = globalOpts._resolvedConfig ?? void 0;
+    const resolved = resolveConfig(config);
+    const profile = resolveProfile(globalOpts.profile, resolved);
+    const priority = profile.priority ?? DEFAULT_PRIORITY;
+    const allChecks = [];
+    allChecks.push(runConfigCheck());
+    allChecks.push(...await runBackendCheck(priority));
+    allChecks.push(runProfileCheck(config));
+    allChecks.push(...runCapabilityChecks(config));
+    allChecks.push(runDeploymentCheck(config));
+    allChecks.push(...await runNetworkCheck());
+    if (opts.repair) {
+      for (const check of allChecks) {
+        if (check.status === "fail" && check.canRepair && check.repair) {
+          if (!opts.yes && !opts.json) {
+            const confirmed = await confirmRepair(check.name);
+            if (!confirmed) continue;
+          }
+          if (!opts.json) {
+            process.stdout.write(`Repairing: ${check.name}...
+`);
+          }
+          await check.repair();
+          check.status = "pass";
+          check.message = `Repaired: ${check.message}`;
+        }
+      }
+    }
+    const summary = {
+      passed: allChecks.filter((c) => c.status === "pass").length,
+      warned: allChecks.filter((c) => c.status === "warn").length,
+      failed: allChecks.filter((c) => c.status === "fail").length
+    };
+    if (opts.json) {
+      printOutput(
+        {
+          checks: allChecks.map(({ repair: _repair, ...rest }) => rest),
+          summary
+        },
+        { json: true }
+      );
+    } else {
+      for (const check of allChecks) {
+        const icon = STATUS_ICON[check.status];
+        process.stdout.write(`${icon} ${check.name}: ${check.message}
+`);
+        if (check.repairHint && check.status !== "pass") {
+          process.stdout.write(`   hint: ${check.repairHint}
+`);
+        }
+      }
+      process.stdout.write(
+        `
+${summary.passed} passed, ${summary.warned} warned, ${summary.failed} failed
+`
+      );
+    }
+    if (summary.failed > 0) process.exitCode = 1;
+  });
+}
+export {
+  registerDoctorCommand
+};
+//# sourceMappingURL=doctor.js.map

package/dist/cli/commands/doctor.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/cli/commands/doctor.ts"],
+  "sourcesContent": ["import { createInterface } from 'node:readline';\n\nimport type { Command } from 'commander';\n\nimport type { OctoFlowConfig } from '../../config/config.js';\nimport {\n  DEFAULT_PRIORITY,\n  resolveConfig,\n  resolveProfile,\n} from '../../config/config.js';\nimport { runBackendCheck } from '../checks/backend-check.js';\nimport { runCapabilityChecks } from '../checks/capability-check.js';\nimport { runConfigCheck } from '../checks/config-check.js';\nimport { runDeploymentCheck } from '../checks/deployment-check.js';\nimport { runNetworkCheck } from '../checks/network-check.js';\nimport { runProfileCheck } from '../checks/profile-check.js';\nimport type { CheckResult } from '../contracts/check-result.js';\nimport { printOutput } from '../format/output.js';\n\nfunction confirmRepair(name: string): Promise<boolean> {\n  return new Promise((resolve) => {\n    const rl = createInterface({\n      input: process.stdin,\n      output: process.stdout,\n    });\n    rl.question(`Repair \"${name}\"? [y/N] `, (answer) => {\n      rl.close();\n      resolve(answer.trim().toLowerCase() === 'y');\n    });\n  });\n}\n\nconst STATUS_ICON: Record<CheckResult['status'], string> = {\n  pass: '\\u2705',\n  warn: '\\u26A0\\uFE0F',\n  fail: '\\u274C',\n};\n\nexport function registerDoctorCommand(program: Command): void {\n  program\n    .command('doctor')\n    .description('Run diagnostic checks across all connection families')\n    .option('--json', 'output as JSON', false)\n    .option('--repair', 'attempt to repair failed checks', false)\n    .option('--yes', 'skip repair confirmation prompts', false)\n    .action(async (opts: { json: boolean; repair: boolean; yes: boolean }) => {\n      const globalOpts = program.opts<{\n        _resolvedConfig?: OctoFlowConfig | null;\n        profile?: string;\n      }>();\n      const config = globalOpts._resolvedConfig ?? undefined;\n      const resolved = resolveConfig(config);\n      const profile = resolveProfile(globalOpts.profile, resolved);\n      const priority = profile.priority ?? DEFAULT_PRIORITY;\n\n      const allChecks: CheckResult[] = [];\n\n      allChecks.push(runConfigCheck());\n      allChecks.push(...(await runBackendCheck(priority)));\n      allChecks.push(runProfileCheck(config));\n      allChecks.push(...runCapabilityChecks(config));\n      allChecks.push(runDeploymentCheck(config));\n      allChecks.push(...(await runNetworkCheck()));\n\n      if (opts.repair) {\n        for (const check of allChecks) {\n          if (check.status === 'fail' && check.canRepair && check.repair) {\n            if (!opts.yes && !opts.json) {\n              const confirmed = await confirmRepair(check.name);\n              if (!confirmed) continue;\n            }\n            if (!opts.json) {\n              process.stdout.write(`Repairing: ${check.name}...\\n`);\n            }\n            await check.repair();\n            check.status = 'pass';\n            check.message = `Repaired: ${check.message}`;\n          }\n        }\n      }\n\n      const summary = {\n        passed: allChecks.filter((c) => c.status === 'pass').length,\n        warned: allChecks.filter((c) => c.status === 'warn').length,\n        failed: allChecks.filter((c) => c.status === 'fail').length,\n      };\n\n      if (opts.json) {\n        printOutput(\n          {\n            checks: allChecks.map(({ repair: _repair, ...rest }) => rest),\n            summary,\n          },\n          { json: true }\n        );\n      } else {\n        for (const check of allChecks) {\n          const icon = STATUS_ICON[check.status];\n          process.stdout.write(`${icon} ${check.name}: ${check.message}\\n`);\n          if (check.repairHint && check.status !== 'pass') {\n            process.stdout.write(`   hint: ${check.repairHint}\\n`);\n          }\n        }\n        process.stdout.write(\n          `\\n${summary.passed} passed, ${summary.warned} warned, ${summary.failed} failed\\n`\n        );\n      }\n\n      if (summary.failed > 0) process.exitCode = 1;\n    });\n}\n"],
+  "mappings": "AAAA,SAAS,uBAAuB;AAKhC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,uBAAuB;AAChC,SAAS,2BAA2B;AACpC,SAAS,sBAAsB;AAC/B,SAAS,0BAA0B;AACnC,SAAS,uBAAuB;AAChC,SAAS,uBAAuB;AAEhC,SAAS,mBAAmB;AAE5B,SAAS,cAAc,MAAgC;AACrD,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,KAAK,gBAAgB;AAAA,MACzB,OAAO,QAAQ;AAAA,MACf,QAAQ,QAAQ;AAAA,IAClB,CAAC;AACD,OAAG,SAAS,WAAW,IAAI,aAAa,CAAC,WAAW;AAClD,SAAG,MAAM;AACT,cAAQ,OAAO,KAAK,EAAE,YAAY,MAAM,GAAG;AAAA,IAC7C,CAAC;AAAA,EACH,CAAC;AACH;AAEA,MAAM,cAAqD;AAAA,EACzD,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AACR;AAEO,SAAS,sBAAsB,SAAwB;AAC5D,UACG,QAAQ,QAAQ,EAChB,YAAY,sDAAsD,EAClE,OAAO,UAAU,kBAAkB,KAAK,EACxC,OAAO,YAAY,mCAAmC,KAAK,EAC3D,OAAO,SAAS,oCAAoC,KAAK,EACzD,OAAO,OAAO,SAA2D;AACxE,UAAM,aAAa,QAAQ,KAGxB;AACH,UAAM,SAAS,WAAW,mBAAmB;AAC7C,UAAM,WAAW,cAAc,MAAM;AACrC,UAAM,UAAU,eAAe,WAAW,SAAS,QAAQ;AAC3D,UAAM,WAAW,QAAQ,YAAY;AAErC,UAAM,YAA2B,CAAC;AAElC,cAAU,KAAK,eAAe,CAAC;AAC/B,cAAU,KAAK,GAAI,MAAM,gBAAgB,QAAQ,CAAE;AACnD,cAAU,KAAK,gBAAgB,MAAM,CAAC;AACtC,cAAU,KAAK,GAAG,oBAAoB,MAAM,CAAC;AAC7C,cAAU,KAAK,mBAAmB,MAAM,CAAC;AACzC,cAAU,KAAK,GAAI,MAAM,gBAAgB,CAAE;AAE3C,QAAI,KAAK,QAAQ;AACf,iBAAW,SAAS,WAAW;AAC7B,YAAI,MAAM,WAAW,UAAU,MAAM,aAAa,MAAM,QAAQ;AAC9D,cAAI,CAAC,KAAK,OAAO,CAAC,KAAK,MAAM;AAC3B,kBAAM,YAAY,MAAM,cAAc,MAAM,IAAI;AAChD,gBAAI,CAAC,UAAW;AAAA,UAClB;AACA,cAAI,CAAC,KAAK,MAAM;AACd,oBAAQ,OAAO,MAAM,cAAc,MAAM,IAAI;AAAA,CAAO;AAAA,UACtD;AACA,gBAAM,MAAM,OAAO;AACnB,gBAAM,SAAS;AACf,gBAAM,UAAU,aAAa,MAAM,OAAO;AAAA,QAC5C;AAAA,MACF;AAAA,IACF;AAEA,UAAM,UAAU;AAAA,MACd,QAAQ,UAAU,OAAO,CAAC,MAAM,EAAE,WAAW,MAAM,EAAE;AAAA,MACrD,QAAQ,UAAU,OAAO,CAAC,MAAM,EAAE,WAAW,MAAM,EAAE;AAAA,MACrD,QAAQ,UAAU,OAAO,CAAC,MAAM,EAAE,WAAW,MAAM,EAAE;AAAA,IACvD;AAEA,QAAI,KAAK,MAAM;AACb;AAAA,QACE;AAAA,UACE,QAAQ,UAAU,IAAI,CAAC,EAAE,QAAQ,SAAS,GAAG,KAAK,MAAM,IAAI;AAAA,UAC5D;AAAA,QACF;AAAA,QACA,EAAE,MAAM,KAAK;AAAA,MACf;AAAA,IACF,OAAO;AACL,iBAAW,SAAS,WAAW;AAC7B,cAAM,OAAO,YAAY,MAAM,MAAM;AACrC,gBAAQ,OAAO,MAAM,GAAG,IAAI,IAAI,MAAM,IAAI,KAAK,MAAM,OAAO;AAAA,CAAI;AAChE,YAAI,MAAM,cAAc,MAAM,WAAW,QAAQ;AAC/C,kBAAQ,OAAO,MAAM,YAAY,MAAM,UAAU;AAAA,CAAI;AAAA,QACvD;AAAA,MACF;AACA,cAAQ,OAAO;AAAA,QACb;AAAA,EAAK,QAAQ,MAAM,YAAY,QAAQ,MAAM,YAAY,QAAQ,MAAM;AAAA;AAAA,MACzE;AAAA,IACF;AAEA,QAAI,QAAQ,SAAS,EAAG,SAAQ,WAAW;AAAA,EAC7C,CAAC;AACL;",
+  "names": []
+}

package/dist/cli/commands/env.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerEnvCommand(program: Command): void;
+//# sourceMappingURL=env.d.ts.map

package/dist/cli/commands/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0CzC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+BzD"}

package/dist/cli/commands/env.js

@@ -0,0 +1,47 @@
+import {
+  DEFAULT_PRIORITY,
+  resolveConfig,
+  resolveProfile
+} from "../../config/config.js";
+import { discoverEnv } from "../../config/env-registry.js";
+import { printOutput } from "../format/output.js";
+function collectEnvEntries(priority) {
+  const prioritySet = new Set(priority);
+  const discovered = discoverEnv();
+  return discovered.filter((d) => d.category !== "metadata").filter(
+    (d) => d.backends.length === 0 || d.backends.some((b) => prioritySet.has(b))
+  ).map((d) => ({
+    key: d.key,
+    value: d.value,
+    source: d.source === "process.env" ? "env" : "unset",
+    required: d.required,
+    backendScope: d.backends.filter((b) => prioritySet.has(b)),
+    category: d.category
+  }));
+}
+function registerEnvCommand(program) {
+  program.command("env").description("Show environment variable status for configured backends").option("--json", "output as JSON", false).option("--all", "include metadata vars", false).action((opts) => {
+    const globalOpts = program.opts();
+    const config = resolveConfig(globalOpts._resolvedConfig ?? void 0);
+    const profile = resolveProfile(globalOpts.profile, config);
+    const priority = profile.priority ?? DEFAULT_PRIORITY;
+    if (opts.all) {
+      const all = discoverEnv().map((d) => ({
+        key: d.key,
+        value: d.value,
+        source: d.source === "process.env" ? "env" : "unset",
+        required: d.required,
+        backendScope: d.backends,
+        category: d.category
+      }));
+      printOutput(all, { json: opts.json, label: "Environment (all)" });
+    } else {
+      const entries = collectEnvEntries(priority);
+      printOutput(entries, { json: opts.json, label: "Environment" });
+    }
+  });
+}
+export {
+  registerEnvCommand
+};
+//# sourceMappingURL=env.js.map

package/dist/cli/commands/env.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/cli/commands/env.ts"],
+  "sourcesContent": ["import type { Command } from 'commander';\n\nimport type { OctoFlowConfig } from '../../config/config.js';\nimport {\n  DEFAULT_PRIORITY,\n  resolveConfig,\n  resolveProfile,\n} from '../../config/config.js';\nimport { discoverEnv } from '../../config/env-registry.js';\nimport type { BackendName } from '../../domain/core-client.js';\nimport { printOutput } from '../format/output.js';\n\ninterface EnvEntry {\n  key: string;\n  value: string | null;\n  source: 'env' | 'unset';\n  required: boolean;\n  backendScope: string[];\n  category: string;\n}\n\nfunction collectEnvEntries(priority: BackendName[]): EnvEntry[] {\n  const prioritySet = new Set<string>(priority);\n  const discovered = discoverEnv();\n\n  return discovered\n    .filter((d) => d.category !== 'metadata')\n    .filter(\n      (d) =>\n        d.backends.length === 0 || d.backends.some((b) => prioritySet.has(b))\n    )\n    .map((d) => ({\n      key: d.key,\n      value: d.value,\n      source:\n        d.source === 'process.env' ? ('env' as const) : ('unset' as const),\n      required: d.required,\n      backendScope: d.backends.filter((b) => prioritySet.has(b)),\n      category: d.category,\n    }));\n}\n\nexport function registerEnvCommand(program: Command): void {\n  program\n    .command('env')\n    .description('Show environment variable status for configured backends')\n    .option('--json', 'output as JSON', false)\n    .option('--all', 'include metadata vars', false)\n    .action((opts: { json: boolean; all: boolean }) => {\n      const globalOpts = program.opts<{\n        _resolvedConfig?: OctoFlowConfig | null;\n        profile?: string;\n      }>();\n      const config = resolveConfig(globalOpts._resolvedConfig ?? undefined);\n      const profile = resolveProfile(globalOpts.profile, config);\n      const priority = profile.priority ?? DEFAULT_PRIORITY;\n\n      if (opts.all) {\n        const all = discoverEnv().map((d) => ({\n          key: d.key,\n          value: d.value,\n          source:\n            d.source === 'process.env' ? ('env' as const) : ('unset' as const),\n          required: d.required,\n          backendScope: d.backends,\n          category: d.category,\n        }));\n        printOutput(all, { json: opts.json, label: 'Environment (all)' });\n      } else {\n        const entries = collectEnvEntries(priority);\n        printOutput(entries, { json: opts.json, label: 'Environment' });\n      }\n    });\n}\n"],
+  "mappings": "AAGA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,mBAAmB;AAE5B,SAAS,mBAAmB;AAW5B,SAAS,kBAAkB,UAAqC;AAC9D,QAAM,cAAc,IAAI,IAAY,QAAQ;AAC5C,QAAM,aAAa,YAAY;AAE/B,SAAO,WACJ,OAAO,CAAC,MAAM,EAAE,aAAa,UAAU,EACvC;AAAA,IACC,CAAC,MACC,EAAE,SAAS,WAAW,KAAK,EAAE,SAAS,KAAK,CAAC,MAAM,YAAY,IAAI,CAAC,CAAC;AAAA,EACxE,EACC,IAAI,CAAC,OAAO;AAAA,IACX,KAAK,EAAE;AAAA,IACP,OAAO,EAAE;AAAA,IACT,QACE,EAAE,WAAW,gBAAiB,QAAmB;AAAA,IACnD,UAAU,EAAE;AAAA,IACZ,cAAc,EAAE,SAAS,OAAO,CAAC,MAAM,YAAY,IAAI,CAAC,CAAC;AAAA,IACzD,UAAU,EAAE;AAAA,EACd,EAAE;AACN;AAEO,SAAS,mBAAmB,SAAwB;AACzD,UACG,QAAQ,KAAK,EACb,YAAY,0DAA0D,EACtE,OAAO,UAAU,kBAAkB,KAAK,EACxC,OAAO,SAAS,yBAAyB,KAAK,EAC9C,OAAO,CAAC,SAA0C;AACjD,UAAM,aAAa,QAAQ,KAGxB;AACH,UAAM,SAAS,cAAc,WAAW,mBAAmB,MAAS;AACpE,UAAM,UAAU,eAAe,WAAW,SAAS,MAAM;AACzD,UAAM,WAAW,QAAQ,YAAY;AAErC,QAAI,KAAK,KAAK;AACZ,YAAM,MAAM,YAAY,EAAE,IAAI,CAAC,OAAO;AAAA,QACpC,KAAK,EAAE;AAAA,QACP,OAAO,EAAE;AAAA,QACT,QACE,EAAE,WAAW,gBAAiB,QAAmB;AAAA,QACnD,UAAU,EAAE;AAAA,QACZ,cAAc,EAAE;AAAA,QAChB,UAAU,EAAE;AAAA,MACd,EAAE;AACF,kBAAY,KAAK,EAAE,MAAM,KAAK,MAAM,OAAO,oBAAoB,CAAC;AAAA,IAClE,OAAO;AACL,YAAM,UAAU,kBAAkB,QAAQ;AAC1C,kBAAY,SAAS,EAAE,MAAM,KAAK,MAAM,OAAO,cAAc,CAAC;AAAA,IAChE;AAAA,EACF,CAAC;AACL;",
+  "names": []
+}

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerInitCommand(program: Command): void;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0B1D"}

package/dist/cli/commands/init.js

@@ -0,0 +1,28 @@
+import { errorToExitCode } from "../contracts/errors.js";
+import { printOutput } from "../format/output.js";
+import { initFrameworkWorkspace } from "../framework-workspace.js";
+import { resolveCliFrameworkWorkspaceOptions } from "../lifecycle/runtime-options.js";
+function registerInitCommand(program) {
+  program.command("init").description("Scaffold a framework-mode OctoFlow workspace").option("--dir <path>", "workspace directory for agents, roles, and skills").option("--force", "overwrite existing scaffold files", false).option("--json", "output as JSON", false).action(async (opts) => {
+    try {
+      const workspace = resolveCliFrameworkWorkspaceOptions(program, opts, {
+        dir: ".octoflow"
+      });
+      const result = await initFrameworkWorkspace({
+        dir: workspace.dir,
+        force: opts.force
+      });
+      printOutput(result, { json: opts.json, label: "Initialized" });
+    } catch (error) {
+      process.exitCode = errorToExitCode(error);
+      printOutput(
+        { error: error instanceof Error ? error.message : String(error) },
+        { json: opts.json, label: "Error" }
+      );
+    }
+  });
+}
+export {
+  registerInitCommand
+};
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/cli/commands/init.ts"],
+  "sourcesContent": ["import type { Command } from 'commander';\n\nimport { errorToExitCode } from '../contracts/errors.js';\nimport { printOutput } from '../format/output.js';\nimport { initFrameworkWorkspace } from '../framework-workspace.js';\nimport { resolveCliFrameworkWorkspaceOptions } from '../lifecycle/runtime-options.js';\n\nexport function registerInitCommand(program: Command): void {\n  program\n    .command('init')\n    .description('Scaffold a framework-mode OctoFlow workspace')\n    .option('--dir <path>', 'workspace directory for agents, roles, and skills')\n    .option('--force', 'overwrite existing scaffold files', false)\n    .option('--json', 'output as JSON', false)\n    .action(async (opts: { dir?: string; force: boolean; json: boolean }) => {\n      try {\n        const workspace = resolveCliFrameworkWorkspaceOptions(program, opts, {\n          dir: '.octoflow',\n        });\n        const result = await initFrameworkWorkspace({\n          dir: workspace.dir,\n          force: opts.force,\n        });\n\n        printOutput(result, { json: opts.json, label: 'Initialized' });\n      } catch (error) {\n        process.exitCode = errorToExitCode(error);\n        printOutput(\n          { error: error instanceof Error ? error.message : String(error) },\n          { json: opts.json, label: 'Error' }\n        );\n      }\n    });\n}\n"],
+  "mappings": "AAEA,SAAS,uBAAuB;AAChC,SAAS,mBAAmB;AAC5B,SAAS,8BAA8B;AACvC,SAAS,2CAA2C;AAE7C,SAAS,oBAAoB,SAAwB;AAC1D,UACG,QAAQ,MAAM,EACd,YAAY,8CAA8C,EAC1D,OAAO,gBAAgB,mDAAmD,EAC1E,OAAO,WAAW,qCAAqC,KAAK,EAC5D,OAAO,UAAU,kBAAkB,KAAK,EACxC,OAAO,OAAO,SAA0D;AACvE,QAAI;AACF,YAAM,YAAY,oCAAoC,SAAS,MAAM;AAAA,QACnE,KAAK;AAAA,MACP,CAAC;AACD,YAAM,SAAS,MAAM,uBAAuB;AAAA,QAC1C,KAAK,UAAU;AAAA,QACf,OAAO,KAAK;AAAA,MACd,CAAC;AAED,kBAAY,QAAQ,EAAE,MAAM,KAAK,MAAM,OAAO,cAAc,CAAC;AAAA,IAC/D,SAAS,OAAO;AACd,cAAQ,WAAW,gBAAgB,KAAK;AACxC;AAAA,QACE,EAAE,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,EAAE;AAAA,QAChE,EAAE,MAAM,KAAK,MAAM,OAAO,QAAQ;AAAA,MACpC;AAAA,IACF;AAAA,EACF,CAAC;AACL;",
+  "names": []
+}

package/dist/cli/commands/inspect.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerInspectCommand(program: Command): void;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/cli/commands/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAezC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuC7D"}

package/dist/cli/commands/inspect.js

@@ -0,0 +1,64 @@
+import {
+  buildCliFeatureMatrix,
+  BUILT_IN_CLI_DESCRIPTORS
+} from "../../adapters/agents/backends/cli-feature-matrix.js";
+import {
+  DEFAULT_PRIORITY,
+  resolveConfig,
+  resolveProfile
+} from "../../config/config.js";
+import { inspect } from "../adapters/bridge-facade.js";
+import { printOutput } from "../format/output.js";
+function registerInspectCommand(program) {
+  program.command("inspect").description("Inspect backend readiness across all connection families").argument(
+    "[backend]",
+    "Backend name (e.g. claude-code-cli). Required when --features is set."
+  ).option("--json", "output as JSON", false).option(
+    "--features",
+    "show the feature support matrix for the chosen CLI backend (or all CLI backends when no backend is given)",
+    false
+  ).action(
+    async (backend, opts) => {
+      if (opts.features) {
+        const matrix = buildCliFeatureMatrix(BUILT_IN_CLI_DESCRIPTORS);
+        const view = backend ? renderSingleBackendMatrix(matrix, backend) : renderFullMatrix(matrix);
+        printOutput(view, { json: opts.json, label: "CLI features" });
+        return;
+      }
+      const globalOpts = program.opts();
+      const config = resolveConfig(globalOpts._resolvedConfig ?? void 0);
+      const profile = resolveProfile(globalOpts.profile, config);
+      const priority = profile.priority ?? DEFAULT_PRIORITY;
+      const result = await inspect({ priority });
+      printOutput(result, { json: opts.json, label: "Backends" });
+    }
+  );
+}
+function renderSingleBackendMatrix(matrix, backend) {
+  if (!matrix.backends.includes(backend)) {
+    return {
+      error: `Unknown CLI backend "${backend}". Known: ${matrix.backends.join(", ")}.`
+    };
+  }
+  const supported = matrix.features.filter((f) => matrix.supports(backend, f));
+  const unsupported = [...matrix.unsupportedFor(backend)];
+  return { backend, supported, unsupported };
+}
+function renderFullMatrix(matrix) {
+  const support = {};
+  for (const backend of matrix.backends) {
+    support[backend] = {};
+    for (const feature of matrix.features) {
+      support[backend][feature] = matrix.supports(backend, feature);
+    }
+  }
+  return {
+    backends: matrix.backends,
+    features: matrix.features,
+    support
+  };
+}
+export {
+  registerInspectCommand
+};
+//# sourceMappingURL=inspect.js.map

package/dist/cli/commands/inspect.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/cli/commands/inspect.ts"],
+  "sourcesContent": ["import type { Command } from 'commander';\n\nimport {\n  buildCliFeatureMatrix,\n  BUILT_IN_CLI_DESCRIPTORS,\n} from '../../adapters/agents/backends/cli-feature-matrix.js';\nimport type { OctoFlowConfig } from '../../config/config.js';\nimport {\n  DEFAULT_PRIORITY,\n  resolveConfig,\n  resolveProfile,\n} from '../../config/config.js';\nimport { inspect } from '../adapters/bridge-facade.js';\nimport { printOutput } from '../format/output.js';\n\nexport function registerInspectCommand(program: Command): void {\n  program\n    .command('inspect')\n    .description('Inspect backend readiness across all connection families')\n    .argument(\n      '[backend]',\n      'Backend name (e.g. claude-code-cli). Required when --features is set.'\n    )\n    .option('--json', 'output as JSON', false)\n    .option(\n      '--features',\n      'show the feature support matrix for the chosen CLI backend (or all CLI backends when no backend is given)',\n      false\n    )\n    .action(\n      async (\n        backend: string | undefined,\n        opts: { json: boolean; features: boolean }\n      ) => {\n        if (opts.features) {\n          const matrix = buildCliFeatureMatrix(BUILT_IN_CLI_DESCRIPTORS);\n          const view = backend\n            ? renderSingleBackendMatrix(matrix, backend)\n            : renderFullMatrix(matrix);\n          printOutput(view, { json: opts.json, label: 'CLI features' });\n          return;\n        }\n\n        const globalOpts = program.opts<{\n          _resolvedConfig?: OctoFlowConfig | null;\n          profile?: string;\n        }>();\n        const config = resolveConfig(globalOpts._resolvedConfig ?? undefined);\n        const profile = resolveProfile(globalOpts.profile, config);\n        const priority = profile.priority ?? DEFAULT_PRIORITY;\n        const result = await inspect({ priority });\n        printOutput(result, { json: opts.json, label: 'Backends' });\n      }\n    );\n}\n\nfunction renderSingleBackendMatrix(\n  matrix: ReturnType<typeof buildCliFeatureMatrix>,\n  backend: string\n):\n  | { backend: string; supported: string[]; unsupported: string[] }\n  | { error: string } {\n  if (!matrix.backends.includes(backend)) {\n    return {\n      error: `Unknown CLI backend \"${backend}\". Known: ${matrix.backends.join(', ')}.`,\n    };\n  }\n  const supported = matrix.features.filter((f) => matrix.supports(backend, f));\n  const unsupported = [...matrix.unsupportedFor(backend)];\n  return { backend, supported, unsupported };\n}\n\nfunction renderFullMatrix(matrix: ReturnType<typeof buildCliFeatureMatrix>): {\n  backends: readonly string[];\n  features: readonly string[];\n  support: Record<string, Record<string, boolean>>;\n} {\n  const support: Record<string, Record<string, boolean>> = {};\n  for (const backend of matrix.backends) {\n    support[backend] = {};\n    for (const feature of matrix.features) {\n      support[backend][feature] = matrix.supports(backend, feature);\n    }\n  }\n  return {\n    backends: matrix.backends,\n    features: matrix.features,\n    support,\n  };\n}\n"],
+  "mappings": "AAEA;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,eAAe;AACxB,SAAS,mBAAmB;AAErB,SAAS,uBAAuB,SAAwB;AAC7D,UACG,QAAQ,SAAS,EACjB,YAAY,0DAA0D,EACtE;AAAA,IACC;AAAA,IACA;AAAA,EACF,EACC,OAAO,UAAU,kBAAkB,KAAK,EACxC;AAAA,IACC;AAAA,IACA;AAAA,IACA;AAAA,EACF,EACC;AAAA,IACC,OACE,SACA,SACG;AACH,UAAI,KAAK,UAAU;AACjB,cAAM,SAAS,sBAAsB,wBAAwB;AAC7D,cAAM,OAAO,UACT,0BAA0B,QAAQ,OAAO,IACzC,iBAAiB,MAAM;AAC3B,oBAAY,MAAM,EAAE,MAAM,KAAK,MAAM,OAAO,eAAe,CAAC;AAC5D;AAAA,MACF;AAEA,YAAM,aAAa,QAAQ,KAGxB;AACH,YAAM,SAAS,cAAc,WAAW,mBAAmB,MAAS;AACpE,YAAM,UAAU,eAAe,WAAW,SAAS,MAAM;AACzD,YAAM,WAAW,QAAQ,YAAY;AACrC,YAAM,SAAS,MAAM,QAAQ,EAAE,SAAS,CAAC;AACzC,kBAAY,QAAQ,EAAE,MAAM,KAAK,MAAM,OAAO,WAAW,CAAC;AAAA,IAC5D;AAAA,EACF;AACJ;AAEA,SAAS,0BACP,QACA,SAGoB;AACpB,MAAI,CAAC,OAAO,SAAS,SAAS,OAAO,GAAG;AACtC,WAAO;AAAA,MACL,OAAO,wBAAwB,OAAO,aAAa,OAAO,SAAS,KAAK,IAAI,CAAC;AAAA,IAC/E;AAAA,EACF;AACA,QAAM,YAAY,OAAO,SAAS,OAAO,CAAC,MAAM,OAAO,SAAS,SAAS,CAAC,CAAC;AAC3E,QAAM,cAAc,CAAC,GAAG,OAAO,eAAe,OAAO,CAAC;AACtD,SAAO,EAAE,SAAS,WAAW,YAAY;AAC3C;AAEA,SAAS,iBAAiB,QAIxB;AACA,QAAM,UAAmD,CAAC;AAC1D,aAAW,WAAW,OAAO,UAAU;AACrC,YAAQ,OAAO,IAAI,CAAC;AACpB,eAAW,WAAW,OAAO,UAAU;AACrC,cAAQ,OAAO,EAAE,OAAO,IAAI,OAAO,SAAS,SAAS,OAAO;AAAA,IAC9D;AAAA,EACF;AACA,SAAO;AAAA,IACL,UAAU,OAAO;AAAA,IACjB,UAAU,OAAO;AAAA,IACjB;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/cli/commands/run.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerRunCommand(program: Command): void;
+//# sourceMappingURL=run.d.ts.map

package/dist/cli/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAczC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2GzD"}

package/dist/cli/commands/run.js

@@ -0,0 +1,86 @@
+import { createFacadeBridge } from "../adapters/bridge-facade.js";
+import { errorToExitCode } from "../contracts/errors.js";
+import { resolveResumeContext } from "../contracts/resume.js";
+import { printOutput } from "../format/output.js";
+import {
+  collect,
+  parseInteger,
+  resolveCliBridgeRuntimeOptions,
+  resolveCliPermission
+} from "../lifecycle/runtime-options.js";
+function registerRunCommand(program) {
+  program.command("run").description("Send a message and wait for the result").argument("<message>", "The prompt message to send").option("--json", "output as JSON", false).option("--model <model>", "override model selection").option("--mcp-config <path>", "native backend MCP config path").option(
+    "--mcp-server <name=command>",
+    "bridge-managed MCP server; repeatable; value can also be name={...json}",
+    collect
+  ).option(
+    "--skill <path>",
+    "load custom SKILL.md bundle directory or parent directory; repeatable",
+    collect
+  ).option("--context <id>", "context ID for multi-turn").option(
+    "--session-id <id>",
+    "resume session by bridge session ID (ignored when --context is set)"
+  ).option("--timeout <ms>", "timeout in milliseconds", parseInteger).option(
+    "--permission <preset>",
+    "approval preset: allow-all | allow-this-session | ask | deny-all | deny-this-session"
+  ).option(
+    "-y, --yes",
+    "shorthand for --permission allow-this-session (auto-approve only this run)",
+    false
+  ).option(
+    "--always-ask <name>",
+    "force approval prompt for this tool name; repeatable",
+    collect
+  ).action(
+    async (message, opts) => {
+      const runtime = resolveCliBridgeRuntimeOptions(program, opts);
+      const permission = resolveCliPermission(
+        opts,
+        runtime.config,
+        runtime.profile
+      );
+      const bridge = await createFacadeBridge(runtime);
+      try {
+        const result = await bridge.sendMessage({
+          message,
+          ...resolveResumeContext(opts),
+          model: opts.model,
+          profile: runtime.profile,
+          timeoutMs: opts.timeout,
+          signal: runtime.signal,
+          ...permission ? { permission } : {}
+        });
+        if (result.kind === "message") {
+          const text = result.message?.parts?.filter((p) => p.kind === "text").map((p) => p.text).join("") ?? "";
+          printOutput(
+            {
+              contextId: result.contextId,
+              text
+            },
+            { json: opts.json, label: "Result" }
+          );
+        } else {
+          printOutput(
+            {
+              taskId: result.taskId,
+              task: result.task.status?.state
+            },
+            { json: opts.json, label: "Task" }
+          );
+        }
+      } catch (error) {
+        process.exitCode = errorToExitCode(error);
+        printOutput(
+          { error: error instanceof Error ? error.message : String(error) },
+          { json: opts.json, label: "Error" }
+        );
+      } finally {
+        await bridge.close();
+      }
+    }
+  );
+}
+export {
+  registerRunCommand
+};
+//# sourceMappingURL=run.js.map

package/dist/cli/commands/run.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/cli/commands/run.ts"],
+  "sourcesContent": ["import type { Command } from 'commander';\n\nimport type { TextPart } from '../../domain/core-task.js';\nimport { createFacadeBridge } from '../adapters/bridge-facade.js';\nimport { errorToExitCode } from '../contracts/errors.js';\nimport { resolveResumeContext } from '../contracts/resume.js';\nimport { printOutput } from '../format/output.js';\nimport {\n  collect,\n  parseInteger,\n  resolveCliBridgeRuntimeOptions,\n  resolveCliPermission,\n} from '../lifecycle/runtime-options.js';\n\nexport function registerRunCommand(program: Command): void {\n  program\n    .command('run')\n    .description('Send a message and wait for the result')\n    .argument('<message>', 'The prompt message to send')\n    .option('--json', 'output as JSON', false)\n    .option('--model <model>', 'override model selection')\n    .option('--mcp-config <path>', 'native backend MCP config path')\n    .option(\n      '--mcp-server <name=command>',\n      'bridge-managed MCP server; repeatable; value can also be name={...json}',\n      collect\n    )\n    .option(\n      '--skill <path>',\n      'load custom SKILL.md bundle directory or parent directory; repeatable',\n      collect\n    )\n    .option('--context <id>', 'context ID for multi-turn')\n    .option(\n      '--session-id <id>',\n      'resume session by bridge session ID (ignored when --context is set)'\n    )\n    .option('--timeout <ms>', 'timeout in milliseconds', parseInteger)\n    .option(\n      '--permission <preset>',\n      'approval preset: allow-all | allow-this-session | ask | deny-all | deny-this-session'\n    )\n    .option(\n      '-y, --yes',\n      'shorthand for --permission allow-this-session (auto-approve only this run)',\n      false\n    )\n    .option(\n      '--always-ask <name>',\n      'force approval prompt for this tool name; repeatable',\n      collect\n    )\n    .action(\n      async (\n        message: string,\n        opts: {\n          json: boolean;\n          model?: string;\n          mcpConfig?: string;\n          mcpServer?: string[];\n          skill?: string[];\n          context?: string;\n          sessionId?: string;\n          timeout?: number;\n          permission?: string;\n          yes?: boolean;\n          alwaysAsk?: string[];\n        }\n      ) => {\n        const runtime = resolveCliBridgeRuntimeOptions(program, opts);\n        const permission = resolveCliPermission(\n          opts,\n          runtime.config,\n          runtime.profile\n        );\n        const bridge = await createFacadeBridge(runtime);\n\n        try {\n          const result = await bridge.sendMessage({\n            message,\n            ...resolveResumeContext(opts),\n            model: opts.model,\n            profile: runtime.profile,\n            timeoutMs: opts.timeout,\n            signal: runtime.signal,\n            ...(permission ? { permission } : {}),\n          });\n\n          if (result.kind === 'message') {\n            const text =\n              result.message?.parts\n                ?.filter((p): p is TextPart => p.kind === 'text')\n                .map((p) => p.text)\n                .join('') ?? '';\n            printOutput(\n              {\n                contextId: result.contextId,\n                text,\n              },\n              { json: opts.json, label: 'Result' }\n            );\n          } else {\n            printOutput(\n              {\n                taskId: result.taskId,\n                task: result.task.status?.state,\n              },\n              { json: opts.json, label: 'Task' }\n            );\n          }\n        } catch (error) {\n          process.exitCode = errorToExitCode(error);\n          printOutput(\n            { error: error instanceof Error ? error.message : String(error) },\n            { json: opts.json, label: 'Error' }\n          );\n        } finally {\n          await bridge.close();\n        }\n      }\n    );\n}\n"],
+  "mappings": "AAGA,SAAS,0BAA0B;AACnC,SAAS,uBAAuB;AAChC,SAAS,4BAA4B;AACrC,SAAS,mBAAmB;AAC5B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,SAAS,mBAAmB,SAAwB;AACzD,UACG,QAAQ,KAAK,EACb,YAAY,wCAAwC,EACpD,SAAS,aAAa,4BAA4B,EAClD,OAAO,UAAU,kBAAkB,KAAK,EACxC,OAAO,mBAAmB,0BAA0B,EACpD,OAAO,uBAAuB,gCAAgC,EAC9D;AAAA,IACC;AAAA,IACA;AAAA,IACA;AAAA,EACF,EACC;AAAA,IACC;AAAA,IACA;AAAA,IACA;AAAA,EACF,EACC,OAAO,kBAAkB,2BAA2B,EACpD;AAAA,IACC;AAAA,IACA;AAAA,EACF,EACC,OAAO,kBAAkB,2BAA2B,YAAY,EAChE;AAAA,IACC;AAAA,IACA;AAAA,EACF,EACC;AAAA,IACC;AAAA,IACA;AAAA,IACA;AAAA,EACF,EACC;AAAA,IACC;AAAA,IACA;AAAA,IACA;AAAA,EACF,EACC;AAAA,IACC,OACE,SACA,SAaG;AACH,YAAM,UAAU,+BAA+B,SAAS,IAAI;AAC5D,YAAM,aAAa;AAAA,QACjB;AAAA,QACA,QAAQ;AAAA,QACR,QAAQ;AAAA,MACV;AACA,YAAM,SAAS,MAAM,mBAAmB,OAAO;AAE/C,UAAI;AACF,cAAM,SAAS,MAAM,OAAO,YAAY;AAAA,UACtC;AAAA,UACA,GAAG,qBAAqB,IAAI;AAAA,UAC5B,OAAO,KAAK;AAAA,UACZ,SAAS,QAAQ;AAAA,UACjB,WAAW,KAAK;AAAA,UAChB,QAAQ,QAAQ;AAAA,UAChB,GAAI,aAAa,EAAE,WAAW,IAAI,CAAC;AAAA,QACrC,CAAC;AAED,YAAI,OAAO,SAAS,WAAW;AAC7B,gBAAM,OACJ,OAAO,SAAS,OACZ,OAAO,CAAC,MAAqB,EAAE,SAAS,MAAM,EAC/C,IAAI,CAAC,MAAM,EAAE,IAAI,EACjB,KAAK,EAAE,KAAK;AACjB;AAAA,YACE;AAAA,cACE,WAAW,OAAO;AAAA,cAClB;AAAA,YACF;AAAA,YACA,EAAE,MAAM,KAAK,MAAM,OAAO,SAAS;AAAA,UACrC;AAAA,QACF,OAAO;AACL;AAAA,YACE;AAAA,cACE,QAAQ,OAAO;AAAA,cACf,MAAM,OAAO,KAAK,QAAQ;AAAA,YAC5B;AAAA,YACA,EAAE,MAAM,KAAK,MAAM,OAAO,OAAO;AAAA,UACnC;AAAA,QACF;AAAA,MACF,SAAS,OAAO;AACd,gBAAQ,WAAW,gBAAgB,KAAK;AACxC;AAAA,UACE,EAAE,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,EAAE;AAAA,UAChE,EAAE,MAAM,KAAK,MAAM,OAAO,QAAQ;AAAA,QACpC;AAAA,MACF,UAAE;AACA,cAAM,OAAO,MAAM;AAAA,MACrB;AAAA,IACF;AAAA,EACF;AACJ;",
+  "names": []
+}

package/dist/cli/commands/server.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerServerCommand(program: Command): void;
+//# sourceMappingURL=server.d.ts.map

package/dist/cli/commands/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAczC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsD5D"}

package/dist/cli/commands/server.js

@@ -0,0 +1,62 @@
+import { createA2AServer } from "../../adapters/transport/server.js";
+import { errorToExitCode } from "../contracts/errors.js";
+import {
+  parseInteger,
+  resolveCliServerRuntimeOptions
+} from "../lifecycle/runtime-options.js";
+import {
+  isServerNotRunningError,
+  listenOnServer,
+  waitForServerExit
+} from "../lifecycle/server-listen.js";
+function registerServerCommand(program) {
+  const server = program.command("server").description("A2A server management");
+  server.command("serve").description("Start the A2A JSON-RPC server").option("--host <host>", "bind host").option("--port <port>", "bind port", parseInteger).action(async (opts) => {
+    const runtime = resolveCliServerRuntimeOptions(program, opts, {
+      host: "0.0.0.0",
+      port: 3e3
+    });
+    let handle = null;
+    try {
+      handle = await createA2AServer({
+        config: runtime.config,
+        host: runtime.host,
+        port: runtime.port
+      });
+      await listenOnServer(handle.server, runtime.host, runtime.port);
+      process.stdout.write(`A2A server listening at ${handle.url}
+`);
+      if (runtime.signal) {
+        runtime.signal.addEventListener(
+          "abort",
+          () => {
+            process.stdout.write("Shutting down...\n");
+            void handle?.close();
+          },
+          { once: true }
+        );
+      }
+      const exitError = await waitForServerExit(handle.server);
+      if (exitError) throw exitError;
+    } catch (error) {
+      process.exitCode = errorToExitCode(error);
+      process.stderr.write(
+        `Server error: ${error instanceof Error ? error.message : String(error)}
+`
+      );
+    } finally {
+      await handle?.close().catch((error) => {
+        if (!isServerNotRunningError(error)) {
+          process.stderr.write(
+            `Server cleanup error: ${error instanceof Error ? error.message : String(error)}
+`
+          );
+        }
+      });
+    }
+  });
+}
+export {
+  registerServerCommand
+};
+//# sourceMappingURL=server.js.map