octoflow-core 1.0.0

package/dist/cli/index.d.ts

@@ -0,0 +1,9 @@
+import { Command } from 'commander';
+export interface CliProgramOptions {
+    description?: string;
+    name?: string;
+    version?: string;
+}
+export declare function createCliProgram(options?: CliProgramOptions): Command;
+export declare function runCli(argv?: string[], options?: CliProgramOptions): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBpC,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAOD,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAmCzE;AAED,wBAAsB,MAAM,CAC1B,IAAI,WAAe,EACnB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAiCf"}

package/dist/cli/index.js

@@ -0,0 +1,83 @@
+import { Command } from "commander";
+import { registerBuildCommand } from "./commands/build.js";
+import { registerDaemonCommand } from "./commands/daemon.js";
+import { registerDevCommand } from "./commands/dev.js";
+import { registerDoctorCommand } from "./commands/doctor.js";
+import { registerEnvCommand } from "./commands/env.js";
+import { registerInitCommand } from "./commands/init.js";
+import { registerInspectCommand } from "./commands/inspect.js";
+import { registerRunCommand } from "./commands/run.js";
+import { registerServerCommand } from "./commands/server.js";
+import { registerSessionCommands } from "./commands/session.js";
+import { registerStreamCommand } from "./commands/stream.js";
+import { registerTaskCommands } from "./commands/task.js";
+import { errorToExitCode, EXIT_CODES } from "./contracts/errors.js";
+import {
+  applyBridgeEnvFile,
+  resolveCliConfig
+} from "./lifecycle/pre-action.js";
+import { wireSignals } from "./lifecycle/signal.js";
+const DEFAULT_CLI_DESCRIPTION = "Infrastructure CLI for octoflow \u2014 backend inspection, diagnostics, and automation";
+const DEFAULT_CLI_NAME = "octoflow-core";
+const DEFAULT_CLI_VERSION = "0.3.0";
+function createCliProgram(options = {}) {
+  const program = new Command();
+  program.name(options.name ?? DEFAULT_CLI_NAME).description(options.description ?? DEFAULT_CLI_DESCRIPTION).version(options.version ?? DEFAULT_CLI_VERSION).option("--config <path>", "path to octoflow config file").option("--profile <name>", "profile name override");
+  program.hook("preAction", (_thisCommand, actionCommand) => {
+    const opts = actionCommand.optsWithGlobals();
+    const config = resolveCliConfig(opts.config);
+    applyBridgeEnvFile(opts.config);
+    actionCommand.setOptionValue("_resolvedConfig", config);
+    program.setOptionValue("_resolvedConfig", config);
+  });
+  registerInspectCommand(program);
+  registerInitCommand(program);
+  registerBuildCommand(program);
+  registerDevCommand(program);
+  registerRunCommand(program);
+  registerStreamCommand(program);
+  registerTaskCommands(program);
+  registerSessionCommands(program);
+  registerDaemonCommand(program);
+  registerDoctorCommand(program);
+  registerEnvCommand(program);
+  registerServerCommand(program);
+  return program;
+}
+async function runCli(argv = process.argv, options = {}) {
+  if (process.listenerCount("unhandledRejection") === 0) {
+    process.on("unhandledRejection", (reason) => {
+      process.exitCode = EXIT_CODES.INTERNAL_ERROR;
+      process.stderr.write(
+        `Unhandled rejection: ${reason instanceof Error ? reason.message : String(reason)}
+`
+      );
+    });
+  }
+  if (process.listenerCount("uncaughtException") === 0) {
+    process.on("uncaughtException", (error) => {
+      process.exitCode = EXIT_CODES.INTERNAL_ERROR;
+      process.stderr.write(`Uncaught exception: ${error.message}
+`);
+      process.exit(EXIT_CODES.INTERNAL_ERROR);
+    });
+  }
+  const program = createCliProgram(options);
+  const abort = new AbortController();
+  wireSignals(abort);
+  program.setOptionValue("_signal", abort.signal);
+  try {
+    await program.parseAsync(argv);
+  } catch (error) {
+    if (error instanceof Error && "exitCode" in error) {
+      process.exitCode = error.exitCode ?? EXIT_CODES.GENERAL_FAILURE;
+    } else {
+      process.exitCode = errorToExitCode(error);
+    }
+  }
+}
+export {
+  createCliProgram,
+  runCli
+};
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/cli/index.ts"],
+  "sourcesContent": ["import { Command } from 'commander';\n\nimport { registerBuildCommand } from './commands/build.js';\nimport { registerDaemonCommand } from './commands/daemon.js';\nimport { registerDevCommand } from './commands/dev.js';\nimport { registerDoctorCommand } from './commands/doctor.js';\nimport { registerEnvCommand } from './commands/env.js';\nimport { registerInitCommand } from './commands/init.js';\nimport { registerInspectCommand } from './commands/inspect.js';\nimport { registerRunCommand } from './commands/run.js';\nimport { registerServerCommand } from './commands/server.js';\nimport { registerSessionCommands } from './commands/session.js';\nimport { registerStreamCommand } from './commands/stream.js';\nimport { registerTaskCommands } from './commands/task.js';\nimport { errorToExitCode, EXIT_CODES } from './contracts/errors.js';\nimport {\n  applyBridgeEnvFile,\n  resolveCliConfig,\n} from './lifecycle/pre-action.js';\nimport { wireSignals } from './lifecycle/signal.js';\n\nexport interface CliProgramOptions {\n  description?: string;\n  name?: string;\n  version?: string;\n}\n\nconst DEFAULT_CLI_DESCRIPTION =\n  'Infrastructure CLI for octoflow \u2014 backend inspection, diagnostics, and automation';\nconst DEFAULT_CLI_NAME = 'octoflow-core';\nconst DEFAULT_CLI_VERSION = '0.3.0';\n\nexport function createCliProgram(options: CliProgramOptions = {}): Command {\n  const program = new Command();\n\n  program\n    .name(options.name ?? DEFAULT_CLI_NAME)\n    .description(options.description ?? DEFAULT_CLI_DESCRIPTION)\n    .version(options.version ?? DEFAULT_CLI_VERSION)\n    .option('--config <path>', 'path to octoflow config file')\n    .option('--profile <name>', 'profile name override');\n\n  program.hook('preAction', (_thisCommand, actionCommand) => {\n    const opts = actionCommand.optsWithGlobals<{\n      config?: string;\n      profile?: string;\n    }>();\n    const config = resolveCliConfig(opts.config);\n    applyBridgeEnvFile(opts.config);\n    actionCommand.setOptionValue('_resolvedConfig', config);\n    program.setOptionValue('_resolvedConfig', config);\n  });\n\n  registerInspectCommand(program);\n  registerInitCommand(program);\n  registerBuildCommand(program);\n  registerDevCommand(program);\n  registerRunCommand(program);\n  registerStreamCommand(program);\n  registerTaskCommands(program);\n  registerSessionCommands(program);\n  registerDaemonCommand(program);\n  registerDoctorCommand(program);\n  registerEnvCommand(program);\n  registerServerCommand(program);\n\n  return program;\n}\n\nexport async function runCli(\n  argv = process.argv,\n  options: CliProgramOptions = {}\n): Promise<void> {\n  if (process.listenerCount('unhandledRejection') === 0) {\n    process.on('unhandledRejection', (reason) => {\n      process.exitCode = EXIT_CODES.INTERNAL_ERROR;\n      process.stderr.write(\n        `Unhandled rejection: ${reason instanceof Error ? reason.message : String(reason)}\\n`\n      );\n    });\n  }\n\n  if (process.listenerCount('uncaughtException') === 0) {\n    process.on('uncaughtException', (error) => {\n      process.exitCode = EXIT_CODES.INTERNAL_ERROR;\n      process.stderr.write(`Uncaught exception: ${error.message}\\n`);\n      process.exit(EXIT_CODES.INTERNAL_ERROR);\n    });\n  }\n\n  const program = createCliProgram(options);\n  const abort = new AbortController();\n  wireSignals(abort);\n  program.setOptionValue('_signal', abort.signal);\n\n  try {\n    await program.parseAsync(argv);\n  } catch (error) {\n    if (error instanceof Error && 'exitCode' in error) {\n      process.exitCode =\n        (error as { exitCode: number }).exitCode ?? EXIT_CODES.GENERAL_FAILURE;\n    } else {\n      process.exitCode = errorToExitCode(error);\n    }\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,eAAe;AAExB,SAAS,4BAA4B;AACrC,SAAS,6BAA6B;AACtC,SAAS,0BAA0B;AACnC,SAAS,6BAA6B;AACtC,SAAS,0BAA0B;AACnC,SAAS,2BAA2B;AACpC,SAAS,8BAA8B;AACvC,SAAS,0BAA0B;AACnC,SAAS,6BAA6B;AACtC,SAAS,+BAA+B;AACxC,SAAS,6BAA6B;AACtC,SAAS,4BAA4B;AACrC,SAAS,iBAAiB,kBAAkB;AAC5C;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,mBAAmB;AAQ5B,MAAM,0BACJ;AACF,MAAM,mBAAmB;AACzB,MAAM,sBAAsB;AAErB,SAAS,iBAAiB,UAA6B,CAAC,GAAY;AACzE,QAAM,UAAU,IAAI,QAAQ;AAE5B,UACG,KAAK,QAAQ,QAAQ,gBAAgB,EACrC,YAAY,QAAQ,eAAe,uBAAuB,EAC1D,QAAQ,QAAQ,WAAW,mBAAmB,EAC9C,OAAO,mBAAmB,8BAA8B,EACxD,OAAO,oBAAoB,uBAAuB;AAErD,UAAQ,KAAK,aAAa,CAAC,cAAc,kBAAkB;AACzD,UAAM,OAAO,cAAc,gBAGxB;AACH,UAAM,SAAS,iBAAiB,KAAK,MAAM;AAC3C,uBAAmB,KAAK,MAAM;AAC9B,kBAAc,eAAe,mBAAmB,MAAM;AACtD,YAAQ,eAAe,mBAAmB,MAAM;AAAA,EAClD,CAAC;AAED,yBAAuB,OAAO;AAC9B,sBAAoB,OAAO;AAC3B,uBAAqB,OAAO;AAC5B,qBAAmB,OAAO;AAC1B,qBAAmB,OAAO;AAC1B,wBAAsB,OAAO;AAC7B,uBAAqB,OAAO;AAC5B,0BAAwB,OAAO;AAC/B,wBAAsB,OAAO;AAC7B,wBAAsB,OAAO;AAC7B,qBAAmB,OAAO;AAC1B,wBAAsB,OAAO;AAE7B,SAAO;AACT;AAEA,eAAsB,OACpB,OAAO,QAAQ,MACf,UAA6B,CAAC,GACf;AACf,MAAI,QAAQ,cAAc,oBAAoB,MAAM,GAAG;AACrD,YAAQ,GAAG,sBAAsB,CAAC,WAAW;AAC3C,cAAQ,WAAW,WAAW;AAC9B,cAAQ,OAAO;AAAA,QACb,wBAAwB,kBAAkB,QAAQ,OAAO,UAAU,OAAO,MAAM,CAAC;AAAA;AAAA,MACnF;AAAA,IACF,CAAC;AAAA,EACH;AAEA,MAAI,QAAQ,cAAc,mBAAmB,MAAM,GAAG;AACpD,YAAQ,GAAG,qBAAqB,CAAC,UAAU;AACzC,cAAQ,WAAW,WAAW;AAC9B,cAAQ,OAAO,MAAM,uBAAuB,MAAM,OAAO;AAAA,CAAI;AAC7D,cAAQ,KAAK,WAAW,cAAc;AAAA,IACxC,CAAC;AAAA,EACH;AAEA,QAAM,UAAU,iBAAiB,OAAO;AACxC,QAAM,QAAQ,IAAI,gBAAgB;AAClC,cAAY,KAAK;AACjB,UAAQ,eAAe,WAAW,MAAM,MAAM;AAE9C,MAAI;AACF,UAAM,QAAQ,WAAW,IAAI;AAAA,EAC/B,SAAS,OAAO;AACd,QAAI,iBAAiB,SAAS,cAAc,OAAO;AACjD,cAAQ,WACL,MAA+B,YAAY,WAAW;AAAA,IAC3D,OAAO;AACL,cAAQ,WAAW,gBAAgB,KAAK;AAAA,IAC1C;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/cli/lifecycle/pre-action.d.ts

@@ -0,0 +1,13 @@
+import type { OctoFlowConfig } from '../../config/config.js';
+export declare function mergeCliConfig(shared: OctoFlowConfig | null, user: OctoFlowConfig | null): OctoFlowConfig | null;
+/**
+ * Resolve the bridge config from the --config CLI option or default location.
+ * Returns the parsed config or null if no config file is found.
+ */
+export declare function resolveCliConfig(configPath?: string): OctoFlowConfig | null;
+/**
+ * Load a .env file and apply entries to process.env (CLI-only convenience).
+ * Entries are set only when not already defined in process.env.
+ */
+export declare function applyBridgeEnvFile(configPath?: string): void;
+//# sourceMappingURL=pre-action.d.ts.map

package/dist/cli/lifecycle/pre-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-action.d.ts","sourceRoot":"","sources":["../../../src/cli/lifecycle/pre-action.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,wBAAwB,CAAC;AA0F9E,wBAAgB,cAAc,CAC5B,MAAM,EAAE,cAAc,GAAG,IAAI,EAC7B,IAAI,EAAE,cAAc,GAAG,IAAI,GAC1B,cAAc,GAAG,IAAI,CAqDvB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAO3E;AAkDD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAO5D"}

package/dist/cli/lifecycle/pre-action.js

@@ -0,0 +1,178 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { loadConfig, mergeToolConfigs } from "../../config/config.js";
+import { isSafeKey } from "../../utils/safe-key.js";
+function readJsonConfig(path) {
+  if (!existsSync(path)) return null;
+  try {
+    return JSON.parse(readFileSync(path, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function unique(values) {
+  return [...new Set(values)];
+}
+function hasKeys(value) {
+  return Object.keys(value).length > 0;
+}
+function objectOrUndefined(value) {
+  return hasKeys(value) ? value : void 0;
+}
+function mergeArrayByName(shared, user) {
+  if (!shared && !user) return void 0;
+  if (!shared) return user;
+  if (!user) return shared;
+  const userNames = new Set(user.map((item) => item.name));
+  return [...shared.filter((item) => !userNames.has(item.name)), ...user];
+}
+function mergeAgentSkillsConfig(shared, user) {
+  if (!shared && !user) return void 0;
+  if (!shared) return user;
+  if (!user) return shared;
+  const additionalPaths = unique([
+    ...shared.additionalPaths ?? [],
+    ...user.additionalPaths ?? []
+  ]);
+  const disabled = unique([
+    ...shared.disabled ?? [],
+    ...user.disabled ?? []
+  ]);
+  return {
+    ...shared,
+    ...user,
+    additionalPaths: additionalPaths.length > 0 ? additionalPaths : void 0,
+    disabled: disabled.length > 0 ? disabled : void 0
+  };
+}
+function mergeProfileConfig(shared, user) {
+  if (!shared && !user) return void 0;
+  if (!shared) return user;
+  if (!user) return shared;
+  return {
+    ...shared,
+    ...user,
+    backends: { ...shared.backends ?? {}, ...user.backends ?? {} },
+    defaults: { ...shared.defaults ?? {}, ...user.defaults ?? {} },
+    mcpServers: { ...shared.mcpServers ?? {}, ...user.mcpServers ?? {} },
+    runtime: { ...shared.runtime ?? {}, ...user.runtime ?? {} },
+    security: {
+      ...shared.security ?? {},
+      ...user.security ?? {},
+      credentials: {
+        ...shared.security?.credentials ?? {},
+        ...user.security?.credentials ?? {}
+      },
+      filesystem: {
+        ...shared.security?.filesystem ?? {},
+        ...user.security?.filesystem ?? {}
+      }
+    },
+    session: { ...shared.session ?? {}, ...user.session ?? {} },
+    tools: mergeToolConfigs(shared.tools ?? {}, user.tools)
+  };
+}
+function mergeCliConfig(shared, user) {
+  if (!shared) return user;
+  if (!user) return shared;
+  const profileNames = /* @__PURE__ */ new Set([
+    ...Object.keys(shared.profiles ?? {}),
+    ...Object.keys(user.profiles ?? {})
+  ]);
+  const profiles = {};
+  for (const name of profileNames) {
+    if (!isSafeKey(name)) continue;
+    const profile = mergeProfileConfig(
+      shared.profiles?.[name],
+      user.profiles?.[name]
+    );
+    if (profile) profiles[name] = profile;
+  }
+  return {
+    ...shared,
+    ...user,
+    agentCard: { ...shared.agentCard ?? {}, ...user.agentCard ?? {} },
+    agentSkills: mergeAgentSkillsConfig(shared.agentSkills, user.agentSkills),
+    apiKeys: { ...shared.apiKeys ?? {}, ...user.apiKeys ?? {} },
+    brain: { ...shared.brain ?? {}, ...user.brain ?? {} },
+    defaults: { ...shared.defaults ?? {}, ...user.defaults ?? {} },
+    frameworkWorkspace: objectOrUndefined({
+      ...shared.frameworkWorkspace ?? {},
+      ...user.frameworkWorkspace ?? {}
+    }),
+    hooks: { ...shared.hooks ?? {}, ...user.hooks ?? {} },
+    mcpOptions: { ...shared.mcpOptions ?? {}, ...user.mcpOptions ?? {} },
+    mcpServers: { ...shared.mcpServers ?? {}, ...user.mcpServers ?? {} },
+    profiles: Object.keys(profiles).length > 0 ? profiles : void 0,
+    server: objectOrUndefined({
+      ...shared.server ?? {},
+      ...user.server ?? {},
+      auth: objectOrUndefined({
+        ...shared.server?.auth ?? {},
+        ...user.server?.auth ?? {}
+      }),
+      rateLimit: objectOrUndefined({
+        ...shared.server?.rateLimit ?? {},
+        ...user.server?.rateLimit ?? {}
+      }),
+      tls: objectOrUndefined({
+        ...shared.server?.tls ?? {},
+        ...user.server?.tls ?? {}
+      })
+    }),
+    skills: mergeArrayByName(shared.skills, user.skills),
+    tools: mergeToolConfigs(shared.tools ?? {}, user.tools)
+  };
+}
+function resolveCliConfig(configPath) {
+  if (configPath) {
+    const userConfig = readJsonConfig(resolve(configPath));
+    if (!userConfig) return null;
+    return mergeCliConfig(loadConfig(), userConfig);
+  }
+  return loadConfig();
+}
+function parseEnvFile(filePath) {
+  if (!existsSync(filePath)) return {};
+  const entries = {};
+  const lines = readFileSync(filePath, "utf-8").split(/\r?\n/);
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const eqIdx = trimmed.indexOf("=");
+    if (eqIdx === -1) continue;
+    const key = trimmed.slice(0, eqIdx).trim();
+    if (!isSafeKey(key)) continue;
+    const value = trimmed.slice(eqIdx + 1).trim().replace(/^["']|["']$/g, "");
+    entries[key] = value;
+  }
+  return entries;
+}
+function loadBridgeEnvFile(configPath, cwd) {
+  const candidates = [];
+  if (configPath) {
+    candidates.push(resolve(dirname(resolve(configPath)), ".env"));
+  }
+  if (cwd) candidates.push(resolve(cwd, ".env"));
+  candidates.push(resolve(process.cwd(), ".env"));
+  for (const envPath of candidates) {
+    if (existsSync(envPath)) {
+      return parseEnvFile(envPath);
+    }
+  }
+  return {};
+}
+function applyBridgeEnvFile(configPath) {
+  const entries = loadBridgeEnvFile(configPath);
+  for (const [key, value] of Object.entries(entries)) {
+    if (!(key in process.env)) {
+      process.env[key] = value;
+    }
+  }
+}
+export {
+  applyBridgeEnvFile,
+  mergeCliConfig,
+  resolveCliConfig
+};
+//# sourceMappingURL=pre-action.js.map

package/dist/cli/lifecycle/pre-action.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/cli/lifecycle/pre-action.ts"],
+  "sourcesContent": ["import { existsSync, readFileSync } from 'node:fs';\nimport { dirname, resolve } from 'node:path';\n\nimport type { OctoFlowConfig, OctoFlowProfile } from '../../config/config.js';\nimport { loadConfig, mergeToolConfigs } from '../../config/config.js';\nimport { isSafeKey } from '../../utils/safe-key.js';\n\nfunction readJsonConfig(path: string): OctoFlowConfig | null {\n  if (!existsSync(path)) return null;\n  try {\n    return JSON.parse(readFileSync(path, 'utf-8')) as OctoFlowConfig;\n  } catch {\n    return null;\n  }\n}\n\nfunction unique(values: string[]): string[] {\n  return [...new Set(values)];\n}\n\nfunction hasKeys(value: object): boolean {\n  return Object.keys(value).length > 0;\n}\n\nfunction objectOrUndefined<T extends object>(value: T): T | undefined {\n  return hasKeys(value) ? value : undefined;\n}\n\nfunction mergeArrayByName<T extends { name: string }>(\n  shared: T[] | undefined,\n  user: T[] | undefined\n): T[] | undefined {\n  if (!shared && !user) return undefined;\n  if (!shared) return user;\n  if (!user) return shared;\n  const userNames = new Set(user.map((item) => item.name));\n  return [...shared.filter((item) => !userNames.has(item.name)), ...user];\n}\n\nfunction mergeAgentSkillsConfig(\n  shared: OctoFlowConfig['agentSkills'],\n  user: OctoFlowConfig['agentSkills']\n): OctoFlowConfig['agentSkills'] {\n  if (!shared && !user) return undefined;\n  if (!shared) return user;\n  if (!user) return shared;\n  const additionalPaths = unique([\n    ...(shared.additionalPaths ?? []),\n    ...(user.additionalPaths ?? []),\n  ]);\n  const disabled = unique([\n    ...(shared.disabled ?? []),\n    ...(user.disabled ?? []),\n  ]);\n  return {\n    ...shared,\n    ...user,\n    additionalPaths: additionalPaths.length > 0 ? additionalPaths : undefined,\n    disabled: disabled.length > 0 ? disabled : undefined,\n  };\n}\n\nfunction mergeProfileConfig(\n  shared: OctoFlowProfile | undefined,\n  user: OctoFlowProfile | undefined\n): OctoFlowProfile | undefined {\n  if (!shared && !user) return undefined;\n  if (!shared) return user;\n  if (!user) return shared;\n  return {\n    ...shared,\n    ...user,\n    backends: { ...(shared.backends ?? {}), ...(user.backends ?? {}) },\n    defaults: { ...(shared.defaults ?? {}), ...(user.defaults ?? {}) },\n    mcpServers: { ...(shared.mcpServers ?? {}), ...(user.mcpServers ?? {}) },\n    runtime: { ...(shared.runtime ?? {}), ...(user.runtime ?? {}) },\n    security: {\n      ...(shared.security ?? {}),\n      ...(user.security ?? {}),\n      credentials: {\n        ...(shared.security?.credentials ?? {}),\n        ...(user.security?.credentials ?? {}),\n      },\n      filesystem: {\n        ...(shared.security?.filesystem ?? {}),\n        ...(user.security?.filesystem ?? {}),\n      },\n    },\n    session: { ...(shared.session ?? {}), ...(user.session ?? {}) },\n    tools: mergeToolConfigs(shared.tools ?? {}, user.tools),\n  };\n}\n\nexport function mergeCliConfig(\n  shared: OctoFlowConfig | null,\n  user: OctoFlowConfig | null\n): OctoFlowConfig | null {\n  if (!shared) return user;\n  if (!user) return shared;\n\n  const profileNames = new Set([\n    ...Object.keys(shared.profiles ?? {}),\n    ...Object.keys(user.profiles ?? {}),\n  ]);\n  const profiles: NonNullable<OctoFlowConfig['profiles']> = {};\n  for (const name of profileNames) {\n    if (!isSafeKey(name)) continue;\n    const profile = mergeProfileConfig(\n      shared.profiles?.[name],\n      user.profiles?.[name]\n    );\n    if (profile) profiles[name] = profile;\n  }\n\n  return {\n    ...shared,\n    ...user,\n    agentCard: { ...(shared.agentCard ?? {}), ...(user.agentCard ?? {}) },\n    agentSkills: mergeAgentSkillsConfig(shared.agentSkills, user.agentSkills),\n    apiKeys: { ...(shared.apiKeys ?? {}), ...(user.apiKeys ?? {}) },\n    brain: { ...(shared.brain ?? {}), ...(user.brain ?? {}) },\n    defaults: { ...(shared.defaults ?? {}), ...(user.defaults ?? {}) },\n    frameworkWorkspace: objectOrUndefined({\n      ...(shared.frameworkWorkspace ?? {}),\n      ...(user.frameworkWorkspace ?? {}),\n    }),\n    hooks: { ...(shared.hooks ?? {}), ...(user.hooks ?? {}) },\n    mcpOptions: { ...(shared.mcpOptions ?? {}), ...(user.mcpOptions ?? {}) },\n    mcpServers: { ...(shared.mcpServers ?? {}), ...(user.mcpServers ?? {}) },\n    profiles: Object.keys(profiles).length > 0 ? profiles : undefined,\n    server: objectOrUndefined({\n      ...(shared.server ?? {}),\n      ...(user.server ?? {}),\n      auth: objectOrUndefined({\n        ...(shared.server?.auth ?? {}),\n        ...(user.server?.auth ?? {}),\n      }),\n      rateLimit: objectOrUndefined({\n        ...(shared.server?.rateLimit ?? {}),\n        ...(user.server?.rateLimit ?? {}),\n      }),\n      tls: objectOrUndefined({\n        ...(shared.server?.tls ?? {}),\n        ...(user.server?.tls ?? {}),\n      }),\n    }),\n    skills: mergeArrayByName(shared.skills, user.skills),\n    tools: mergeToolConfigs(shared.tools ?? {}, user.tools),\n  };\n}\n\n/**\n * Resolve the bridge config from the --config CLI option or default location.\n * Returns the parsed config or null if no config file is found.\n */\nexport function resolveCliConfig(configPath?: string): OctoFlowConfig | null {\n  if (configPath) {\n    const userConfig = readJsonConfig(resolve(configPath));\n    if (!userConfig) return null;\n    return mergeCliConfig(loadConfig(), userConfig);\n  }\n  return loadConfig();\n}\n\n/**\n * Parse a .env file into a key-value record.\n * Supports `#` comments, `KEY=VALUE` lines, and quoted values.\n */\nfunction parseEnvFile(filePath: string): Record<string, string> {\n  if (!existsSync(filePath)) return {};\n  const entries: Record<string, string> = {};\n  const lines = readFileSync(filePath, 'utf-8').split(/\\r?\\n/);\n  for (const line of lines) {\n    const trimmed = line.trim();\n    if (!trimmed || trimmed.startsWith('#')) continue;\n    const eqIdx = trimmed.indexOf('=');\n    if (eqIdx === -1) continue;\n    const key = trimmed.slice(0, eqIdx).trim();\n    if (!isSafeKey(key)) continue;\n    const value = trimmed\n      .slice(eqIdx + 1)\n      .trim()\n      .replace(/^[\"']|[\"']$/g, '');\n    entries[key] = value;\n  }\n  return entries;\n}\n\n/**\n * Load a .env file from candidate locations.\n * Searches: config file directory, workspace/cwd, then process.cwd().\n * Returns parsed entries without mutating process.env.\n */\nfunction loadBridgeEnvFile(\n  configPath?: string,\n  cwd?: string\n): Record<string, string> {\n  const candidates: string[] = [];\n  if (configPath) {\n    candidates.push(resolve(dirname(resolve(configPath)), '.env'));\n  }\n  if (cwd) candidates.push(resolve(cwd, '.env'));\n  candidates.push(resolve(process.cwd(), '.env'));\n\n  for (const envPath of candidates) {\n    if (existsSync(envPath)) {\n      return parseEnvFile(envPath);\n    }\n  }\n  return {};\n}\n\n/**\n * Load a .env file and apply entries to process.env (CLI-only convenience).\n * Entries are set only when not already defined in process.env.\n */\nexport function applyBridgeEnvFile(configPath?: string): void {\n  const entries = loadBridgeEnvFile(configPath);\n  for (const [key, value] of Object.entries(entries)) {\n    if (!(key in process.env)) {\n      process.env[key] = value;\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cli/lifecycle/runtime-options.d.ts

@@ -0,0 +1,82 @@
+import type { Command } from 'commander';
+import type { OctoFlowConfig } from '../../config/config.js';
+import type { PermissionConfig } from '../../domain/permission.js';
+import type { BridgeOptions } from '../../runtime/bridge/bridge.js';
+export interface CliBridgeOptionFlags {
+    mcpConfig?: string;
+    mcpServer?: string[];
+    skill?: string[];
+    permission?: string;
+    yes?: boolean;
+    alwaysAsk?: string[];
+}
+/**
+ * Translate CLI permission flags into a {@link PermissionConfig}.
+ *
+ * Resolution order (highest precedence first):
+ *   1. `--permission <preset>` — explicit preset.
+ *   2. `-y` / `--yes`          — shorthand for `allow-this-session`.
+ *
+ * `--always-ask <name>` is repeatable and layers on top to force specific
+ * tool names back to the prompt; useful alongside `--permission allow-all`
+ * to keep a few sensitive tools guarded. Returns `undefined` when no
+ * permission flags were passed.
+ */
+export declare function parseCliPermission(opts: Pick<CliBridgeOptionFlags, 'permission' | 'yes' | 'alwaysAsk'>): PermissionConfig | undefined;
+/**
+ * Read a `permission` preset from the loaded `octoflow.config.json` for the
+ * active profile. Falls back to `config.defaultProfile` when no explicit
+ * profile name is set. Returns `undefined` when no config is loaded or the
+ * profile does not declare one — callers layer this under
+ * {@link parseCliPermission} so CLI flags always win.
+ */
+export declare function readConfigPermission(config: OctoFlowConfig | null | undefined, profileName: string | undefined): PermissionConfig | undefined;
+/**
+ * Resolve the effective `permission` config for a CLI invocation.
+ *
+ * Precedence (first defined wins):
+ *
+ *   1. CLI flags  (`--permission` / `-y` / `--always-ask`)
+ *   2. `octoflow.config.json` → `profiles[<active>].security.permission`
+ *
+ * Per-send `BridgeSendMessageParams.permission` and bridge-level
+ * `BridgeOptions.permission` precedence is handled inside the runtime
+ * resolver — this helper only feeds the per-send slot from the CLI surface.
+ */
+export declare function resolveCliPermission(opts: Pick<CliBridgeOptionFlags, 'permission' | 'yes' | 'alwaysAsk'>, config: OctoFlowConfig | null | undefined, profileName: string | undefined): PermissionConfig | undefined;
+export interface CliFrameworkWorkspaceFlags {
+    dir?: string;
+    out?: string;
+}
+export interface CliServerOptionFlags {
+    host?: string;
+    port?: number;
+}
+export interface ResolvedCliBridgeRuntimeOptions {
+    bridgeOptions: Pick<BridgeOptions, 'agentSkills' | 'mcpConfigPath' | 'mcpOptions' | 'mcpServers' | 'profile'>;
+    config: OctoFlowConfig | null;
+    profile?: string;
+    signal?: AbortSignal;
+}
+export interface ResolvedCliServerRuntimeOptions {
+    config?: OctoFlowConfig;
+    host: string;
+    port: number;
+    signal?: AbortSignal;
+}
+export declare function collect(value: string, previous?: string[]): string[];
+export declare function parseInteger(value: string): number;
+export declare function resolveCliProfile(program: Command): string | undefined;
+export declare function resolveCliBridgeRuntimeOptions(program: Command, opts: CliBridgeOptionFlags): ResolvedCliBridgeRuntimeOptions;
+export declare function resolveCliServerRuntimeOptions(program: Command, opts: CliServerOptionFlags, defaults: {
+    host: string;
+    port: number;
+}): ResolvedCliServerRuntimeOptions;
+export declare function resolveCliFrameworkWorkspaceOptions(program: Command, opts: CliFrameworkWorkspaceFlags, defaults: {
+    dir: string;
+    outDir?: string;
+}): {
+    dir: string;
+    outDir?: string;
+};
+//# sourceMappingURL=runtime-options.d.ts.map

package/dist/cli/lifecycle/runtime-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-options.d.ts","sourceRoot":"","sources":["../../../src/cli/lifecycle/runtime-options.ts"],"names":[],"mappings":"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"}

package/dist/cli/lifecycle/runtime-options.js

@@ -0,0 +1,140 @@
+import { mergeConfigAgentSkills } from "../../runtime/bridge/config-bridge-helpers.js";
+const PERMISSION_PRESETS = [
+  "allow-all",
+  "allow-this-session",
+  "ask",
+  "deny-all",
+  "deny-this-session"
+];
+function isPermissionPreset(value) {
+  return PERMISSION_PRESETS.includes(value);
+}
+function decisionFromPreset(preset) {
+  if (preset === "ask") return "ask";
+  return preset.startsWith("deny") ? "deny" : "allow";
+}
+function parseCliPermission(opts) {
+  const alwaysAsk = opts.alwaysAsk && opts.alwaysAsk.length > 0 ? opts.alwaysAsk : void 0;
+  if (opts.permission) {
+    if (!isPermissionPreset(opts.permission)) {
+      throw new Error(
+        `Invalid --permission "${opts.permission}". Must be one of: ${PERMISSION_PRESETS.join(", ")}.`
+      );
+    }
+    if (alwaysAsk) {
+      return { decision: decisionFromPreset(opts.permission), alwaysAsk };
+    }
+    return opts.permission;
+  }
+  if (opts.yes) {
+    return alwaysAsk ? { decision: "allow", alwaysAsk } : "allow-this-session";
+  }
+  if (alwaysAsk) {
+    return { decision: "ask", alwaysAsk };
+  }
+  return void 0;
+}
+function readConfigPermission(config, profileName) {
+  if (!config?.profiles) return void 0;
+  const name = profileName ?? config.defaultProfile;
+  if (!name) return void 0;
+  const profile = config.profiles[name];
+  return profile?.security?.permission;
+}
+function resolveCliPermission(opts, config, profileName) {
+  return parseCliPermission(opts) ?? readConfigPermission(config, profileName);
+}
+function collect(value, previous = []) {
+  return [...previous, value];
+}
+function parseInteger(value) {
+  return Number.parseInt(value, 10);
+}
+function rootOptions(program) {
+  return program.opts();
+}
+function configFrom(program) {
+  return rootOptions(program)._resolvedConfig ?? null;
+}
+function resolveCliProfile(program) {
+  return rootOptions(program).profile;
+}
+function signalFrom(program) {
+  return rootOptions(program)._signal;
+}
+function parseMcpServerSpec(spec) {
+  const eq = spec.indexOf("=");
+  if (eq <= 0 || eq === spec.length - 1) {
+    throw new Error(
+      `Invalid --mcp-server value "${spec}". Use name=command or name={...json}.`
+    );
+  }
+  const name = spec.slice(0, eq).trim();
+  const value = spec.slice(eq + 1).trim();
+  if (!name) throw new Error("Invalid --mcp-server value: missing name.");
+  if (value.startsWith("{")) {
+    const parsed = JSON.parse(value);
+    return [name, parsed];
+  }
+  const [command, ...args] = value.split(/\s+/).filter(Boolean);
+  if (!command) throw new Error("Invalid --mcp-server value: missing command.");
+  return [name, args.length > 0 ? { command, args } : { command }];
+}
+function parseMcpServers(specs) {
+  if (!specs || specs.length === 0) return void 0;
+  return Object.fromEntries(specs.map(parseMcpServerSpec));
+}
+function cliAgentSkills(paths) {
+  if (!paths || paths.length === 0) return void 0;
+  return {
+    additionalPaths: paths,
+    enabled: true
+  };
+}
+function resolveCliBridgeRuntimeOptions(program, opts) {
+  const config = configFrom(program);
+  const profile = resolveCliProfile(program);
+  const agentSkills = mergeConfigAgentSkills(
+    config?.agentSkills,
+    cliAgentSkills(opts.skill)
+  );
+  return {
+    config,
+    profile,
+    signal: signalFrom(program),
+    bridgeOptions: {
+      agentSkills,
+      mcpConfigPath: opts.mcpConfig,
+      mcpServers: parseMcpServers(opts.mcpServer),
+      profile
+    }
+  };
+}
+function resolveCliServerRuntimeOptions(program, opts, defaults) {
+  const config = configFrom(program) ?? void 0;
+  return {
+    config,
+    host: opts.host ?? config?.server?.host ?? defaults.host,
+    port: opts.port ?? config?.server?.port ?? defaults.port,
+    signal: signalFrom(program)
+  };
+}
+function resolveCliFrameworkWorkspaceOptions(program, opts, defaults) {
+  const workspace = configFrom(program)?.frameworkWorkspace;
+  return {
+    dir: opts.dir ?? workspace?.dir ?? defaults.dir,
+    outDir: opts.out ?? workspace?.outDir ?? defaults.outDir
+  };
+}
+export {
+  collect,
+  parseCliPermission,
+  parseInteger,
+  readConfigPermission,
+  resolveCliBridgeRuntimeOptions,
+  resolveCliFrameworkWorkspaceOptions,
+  resolveCliPermission,
+  resolveCliProfile,
+  resolveCliServerRuntimeOptions
+};
+//# sourceMappingURL=runtime-options.js.map

package/dist/cli/lifecycle/runtime-options.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/cli/lifecycle/runtime-options.ts"],
+  "sourcesContent": ["import type { Command } from 'commander';\n\nimport type { BridgeMcpServerConfig } from '../../capabilities/types.js';\nimport type { OctoFlowConfig } from '../../config/config.js';\nimport type {\n  PermissionConfig,\n  PermissionPreset,\n} from '../../domain/permission.js';\nimport type { BridgeOptions } from '../../runtime/bridge/bridge.js';\nimport { mergeConfigAgentSkills } from '../../runtime/bridge/config-bridge-helpers.js';\nimport type { AgentSkillsOptions } from '../../runtime/sessions/agent-skills-types.js';\n\nexport interface CliBridgeOptionFlags {\n  mcpConfig?: string;\n  mcpServer?: string[];\n  skill?: string[];\n  permission?: string;\n  yes?: boolean;\n  alwaysAsk?: string[];\n}\n\nconst PERMISSION_PRESETS: readonly PermissionPreset[] = [\n  'allow-all',\n  'allow-this-session',\n  'ask',\n  'deny-all',\n  'deny-this-session',\n];\n\nfunction isPermissionPreset(value: string): value is PermissionPreset {\n  return (PERMISSION_PRESETS as readonly string[]).includes(value);\n}\n\nfunction decisionFromPreset(\n  preset: PermissionPreset\n): 'allow' | 'ask' | 'deny' {\n  if (preset === 'ask') return 'ask';\n  return preset.startsWith('deny') ? 'deny' : 'allow';\n}\n\n/**\n * Translate CLI permission flags into a {@link PermissionConfig}.\n *\n * Resolution order (highest precedence first):\n *   1. `--permission <preset>` \u2014 explicit preset.\n *   2. `-y` / `--yes`          \u2014 shorthand for `allow-this-session`.\n *\n * `--always-ask <name>` is repeatable and layers on top to force specific\n * tool names back to the prompt; useful alongside `--permission allow-all`\n * to keep a few sensitive tools guarded. Returns `undefined` when no\n * permission flags were passed.\n */\nexport function parseCliPermission(\n  opts: Pick<CliBridgeOptionFlags, 'permission' | 'yes' | 'alwaysAsk'>\n): PermissionConfig | undefined {\n  const alwaysAsk =\n    opts.alwaysAsk && opts.alwaysAsk.length > 0 ? opts.alwaysAsk : undefined;\n\n  if (opts.permission) {\n    if (!isPermissionPreset(opts.permission)) {\n      throw new Error(\n        `Invalid --permission \"${opts.permission}\". Must be one of: ${PERMISSION_PRESETS.join(', ')}.`\n      );\n    }\n    if (alwaysAsk) {\n      return { decision: decisionFromPreset(opts.permission), alwaysAsk };\n    }\n    return opts.permission;\n  }\n\n  if (opts.yes) {\n    return alwaysAsk ? { decision: 'allow', alwaysAsk } : 'allow-this-session';\n  }\n\n  if (alwaysAsk) {\n    return { decision: 'ask', alwaysAsk };\n  }\n\n  return undefined;\n}\n\n/**\n * Read a `permission` preset from the loaded `octoflow.config.json` for the\n * active profile. Falls back to `config.defaultProfile` when no explicit\n * profile name is set. Returns `undefined` when no config is loaded or the\n * profile does not declare one \u2014 callers layer this under\n * {@link parseCliPermission} so CLI flags always win.\n */\nexport function readConfigPermission(\n  config: OctoFlowConfig | null | undefined,\n  profileName: string | undefined\n): PermissionConfig | undefined {\n  if (!config?.profiles) return undefined;\n  const name = profileName ?? config.defaultProfile;\n  if (!name) return undefined;\n  const profile = config.profiles[name];\n  return profile?.security?.permission;\n}\n\n/**\n * Resolve the effective `permission` config for a CLI invocation.\n *\n * Precedence (first defined wins):\n *\n *   1. CLI flags  (`--permission` / `-y` / `--always-ask`)\n *   2. `octoflow.config.json` \u2192 `profiles[<active>].security.permission`\n *\n * Per-send `BridgeSendMessageParams.permission` and bridge-level\n * `BridgeOptions.permission` precedence is handled inside the runtime\n * resolver \u2014 this helper only feeds the per-send slot from the CLI surface.\n */\nexport function resolveCliPermission(\n  opts: Pick<CliBridgeOptionFlags, 'permission' | 'yes' | 'alwaysAsk'>,\n  config: OctoFlowConfig | null | undefined,\n  profileName: string | undefined\n): PermissionConfig | undefined {\n  return parseCliPermission(opts) ?? readConfigPermission(config, profileName);\n}\n\nexport interface CliFrameworkWorkspaceFlags {\n  dir?: string;\n  out?: string;\n}\n\nexport interface CliServerOptionFlags {\n  host?: string;\n  port?: number;\n}\n\nexport interface ResolvedCliBridgeRuntimeOptions {\n  bridgeOptions: Pick<\n    BridgeOptions,\n    'agentSkills' | 'mcpConfigPath' | 'mcpOptions' | 'mcpServers' | 'profile'\n  >;\n  config: OctoFlowConfig | null;\n  profile?: string;\n  signal?: AbortSignal;\n}\n\nexport interface ResolvedCliServerRuntimeOptions {\n  config?: OctoFlowConfig;\n  host: string;\n  port: number;\n  signal?: AbortSignal;\n}\n\nexport function collect(value: string, previous: string[] = []): string[] {\n  return [...previous, value];\n}\n\nexport function parseInteger(value: string): number {\n  return Number.parseInt(value, 10);\n}\n\nfunction rootOptions(program: Command): {\n  _resolvedConfig?: OctoFlowConfig | null;\n  _signal?: AbortSignal;\n  profile?: string;\n} {\n  return program.opts<{\n    _resolvedConfig?: OctoFlowConfig | null;\n    _signal?: AbortSignal;\n    profile?: string;\n  }>();\n}\n\nfunction configFrom(program: Command): OctoFlowConfig | null {\n  return rootOptions(program)._resolvedConfig ?? null;\n}\n\nexport function resolveCliProfile(program: Command): string | undefined {\n  return rootOptions(program).profile;\n}\n\nfunction signalFrom(program: Command): AbortSignal | undefined {\n  return rootOptions(program)._signal;\n}\n\nfunction parseMcpServerSpec(spec: string): [string, BridgeMcpServerConfig] {\n  const eq = spec.indexOf('=');\n  if (eq <= 0 || eq === spec.length - 1) {\n    throw new Error(\n      `Invalid --mcp-server value \"${spec}\". Use name=command or name={...json}.`\n    );\n  }\n  const name = spec.slice(0, eq).trim();\n  const value = spec.slice(eq + 1).trim();\n  if (!name) throw new Error('Invalid --mcp-server value: missing name.');\n  if (value.startsWith('{')) {\n    const parsed = JSON.parse(value) as BridgeMcpServerConfig;\n    return [name, parsed];\n  }\n  const [command, ...args] = value.split(/\\s+/).filter(Boolean);\n  if (!command) throw new Error('Invalid --mcp-server value: missing command.');\n  return [name, args.length > 0 ? { command, args } : { command }];\n}\n\nfunction parseMcpServers(\n  specs: string[] | undefined\n): Record<string, BridgeMcpServerConfig> | undefined {\n  if (!specs || specs.length === 0) return undefined;\n  return Object.fromEntries(specs.map(parseMcpServerSpec));\n}\n\nfunction cliAgentSkills(\n  paths: string[] | undefined\n): AgentSkillsOptions | undefined {\n  if (!paths || paths.length === 0) return undefined;\n  return {\n    additionalPaths: paths,\n    enabled: true,\n  };\n}\n\nexport function resolveCliBridgeRuntimeOptions(\n  program: Command,\n  opts: CliBridgeOptionFlags\n): ResolvedCliBridgeRuntimeOptions {\n  const config = configFrom(program);\n  const profile = resolveCliProfile(program);\n  const agentSkills = mergeConfigAgentSkills(\n    config?.agentSkills,\n    cliAgentSkills(opts.skill)\n  );\n\n  return {\n    config,\n    profile,\n    signal: signalFrom(program),\n    bridgeOptions: {\n      agentSkills,\n      mcpConfigPath: opts.mcpConfig,\n      mcpServers: parseMcpServers(opts.mcpServer),\n      profile,\n    },\n  };\n}\n\nexport function resolveCliServerRuntimeOptions(\n  program: Command,\n  opts: CliServerOptionFlags,\n  defaults: { host: string; port: number }\n): ResolvedCliServerRuntimeOptions {\n  const config = configFrom(program) ?? undefined;\n  return {\n    config,\n    host: opts.host ?? config?.server?.host ?? defaults.host,\n    port: opts.port ?? config?.server?.port ?? defaults.port,\n    signal: signalFrom(program),\n  };\n}\n\nexport function resolveCliFrameworkWorkspaceOptions(\n  program: Command,\n  opts: CliFrameworkWorkspaceFlags,\n  defaults: { dir: string; outDir?: string }\n): { dir: string; outDir?: string } {\n  const workspace = configFrom(program)?.frameworkWorkspace;\n  return {\n    dir: opts.dir ?? workspace?.dir ?? defaults.dir,\n    outDir: opts.out ?? workspace?.outDir ?? defaults.outDir,\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cli/lifecycle/server-listen.d.ts

@@ -0,0 +1,7 @@
+import type { Server as HttpServer } from 'node:http';
+import type { Server as HttpsServer } from 'node:https';
+export type CliServer = HttpServer | HttpsServer;
+export declare function isServerNotRunningError(error: unknown): boolean;
+export declare function listenOnServer(server: CliServer, host: string, port: number): Promise<void>;
+export declare function waitForServerExit(server: CliServer): Promise<Error | null>;
+//# sourceMappingURL=server-listen.d.ts.map

package/dist/cli/lifecycle/server-listen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-listen.d.ts","sourceRoot":"","sources":["../../../src/cli/lifecycle/server-listen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;AAEjD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAO/D;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAc1E"}

package/dist/cli/lifecycle/server-listen.js

@@ -0,0 +1,37 @@
+function isServerNotRunningError(error) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === "ERR_SERVER_NOT_RUNNING";
+}
+function listenOnServer(server, host, port) {
+  return new Promise((resolve, reject) => {
+    const onError = (error) => {
+      server.off("error", onError);
+      reject(error);
+    };
+    const onListening = () => {
+      server.off("error", onError);
+      resolve();
+    };
+    server.once("error", onError);
+    server.listen(port, host, onListening);
+  });
+}
+function waitForServerExit(server) {
+  return new Promise((resolve) => {
+    const onClose = () => {
+      server.off("error", onError);
+      resolve(null);
+    };
+    const onError = (error) => {
+      server.off("close", onClose);
+      resolve(error);
+    };
+    server.once("close", onClose);
+    server.once("error", onError);
+  });
+}
+export {
+  isServerNotRunningError,
+  listenOnServer,
+  waitForServerExit
+};
+//# sourceMappingURL=server-listen.js.map