octoflow-core 1.0.0

package/dist/runtime/orchestration/pack/coordination.js

@@ -0,0 +1,260 @@
+import crypto from "node:crypto";
+import { forkLineage } from "../../../adapters/agents/registry/types.js";
+import { createBridge } from "../../bridge/create-bridge.js";
+import { contextFabricPlugin } from "../../bridge/fabric-plugin.js";
+const RUNTIME_INHERIT_KEYS = [
+  "agentSkills",
+  "apiKeys",
+  "backendType",
+  "backends",
+  "cache",
+  "config",
+  "context",
+  "contextCompaction",
+  "customApi",
+  "customCli",
+  "fallback",
+  "getToolsFromLocalContext",
+  "historyStrategy",
+  "llmProvider",
+  "localContext",
+  "maxContext",
+  "maxOutputTokens",
+  "maxSectionTokens",
+  "mcpConfigPath",
+  "mcpOptions",
+  "mcpServers",
+  "model",
+  "priority",
+  "profile",
+  "retries",
+  "routing",
+  "runner",
+  "security",
+  "actionBundles",
+  "suppressWarnings",
+  "timeoutMs",
+  "verbose",
+  "workspace"
+];
+const DEFAULT_INHERITED_HISTORY_MESSAGES = 20;
+function forkSession(parentLineage, parentContextId, options) {
+  const childContextId = crypto.randomUUID();
+  const isolation = options.isolation ?? parentLineage.isolation;
+  const lineage = forkLineage(parentLineage, options.agentName, {
+    contextId: parentContextId,
+    isolation
+  });
+  return { contextId: childContextId, lineage };
+}
+function buildChildBridgeOptions(inherit, parentBridge, childContextId, inheritTaskStore) {
+  const opts = {
+    taskStore: { type: "memory" }
+  };
+  if (inherit.runtime) {
+    Object.assign(opts, extractRuntimeBridgeOptions(parentBridge));
+    opts.taskStore = { type: "memory" };
+  }
+  if (inheritTaskStore) {
+    const parentStore = parentBridge.taskStore;
+    if (parentStore) {
+      opts.taskStore = parentStore;
+    }
+  }
+  if (inherit.systemPrompt) {
+    opts.systemPrompt = parentBridge.systemPrompt;
+  }
+  if (inherit.plugins && parentBridge.plugins.length) {
+    opts.plugins = [...parentBridge.plugins];
+  }
+  if (inherit.guardrails && parentBridge.guardrails.length > 0) {
+    opts.guardrails = [...parentBridge.guardrails];
+  }
+  if (inherit.fabric) {
+    const parentFabric = parentBridge.fabric;
+    if (parentFabric) {
+      const childAccessor = parentFabric.createChildScope(
+        childContextId,
+        inherit.fabric
+      );
+      opts.plugins = [
+        ...opts.plugins ?? [],
+        contextFabricPlugin({
+          _prebuiltScope: {
+            contextId: childContextId,
+            accessor: childAccessor
+          }
+        })
+      ];
+    }
+  }
+  return opts;
+}
+function extractRuntimeBridgeOptions(parentBridge) {
+  const parentOptions = parentBridge.bridgeOptions;
+  if (!parentOptions) return {};
+  const inherited = {};
+  for (const key of RUNTIME_INHERIT_KEYS) {
+    copyDefinedBridgeOption(inherited, parentOptions, key);
+  }
+  return inherited;
+}
+function copyDefinedBridgeOption(target, source, key) {
+  const value = source[key];
+  if (value !== void 0) {
+    target[key] = value;
+  }
+}
+function getParentActions(parentBridge) {
+  return parentBridge?.registry?.listActions() ?? [];
+}
+function isToolAllowed(name, definition) {
+  const allowed = definition.tools === "*" || definition.tools.includes(name);
+  const disallowed = definition.disallowedTools?.includes(name) ?? false;
+  return allowed && !disallowed;
+}
+function buildDefinitionBridgeOptions(definition, parentBridge) {
+  if (!definition) return {};
+  const opts = {
+    systemPrompt: definition.getSystemPrompt()
+  };
+  if (definition.model && definition.model !== "inherit" && definition.model !== "fast") {
+    opts.model = definition.model;
+  }
+  const parentActions = getParentActions(parentBridge);
+  if (parentActions.length > 0) {
+    opts.actions = parentActions.filter(
+      (action) => isToolAllowed(action.name, definition)
+    );
+    opts.tools = {
+      allowedTools: opts.actions.map((action) => action.name)
+    };
+  } else if (definition.tools !== "*") {
+    opts.tools = {
+      allowedTools: definition.tools.filter(
+        (name) => !(definition.disallowedTools?.includes(name) ?? false)
+      )
+    };
+  }
+  return opts;
+}
+function mergeBridgeOptions(base, override) {
+  return {
+    ...base,
+    ...override,
+    plugins: [...base.plugins ?? [], ...override.plugins ?? []],
+    tools: base.tools || override.tools ? {
+      ...base.tools,
+      ...override.tools
+    } : void 0
+  };
+}
+function resolveHistoryLimit(inherit) {
+  const history = inherit?.history;
+  if (!history) return void 0;
+  const max = history === true ? DEFAULT_INHERITED_HISTORY_MESSAGES : history.maxMessages;
+  const limit = max ?? DEFAULT_INHERITED_HISTORY_MESSAGES;
+  if (!Number.isFinite(limit)) return DEFAULT_INHERITED_HISTORY_MESSAGES;
+  return Math.max(0, Math.trunc(limit));
+}
+async function readInheritedHistory(parentContextId, options) {
+  const limit = resolveHistoryLimit(options.inherit);
+  if (limit == null || limit === 0 || !options.parentBridge?.getConversation) {
+    return void 0;
+  }
+  try {
+    const conversation = await options.parentBridge.getConversation(
+      parentContextId,
+      {
+        historyLength: limit,
+        includeArtifacts: false,
+        includeHistory: true,
+        includeTasks: false,
+        ...options.tenant !== void 0 ? { tenant: options.tenant } : {}
+      }
+    );
+    return conversation.history?.slice(-limit);
+  } catch (error) {
+    if (error instanceof Error && error.message.startsWith("Conversation not found:")) {
+      return void 0;
+    }
+    throw error;
+  }
+}
+async function spawnAgent(parentLineage, parentContextId, options) {
+  const { contextId, lineage } = forkSession(
+    parentLineage,
+    parentContextId,
+    options
+  );
+  const bridgeOpts = options.parentBridge && options.inherit ? buildChildBridgeOptions(
+    options.inherit,
+    options.parentBridge,
+    contextId,
+    options.inheritTaskStore
+  ) : { taskStore: { type: "memory" } };
+  const definitionOpts = buildDefinitionBridgeOptions(
+    options.agentDefinition,
+    options.parentBridge
+  );
+  const inheritedHistory = await readInheritedHistory(parentContextId, options);
+  const bridge = await createBridge(
+    mergeBridgeOptions(bridgeOpts, definitionOpts)
+  );
+  Object.defineProperty(bridge, "lineage", {
+    configurable: true,
+    enumerable: false,
+    value: lineage
+  });
+  return {
+    lineage,
+    bridge,
+    contextId,
+    background: options.background ?? false,
+    ...inheritedHistory?.length ? { inheritedHistory } : {}
+  };
+}
+const TASK_STATE_TO_NODE_STATUS = {
+  submitted: "running",
+  working: "running",
+  "input-required": "running",
+  completed: "completed",
+  failed: "failed",
+  canceled: "cancelled",
+  rejected: "failed",
+  "auth-required": "running",
+  "approval-required": "running",
+  "budget-exhausted": "failed",
+  unknown: "running"
+};
+function toNodeStatus(taskState) {
+  return TASK_STATE_TO_NODE_STATUS[taskState] ?? "running";
+}
+function buildAgentTree(rootAgentId, tasks) {
+  const nodeMap = /* @__PURE__ */ new Map();
+  for (const task of tasks) {
+    const lineage = task.metadata?.bridge?.lineage;
+    if (!lineage) continue;
+    const existing = nodeMap.get(lineage.agentId);
+    if (!existing) {
+      nodeMap.set(lineage.agentId, {
+        lineage,
+        status: toNodeStatus(task.status.state),
+        children: []
+      });
+    }
+  }
+  for (const node of nodeMap.values()) {
+    const parentId = node.lineage.parentAgentId;
+    if (parentId && nodeMap.has(parentId)) {
+      nodeMap.get(parentId).children.push(node);
+    }
+  }
+  return nodeMap.get(rootAgentId);
+}
+export {
+  buildAgentTree,
+  forkSession,
+  spawnAgent
+};
+//# sourceMappingURL=coordination.js.map

