octoflow-core 1.0.0

package/dist/runtime/bridge/agent-route-builders.js

@@ -0,0 +1,321 @@
+import crypto from "node:crypto";
+import { createHandoffAction } from "../../actions/handoff.js";
+import { DEFAULT_PRIORITY } from "../../config/defaults.js";
+import {
+  isAllNativeCliBackends,
+  resolvePriorityFilters
+} from "../../domain/backend-runtime.js";
+import { OctoFlowError } from "../../domain/errors/index.js";
+import {
+  applyAgentTypePromptToBridgeOptions,
+  applyAgentTypePromptToPackOptions
+} from "../../prompts/agent-type.js";
+import {
+  createDebateDecide,
+  createExplorePlanExecute,
+  createMapReduce,
+  createPackAsync,
+  PackMesh
+} from "../orchestration/pack.js";
+import { bridgeAgentHandle, packAgentHandle } from "./agent-handle.js";
+import { registerAgentRoute } from "./agent-route-registry.js";
+import { createBridge } from "./create-bridge.js";
+import { mergeBackendOverrides } from "./merge-backend-overrides.js";
+import { wireSwarmHandoffPeer } from "./swarm-handoff.js";
+import { TopicChannel } from "./topic-channel.js";
+function bridgePriority(options) {
+  const { backend, apiKey, host, ...rest } = options;
+  const resolvedOptions = rest;
+  if (backend && !resolvedOptions.priority?.length) {
+    resolvedOptions.priority = [backend];
+  }
+  const targetBackend = backend ?? resolvedOptions.priority?.[0];
+  if (apiKey && targetBackend) {
+    resolvedOptions.apiKeys = {
+      [targetBackend]: apiKey,
+      ...resolvedOptions.apiKeys
+    };
+  }
+  if (host && targetBackend) {
+    resolvedOptions.backends = mergeBackendOverrides(
+      resolvedOptions.backends,
+      targetBackend,
+      host
+    );
+  }
+  return {
+    ...resolvedOptions,
+    priority: resolvePriorityFilters({
+      backendType: resolvedOptions.backendType,
+      llmProvider: resolvedOptions.llmProvider,
+      order: DEFAULT_PRIORITY,
+      priority: resolvedOptions.priority
+    })
+  };
+}
+function stripAgentType(options) {
+  const { agentType: _agentType, ...rest } = options;
+  return rest;
+}
+function stripAgentKeys(options) {
+  const {
+    agentType: _agentType,
+    backendType: _backendType,
+    llmProvider: _llmProvider,
+    onEvent: _onEvent,
+    backend: _backend,
+    apiKey: _apiKey,
+    host: _host,
+    model: _model,
+    systemPrompt: _systemPrompt,
+    llm: _llm,
+    sessions: _sessions,
+    prompt: _prompt,
+    ...rest
+  } = options;
+  return rest;
+}
+function isAllNativeCli(priority) {
+  return isAllNativeCliBackends(priority);
+}
+function applyNativeCliDefaults(opts) {
+  if (!isAllNativeCli(opts.priority)) return opts;
+  return {
+    ...opts,
+    builtinActions: false
+  };
+}
+function applyAgentLoopOffDefaults(opts) {
+  const loopDisabled = opts.agentLoop === false || typeof opts.agentLoop === "object" && opts.agentLoop.enabled === false;
+  if (!loopDisabled) return opts;
+  return {
+    ...opts.builtinActions === void 0 ? { builtinActions: false } : {},
+    ...opts
+  };
+}
+function bridgeOptions(agentType, options) {
+  const resolved = applyAgentTypePromptToBridgeOptions(
+    agentType,
+    bridgePriority(
+      stripAgentType(options)
+    )
+  );
+  return applyAgentLoopOffDefaults(applyNativeCliDefaults(resolved));
+}
+function packOptions(agentType, options) {
+  const {
+    backendType,
+    llmProvider,
+    onEvent,
+    backend,
+    apiKey,
+    host,
+    model,
+    systemPrompt,
+    sessions: _sessions,
+    prompt: _prompt,
+    ...pack
+  } = options;
+  const targetBackend = backend ?? pack.leader?.priority?.[0];
+  const priority = resolvePriorityFilters({
+    backendType,
+    llmProvider,
+    order: DEFAULT_PRIORITY,
+    priority: backend ? [backend] : pack.leader?.priority
+  });
+  const shared = {
+    ...pack.shared,
+    ...model !== void 0 && !pack.shared?.model ? { model } : {},
+    ...systemPrompt !== void 0 && !pack.shared?.systemPrompt ? { systemPrompt } : {},
+    ...apiKey && backend ? { apiKeys: { [backend]: apiKey, ...pack.shared?.apiKeys } } : {}
+  };
+  const leaderBackendsFromHost = host && targetBackend ? mergeBackendOverrides(pack.leader?.backends, targetBackend, host) : pack.leader?.backends;
+  const leaderOverrides = {
+    ...priority ? { priority } : {},
+    ...leaderBackendsFromHost ? { backends: leaderBackendsFromHost } : {}
+  };
+  return applyAgentTypePromptToPackOptions(agentType, {
+    ...pack,
+    ...Object.keys(leaderOverrides).length > 0 ? { leader: { ...pack.leader, ...leaderOverrides } } : {},
+    ...Object.keys(shared).length > 0 ? { shared } : {},
+    onEvent
+  });
+}
+async function rehydratePackAsync(pack) {
+  const options = pack.getConfig().options;
+  await pack.closeAsync();
+  return createPackAsync(options);
+}
+function requireNonEmptyArray(value, key, agentType) {
+  if (!Array.isArray(value) || value.length === 0) {
+    throw new OctoFlowError(
+      "AGENT_ROUTE_VALIDATION_FAILED",
+      `Agent type "${agentType}" requires a non-empty "${key}" array.`,
+      { agentType, key }
+    );
+  }
+}
+function registerBuiltInAgentRoutes() {
+  registerAgentRoute("tool-loop", {
+    config: { selectableFromDefaults: true },
+    validate: () => void 0,
+    build: async (options) => bridgeAgentHandle(
+      "tool-loop",
+      await createBridge(bridgeOptions("tool-loop", options))
+    )
+  });
+  registerAgentRoute("loop", {
+    config: { selectableFromDefaults: true },
+    validate: () => void 0,
+    build: async (options) => bridgeAgentHandle(
+      "loop",
+      await createBridge(
+        bridgeOptions("loop", {
+          ...options,
+          builtinActions: options.builtinActions ?? false
+        })
+      )
+    )
+  });
+  registerAgentRoute("code-act", {
+    config: { selectableFromDefaults: false },
+    validate: () => void 0,
+    build: async (options) => bridgeAgentHandle(
+      "code-act",
+      await createBridge(bridgeOptions("code-act", options))
+    )
+  });
+  registerAgentRoute("sequential", {
+    config: { selectableFromDefaults: false },
+    validate: (options) => requireNonEmptyArray(
+      options.steps && Object.keys(options.steps),
+      "steps",
+      "sequential"
+    ),
+    build: async (options) => {
+      const seq = stripAgentKeys(options);
+      const flow = {
+        steps: seq.steps,
+        edges: seq.edges ?? [],
+        ...seq.maxIterations !== void 0 ? { maxIterations: seq.maxIterations } : {}
+      };
+      const bridge = await createBridge(bridgeOptions("sequential", options));
+      return bridgeAgentHandle("sequential", bridge, { flow });
+    }
+  });
+  registerAgentRoute("supervisor", {
+    config: { selectableFromDefaults: false },
+    validate: (options) => requireNonEmptyArray(
+      options.workers,
+      "workers",
+      "supervisor"
+    ),
+    build: async (options) => packAgentHandle(
+      "supervisor",
+      await createPackAsync(
+        packOptions("supervisor", stripAgentType(options))
+      )
+    )
+  });
+  registerAgentRoute("swarm", {
+    config: { selectableFromDefaults: false },
+    validate: (options) => requireNonEmptyArray(
+      options.peers,
+      "peers",
+      "swarm"
+    ),
+    build: async (options) => {
+      const swarm = stripAgentType(options);
+      const source = swarm.handoffSource ?? `swarm-${crypto.randomUUID()}`;
+      const pack = await createPackAsync(
+        packOptions("swarm", { ...swarm, workers: swarm.peers })
+      );
+      const mesh = new PackMesh(pack.topics ?? new TopicChannel());
+      mesh.register({
+        packId: source,
+        capabilities: ["handoff", "swarm"],
+        metadata: {}
+      });
+      for (const peer of swarm.peers) {
+        mesh.register({
+          packId: peer.name,
+          capabilities: ["handoff", "worker"],
+          metadata: {}
+        });
+        wireSwarmHandoffPeer(pack, mesh, peer.name);
+      }
+      pack.leader._packMesh = mesh;
+      pack.leader.registry.registerAction(createHandoffAction(source));
+      return packAgentHandle("swarm", pack);
+    }
+  });
+  registerAgentRoute("parallel", {
+    config: { selectableFromDefaults: false },
+    validate: (options) => requireNonEmptyArray(
+      options.items,
+      "items",
+      "parallel"
+    ),
+    build: async (options) => packAgentHandle(
+      "parallel",
+      await rehydratePackAsync(
+        createMapReduce(
+          packOptions(
+            "parallel",
+            stripAgentType(options)
+          )
+        )
+      )
+    )
+  });
+  registerAgentRoute("plan-execute", {
+    config: { selectableFromDefaults: false },
+    validate: () => void 0,
+    build: async (options) => packAgentHandle(
+      "plan-execute",
+      await rehydratePackAsync(
+        createExplorePlanExecute(
+          packOptions(
+            "plan-execute",
+            stripAgentType(options)
+          )
+        )
+      )
+    )
+  });
+  registerAgentRoute("reflection", {
+    config: { selectableFromDefaults: false },
+    validate: () => void 0,
+    build: async (options) => packAgentHandle(
+      "reflection",
+      await rehydratePackAsync(
+        createDebateDecide(
+          packOptions(
+            "reflection",
+            stripAgentType(options)
+          )
+        )
+      )
+    )
+  });
+  registerAgentRoute("react", {
+    config: { selectableFromDefaults: false },
+    validate: () => void 0,
+    build: async (options) => bridgeAgentHandle(
+      "react",
+      await createBridge(bridgeOptions("react", options))
+    )
+  });
+}
+export {
+  bridgeOptions,
+  bridgePriority,
+  isAllNativeCli,
+  packOptions,
+  registerBuiltInAgentRoutes,
+  rehydratePackAsync,
+  requireNonEmptyArray,
+  stripAgentKeys,
+  stripAgentType
+};
+//# sourceMappingURL=agent-route-builders.js.map

