octoflow-core 1.0.0

package/dist/runtime/bridge/config-validation.d.ts

@@ -0,0 +1,18 @@
+import type { OctoFlowConfig } from '../../config/config.js';
+import type { BridgeEventEmitter } from './events.js';
+export declare function validateBridgeConfig(opts: {
+    priority?: string[];
+    actionNames?: string[];
+    actions?: unknown[];
+    tools?: {
+        definitions?: unknown[];
+    };
+    apiKeys?: Record<string, string | undefined>;
+    backends?: Record<string, {
+        host?: string;
+    } | undefined>;
+    builtinActions?: unknown;
+    config?: OctoFlowConfig;
+    suppressWarnings?: boolean;
+}, events: BridgeEventEmitter): void;
+//# sourceMappingURL=config-validation.d.ts.map

package/dist/runtime/bridge/config-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validation.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/config-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE;IACJ,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAC;IACzD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,EACD,MAAM,EAAE,kBAAkB,GACzB,IAAI,CA0CN"}

package/dist/runtime/bridge/config-validation.js

@@ -0,0 +1,86 @@
+import { BRIDGE_WARNING_CODES } from "./warnings.js";
+function validateBridgeConfig(opts, events) {
+  if (opts.suppressWarnings) return;
+  if (opts.priority && opts.priority.length === 0) {
+    void events.emit("bridge:warn", {
+      code: BRIDGE_WARNING_CODES.NO_BACKENDS_CONFIGURED,
+      message: "priority array is empty \u2014 no backends will be tried."
+    });
+  }
+  const apiBackends = (opts.priority ?? []).filter(
+    (b) => b === "openai-api" || b === "anthropic-api"
+  );
+  if (apiBackends.length > 0 && !opts.apiKeys) {
+    const envKeys = apiBackends.map(
+      (b) => b === "openai-api" ? "OPENAI_API_KEY" : "ANTHROPIC_API_KEY"
+    );
+    const missing = envKeys.filter((k) => !process.env[k]);
+    if (missing.length > 0) {
+      void events.emit("bridge:warn", {
+        code: BRIDGE_WARNING_CODES.LIKELY_MISSING_CREDENTIALS,
+        message: `API backend(s) in priority but env var(s) not set: ${missing.join(", ")}. Pass apiKeys or set the env vars.`
+      });
+    }
+  }
+  const toolCount = countTools(opts);
+  if (toolCount > 20) {
+    void events.emit("bridge:warn", {
+      code: BRIDGE_WARNING_CODES.BROAD_TOOL_SURFACE,
+      message: `${toolCount} tool definitions registered. Consider using readOnlyTools() or devTools() instead of allTools() to follow least-privilege.`
+    });
+  }
+  warnCustomHostWithTools(opts, events);
+  validateConfigMcpServers(opts.config, events);
+  validateConfigSkills(opts.config, opts.actionNames, opts.actions, events);
+}
+function warnCustomHostWithTools(opts, events) {
+  if (opts.builtinActions === false) return;
+  if (countTools(opts) === 0) return;
+  const apiBackendsWithCustomHost = (opts.priority ?? []).filter((b) => {
+    if (b !== "openai-api" && b !== "anthropic-api") return false;
+    const overrideHost = opts.backends?.[b]?.host;
+    return !!overrideHost;
+  });
+  if (apiBackendsWithCustomHost.length === 0) return;
+  void events.emit("bridge:warn", {
+    code: BRIDGE_WARNING_CODES.TOOLS_MAY_NOT_BE_SUPPORTED,
+    message: `Backend(s) [${apiBackendsWithCustomHost.join(", ")}] use a custom host and will receive tool schemas in every request. OpenAI-compatible servers (vLLM, Nebius, Groq, etc.) may reject tool-bearing requests or behave unexpectedly. Pass builtinActions:false to suppress tool injection, or builtinActions:{bash:false} to keep file tools while dropping shell access.`
+  });
+}
+function countTools(opts) {
+  const actionCount = Array.isArray(opts.actionNames) ? opts.actionNames.length : Array.isArray(opts.actions) ? opts.actions.length : 0;
+  const defCount = Array.isArray(opts.tools?.definitions) ? opts.tools.definitions.length : 0;
+  return actionCount + defCount;
+}
+function validateConfigMcpServers(config, events) {
+  if (!config?.mcpServers) return;
+  for (const [name, server] of Object.entries(config.mcpServers)) {
+    if (!server.command && !server.url) {
+      void events.emit("bridge:warn", {
+        code: BRIDGE_WARNING_CODES.INVALID_MCP_SERVER,
+        message: `Config mcpServers["${name}"] has neither "command" nor "url" \u2014 it will not be connectable.`
+      });
+    }
+  }
+}
+function validateConfigSkills(config, registeredActionNames, actions, events) {
+  if (!config?.skills || config.skills.length === 0) return;
+  const actionNameSet = new Set(
+    Array.isArray(registeredActionNames) ? registeredActionNames : Array.isArray(actions) ? actions.map((a) => a?.name).filter(Boolean) : []
+  );
+  for (const skill of config.skills) {
+    const missing = skill.actionNames.filter(
+      (name) => !actionNameSet.has(name)
+    );
+    if (missing.length > 0) {
+      void events.emit("bridge:warn", {
+        code: BRIDGE_WARNING_CODES.SKILL_UNKNOWN_ACTIONS,
+        message: `Config skill "${skill.name}" references unknown action(s): ${missing.join(", ")}.`
+      });
+    }
+  }
+}
+export {
+  validateBridgeConfig
+};
+//# sourceMappingURL=config-validation.js.map