package/dist/runtime/orchestration/pack/coordination.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/runtime/orchestration/pack/coordination.ts"],
+  "sourcesContent": ["/**\n * Agent coordination primitives.\n *\n * - forkSession() \u2014 create a child context with lineage\n * - spawnAgent() \u2014 fork + create a Bridge for the child\n * - buildAgentTree() \u2014 assemble hierarchical tree from task metadata\n */\n\nimport crypto from 'node:crypto';\n\nimport type { ActionDefinition } from '../../../actions/types.js';\nimport type {\n  AgentDefinition,\n  AgentLineage,\n  AgentNodeStatus,\n  AgentTreeNode,\n} from '../../../adapters/agents/registry/types.js';\nimport { forkLineage } from '../../../adapters/agents/registry/types.js';\nimport type { Message, Task, TaskState } from '../../../domain/core-task.js';\nimport type { BridgePort } from '../../bridge/bridge-port.js';\nimport { createBridge } from '../../bridge/create-bridge.js';\nimport type { BridgeWithFabric } from '../../bridge/fabric-bridge-types.js';\nimport { contextFabricPlugin } from '../../bridge/fabric-plugin.js';\nimport type { BridgeOptions } from '../../sessions/bridge-options.js';\nimport type {\n  ForkInheritOptions,\n  ForkOptions,\n  ForkResult,\n  SpawnOptions,\n} from './coordination-types.js';\n\nconst RUNTIME_INHERIT_KEYS: Array<keyof BridgeOptions> = [\n  'agentSkills',\n  'apiKeys',\n  'backendType',\n  'backends',\n  'cache',\n  'config',\n  'context',\n  'contextCompaction',\n  'customApi',\n  'customCli',\n  'fallback',\n  'getToolsFromLocalContext',\n  'historyStrategy',\n  'llmProvider',\n  'localContext',\n  'maxContext',\n  'maxOutputTokens',\n  'maxSectionTokens',\n  'mcpConfigPath',\n  'mcpOptions',\n  'mcpServers',\n  'model',\n  'priority',\n  'profile',\n  'retries',\n  'routing',\n  'runner',\n  'security',\n  'actionBundles',\n  'suppressWarnings',\n  'timeoutMs',\n  'verbose',\n  'workspace',\n];\nconst DEFAULT_INHERITED_HISTORY_MESSAGES = 20;\n\nexport function forkSession(\n  parentLineage: AgentLineage,\n  parentContextId: string,\n  options: ForkOptions\n): ForkResult {\n  const childContextId = crypto.randomUUID();\n  const isolation = options.isolation ?? parentLineage.isolation;\n\n  const lineage = forkLineage(parentLineage, options.agentName, {\n    contextId: parentContextId,\n    isolation,\n  });\n\n  return { contextId: childContextId, lineage };\n}\nfunction buildChildBridgeOptions(\n  inherit: ForkInheritOptions,\n  parentBridge: BridgePort,\n  childContextId: string,\n  inheritTaskStore?: boolean\n): Partial<BridgeOptions> {\n  const opts: Partial<BridgeOptions> = {\n    taskStore: { type: 'memory' as const },\n  };\n\n  if (inherit.runtime) {\n    Object.assign(opts, extractRuntimeBridgeOptions(parentBridge));\n    opts.taskStore = { type: 'memory' as const };\n  }\n\n  if (inheritTaskStore) {\n    const parentStore = (\n      parentBridge as unknown as { taskStore?: BridgeOptions['taskStore'] }\n    ).taskStore;\n    if (parentStore) {\n      opts.taskStore = parentStore;\n    }\n  }\n\n  if (inherit.systemPrompt) {\n    opts.systemPrompt = parentBridge.systemPrompt;\n  }\n\n  if (inherit.plugins && parentBridge.plugins.length) {\n    opts.plugins = [...parentBridge.plugins];\n  }\n\n  if (inherit.guardrails && parentBridge.guardrails.length > 0) {\n    opts.guardrails = [...parentBridge.guardrails];\n  }\n\n  if (inherit.fabric) {\n    const parentFabric = (parentBridge as unknown as BridgeWithFabric).fabric;\n    if (parentFabric) {\n      const childAccessor = parentFabric.createChildScope(\n        childContextId,\n        inherit.fabric\n      );\n      opts.plugins = [\n        ...(opts.plugins ?? []),\n        contextFabricPlugin({\n          _prebuiltScope: {\n            contextId: childContextId,\n            accessor: childAccessor,\n          },\n        }),\n      ];\n    }\n  }\n\n  return opts;\n}\n\nfunction extractRuntimeBridgeOptions(\n  parentBridge: BridgePort\n): Partial<BridgeOptions> {\n  const parentOptions = (\n    parentBridge as unknown as { bridgeOptions?: BridgeOptions }\n  ).bridgeOptions;\n  if (!parentOptions) return {};\n  const inherited: Partial<BridgeOptions> = {};\n  for (const key of RUNTIME_INHERIT_KEYS) {\n    copyDefinedBridgeOption(inherited, parentOptions, key);\n  }\n  return inherited;\n}\n\nfunction copyDefinedBridgeOption<K extends keyof BridgeOptions>(\n  target: Partial<BridgeOptions>,\n  source: BridgeOptions,\n  key: K\n): void {\n  const value = source[key];\n  if (value !== undefined) {\n    target[key] = value;\n  }\n}\n\nfunction getParentActions(\n  parentBridge: BridgePort | undefined\n): ActionDefinition[] {\n  return parentBridge?.registry?.listActions() ?? [];\n}\n\nfunction isToolAllowed(name: string, definition: AgentDefinition): boolean {\n  const allowed = definition.tools === '*' || definition.tools.includes(name);\n  const disallowed = definition.disallowedTools?.includes(name) ?? false;\n  return allowed && !disallowed;\n}\n\nfunction buildDefinitionBridgeOptions(\n  definition: AgentDefinition | undefined,\n  parentBridge: BridgePort | undefined\n): Partial<BridgeOptions> {\n  if (!definition) return {};\n\n  const opts: Partial<BridgeOptions> = {\n    systemPrompt: definition.getSystemPrompt(),\n  };\n\n  if (\n    definition.model &&\n    definition.model !== 'inherit' &&\n    definition.model !== 'fast'\n  ) {\n    opts.model = definition.model;\n  }\n\n  const parentActions = getParentActions(parentBridge);\n  if (parentActions.length > 0) {\n    opts.actions = parentActions.filter((action) =>\n      isToolAllowed(action.name, definition)\n    );\n    opts.tools = {\n      allowedTools: opts.actions.map((action) => action.name),\n    };\n  } else if (definition.tools !== '*') {\n    opts.tools = {\n      allowedTools: definition.tools.filter(\n        (name) => !(definition.disallowedTools?.includes(name) ?? false)\n      ),\n    };\n  }\n\n  return opts;\n}\n\nfunction mergeBridgeOptions(\n  base: Partial<BridgeOptions>,\n  override: Partial<BridgeOptions>\n): Partial<BridgeOptions> {\n  return {\n    ...base,\n    ...override,\n    plugins: [...(base.plugins ?? []), ...(override.plugins ?? [])],\n    tools:\n      base.tools || override.tools\n        ? {\n            ...base.tools,\n            ...override.tools,\n          }\n        : undefined,\n  };\n}\n\nfunction resolveHistoryLimit(\n  inherit: ForkInheritOptions | undefined\n): number | undefined {\n  const history = inherit?.history;\n  if (!history) return undefined;\n  const max =\n    history === true ? DEFAULT_INHERITED_HISTORY_MESSAGES : history.maxMessages;\n  const limit = max ?? DEFAULT_INHERITED_HISTORY_MESSAGES;\n  if (!Number.isFinite(limit)) return DEFAULT_INHERITED_HISTORY_MESSAGES;\n  return Math.max(0, Math.trunc(limit));\n}\n\nasync function readInheritedHistory(\n  parentContextId: string,\n  options: SpawnOptions\n): Promise<Message[] | undefined> {\n  const limit = resolveHistoryLimit(options.inherit);\n  if (limit == null || limit === 0 || !options.parentBridge?.getConversation) {\n    return undefined;\n  }\n\n  try {\n    const conversation = await options.parentBridge.getConversation(\n      parentContextId,\n      {\n        historyLength: limit,\n        includeArtifacts: false,\n        includeHistory: true,\n        includeTasks: false,\n        ...(options.tenant !== undefined ? { tenant: options.tenant } : {}),\n      }\n    );\n    return conversation.history?.slice(-limit);\n  } catch (error) {\n    if (\n      error instanceof Error &&\n      error.message.startsWith('Conversation not found:')\n    ) {\n      return undefined;\n    }\n    throw error;\n  }\n}\n\ninterface SpawnAgentResult {\n  lineage: AgentLineage;\n  bridge: BridgePort;\n  contextId: string;\n  background: boolean;\n  inheritedHistory?: Message[];\n}\n\nexport async function spawnAgent(\n  parentLineage: AgentLineage,\n  parentContextId: string,\n  options: SpawnOptions\n): Promise<SpawnAgentResult> {\n  const { contextId, lineage } = forkSession(\n    parentLineage,\n    parentContextId,\n    options\n  );\n\n  const bridgeOpts: Partial<BridgeOptions> =\n    options.parentBridge && options.inherit\n      ? buildChildBridgeOptions(\n          options.inherit,\n          options.parentBridge,\n          contextId,\n          options.inheritTaskStore\n        )\n      : { taskStore: { type: 'memory' as const } };\n\n  const definitionOpts = buildDefinitionBridgeOptions(\n    options.agentDefinition,\n    options.parentBridge\n  );\n  const inheritedHistory = await readInheritedHistory(parentContextId, options);\n  const bridge = await createBridge(\n    mergeBridgeOptions(bridgeOpts, definitionOpts)\n  );\n  Object.defineProperty(bridge, 'lineage', {\n    configurable: true,\n    enumerable: false,\n    value: lineage,\n  });\n\n  return {\n    lineage,\n    bridge,\n    contextId,\n    background: options.background ?? false,\n    ...(inheritedHistory?.length ? { inheritedHistory } : {}),\n  };\n}\nconst TASK_STATE_TO_NODE_STATUS: Record<string, AgentNodeStatus> = {\n  submitted: 'running',\n  working: 'running',\n  'input-required': 'running',\n  completed: 'completed',\n  failed: 'failed',\n  canceled: 'cancelled',\n  rejected: 'failed',\n  'auth-required': 'running',\n  'approval-required': 'running',\n  'budget-exhausted': 'failed',\n  unknown: 'running',\n};\n\nfunction toNodeStatus(taskState: TaskState): AgentNodeStatus {\n  return TASK_STATE_TO_NODE_STATUS[taskState] ?? 'running';\n}\n\nexport function buildAgentTree(\n  rootAgentId: string,\n  tasks: Task[]\n): AgentTreeNode | undefined {\n  const nodeMap = new Map<string, AgentTreeNode>();\n\n  for (const task of tasks) {\n    const lineage = task.metadata?.bridge?.lineage;\n    if (!lineage) continue;\n\n    const existing = nodeMap.get(lineage.agentId);\n    if (!existing) {\n      nodeMap.set(lineage.agentId, {\n        lineage,\n        status: toNodeStatus(task.status.state),\n        children: [],\n      });\n    }\n  }\n\n  for (const node of nodeMap.values()) {\n    const parentId = node.lineage.parentAgentId;\n    if (parentId && nodeMap.has(parentId)) {\n      nodeMap.get(parentId)!.children.push(node);\n    }\n  }\n\n  return nodeMap.get(rootAgentId);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/runtime/orchestration/pack/create-pack-async.d.ts

@@ -0,0 +1,11 @@
+import { Pack } from './pack.js';
+import type { PackOptions } from './types.js';
+/**
+ * Creates a Pack with async-initialized bridges (leader + local workers).
+ * Uses `createBridge` which supports plugin `setup()/teardown()`,
+ * file-config hooks auto-wiring, and MCP server connections.
+ *
+ * Required when `shared.fabric` is configured.
+ */
+export declare function createPackAsync(options: PackOptions): Promise<Pack>;
+//# sourceMappingURL=create-pack-async.d.ts.map

package/dist/runtime/orchestration/pack/create-pack-async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-pack-async.d.ts","sourceRoot":"","sources":["../../../../src/runtime/orchestration/pack/create-pack-async.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,IAAI,EAAmB,MAAM,WAAW,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA6DzE"}

package/dist/runtime/orchestration/pack/create-pack-async.js

@@ -0,0 +1,59 @@
+import crypto from "node:crypto";
+import { closeBridgePort } from "../../bridge/bridge-port.js";
+import { createBridge } from "../../bridge/create-bridge.js";
+import { contextFabricPlugin } from "../../bridge/fabric-plugin.js";
+import { buildWorkerBridgeOptions } from "./dispatch.js";
+import { Pack, WORKER_PLAYBOOK } from "./pack.js";
+async function createPackAsync(options) {
+  const fabricConfig = options.shared?.fabric;
+  const safeOptions = fabricConfig ? { ...options, shared: { ...options.shared, fabric: void 0 } } : options;
+  const pack = new Pack(safeOptions);
+  if (fabricConfig) {
+    const fabricPlugin = contextFabricPlugin({
+      channels: fabricConfig.channels,
+      defaultPolicy: fabricConfig.defaultWorkerPolicy
+    });
+    pack.leaderBridgeOptions = {
+      ...pack.leaderBridgeOptions,
+      plugins: [...pack.leaderBridgeOptions.plugins ?? [], fabricPlugin]
+    };
+  }
+  await closeBridgePort(pack.leader);
+  pack.leader = await createBridge(pack.leaderBridgeOptions);
+  const leaderFabric = fabricConfig ? pack.leader.fabric : void 0;
+  for (const entry of pack.registry.all()) {
+    if (entry.bridge && !entry.remote) {
+      let workerOpts = buildWorkerBridgeOptions(
+        entry.name,
+        options,
+        options.workerPlaybook ?? WORKER_PLAYBOOK
+      );
+      if (leaderFabric && fabricConfig) {
+        const workerContextId = crypto.randomUUID();
+        const childAccessor = leaderFabric.createChildScope(
+          workerContextId,
+          fabricConfig.workerInherit ?? { channels: "all" }
+        );
+        workerOpts = {
+          ...workerOpts,
+          plugins: [
+            ...workerOpts.plugins ?? [],
+            contextFabricPlugin({
+              _prebuiltScope: {
+                contextId: workerContextId,
+                accessor: childAccessor
+              }
+            })
+          ]
+        };
+      }
+      await closeBridgePort(entry.bridge);
+      entry.bridge = await createBridge(workerOpts);
+    }
+  }
+  return pack;
+}
+export {
+  createPackAsync
+};
+//# sourceMappingURL=create-pack-async.js.map

package/dist/runtime/orchestration/pack/create-pack-async.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/runtime/orchestration/pack/create-pack-async.ts"],
+  "sourcesContent": ["import crypto from 'node:crypto';\n\nimport { closeBridgePort } from '../../bridge/bridge-port.js';\nimport { createBridge } from '../../bridge/create-bridge.js';\nimport type { BridgeWithFabric } from '../../bridge/fabric-bridge-types.js';\nimport { contextFabricPlugin } from '../../bridge/fabric-plugin.js';\nimport { buildWorkerBridgeOptions } from './dispatch.js';\nimport { Pack, WORKER_PLAYBOOK } from './pack.js';\nimport type { PackOptions } from './types.js';\n\n/**\n * Creates a Pack with async-initialized bridges (leader + local workers).\n * Uses `createBridge` which supports plugin `setup()/teardown()`,\n * file-config hooks auto-wiring, and MCP server connections.\n *\n * Required when `shared.fabric` is configured.\n */\nexport async function createPackAsync(options: PackOptions): Promise<Pack> {\n  const fabricConfig = options.shared?.fabric;\n\n  const safeOptions: PackOptions = fabricConfig\n    ? { ...options, shared: { ...options.shared, fabric: undefined } }\n    : options;\n\n  const pack = new Pack(safeOptions);\n\n  if (fabricConfig) {\n    const fabricPlugin = contextFabricPlugin({\n      channels: fabricConfig.channels,\n      defaultPolicy: fabricConfig.defaultWorkerPolicy,\n    });\n    pack.leaderBridgeOptions = {\n      ...pack.leaderBridgeOptions,\n      plugins: [...(pack.leaderBridgeOptions.plugins ?? []), fabricPlugin],\n    };\n  }\n\n  await closeBridgePort(pack.leader);\n  pack.leader = await createBridge(pack.leaderBridgeOptions);\n\n  const leaderFabric = fabricConfig\n    ? (pack.leader as unknown as BridgeWithFabric).fabric\n    : undefined;\n\n  for (const entry of pack.registry.all()) {\n    if (entry.bridge && !entry.remote) {\n      let workerOpts = buildWorkerBridgeOptions(\n        entry.name,\n        options,\n        options.workerPlaybook ?? WORKER_PLAYBOOK\n      );\n\n      if (leaderFabric && fabricConfig) {\n        const workerContextId = crypto.randomUUID();\n        const childAccessor = leaderFabric.createChildScope(\n          workerContextId,\n          fabricConfig.workerInherit ?? { channels: 'all' }\n        );\n        workerOpts = {\n          ...workerOpts,\n          plugins: [\n            ...(workerOpts.plugins ?? []),\n            contextFabricPlugin({\n              _prebuiltScope: {\n                contextId: workerContextId,\n                accessor: childAccessor,\n              },\n            }),\n          ],\n        };\n      }\n\n      await closeBridgePort(entry.bridge);\n      entry.bridge = await createBridge(workerOpts);\n    }\n  }\n\n  return pack;\n}\n"],
+  "mappings": "AAAA,OAAO,YAAY;AAEnB,SAAS,uBAAuB;AAChC,SAAS,oBAAoB;AAE7B,SAAS,2BAA2B;AACpC,SAAS,gCAAgC;AACzC,SAAS,MAAM,uBAAuB;AAUtC,eAAsB,gBAAgB,SAAqC;AACzE,QAAM,eAAe,QAAQ,QAAQ;AAErC,QAAM,cAA2B,eAC7B,EAAE,GAAG,SAAS,QAAQ,EAAE,GAAG,QAAQ,QAAQ,QAAQ,OAAU,EAAE,IAC/D;AAEJ,QAAM,OAAO,IAAI,KAAK,WAAW;AAEjC,MAAI,cAAc;AAChB,UAAM,eAAe,oBAAoB;AAAA,MACvC,UAAU,aAAa;AAAA,MACvB,eAAe,aAAa;AAAA,IAC9B,CAAC;AACD,SAAK,sBAAsB;AAAA,MACzB,GAAG,KAAK;AAAA,MACR,SAAS,CAAC,GAAI,KAAK,oBAAoB,WAAW,CAAC,GAAI,YAAY;AAAA,IACrE;AAAA,EACF;AAEA,QAAM,gBAAgB,KAAK,MAAM;AACjC,OAAK,SAAS,MAAM,aAAa,KAAK,mBAAmB;AAEzD,QAAM,eAAe,eAChB,KAAK,OAAuC,SAC7C;AAEJ,aAAW,SAAS,KAAK,SAAS,IAAI,GAAG;AACvC,QAAI,MAAM,UAAU,CAAC,MAAM,QAAQ;AACjC,UAAI,aAAa;AAAA,QACf,MAAM;AAAA,QACN;AAAA,QACA,QAAQ,kBAAkB;AAAA,MAC5B;AAEA,UAAI,gBAAgB,cAAc;AAChC,cAAM,kBAAkB,OAAO,WAAW;AAC1C,cAAM,gBAAgB,aAAa;AAAA,UACjC;AAAA,UACA,aAAa,iBAAiB,EAAE,UAAU,MAAM;AAAA,QAClD;AACA,qBAAa;AAAA,UACX,GAAG;AAAA,UACH,SAAS;AAAA,YACP,GAAI,WAAW,WAAW,CAAC;AAAA,YAC3B,oBAAoB;AAAA,cAClB,gBAAgB;AAAA,gBACd,WAAW;AAAA,gBACX,UAAU;AAAA,cACZ;AAAA,YACF,CAAC;AAAA,UACH;AAAA,QACF;AAAA,MACF;AAEA,YAAM,gBAAgB,MAAM,MAAM;AAClC,YAAM,SAAS,MAAM,aAAa,UAAU;AAAA,IAC9C;AAAA,EACF;AAEA,SAAO;AACT;",
+  "names": []
+}