package/dist/runtime/bridge/agent-route-builders.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/agent-route-builders.ts"],
+  "sourcesContent": ["/**\n * Built-in agent route registrations and their private helper functions.\n * All helpers are package-private \u2014 only consumed by `agent-routes.ts`.\n */\nimport crypto from 'node:crypto';\n\nimport { createHandoffAction } from '../../actions/handoff.js';\nimport { DEFAULT_PRIORITY } from '../../config/defaults.js';\nimport {\n  isAllNativeCliBackends,\n  resolvePriorityFilters,\n} from '../../domain/backend-runtime.js';\nimport type { BackendName } from '../../domain/core-client.js';\nimport { OctoFlowError } from '../../domain/errors/index.js';\nimport {\n  applyAgentTypePromptToBridgeOptions,\n  applyAgentTypePromptToPackOptions,\n} from '../../prompts/agent-type.js';\nimport {\n  createDebateDecide,\n  createExplorePlanExecute,\n  createMapReduce,\n  createPackAsync,\n  type DebateDecideOptions,\n  type ExplorePlanExecuteOptions,\n  type MapReduceOptions,\n  type Pack,\n  PackMesh,\n  type PackOptions,\n} from '../orchestration/pack.js';\nimport type { FlowConfig } from '../orchestration/run/types.js';\nimport type { BridgeOptions } from '../sessions/context-types.js';\nimport { bridgeAgentHandle, packAgentHandle } from './agent-handle.js';\nimport { registerAgentRoute } from './agent-route-registry.js';\nimport type {\n  AgentType,\n  AgentTypeOptions,\n  CreateAgentCommonOptions,\n  CreateAgentOptions,\n  ParallelAgentOptions,\n  SequentialAgentOptions,\n  SwarmAgentOptions,\n} from './agent-route-types.js';\nimport { createBridge } from './create-bridge.js';\nimport { mergeBackendOverrides } from './merge-backend-overrides.js';\nimport { wireSwarmHandoffPeer } from './swarm-handoff.js';\nimport { TopicChannel } from './topic-channel.js';\n\n/** Expand `backend`/`apiKey`/`host` shorthands and resolve priority. */\nexport function bridgePriority<\n  T extends BridgeOptions & CreateAgentCommonOptions,\n>(options: T): T {\n  const { backend, apiKey, host, ...rest } = options as T &\n    Required<Pick<CreateAgentCommonOptions, 'backend' | 'apiKey' | 'host'>>;\n  const resolvedOptions = rest as BridgeOptions & CreateAgentCommonOptions;\n\n  if (backend && !resolvedOptions.priority?.length) {\n    resolvedOptions.priority = [backend];\n  }\n  const targetBackend = backend ?? resolvedOptions.priority?.[0];\n  if (apiKey && targetBackend) {\n    resolvedOptions.apiKeys = {\n      [targetBackend]: apiKey,\n      ...resolvedOptions.apiKeys,\n    };\n  }\n  if (host && targetBackend) {\n    resolvedOptions.backends = mergeBackendOverrides(\n      resolvedOptions.backends,\n      targetBackend,\n      host\n    );\n  }\n\n  return {\n    ...resolvedOptions,\n    priority: resolvePriorityFilters({\n      backendType: resolvedOptions.backendType,\n      llmProvider: resolvedOptions.llmProvider,\n      order: DEFAULT_PRIORITY,\n      priority: resolvedOptions.priority,\n    }),\n  } as T;\n}\n\nexport function stripAgentType<T extends AgentType>(\n  options: CreateAgentOptions<T>\n): AgentTypeOptions<T> & CreateAgentCommonOptions {\n  const { agentType: _agentType, ...rest } = options as Record<string, unknown>;\n  return rest;\n}\n\nexport function stripAgentKeys<T extends AgentType>(\n  options: CreateAgentOptions<T>\n): AgentTypeOptions<T> {\n  const {\n    agentType: _agentType,\n    backendType: _backendType,\n    llmProvider: _llmProvider,\n    onEvent: _onEvent,\n    backend: _backend,\n    apiKey: _apiKey,\n    host: _host,\n    model: _model,\n    systemPrompt: _systemPrompt,\n    llm: _llm,\n    sessions: _sessions,\n    prompt: _prompt,\n    ...rest\n  } = options as Record<string, unknown>;\n  return rest;\n}\n\n/**\n * Returns true when every backend in the priority list manages its own tool\n * loop and MCP natively (`nativeTools: true`, `backendType: 'cli'`).\n */\nexport function isAllNativeCli(\n  priority: readonly BackendName[] | undefined\n): boolean {\n  return isAllNativeCliBackends(priority);\n}\n\nfunction applyNativeCliDefaults(opts: BridgeOptions): BridgeOptions {\n  if (!isAllNativeCli(opts.priority)) return opts;\n  return {\n    ...opts,\n    builtinActions: false,\n  };\n}\n\n/**\n * When `agentLoop` is explicitly disabled (`false` or `{ enabled: false }`),\n * default `builtinActions` to `false` so that tool schemas are not sent in\n * the request. There is no point loading 11 built-in tools when the caller\n * has opted out of OctoFlow's agentic loop.\n *\n * User-explicit `builtinActions` always wins over this default.\n */\nfunction applyAgentLoopOffDefaults(opts: BridgeOptions): BridgeOptions {\n  const loopDisabled =\n    opts.agentLoop === false ||\n    (typeof opts.agentLoop === 'object' && opts.agentLoop.enabled === false);\n  if (!loopDisabled) return opts;\n  return {\n    ...(opts.builtinActions === undefined ? { builtinActions: false } : {}),\n    ...opts,\n  };\n}\n\nexport function bridgeOptions<T extends AgentType>(\n  agentType: T,\n  options: CreateAgentOptions<T>\n): BridgeOptions {\n  const resolved = applyAgentTypePromptToBridgeOptions(\n    agentType,\n    bridgePriority(\n      stripAgentType(options) as BridgeOptions & CreateAgentCommonOptions\n    )\n  );\n  return applyAgentLoopOffDefaults(applyNativeCliDefaults(resolved));\n}\n\nexport function packOptions<T extends AgentType>(\n  agentType: T,\n  options: PackOptions & CreateAgentCommonOptions\n): PackOptions {\n  const {\n    backendType,\n    llmProvider,\n    onEvent,\n    backend,\n    apiKey,\n    host,\n    model,\n    systemPrompt,\n    sessions: _sessions,\n    prompt: _prompt,\n    ...pack\n  } = options;\n  const targetBackend = backend ?? pack.leader?.priority?.[0];\n  const priority = resolvePriorityFilters({\n    backendType,\n    llmProvider,\n    order: DEFAULT_PRIORITY,\n    priority: backend ? ([backend] as BackendName[]) : pack.leader?.priority,\n  });\n  const shared = {\n    ...pack.shared,\n    ...(model !== undefined && !pack.shared?.model ? { model } : {}),\n    ...(systemPrompt !== undefined && !pack.shared?.systemPrompt\n      ? { systemPrompt }\n      : {}),\n    ...(apiKey && backend\n      ? { apiKeys: { [backend]: apiKey, ...pack.shared?.apiKeys } }\n      : {}),\n  };\n  const leaderBackendsFromHost =\n    host && targetBackend\n      ? mergeBackendOverrides(pack.leader?.backends, targetBackend, host)\n      : pack.leader?.backends;\n  const leaderOverrides = {\n    ...(priority ? { priority } : {}),\n    ...(leaderBackendsFromHost ? { backends: leaderBackendsFromHost } : {}),\n  };\n  return applyAgentTypePromptToPackOptions(agentType, {\n    ...pack,\n    ...(Object.keys(leaderOverrides).length > 0\n      ? { leader: { ...pack.leader, ...leaderOverrides } }\n      : {}),\n    ...(Object.keys(shared).length > 0 ? { shared } : {}),\n    onEvent,\n  });\n}\n\n\nexport async function rehydratePackAsync(pack: Pack): Promise<Pack> {\n  const options = pack.getConfig().options;\n  await pack.closeAsync();\n  return createPackAsync(options);\n}\n\nexport function requireNonEmptyArray(\n  value: unknown,\n  key: string,\n  agentType: string\n): void {\n  if (!Array.isArray(value) || value.length === 0) {\n    throw new OctoFlowError(\n      'AGENT_ROUTE_VALIDATION_FAILED',\n      `Agent type \"${agentType}\" requires a non-empty \"${key}\" array.`,\n      { agentType, key }\n    );\n  }\n}\n\nexport function registerBuiltInAgentRoutes(): void {\n  registerAgentRoute('tool-loop', {\n    config: { selectableFromDefaults: true },\n    validate: () => undefined,\n    build: async (options) =>\n      bridgeAgentHandle(\n        'tool-loop',\n        await createBridge(bridgeOptions('tool-loop', options))\n      ),\n  });\n\n  registerAgentRoute('loop', {\n    config: { selectableFromDefaults: true },\n    validate: () => undefined,\n    build: async (options) =>\n      bridgeAgentHandle(\n        'loop',\n        await createBridge(\n          bridgeOptions('loop', {\n            ...options,\n            builtinActions: options.builtinActions ?? false,\n          })\n        )\n      ),\n  });\n\n  registerAgentRoute('code-act', {\n    config: { selectableFromDefaults: false },\n    validate: () => undefined,\n    build: async (options) =>\n      bridgeAgentHandle(\n        'code-act',\n        await createBridge(bridgeOptions('code-act', options))\n      ),\n  });\n\n  registerAgentRoute('sequential', {\n    config: { selectableFromDefaults: false },\n    validate: (options) =>\n      requireNonEmptyArray(\n        (options as SequentialAgentOptions).steps &&\n          Object.keys((options as SequentialAgentOptions).steps),\n        'steps',\n        'sequential'\n      ),\n    build: async (options) => {\n      const seq = stripAgentKeys(options);\n      const flow: FlowConfig = {\n        steps: seq.steps,\n        edges: seq.edges ?? [],\n        ...(seq.maxIterations !== undefined\n          ? { maxIterations: seq.maxIterations }\n          : {}),\n      };\n      const bridge = await createBridge(bridgeOptions('sequential', options));\n      return bridgeAgentHandle('sequential', bridge, { flow });\n    },\n  });\n\n  registerAgentRoute('supervisor', {\n    config: { selectableFromDefaults: false },\n    validate: (options) =>\n      requireNonEmptyArray(\n        (options as PackOptions).workers,\n        'workers',\n        'supervisor'\n      ),\n    build: async (options) =>\n      packAgentHandle(\n        'supervisor',\n        await createPackAsync(\n          packOptions('supervisor', stripAgentType(options))\n        )\n      ),\n  });\n\n  registerAgentRoute('swarm', {\n    config: { selectableFromDefaults: false },\n    validate: (options) =>\n      requireNonEmptyArray(\n        (options as SwarmAgentOptions).peers,\n        'peers',\n        'swarm'\n      ),\n    build: async (options) => {\n      const swarm = stripAgentType(options);\n      const source = swarm.handoffSource ?? `swarm-${crypto.randomUUID()}`;\n      const pack = await createPackAsync(\n        packOptions('swarm', { ...swarm, workers: swarm.peers })\n      );\n      const mesh = new PackMesh(pack.topics ?? new TopicChannel());\n      mesh.register({\n        packId: source,\n        capabilities: ['handoff', 'swarm'],\n        metadata: {},\n      });\n      for (const peer of swarm.peers) {\n        mesh.register({\n          packId: peer.name,\n          capabilities: ['handoff', 'worker'],\n          metadata: {},\n        });\n        wireSwarmHandoffPeer(pack, mesh, peer.name);\n      }\n      pack.leader._packMesh = mesh;\n      pack.leader.registry.registerAction(createHandoffAction(source));\n      return packAgentHandle('swarm', pack);\n    },\n  });\n\n  registerAgentRoute('parallel', {\n    config: { selectableFromDefaults: false },\n    validate: (options) =>\n      requireNonEmptyArray(\n        (options as MapReduceOptions).items,\n        'items',\n        'parallel'\n      ),\n    build: async (options) =>\n      packAgentHandle(\n        'parallel',\n        await rehydratePackAsync(\n          createMapReduce(\n            packOptions(\n              'parallel',\n              stripAgentType(options) as unknown as PackOptions &\n                CreateAgentCommonOptions\n            ) as unknown as ParallelAgentOptions\n          )\n        )\n      ),\n  });\n\n  registerAgentRoute('plan-execute', {\n    config: { selectableFromDefaults: false },\n    validate: () => undefined,\n    build: async (options) =>\n      packAgentHandle(\n        'plan-execute',\n        await rehydratePackAsync(\n          createExplorePlanExecute(\n            packOptions(\n              'plan-execute',\n              stripAgentType(options) as PackOptions & CreateAgentCommonOptions\n            ) as ExplorePlanExecuteOptions\n          )\n        )\n      ),\n  });\n\n  registerAgentRoute('reflection', {\n    config: { selectableFromDefaults: false },\n    validate: () => undefined,\n    build: async (options) =>\n      packAgentHandle(\n        'reflection',\n        await rehydratePackAsync(\n          createDebateDecide(\n            packOptions(\n              'reflection',\n              stripAgentType(options) as PackOptions & CreateAgentCommonOptions\n            ) as DebateDecideOptions\n          )\n        )\n      ),\n  });\n\n  registerAgentRoute('react', {\n    config: { selectableFromDefaults: false },\n    validate: () => undefined,\n    build: async (options) =>\n      bridgeAgentHandle(\n        'react',\n        await createBridge(bridgeOptions('react', options))\n      ),\n  });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/runtime/bridge/agent-route-registry.d.ts

@@ -0,0 +1,14 @@
+import type { AgentHandle } from './agent-handle.js';
+import type { AgentRouteConfigPolicy, AgentType, CreateAgentOptions } from './agent-route-types.js';
+/**
+ * Descriptor that powers a single agent type inside `createAgent`.
+ * Register custom routes with {@link registerAgentRoute}.
+ */
+export interface AgentRoute<T extends AgentType = AgentType> {
+    readonly config?: AgentRouteConfigPolicy;
+    validate(options: CreateAgentOptions<T>): void;
+    build(options: CreateAgentOptions<T>): Promise<AgentHandle<T>>;
+}
+export declare function registerAgentRoute<T extends AgentType>(agentType: T, route: AgentRoute<T>): void;
+export declare function getRouteMap(): Map<string, AgentRoute>;
+//# sourceMappingURL=agent-route-registry.d.ts.map

package/dist/runtime/bridge/agent-route-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-route-registry.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/agent-route-registry.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EACV,sBAAsB,EACtB,SAAS,EACT,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAEhC;;;GAGG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS;IACzD,QAAQ,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/C,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CAChE;AAID,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,SAAS,EACpD,SAAS,EAAE,CAAC,EACZ,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GACnB,IAAI,CASN;AAED,wBAAgB,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAErD"}

package/dist/runtime/bridge/agent-route-registry.js

@@ -0,0 +1,20 @@
+import { OctoFlowError } from "../../domain/errors/index.js";
+const routes = /* @__PURE__ */ new Map();
+function registerAgentRoute(agentType, route) {
+  if (routes.has(agentType)) {
+    throw new OctoFlowError(
+      "AGENT_ROUTE_ALREADY_REGISTERED",
+      `Agent route "${agentType}" is already registered.`,
+      { agentType }
+    );
+  }
+  routes.set(agentType, route);
+}
+function getRouteMap() {
+  return routes;
+}
+export {
+  getRouteMap,
+  registerAgentRoute
+};
+//# sourceMappingURL=agent-route-registry.js.map

package/dist/runtime/bridge/agent-route-registry.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/agent-route-registry.ts"],
+  "sourcesContent": ["/**\n * Core agent route registry \u2014 the mutable store that maps AgentType \u2192 AgentRoute.\n * Kept in a separate module so both `agent-routes.ts` and `agent-route-builders.ts`\n * can import from it without a circular dependency.\n */\nimport { OctoFlowError } from '../../domain/errors/index.js';\nimport type { AgentHandle } from './agent-handle.js';\nimport type {\n  AgentRouteConfigPolicy,\n  AgentType,\n  CreateAgentOptions,\n} from './agent-route-types.js';\n\n/**\n * Descriptor that powers a single agent type inside `createAgent`.\n * Register custom routes with {@link registerAgentRoute}.\n */\nexport interface AgentRoute<T extends AgentType = AgentType> {\n  readonly config?: AgentRouteConfigPolicy;\n  validate(options: CreateAgentOptions<T>): void;\n  build(options: CreateAgentOptions<T>): Promise<AgentHandle<T>>;\n}\n\nconst routes = new Map<string, AgentRoute>();\n\nexport function registerAgentRoute<T extends AgentType>(\n  agentType: T,\n  route: AgentRoute<T>\n): void {\n  if (routes.has(agentType)) {\n    throw new OctoFlowError(\n      'AGENT_ROUTE_ALREADY_REGISTERED',\n      `Agent route \"${agentType}\" is already registered.`,\n      { agentType }\n    );\n  }\n  routes.set(agentType, route);\n}\n\nexport function getRouteMap(): Map<string, AgentRoute> {\n  return routes;\n}\n"],
+  "mappings": "AAKA,SAAS,qBAAqB;AAkB9B,MAAM,SAAS,oBAAI,IAAwB;AAEpC,SAAS,mBACd,WACA,OACM;AACN,MAAI,OAAO,IAAI,SAAS,GAAG;AACzB,UAAM,IAAI;AAAA,MACR;AAAA,MACA,gBAAgB,SAAS;AAAA,MACzB,EAAE,UAAU;AAAA,IACd;AAAA,EACF;AACA,SAAO,IAAI,WAAW,KAAK;AAC7B;AAEO,SAAS,cAAuC;AACrD,SAAO;AACT;",
+  "names": []
+}