package/dist/runtime/bridge/config-validation.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/config-validation.ts"],
+  "sourcesContent": ["import type { OctoFlowConfig } from '../../config/config.js';\nimport type { BridgeEventEmitter } from './events.js';\nimport { BRIDGE_WARNING_CODES } from './warnings.js';\n\nexport function validateBridgeConfig(\n  opts: {\n    priority?: string[];\n    actionNames?: string[];\n    actions?: unknown[];\n    tools?: { definitions?: unknown[] };\n    apiKeys?: Record<string, string | undefined>;\n    backends?: Record<string, { host?: string } | undefined>;\n    builtinActions?: unknown;\n    config?: OctoFlowConfig;\n    suppressWarnings?: boolean;\n  },\n  events: BridgeEventEmitter\n): void {\n  if (opts.suppressWarnings) return;\n\n  if (opts.priority && opts.priority.length === 0) {\n    void events.emit('bridge:warn', {\n      code: BRIDGE_WARNING_CODES.NO_BACKENDS_CONFIGURED,\n      message: 'priority array is empty \u2014 no backends will be tried.',\n    });\n  }\n\n  const apiBackends = (opts.priority ?? []).filter(\n    (b) => b === 'openai-api' || b === 'anthropic-api'\n  );\n  if (apiBackends.length > 0 && !opts.apiKeys) {\n    const envKeys = apiBackends.map((b) =>\n      b === 'openai-api' ? 'OPENAI_API_KEY' : 'ANTHROPIC_API_KEY'\n    );\n    const missing = envKeys.filter((k) => !process.env[k]);\n    if (missing.length > 0) {\n      void events.emit('bridge:warn', {\n        code: BRIDGE_WARNING_CODES.LIKELY_MISSING_CREDENTIALS,\n        message: `API backend(s) in priority but env var(s) not set: ${missing.join(', ')}. Pass apiKeys or set the env vars.`,\n      });\n    }\n  }\n\n  const toolCount = countTools(opts);\n  if (toolCount > 20) {\n    void events.emit('bridge:warn', {\n      code: BRIDGE_WARNING_CODES.BROAD_TOOL_SURFACE,\n      message: `${toolCount} tool definitions registered. Consider using readOnlyTools() or devTools() instead of allTools() to follow least-privilege.`,\n    });\n  }\n\n  // Warn when tools will be injected into a custom-host OpenAI-compatible backend.\n  // Non-OpenAI endpoints (vLLM, Nebius, Groq, Ollama proxies, etc.) may reject\n  // tool schemas or fail silently. Set builtinActions:false to disable tool injection,\n  // or builtinActions:{bash:false} to keep file tools while dropping the shell tool.\n  warnCustomHostWithTools(opts, events);\n\n  validateConfigMcpServers(opts.config, events);\n  validateConfigSkills(opts.config, opts.actionNames, opts.actions, events);\n}\n\nfunction warnCustomHostWithTools(\n  opts: {\n    priority?: string[];\n    backends?: Record<string, { host?: string } | undefined>;\n    builtinActions?: unknown;\n    actions?: unknown[];\n    actionNames?: string[];\n    tools?: { definitions?: unknown[] };\n  },\n  events: BridgeEventEmitter\n): void {\n  // Only relevant when there are tools to inject\n  if (opts.builtinActions === false) return;\n  if (countTools(opts) === 0) return;\n\n  const apiBackendsWithCustomHost = (opts.priority ?? []).filter((b) => {\n    if (b !== 'openai-api' && b !== 'anthropic-api') return false;\n    const overrideHost = opts.backends?.[b]?.host;\n    return !!overrideHost;\n  });\n\n  if (apiBackendsWithCustomHost.length === 0) return;\n\n  void events.emit('bridge:warn', {\n    code: BRIDGE_WARNING_CODES.TOOLS_MAY_NOT_BE_SUPPORTED,\n    message:\n      `Backend(s) [${apiBackendsWithCustomHost.join(', ')}] use a custom host and will receive ` +\n      `tool schemas in every request. OpenAI-compatible servers (vLLM, Nebius, Groq, etc.) may ` +\n      `reject tool-bearing requests or behave unexpectedly. ` +\n      `Pass builtinActions:false to suppress tool injection, or builtinActions:{bash:false} ` +\n      `to keep file tools while dropping shell access.`,\n  });\n}\n\nfunction countTools(opts: {\n  actionNames?: string[];\n  actions?: unknown[];\n  tools?: { definitions?: unknown[] };\n}): number {\n  const actionCount = Array.isArray(opts.actionNames)\n    ? opts.actionNames.length\n    : Array.isArray(opts.actions)\n      ? opts.actions.length\n      : 0;\n  const defCount = Array.isArray(opts.tools?.definitions)\n    ? opts.tools.definitions.length\n    : 0;\n  return actionCount + defCount;\n}\n\nfunction validateConfigMcpServers(\n  config: OctoFlowConfig | undefined,\n  events: BridgeEventEmitter\n): void {\n  if (!config?.mcpServers) return;\n  for (const [name, server] of Object.entries(config.mcpServers)) {\n    if (!server.command && !server.url) {\n      void events.emit('bridge:warn', {\n        code: BRIDGE_WARNING_CODES.INVALID_MCP_SERVER,\n        message: `Config mcpServers[\"${name}\"] has neither \"command\" nor \"url\" \u2014 it will not be connectable.`,\n      });\n    }\n  }\n}\n\nfunction validateConfigSkills(\n  config: OctoFlowConfig | undefined,\n  registeredActionNames: string[] | undefined,\n  actions: unknown[] | undefined,\n  events: BridgeEventEmitter\n): void {\n  if (!config?.skills || config.skills.length === 0) return;\n\n  const actionNameSet = new Set(\n    Array.isArray(registeredActionNames)\n      ? registeredActionNames\n      : Array.isArray(actions)\n        ? actions.map((a) => (a as { name?: string })?.name).filter(Boolean)\n        : []\n  );\n\n  for (const skill of config.skills) {\n    const missing = skill.actionNames.filter(\n      (name) => !actionNameSet.has(name)\n    );\n    if (missing.length > 0) {\n      void events.emit('bridge:warn', {\n        code: BRIDGE_WARNING_CODES.SKILL_UNKNOWN_ACTIONS,\n        message: `Config skill \"${skill.name}\" references unknown action(s): ${missing.join(', ')}.`,\n      });\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/runtime/bridge/configure.d.ts

@@ -0,0 +1,40 @@
+import type { OctoFlowConfig } from '../../config/config.js';
+import type { BackendName } from '../../domain/core-client.js';
+import type { LoopConfig } from '../orchestration/run/types.js';
+import type { BridgeOptions } from '../sessions/context-types.js';
+export interface AgentHotConfigPatch {
+    loop?: Partial<LoopConfig>;
+    model?: string;
+    priority?: BackendName[];
+    retries?: number;
+    systemPrompt?: string;
+    timeoutMs?: number;
+}
+export type AgentRestartConfigPatch = Partial<Pick<OctoFlowConfig, 'brain' | 'hooks' | 'mcpOptions' | 'mcpServers' | 'skills' | 'storage' | 'taskStore' | 'tools'>> & {
+    defaults?: Partial<NonNullable<OctoFlowConfig['defaults']>>;
+};
+export type AgentConfigPatch = AgentHotConfigPatch & AgentRestartConfigPatch;
+export type AgentConfigureInput = {
+    config: AgentHotConfigPatch;
+    restart?: false;
+} | {
+    config: AgentConfigPatch;
+    restart: true;
+    strategy?: 'graceful' | 'immediate';
+};
+export interface AgentConfigureResult {
+    applied: boolean;
+    changed: string[];
+    requiresRestart: string[];
+    restarted: boolean;
+}
+export declare function classifyAgentConfigPatch(config: AgentConfigPatch): {
+    changed: string[];
+    hot: string[];
+    requiresRestart: string[];
+    unsupported: string[];
+};
+export declare function assertAgentConfigPatchAllowed(input: AgentConfigureInput): ReturnType<typeof classifyAgentConfigPatch>;
+export declare function applyHotAgentConfigPatch(bridgeOptions: BridgeOptions, config: AgentHotConfigPatch): string[];
+export declare function configureBridgeRuntime(bridgeOptions: BridgeOptions, input: AgentConfigureInput, isDestroyed: () => boolean): Promise<AgentConfigureResult>;
+//# sourceMappingURL=configure.d.ts.map

package/dist/runtime/bridge/configure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/configure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAC3C,IAAI,CACF,cAAc,EACZ,OAAO,GACP,OAAO,GACP,YAAY,GACZ,YAAY,GACZ,QAAQ,GACR,SAAS,GACT,WAAW,GACX,OAAO,CACV,CACF,GAAG;IACF,QAAQ,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;CAC7D,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,GAAG,uBAAuB,CAAC;AAE7E,MAAM,MAAM,mBAAmB,GAC3B;IACE,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,CAAC,EAAE,KAAK,CAAC;CACjB,GACD;IACE,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;CACrC,CAAC;AAEN,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;CACpB;AAuBD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,GAAG;IAClE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAaA;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,mBAAmB,GACzB,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAiB7C;AAED,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,mBAAmB,GAC1B,MAAM,EAAE,CAgDV;AAED,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE,mBAAmB,EAC1B,WAAW,EAAE,MAAM,OAAO,GACzB,OAAO,CAAC,oBAAoB,CAAC,CA6B/B"}

package/dist/runtime/bridge/configure.js

@@ -0,0 +1,135 @@
+import { OctoFlowError } from "../../domain/errors/index.js";
+const HOT_CONFIG_KEYS = /* @__PURE__ */ new Set([
+  "loop",
+  "model",
+  "priority",
+  "retries",
+  "systemPrompt",
+  "timeoutMs"
+]);
+const RESTART_CONFIG_KEYS = /* @__PURE__ */ new Set([
+  "brain",
+  "defaults",
+  "hooks",
+  "mcpOptions",
+  "mcpServers",
+  "skills",
+  "storage",
+  "taskStore",
+  "tools"
+]);
+function classifyAgentConfigPatch(config) {
+  const changed = Object.keys(config).filter(
+    (key) => config[key] !== void 0
+  );
+  const hot = changed.filter(
+    (key) => HOT_CONFIG_KEYS.has(key)
+  );
+  const requiresRestart = changed.filter(
+    (key) => RESTART_CONFIG_KEYS.has(key)
+  );
+  const known = /* @__PURE__ */ new Set([...hot, ...requiresRestart]);
+  const unsupported = changed.filter((key) => !known.has(key));
+  return { changed, hot, requiresRestart, unsupported };
+}
+function assertAgentConfigPatchAllowed(input) {
+  const classification = classifyAgentConfigPatch(input.config);
+  if (classification.unsupported.length > 0) {
+    throw new OctoFlowError(
+      "AGENT_CONFIG_UNSUPPORTED_FIELD",
+      `Unsupported agent config field(s): ${classification.unsupported.join(", ")}.`,
+      { fields: classification.unsupported }
+    );
+  }
+  if (classification.requiresRestart.length > 0 && input.restart !== true) {
+    throw new OctoFlowError(
+      "AGENT_CONFIG_RESTART_REQUIRED",
+      `Agent config field(s) require restart: ${classification.requiresRestart.join(", ")}.`,
+      { requiresRestart: classification.requiresRestart }
+    );
+  }
+  return classification;
+}
+function applyHotAgentConfigPatch(bridgeOptions, config) {
+  const changed = [];
+  for (const key of Object.keys(config)) {
+    switch (key) {
+      case "model":
+        if (config.model !== void 0) {
+          bridgeOptions.model = config.model;
+          changed.push("model");
+        }
+        break;
+      case "timeoutMs":
+        if (config.timeoutMs !== void 0) {
+          bridgeOptions.timeoutMs = config.timeoutMs;
+          changed.push("timeoutMs");
+        }
+        break;
+      case "retries":
+        if (config.retries !== void 0) {
+          bridgeOptions.retries = config.retries;
+          changed.push("retries");
+        }
+        break;
+      case "systemPrompt":
+        if (config.systemPrompt !== void 0) {
+          bridgeOptions.systemPrompt = config.systemPrompt;
+          changed.push("systemPrompt");
+        }
+        break;
+      case "priority":
+        if (config.priority !== void 0) {
+          bridgeOptions.priority = [...config.priority];
+          changed.push("priority");
+        }
+        break;
+      case "loop":
+        if (config.loop !== void 0) {
+          bridgeOptions.loop = {
+            ...bridgeOptions.loop ?? {},
+            ...config.loop
+          };
+          changed.push("loop");
+        }
+        break;
+      default:
+        break;
+    }
+  }
+  return changed;
+}
+function configureBridgeRuntime(bridgeOptions, input, isDestroyed) {
+  if (isDestroyed()) return Promise.reject(new Error("Bridge is destroyed"));
+  let classification;
+  try {
+    classification = assertAgentConfigPatchAllowed(input);
+  } catch (error) {
+    return Promise.reject(
+      error instanceof Error ? error : new Error(String(error))
+    );
+  }
+  if (classification.requiresRestart.length > 0) {
+    return Promise.reject(
+      new OctoFlowError(
+        "AGENT_CONFIG_RESTART_UNSUPPORTED",
+        `Agent config restart is not supported yet for field(s): ${classification.requiresRestart.join(", ")}.`,
+        { requiresRestart: classification.requiresRestart }
+      )
+    );
+  }
+  const changed = applyHotAgentConfigPatch(bridgeOptions, input.config);
+  return Promise.resolve({
+    applied: changed.length > 0,
+    changed,
+    requiresRestart: [],
+    restarted: false
+  });
+}
+export {
+  applyHotAgentConfigPatch,
+  assertAgentConfigPatchAllowed,
+  classifyAgentConfigPatch,
+  configureBridgeRuntime
+};
+//# sourceMappingURL=configure.js.map

package/dist/runtime/bridge/configure.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/configure.ts"],
+  "sourcesContent": ["import type { OctoFlowConfig } from '../../config/config.js';\nimport type { BackendName } from '../../domain/core-client.js';\nimport { OctoFlowError } from '../../domain/errors/index.js';\nimport type { LoopConfig } from '../orchestration/run/types.js';\nimport type { BridgeOptions } from '../sessions/context-types.js';\n\nexport interface AgentHotConfigPatch {\n  loop?: Partial<LoopConfig>;\n  model?: string;\n  priority?: BackendName[];\n  retries?: number;\n  systemPrompt?: string;\n  timeoutMs?: number;\n}\n\nexport type AgentRestartConfigPatch = Partial<\n  Pick<\n    OctoFlowConfig,\n    | 'brain'\n    | 'hooks'\n    | 'mcpOptions'\n    | 'mcpServers'\n    | 'skills'\n    | 'storage'\n    | 'taskStore'\n    | 'tools'\n  >\n> & {\n  defaults?: Partial<NonNullable<OctoFlowConfig['defaults']>>;\n};\n\nexport type AgentConfigPatch = AgentHotConfigPatch & AgentRestartConfigPatch;\n\nexport type AgentConfigureInput =\n  | {\n      config: AgentHotConfigPatch;\n      restart?: false;\n    }\n  | {\n      config: AgentConfigPatch;\n      restart: true;\n      strategy?: 'graceful' | 'immediate';\n    };\n\nexport interface AgentConfigureResult {\n  applied: boolean;\n  changed: string[];\n  requiresRestart: string[];\n  restarted: boolean;\n}\n\nconst HOT_CONFIG_KEYS = new Set<keyof AgentHotConfigPatch>([\n  'loop',\n  'model',\n  'priority',\n  'retries',\n  'systemPrompt',\n  'timeoutMs',\n]);\n\nconst RESTART_CONFIG_KEYS = new Set<keyof AgentRestartConfigPatch>([\n  'brain',\n  'defaults',\n  'hooks',\n  'mcpOptions',\n  'mcpServers',\n  'skills',\n  'storage',\n  'taskStore',\n  'tools',\n]);\n\nexport function classifyAgentConfigPatch(config: AgentConfigPatch): {\n  changed: string[];\n  hot: string[];\n  requiresRestart: string[];\n  unsupported: string[];\n} {\n  const changed = Object.keys(config).filter(\n    (key) => (config as Record<string, unknown>)[key] !== undefined\n  );\n  const hot = changed.filter((key) =>\n    HOT_CONFIG_KEYS.has(key as keyof AgentHotConfigPatch)\n  );\n  const requiresRestart = changed.filter((key) =>\n    RESTART_CONFIG_KEYS.has(key as keyof AgentRestartConfigPatch)\n  );\n  const known = new Set([...hot, ...requiresRestart]);\n  const unsupported = changed.filter((key) => !known.has(key));\n  return { changed, hot, requiresRestart, unsupported };\n}\n\nexport function assertAgentConfigPatchAllowed(\n  input: AgentConfigureInput\n): ReturnType<typeof classifyAgentConfigPatch> {\n  const classification = classifyAgentConfigPatch(input.config);\n  if (classification.unsupported.length > 0) {\n    throw new OctoFlowError(\n      'AGENT_CONFIG_UNSUPPORTED_FIELD',\n      `Unsupported agent config field(s): ${classification.unsupported.join(', ')}.`,\n      { fields: classification.unsupported }\n    );\n  }\n  if (classification.requiresRestart.length > 0 && input.restart !== true) {\n    throw new OctoFlowError(\n      'AGENT_CONFIG_RESTART_REQUIRED',\n      `Agent config field(s) require restart: ${classification.requiresRestart.join(', ')}.`,\n      { requiresRestart: classification.requiresRestart }\n    );\n  }\n  return classification;\n}\n\nexport function applyHotAgentConfigPatch(\n  bridgeOptions: BridgeOptions,\n  config: AgentHotConfigPatch\n): string[] {\n  const changed: string[] = [];\n  for (const key of Object.keys(config) as Array<keyof AgentHotConfigPatch>) {\n    switch (key) {\n      case 'model':\n        if (config.model !== undefined) {\n          bridgeOptions.model = config.model;\n          changed.push('model');\n        }\n        break;\n      case 'timeoutMs':\n        if (config.timeoutMs !== undefined) {\n          bridgeOptions.timeoutMs = config.timeoutMs;\n          changed.push('timeoutMs');\n        }\n        break;\n      case 'retries':\n        if (config.retries !== undefined) {\n          bridgeOptions.retries = config.retries;\n          changed.push('retries');\n        }\n        break;\n      case 'systemPrompt':\n        if (config.systemPrompt !== undefined) {\n          bridgeOptions.systemPrompt = config.systemPrompt;\n          changed.push('systemPrompt');\n        }\n        break;\n      case 'priority':\n        if (config.priority !== undefined) {\n          bridgeOptions.priority = [...config.priority];\n          changed.push('priority');\n        }\n        break;\n      case 'loop':\n        if (config.loop !== undefined) {\n          bridgeOptions.loop = {\n            ...(bridgeOptions.loop ?? {}),\n            ...config.loop,\n          };\n          changed.push('loop');\n        }\n        break;\n      default:\n        break;\n    }\n  }\n  return changed;\n}\n\nexport function configureBridgeRuntime(\n  bridgeOptions: BridgeOptions,\n  input: AgentConfigureInput,\n  isDestroyed: () => boolean\n): Promise<AgentConfigureResult> {\n  if (isDestroyed()) return Promise.reject(new Error('Bridge is destroyed'));\n\n  let classification: ReturnType<typeof assertAgentConfigPatchAllowed>;\n  try {\n    classification = assertAgentConfigPatchAllowed(input);\n  } catch (error) {\n    return Promise.reject(\n      error instanceof Error ? error : new Error(String(error))\n    );\n  }\n\n  if (classification.requiresRestart.length > 0) {\n    return Promise.reject(\n      new OctoFlowError(\n        'AGENT_CONFIG_RESTART_UNSUPPORTED',\n        `Agent config restart is not supported yet for field(s): ${classification.requiresRestart.join(', ')}.`,\n        { requiresRestart: classification.requiresRestart }\n      )\n    );\n  }\n\n  const changed = applyHotAgentConfigPatch(bridgeOptions, input.config);\n  return Promise.resolve({\n    applied: changed.length > 0,\n    changed,\n    requiresRestart: [],\n    restarted: false,\n  });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/runtime/bridge/context-compaction-resolution.d.ts

@@ -0,0 +1,4 @@
+import type { BackendName } from '../../domain/core-client.js';
+import type { ContextCompactionOptions, ResolvedBridgeOptions } from '../sessions/context-manager.js';
+export declare function resolveContextCompactionOptions(backend: BackendName, options: Pick<ResolvedBridgeOptions, 'contextCompaction' | 'maxContext' | 'model'>, modelOverride?: string): ContextCompactionOptions | undefined;
+//# sourceMappingURL=context-compaction-resolution.d.ts.map

package/dist/runtime/bridge/context-compaction-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-compaction-resolution.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/context-compaction-resolution.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,gCAAgC,CAAC;AAExC,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,IAAI,CACX,qBAAqB,EACrB,mBAAmB,GAAG,YAAY,GAAG,OAAO,CAC7C,EACD,aAAa,CAAC,EAAE,MAAM,GACrB,wBAAwB,GAAG,SAAS,CAyBtC"}

package/dist/runtime/bridge/context-compaction-resolution.js

@@ -0,0 +1,25 @@
+import { backendTokenEstimator } from "../../capabilities/context-compaction.js";
+import { resolveModelBudget } from "../../config/model-budget.js";
+function resolveContextCompactionOptions(backend, options, modelOverride) {
+  const compaction = options.contextCompaction;
+  if (compaction === false) return void 0;
+  const resolvedCompaction = compaction ?? { strategy: "truncate" };
+  const estimator = resolvedCompaction.estimator ?? backendTokenEstimator(backend);
+  if (resolvedCompaction.maxTokens != null) {
+    return { ...resolvedCompaction, estimator };
+  }
+  if (options.maxContext === 0) return void 0;
+  const resolvedModel = modelOverride ?? options.model;
+  const budget = resolveModelBudget(backend, resolvedModel, {
+    contextTokens: options.maxContext
+  });
+  return {
+    ...resolvedCompaction,
+    maxTokens: budget.compactAt,
+    estimator
+  };
+}
+export {
+  resolveContextCompactionOptions
+};
+//# sourceMappingURL=context-compaction-resolution.js.map

package/dist/runtime/bridge/context-compaction-resolution.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/context-compaction-resolution.ts"],
+  "sourcesContent": ["import { backendTokenEstimator } from '../../capabilities/context-compaction.js';\nimport { resolveModelBudget } from '../../config/model-budget.js';\nimport type { BackendName } from '../../domain/core-client.js';\nimport type {\n  ContextCompactionOptions,\n  ResolvedBridgeOptions,\n} from '../sessions/context-manager.js';\n\nexport function resolveContextCompactionOptions(\n  backend: BackendName,\n  options: Pick<\n    ResolvedBridgeOptions,\n    'contextCompaction' | 'maxContext' | 'model'\n  >,\n  modelOverride?: string\n): ContextCompactionOptions | undefined {\n  const compaction = options.contextCompaction;\n  if (compaction === false) return undefined;\n\n  // `maxContext: 0` is the documented disable signal for derived budgets;\n  // explicit `contextCompaction.maxTokens` remains a caller override.\n\n  const resolvedCompaction = compaction ?? { strategy: 'truncate' as const };\n  const estimator =\n    resolvedCompaction.estimator ?? backendTokenEstimator(backend);\n  if (resolvedCompaction.maxTokens != null) {\n    return { ...resolvedCompaction, estimator };\n  }\n\n  if (options.maxContext === 0) return undefined;\n\n  const resolvedModel = modelOverride ?? options.model;\n  const budget = resolveModelBudget(backend, resolvedModel, {\n    contextTokens: options.maxContext,\n  });\n  return {\n    ...resolvedCompaction,\n    maxTokens: budget.compactAt,\n    estimator,\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,6BAA6B;AACtC,SAAS,0BAA0B;AAO5B,SAAS,gCACd,SACA,SAIA,eACsC;AACtC,QAAM,aAAa,QAAQ;AAC3B,MAAI,eAAe,MAAO,QAAO;AAKjC,QAAM,qBAAqB,cAAc,EAAE,UAAU,WAAoB;AACzE,QAAM,YACJ,mBAAmB,aAAa,sBAAsB,OAAO;AAC/D,MAAI,mBAAmB,aAAa,MAAM;AACxC,WAAO,EAAE,GAAG,oBAAoB,UAAU;AAAA,EAC5C;AAEA,MAAI,QAAQ,eAAe,EAAG,QAAO;AAErC,QAAM,gBAAgB,iBAAiB,QAAQ;AAC/C,QAAM,SAAS,mBAAmB,SAAS,eAAe;AAAA,IACxD,eAAe,QAAQ;AAAA,EACzB,CAAC;AACD,SAAO;AAAA,IACL,GAAG;AAAA,IACH,WAAW,OAAO;AAAA,IAClB;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/runtime/bridge/create-agent.d.ts

@@ -0,0 +1,55 @@
+import type { AgentHandle } from './agent-handle.js';
+import type { AgentType, CreateAgentOptions } from './agent-routes.js';
+/**
+ * Create and start an OctoFlow agent.
+ *
+ * The default agent type is `'tool-loop'` — a single-agent loop with full
+ * tool-call support. Use `agentType` to select any
+ * built-in type, or a custom type registered via `registerAgentRoute`.
+ *
+ * **Common patterns**
+ *
+ * ```ts
+ * // Simplest: default tool-loop agent
+ * const agent = await createAgent();
+ *
+ * // Pin a backend by shorthand
+ * const agent = await createAgent({ backend: 'ollama', host: 'http://localhost:11434' });
+ *
+ * // Multi-agent supervisor
+ * const agent = await createAgent({
+ *   agentType: 'supervisor',
+ *   workers: [{ name: 'researcher' }, { name: 'writer' }],
+ * });
+ *
+ * // Load agent type from config file (octoflow.config.ts)
+ * const agent = await createAgent({ config: myConfig });
+ * ```
+ *
+ * **Agent type quick-reference**
+ *
+ * | `agentType`     | Use when…                                               |
+ * |-----------------|----------------------------------------------------------|
+ * | `tool-loop`     | Single agent, general-purpose tasks (default)           |
+ * | `loop`          | Like `tool-loop` but without built-in tool presets      |
+ * | `code-act`      | Code generation and execution                           |
+ * | `sequential`    | Fixed ordered steps (DAG)                               |
+ * | `supervisor`    | Leader delegates to named worker agents                 |
+ * | `swarm`         | Peer mesh, any agent can hand off to any other          |
+ * | `parallel`      | Fan-out map-reduce over a list of items                 |
+ * | `plan-execute`  | Plan first, then execute                                |
+ * | `reflection`    | Debate-decide (adversarial critique → final answer)     |
+ * | `react`         | Explicit Thought → Action → Observation loop           |
+ *
+ * @typeParam T - Agent type literal, inferred from `agentType` when provided.
+ * @param options - Agent configuration. All fields are optional for `tool-loop`.
+ * @returns       A fully initialised `AgentHandle<T>`.
+ * @throws        `OctoFlowError('UNKNOWN_AGENT_TYPE')` for unregistered types.
+ * @throws        `OctoFlowError('AGENT_ROUTE_VALIDATION_FAILED')` when required options are missing.
+ */
+export declare function createAgent(): Promise<AgentHandle<'tool-loop'>>;
+export declare function createAgent<T extends AgentType>(options: CreateAgentOptions<T> & {
+    agentType: T;
+}): Promise<AgentHandle<T>>;
+export declare function createAgent(options: CreateAgentOptions<'tool-loop'>): Promise<AgentHandle<'tool-loop'>>;
+//# sourceMappingURL=create-agent.d.ts.map

package/dist/runtime/bridge/create-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-agent.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/create-agent.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EAEV,SAAS,EACT,kBAAkB,EAEnB,MAAM,mBAAmB,CAAC;AA8O3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC;AACvE,wBAAsB,WAAW,CAAC,CAAC,SAAS,SAAS,EACnD,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG;IAAE,SAAS,EAAE,CAAC,CAAA;CAAE,GAChD,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3B,wBAAsB,WAAW,CAC/B,OAAO,EAAE,kBAAkB,CAAC,WAAW,CAAC,GACvC,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC"}

package/dist/runtime/bridge/create-agent.js

@@ -0,0 +1,140 @@
+import { SshProcessRunner } from "../../adapters/agents/runtime/ssh-runner.js";
+import {
+  loadConfig,
+  resolveConfig,
+  resolveProfile
+} from "../../config/config.js";
+import { OctoFlowError } from "../../domain/errors/index.js";
+import { getAgentRoute } from "./agent-routes.js";
+import { resolveLlmSelection } from "./llm-selection.js";
+function applyLlmShorthand(options) {
+  const llm = options.llm;
+  if (!llm) return options;
+  const resolved = resolveLlmSelection(llm);
+  const base = options;
+  return {
+    ...base,
+    ...resolved.priority && !base.backend && !base.priority?.length ? { priority: resolved.priority } : {},
+    ...resolved.backend && !resolved.priority && !base.backend && !base.priority?.length ? { backend: resolved.backend } : {},
+    ...resolved.backendType && !base.backendType ? { backendType: resolved.backendType } : {},
+    ...resolved.model && !base.model ? { model: resolved.model } : {},
+    ...resolved.customApi && !base.customApi ? { customApi: resolved.customApi } : {},
+    ...resolved.customCli && !base.customCli ? { customCli: resolved.customCli } : {},
+    ...resolved.providerFallbacks && !base.providerFallbacks ? { providerFallbacks: resolved.providerFallbacks } : {},
+    // Merge apiKeys: explicit top-level/apiKeys win over llm.apiKey.
+    ...resolved.apiKeys && !base.apiKey ? { apiKeys: { ...resolved.apiKeys, ...base.apiKeys ?? {} } } : {},
+    // Merge backends: explicit top-level host/backends win over llm.host.
+    ...resolved.backends && !base.host ? { backends: { ...resolved.backends, ...base.backends ?? {} } } : {}
+  };
+}
+function applySessionsShorthand(options) {
+  const sessions = options.sessions;
+  if (!sessions) return options;
+  const { sessions: _dropped, ...rest } = options;
+  return {
+    ...rest,
+    ...sessions.dynamic !== void 0 && !("dynamicSession" in rest) ? { dynamicSession: sessions.dynamic } : {},
+    ...sessions.store !== void 0 && !("sessionStore" in rest) ? { sessionStore: sessions.store } : {},
+    ...sessions.backendMobility !== void 0 && !("sessionBackendMobility" in rest) ? { sessionBackendMobility: sessions.backendMobility } : {},
+    ...sessions.gc !== void 0 && !("sessionGc" in rest) ? { sessionGc: sessions.gc } : {},
+    ...sessions.maxContexts !== void 0 && !("maxContexts" in rest) ? { maxContexts: sessions.maxContexts } : {},
+    ...sessions.maxQueueDepth !== void 0 && !("maxQueueDepth" in rest) ? { maxQueueDepth: sessions.maxQueueDepth } : {},
+    ...sessions.contextTtlMs !== void 0 && !("contextTtlMs" in rest) ? { contextTtlMs: sessions.contextTtlMs } : {}
+  };
+}
+function applyPromptShorthand(options) {
+  const prompt = options.prompt;
+  if (!prompt) return options;
+  const { prompt: _dropped, ...rest } = options;
+  return {
+    ...rest,
+    ...prompt.system !== void 0 && !("systemPrompt" in rest) ? { systemPrompt: prompt.system } : {},
+    ...prompt.caller !== void 0 && !("userSystemPrompt" in rest) ? { userSystemPrompt: prompt.caller } : {},
+    ...prompt.parts !== void 0 && !("systemPromptParts" in rest) ? { systemPromptParts: prompt.parts } : {}
+  };
+}
+function applyMcpShorthand(options) {
+  const mcp = options.mcp;
+  if (!mcp) return options;
+  const { mcp: _dropped, ...rest } = options;
+  return {
+    ...rest,
+    // Merge servers: shorthand first so explicit mcpServers wins per-key
+    ...mcp.servers !== void 0 ? {
+      mcpServers: {
+        ...mcp.servers,
+        ...rest.mcpServers ?? {}
+      }
+    } : {},
+    ...mcp.configPath !== void 0 && !("mcpConfigPath" in rest) ? { mcpConfigPath: mcp.configPath } : {},
+    ...mcp.options !== void 0 && !("mcpOptions" in rest) ? { mcpOptions: mcp.options } : {}
+  };
+}
+function applySshShorthand(options) {
+  const ssh = options.ssh;
+  if (!ssh) return options;
+  const { ssh: _dropped, ...rest } = options;
+  return {
+    ...rest,
+    ..."runner" in rest ? {} : { runner: new SshProcessRunner(ssh) }
+  };
+}
+function applyToolsShorthand(options) {
+  const tools = options.tools;
+  if (!tools || tools.length === 0) return options;
+  const { tools: _dropped, ...rest } = options;
+  const existing = rest.actions ?? [];
+  return {
+    ...rest,
+    // Explicit actions win: tools provides the base, explicit actions override per entry
+    actions: [...tools, ...existing]
+  };
+}
+function applyShorthands(options) {
+  return applyToolsShorthand(
+    applySshShorthand(
+      applyMcpShorthand(
+        applyPromptShorthand(
+          applySessionsShorthand(
+            applyLlmShorthand(options)
+          )
+        )
+      )
+    )
+  );
+}
+function configuredAgentType(options) {
+  const config = options.config ?? loadConfig({ ignoreFileConfig: options.ignoreFileConfig === true }) ?? void 0;
+  if (!config) return void 0;
+  const profile = typeof options.profile === "string" ? options.profile : void 0;
+  return resolveProfile(profile, resolveConfig(config)).defaults.agentType;
+}
+function assertConfigSelectable(agentType, route) {
+  if (!route) return;
+  if (route.config?.selectableFromDefaults === false) {
+    throw new OctoFlowError(
+      "AGENT_TYPE_CONFIG_REQUIRES_CODE",
+      `Agent type "${agentType}" cannot be selected from file config in v1; pass route options in code.`,
+      { agentType }
+    );
+  }
+}
+async function createAgent(options = {}) {
+  const resolved = applyShorthands(options);
+  const agentType = resolved.agentType ?? configuredAgentType(resolved) ?? "tool-loop";
+  const route = getAgentRoute(agentType);
+  if (!resolved.agentType) assertConfigSelectable(agentType, route);
+  if (!route) {
+    throw new OctoFlowError(
+      "UNKNOWN_AGENT_TYPE",
+      `Unknown agentType "${agentType}".`,
+      { agentType }
+    );
+  }
+  route.validate(resolved);
+  return route.build(resolved);
+}
+export {
+  createAgent
+};
+//# sourceMappingURL=create-agent.js.map

package/dist/runtime/bridge/create-agent.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/create-agent.ts"],
+  "sourcesContent": ["import type { ActionDefinition } from '../../actions/types.js';\nimport { SshProcessRunner } from '../../adapters/agents/runtime/ssh-runner.js';\nimport type { SshRunnerOptions } from '../../adapters/agents/runtime/ssh-runner-types.js';\nimport type { OctoFlowConfig } from '../../config/config.js';\nimport {\n  loadConfig,\n  resolveConfig,\n  resolveProfile,\n} from '../../config/config.js';\nimport type { BackendName } from '../../domain/core-task.js';\nimport { OctoFlowError } from '../../domain/errors/index.js';\nimport type { BackendType } from '../../domain/protocol.js';\nimport type {\n  PromptConfig,\n  SessionsConfig,\n} from '../sessions/bridge-options.js';\nimport type { AgentHandle } from './agent-handle.js';\nimport type { McpConfig } from './agent-route-types.js';\nimport type {\n  AgentRoute,\n  AgentType,\n  CreateAgentOptions,\n  LlmSelection,\n} from './agent-routes.js';\nimport { getAgentRoute } from './agent-routes.js';\nimport type { ResolvedLlm } from './llm-selection.js';\nimport { resolveLlmSelection } from './llm-selection.js';\n\n/**\n * Apply `llm` shorthand into lower-level option fields before route dispatch.\n * Precedence: explicit caller fields > resolved `llm.*`.\n * `apiKeys` and `backends` are merged \u2014 per-key caller values win.\n */\nfunction applyLlmShorthand<T extends AgentType>(\n  options: CreateAgentOptions<T>\n): CreateAgentOptions<T> {\n  const llm = (options as { llm?: LlmSelection }).llm;\n  if (!llm) return options;\n  const resolved = resolveLlmSelection(llm);\n  const base = options as Record<string, unknown> & {\n    backend?: Exclude<BackendName, 'a2a'>;\n    backendType?: BackendType;\n    model?: string;\n    priority?: BackendName[];\n    apiKeys?: Partial<Record<string, string>>;\n    backends?: Partial<Record<string, { host?: string }>>;\n    customApi?: ResolvedLlm['customApi'];\n    customCli?: ResolvedLlm['customCli'];\n    providerFallbacks?: ResolvedLlm['providerFallbacks'];\n  };\n  return {\n    ...base,\n    ...(resolved.priority && !base.backend && !base.priority?.length\n      ? { priority: resolved.priority }\n      : {}),\n    ...(resolved.backend && !resolved.priority && !base.backend && !base.priority?.length\n      ? { backend: resolved.backend }\n      : {}),\n    ...(resolved.backendType && !base.backendType\n      ? { backendType: resolved.backendType }\n      : {}),\n    ...(resolved.model && !base.model ? { model: resolved.model } : {}),\n    ...(resolved.customApi && !base.customApi\n      ? { customApi: resolved.customApi }\n      : {}),\n    ...(resolved.customCli && !base.customCli\n      ? { customCli: resolved.customCli }\n      : {}),\n    ...(resolved.providerFallbacks && !base.providerFallbacks\n      ? { providerFallbacks: resolved.providerFallbacks }\n      : {}),\n    // Merge apiKeys: explicit top-level/apiKeys win over llm.apiKey.\n    ...(resolved.apiKeys && !base.apiKey\n      ? { apiKeys: { ...resolved.apiKeys, ...(base.apiKeys ?? {}) } }\n      : {}),\n    // Merge backends: explicit top-level host/backends win over llm.host.\n    ...(resolved.backends && !base.host\n      ? { backends: { ...resolved.backends, ...(base.backends ?? {}) } }\n      : {}),\n  };\n}\n\n/**\n * Expand `sessions` shorthand to flat `BridgeOptions` equivalents.\n * Explicit flat fields take precedence over `sessions.*`.\n * The `sessions` key is removed from the result.\n */\nfunction applySessionsShorthand<T extends AgentType>(\n  options: CreateAgentOptions<T>\n): CreateAgentOptions<T> {\n  const sessions = (options as { sessions?: SessionsConfig }).sessions;\n  if (!sessions) return options;\n  const { sessions: _dropped, ...rest } = options as Record<string, unknown>;\n  return {\n    ...rest,\n    ...(sessions.dynamic !== undefined && !('dynamicSession' in rest)\n      ? { dynamicSession: sessions.dynamic }\n      : {}),\n    ...(sessions.store !== undefined && !('sessionStore' in rest)\n      ? { sessionStore: sessions.store }\n      : {}),\n    ...(sessions.backendMobility !== undefined &&\n    !('sessionBackendMobility' in rest)\n      ? { sessionBackendMobility: sessions.backendMobility }\n      : {}),\n    ...(sessions.gc !== undefined && !('sessionGc' in rest)\n      ? { sessionGc: sessions.gc }\n      : {}),\n    ...(sessions.maxContexts !== undefined && !('maxContexts' in rest)\n      ? { maxContexts: sessions.maxContexts }\n      : {}),\n    ...(sessions.maxQueueDepth !== undefined && !('maxQueueDepth' in rest)\n      ? { maxQueueDepth: sessions.maxQueueDepth }\n      : {}),\n    ...(sessions.contextTtlMs !== undefined && !('contextTtlMs' in rest)\n      ? { contextTtlMs: sessions.contextTtlMs }\n      : {}),\n  };\n}\n\n/**\n * Expand `prompt` shorthand to flat `BridgeOptions` equivalents.\n * Explicit flat fields take precedence over `prompt.*`.\n * The `prompt` key is removed from the result.\n */\nfunction applyPromptShorthand<T extends AgentType>(\n  options: CreateAgentOptions<T>\n): CreateAgentOptions<T> {\n  const prompt = (options as { prompt?: PromptConfig }).prompt;\n  if (!prompt) return options;\n  const { prompt: _dropped, ...rest } = options as Record<string, unknown>;\n  return {\n    ...rest,\n    ...(prompt.system !== undefined && !('systemPrompt' in rest)\n      ? { systemPrompt: prompt.system }\n      : {}),\n    ...(prompt.caller !== undefined && !('userSystemPrompt' in rest)\n      ? { userSystemPrompt: prompt.caller }\n      : {}),\n    ...(prompt.parts !== undefined && !('systemPromptParts' in rest)\n      ? { systemPromptParts: prompt.parts }\n      : {}),\n  };\n}\n\n/**\n * Expand `mcp` shorthand to flat `BridgeOptions` equivalents.\n * Explicit flat fields take precedence over `mcp.*`.\n * `mcp.servers` is merged with explicit `mcpServers` \u2014 explicit wins per-key.\n * The `mcp` key is removed from the result.\n */\nfunction applyMcpShorthand<T extends AgentType>(\n  options: CreateAgentOptions<T>\n): CreateAgentOptions<T> {\n  const mcp = (options as { mcp?: McpConfig }).mcp;\n  if (!mcp) return options;\n  const { mcp: _dropped, ...rest } = options as Record<string, unknown>;\n  return {\n    ...rest,\n    // Merge servers: shorthand first so explicit mcpServers wins per-key\n    ...(mcp.servers !== undefined\n      ? {\n          mcpServers: {\n            ...mcp.servers,\n            ...((rest.mcpServers as Record<string, unknown> | undefined) ?? {}),\n          },\n        }\n      : {}),\n    ...(mcp.configPath !== undefined && !('mcpConfigPath' in rest)\n      ? { mcpConfigPath: mcp.configPath }\n      : {}),\n    ...(mcp.options !== undefined && !('mcpOptions' in rest)\n      ? { mcpOptions: mcp.options }\n      : {}),\n  } as CreateAgentOptions<T>;\n}\n\n/**\n * Expand `ssh` shorthand by constructing a `SshProcessRunner` and setting `runner`.\n * Explicit `runner` takes precedence.\n * The `ssh` key is removed from the result.\n */\nfunction applySshShorthand<T extends AgentType>(\n  options: CreateAgentOptions<T>\n): CreateAgentOptions<T> {\n  const ssh = (options as { ssh?: SshRunnerOptions }).ssh;\n  if (!ssh) return options;\n  const { ssh: _dropped, ...rest } = options as Record<string, unknown>;\n  return {\n    ...rest,\n    ...('runner' in rest ? {} : { runner: new SshProcessRunner(ssh) }),\n  };\n}\n\n/**\n * Expand `tools` shorthand to `actions`.\n * Explicit `actions` array takes precedence; `tools` is additive.\n * The `tools` key is removed from the result.\n */\nfunction applyToolsShorthand<T extends AgentType>(\n  options: CreateAgentOptions<T>\n): CreateAgentOptions<T> {\n  const tools = (options as { tools?: ActionDefinition[] }).tools;\n  if (!tools || tools.length === 0) return options;\n  const { tools: _dropped, ...rest } = options as Record<string, unknown>;\n  const existing = (rest.actions as ActionDefinition[] | undefined) ?? [];\n  return {\n    ...rest,\n    // Explicit actions win: tools provides the base, explicit actions override per entry\n    actions: [...tools, ...existing],\n  };\n}\n\n/** Apply all `createAgent` shorthands in order before route dispatch. */\nfunction applyShorthands<T extends AgentType>(\n  options: CreateAgentOptions<T>\n): CreateAgentOptions<T> {\n  return applyToolsShorthand(\n    applySshShorthand(\n      applyMcpShorthand(\n        applyPromptShorthand(\n          applySessionsShorthand(\n            applyLlmShorthand(options)\n          )\n        )\n      )\n    )\n  );\n}\n\nfunction configuredAgentType(\n  options: Record<string, unknown> & {\n    config?: OctoFlowConfig;\n    ignoreFileConfig?: boolean;\n    profile?: unknown;\n  }\n): AgentType | undefined {\n  const config =\n    options.config ??\n    loadConfig({ ignoreFileConfig: options.ignoreFileConfig === true }) ??\n    undefined;\n  if (!config) return undefined;\n  const profile =\n    typeof options.profile === 'string' ? options.profile : undefined;\n  return resolveProfile(profile, resolveConfig(config)).defaults.agentType;\n}\n\nfunction assertConfigSelectable(\n  agentType: string,\n  route: AgentRoute | undefined\n): void {\n  if (!route) return;\n  if (route.config?.selectableFromDefaults === false) {\n    throw new OctoFlowError(\n      'AGENT_TYPE_CONFIG_REQUIRES_CODE',\n      `Agent type \"${agentType}\" cannot be selected from file config in v1; pass route options in code.`,\n      { agentType }\n    );\n  }\n}\n\n/**\n * Create and start an OctoFlow agent.\n *\n * The default agent type is `'tool-loop'` \u2014 a single-agent loop with full\n * tool-call support. Use `agentType` to select any\n * built-in type, or a custom type registered via `registerAgentRoute`.\n *\n * **Common patterns**\n *\n * ```ts\n * // Simplest: default tool-loop agent\n * const agent = await createAgent();\n *\n * // Pin a backend by shorthand\n * const agent = await createAgent({ backend: 'ollama', host: 'http://localhost:11434' });\n *\n * // Multi-agent supervisor\n * const agent = await createAgent({\n *   agentType: 'supervisor',\n *   workers: [{ name: 'researcher' }, { name: 'writer' }],\n * });\n *\n * // Load agent type from config file (octoflow.config.ts)\n * const agent = await createAgent({ config: myConfig });\n * ```\n *\n * **Agent type quick-reference**\n *\n * | `agentType`     | Use when\u2026                                               |\n * |-----------------|----------------------------------------------------------|\n * | `tool-loop`     | Single agent, general-purpose tasks (default)           |\n * | `loop`          | Like `tool-loop` but without built-in tool presets      |\n * | `code-act`      | Code generation and execution                           |\n * | `sequential`    | Fixed ordered steps (DAG)                               |\n * | `supervisor`    | Leader delegates to named worker agents                 |\n * | `swarm`         | Peer mesh, any agent can hand off to any other          |\n * | `parallel`      | Fan-out map-reduce over a list of items                 |\n * | `plan-execute`  | Plan first, then execute                                |\n * | `reflection`    | Debate-decide (adversarial critique \u2192 final answer)     |\n * | `react`         | Explicit Thought \u2192 Action \u2192 Observation loop           |\n *\n * @typeParam T - Agent type literal, inferred from `agentType` when provided.\n * @param options - Agent configuration. All fields are optional for `tool-loop`.\n * @returns       A fully initialised `AgentHandle<T>`.\n * @throws        `OctoFlowError('UNKNOWN_AGENT_TYPE')` for unregistered types.\n * @throws        `OctoFlowError('AGENT_ROUTE_VALIDATION_FAILED')` when required options are missing.\n */\nexport async function createAgent(): Promise<AgentHandle<'tool-loop'>>;\nexport async function createAgent<T extends AgentType>(\n  options: CreateAgentOptions<T> & { agentType: T }\n): Promise<AgentHandle<T>>;\nexport async function createAgent(\n  options: CreateAgentOptions<'tool-loop'>\n): Promise<AgentHandle<'tool-loop'>>;\nexport async function createAgent<T extends AgentType = 'tool-loop'>(\n  options: CreateAgentOptions<T> = {}\n): Promise<AgentHandle<T>> {\n  const resolved = applyShorthands(options);\n  const agentType = (resolved.agentType ??\n    configuredAgentType(resolved as Record<string, unknown>) ??\n    'tool-loop') as T;\n  const route = getAgentRoute(agentType);\n  // Skip selectability check when the caller explicitly chose a type\n  if (!resolved.agentType) assertConfigSelectable(agentType, route);\n  if (!route) {\n    throw new OctoFlowError(\n      'UNKNOWN_AGENT_TYPE',\n      `Unknown agentType \"${agentType}\".`,\n      { agentType }\n    );\n  }\n  route.validate(resolved);\n  return route.build(resolved);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/runtime/bridge/create-bridge.d.ts

@@ -0,0 +1,6 @@
+import type { BridgePreset } from '../../domain/bridge-api.js';
+import type { BridgeOptions } from '../sessions/context-manager.js';
+import { Bridge } from './bridge.js';
+export declare function createBridge(opts?: BridgeOptions): Promise<Bridge>;
+export declare function createBridge(preset: BridgePreset, opts?: BridgeOptions): Promise<Bridge>;
+//# sourceMappingURL=create-bridge.d.ts.map