package/dist/runtime/orchestration/pack/dispatch-worker.d.ts

@@ -0,0 +1,25 @@
+import type { AgentLineage } from '../../../adapters/agents/registry/types.js';
+import type { BridgeSendMessageParams, BridgeSendResult } from '../../../domain/bridge-api.js';
+import type { RunResult } from '../../../domain/core-client.js';
+import type { BridgeOptions } from '../../bridge/bridge.js';
+import type { BridgeEventEmitter } from '../../bridge/events.js';
+import type { BridgePlugin } from '../../bridge/plugins.js';
+import type { PackOptions, PackWorkerConfig, WorkerEntry } from './types.js';
+export declare function mergePlugins(shared?: BridgePlugin[], specific?: BridgePlugin[]): BridgePlugin[] | undefined;
+export type ForwardedWorkerSendParams = Pick<BridgeSendMessageParams, 'approvalMode' | 'onError' | 'onRetry' | 'onToolApproval' | 'tenant' | 'timeoutMs'>;
+/** Shared context passed to every worker dispatch call within a Pack round. */
+export interface WorkerDispatchContext {
+    contextId: string;
+    leaderTaskId: string | undefined;
+    packId: string;
+    workerTaskCounts: Map<string, number>;
+    lineage?: AgentLineage;
+    forwardedParams?: ForwardedWorkerSendParams;
+    events?: BridgeEventEmitter;
+    onRemoteWorkerResult?: (name: string, result: RunResult) => void;
+}
+export declare function dispatchToWorker(entry: WorkerEntry, task: string, ctx: WorkerDispatchContext): Promise<BridgeSendResult>;
+export declare function dispatchToWorkerWithCallback(entry: WorkerEntry, task: string, ctx: WorkerDispatchContext): Promise<BridgeSendResult>;
+export declare function createWorkerEntry(config: PackWorkerConfig, options: PackOptions, workerPlaybook: string): WorkerEntry;
+export declare function buildWorkerBridgeOptions(name: string, options: PackOptions, workerPlaybook: string): BridgeOptions;
+//# sourceMappingURL=dispatch-worker.d.ts.map

package/dist/runtime/orchestration/pack/dispatch-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-worker.d.ts","sourceRoot":"","sources":["../../../../src/runtime/orchestration/pack/dispatch-worker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAI/E,OAAO,KAAK,EACV,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAG5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAO5D,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAwD7E,wBAAgB,YAAY,CAC1B,MAAM,CAAC,EAAE,YAAY,EAAE,EACvB,QAAQ,CAAC,EAAE,YAAY,EAAE,GACxB,YAAY,EAAE,GAAG,SAAS,CAG5B;AAED,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,uBAAuB,EACrB,cAAc,GACd,SAAS,GACT,SAAS,GACT,gBAAgB,GAChB,QAAQ,GACR,WAAW,CACd,CAAC;AAEF,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,eAAe,CAAC,EAAE,yBAAyB,CAAC;IAC5C,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;CAClE;AAsCD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAkE3B;AAED,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAkC3B;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,WAAW,EACpB,cAAc,EAAE,MAAM,GACrB,WAAW,CA0Fb;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,EACpB,cAAc,EAAE,MAAM,GACrB,aAAa,CAqCf"}