octoflow-core 1.0.0

package/dist/runtime/orchestration/pack/types.d.ts

@@ -0,0 +1,366 @@
+import type { AgentLineage } from '../../../adapters/agents/registry/types.js';
+import type { BridgeSendMessageParams, BridgeSendResult, BridgeSubscriptionEvent } from '../../../domain/bridge-api.js';
+import type { BridgeToolConfig } from '../../../domain/bridge-api.js';
+import type { BackendName, BackendType, Client, RunResult } from '../../../domain/core-client.js';
+import type { BridgeCacheOptions } from '../../../domain/core-task.js';
+import { OctoFlowError } from '../../../domain/errors/index.js';
+import type { SkillRef } from '../../../domain/shared.js';
+import type { BridgeOptions } from '../../bridge/bridge.js';
+import type { BridgePort } from '../../bridge/bridge-port.js';
+import type { BridgeAnyEventHandler } from '../../bridge/events.js';
+import type { PackFabricConfig } from '../../bridge/fabric-types.js';
+import type { BridgePlugin } from '../../bridge/plugins.js';
+import type { FlowConfig, LoopConfig, PackRunResult, PackSessionRunParams, RunEvent } from '../run/types.js';
+import type { McpServerConfig, PackToolsConfig } from './pack-mcp-types.js';
+export type { McpServerConfig, McpServerTransport, PackToolsConfig, } from './pack-mcp-types.js';
+export type WorkerContextPolicy = 'per-task' | 'per-worker' | 'shared-pack';
+export interface DelegationEntry {
+    worker: string;
+    task: string;
+    strategy?: 'sequential' | 'parallel';
+    timeoutMs?: number;
+    priority?: 'high' | 'normal' | 'low';
+}
+export type DelegationParseResult = {
+    kind: 'none';
+} | {
+    kind: 'ok';
+    entries: DelegationEntry[];
+} | {
+    kind: 'malformed';
+    raw: string;
+    error: string;
+};
+export interface DelegationDriver {
+    parse(responseText: string): DelegationParseResult;
+    buildManifest(workers: WorkerEntry[]): string;
+    buildCorrectionPrompt(raw: string, error: string): string;
+}
+export interface WorkerEntry {
+    name: string;
+    description?: string;
+    client: Client | null;
+    bridge?: BridgePort;
+    /** Manifest routing tags derived from `LocalWorkerConfig.tags`. */
+    skills?: SkillRef[];
+    backendType: BackendType;
+    remote: boolean;
+}
+export interface LocalWorkerConfig {
+    kind?: 'local';
+    name: string;
+    description?: string;
+    priority?: BackendName[];
+    systemPrompt?: string;
+    model?: string;
+    /**
+     * Manifest routing tags — displayed in the leader's delegation manifest so
+     * the leader LLM can route tasks to the right specialist worker.
+     *
+     * These are **metadata only** and have zero runtime effect on the worker's
+     * actual capabilities. To give a worker access to SKILL.md files use
+     * `agentSkills`; for MCP servers use `mcpServers`; for inline tool
+     * definitions use `tools`.
+     */
+    tags?: string[];
+    /**
+     * Inline tool definitions and/or MCP servers delivered to this worker's
+     * bridge at runtime. Uses the same `BridgeToolConfig` shape as
+     * `BridgeOptions.tools`:
+     *
+     * - `definitions` — function-call schemas (native for API backends,
+     *   prompt-injected for CLI backends).
+     * - `servers` — MCP server processes (claude-code-cli only; API backends
+     *   ignore servers and use `definitions` instead).
+     * - `allowedTools` — optional allowlist applied before delivery.
+     */
+    tools?: BridgeToolConfig;
+    runner?: BridgeOptions['runner'];
+    plugins?: BridgePlugin[];
+    mcpServers?: BridgeOptions['mcpServers'];
+    mcpOptions?: BridgeOptions['mcpOptions'];
+    /**
+     * Native SKILL.md skill runner for this worker. Discovers and injects skill
+     * catalogs into the worker's system prompt at startup. Use `additionalPaths`
+     * to point at specific skill directories, or `bundles` to pre-load skill
+     * metadata produced by `loadSkillBundle()`.
+     */
+    agentSkills?: BridgeOptions['agentSkills'];
+    getToolsFromLocalContext?: BridgeOptions['getToolsFromLocalContext'];
+    localContext?: BridgeOptions['localContext'];
+    /**
+     * Retry count on transient worker-run failures. Forwarded into the worker
+     * bridge's `retries` option and ultimately into the constructed backend
+     * client. Defaults to `0`.
+     */
+    retries?: number;
+}
+export interface RemoteWorkerConfig {
+    kind: 'remote';
+    name: string;
+    description?: string;
+    url: string;
+    apiKey?: string;
+    /** Manifest routing tags — see `LocalWorkerConfig.tags`. */
+    tags?: string[];
+}
+export interface CustomWorkerConfig {
+    kind: 'custom';
+    name: string;
+    description?: string;
+    bridge?: BridgePort;
+    client?: Client;
+    /** Manifest routing tags — see `LocalWorkerConfig.tags`. */
+    tags?: string[];
+}
+/**
+ * Minimal structural shape of an agent handle that can back a `kind:'agent'` worker.
+ * Compatible with `AgentHandle<AgentType>` — kept as a structural alias here to
+ * avoid a circular import with `agent-handle.ts → pack.ts → types.ts`.
+ */
+export interface WorkerAgentHandle {
+    /** Bridge or Pack instance powering the agent. Duck-typed: Pack-backed runtimes have a `leader` property. */
+    readonly runtime: unknown;
+    /** Shut down and clean up the agent. */
+    close(): Promise<void>;
+}
+/**
+ * Worker backed by a fully-configured `AgentHandle` — any `createAgent` mode.
+ *
+ * This enables **hierarchical packs**: a worker can itself be a `supervisor`,
+ * `reflection`, `plan-execute`, or any other agent type. The parent pack
+ * dispatches tasks to this worker exactly like any other, and the nested
+ * agent handles its own internal orchestration.
+ *
+ * @example
+ * ```ts
+ * const pack = await createAgent({
+ *   agentType: 'supervisor',
+ *   workers: [
+ *     {
+ *       kind: 'agent',
+ *       name: 'deep-reviewer',
+ *       handle: await createAgent({ agentType: 'reflection', ... }),
+ *     },
+ *   ],
+ * });
+ * ```
+ */
+export interface AgentWorkerConfig {
+    kind: 'agent';
+    name: string;
+    description?: string;
+    /** Manifest routing tags — see `LocalWorkerConfig.tags`. */
+    tags?: string[];
+    /** A fully initialised agent handle — Bridge or Pack-backed. */
+    handle: WorkerAgentHandle;
+}
+export type PackWorkerConfig = LocalWorkerConfig | RemoteWorkerConfig | CustomWorkerConfig | AgentWorkerConfig;
+export interface PackSharedContext {
+    systemPrompt?: string;
+    protocol?: string[];
+    tools?: PackToolsConfig;
+    cwd?: string;
+    apiKeys?: Record<string, string | undefined>;
+    model?: string;
+    timeoutMs?: number;
+    /** Plugins applied to all bridges (leader + local workers). Worker-specific plugins are appended after shared. */
+    plugins?: BridgePlugin[];
+    /** Bridge-managed MCP/skills defaults applied to leader and local worker bridges. */
+    mcpServers?: BridgeOptions['mcpServers'];
+    mcpOptions?: BridgeOptions['mcpOptions'];
+    agentSkills?: BridgeOptions['agentSkills'];
+    getToolsFromLocalContext?: BridgeOptions['getToolsFromLocalContext'];
+    localContext?: BridgeOptions['localContext'];
+    /** Fabric channels shared across the pack. Requires `createPackAsync()`. */
+    fabric?: PackFabricConfig;
+    /**
+     * Prompt-cache configuration propagated to the leader and all
+     * local worker bridges. Controls cache markers on the stable system-
+     * prompt prefix for cache-aware backends (Anthropic, OpenAI).
+     */
+    cache?: BridgeCacheOptions;
+    /**
+     * When `false`, the leader and worker playbooks are omitted from the
+     * assembled system prompt. Defaults to `true` (current behavior). Opt-out
+     * for quick delegation tasks that don't need the full playbook context
+     *.
+     */
+    includePlaybooks?: boolean;
+    /**
+     * Controls which context id a worker receives for each delegated task.
+     * Defaults to `'shared-pack'` for backward compatibility. Use `'per-task'`
+     * for strict isolation or `'per-worker'` for stable worker-local memory.
+     */
+    workerContextPolicy?: WorkerContextPolicy;
+}
+export interface PackLeaderConfig {
+    priority?: BackendName[];
+    systemPrompt?: string;
+    model?: string;
+    playbook?: string;
+    tools?: {
+        servers?: McpServerConfig[];
+    };
+    plugins?: BridgePlugin[];
+    mcpServers?: BridgeOptions['mcpServers'];
+    mcpOptions?: BridgeOptions['mcpOptions'];
+    agentSkills?: BridgeOptions['agentSkills'];
+    getToolsFromLocalContext?: BridgeOptions['getToolsFromLocalContext'];
+    localContext?: BridgeOptions['localContext'];
+    /** Per-backend host/model overrides for the leader. Same shape as `BridgeOptions.backends`. */
+    backends?: BridgeOptions['backends'];
+}
+export interface PackOptions {
+    shared?: PackSharedContext;
+    leader?: PackLeaderConfig;
+    /** Bridge-managed MCP/skills defaults applied to the pack. `shared`/leader/worker values may extend or override these. */
+    mcpServers?: BridgeOptions['mcpServers'];
+    mcpOptions?: BridgeOptions['mcpOptions'];
+    agentSkills?: BridgeOptions['agentSkills'];
+    getToolsFromLocalContext?: BridgeOptions['getToolsFromLocalContext'];
+    localContext?: BridgeOptions['localContext'];
+    workers: PackWorkerConfig[];
+    strategy?: 'sequential' | 'parallel';
+    workerPlaybook?: string;
+    maxDelegationRounds?: number;
+    /** How many times to retry correcting a malformed delegation block per round. Default: 1. */
+    maxParseRetries?: number;
+    delegationTimeoutMs?: number;
+    maxConcurrency?: number;
+    maxWorkers?: number;
+    contextId?: string;
+    tenant?: string;
+    maxWorkerResultTokens?: number;
+    tokenEstimationFn?: (text: string) => number;
+    delegationDriver?: DelegationDriver;
+    onRemoteWorkerResult?: (name: string, result: RunResult) => void;
+    defaultFlow?: FlowConfig;
+    defaultLoop?: LoopConfig;
+    /** Subscribe to every event emitted by leader and local worker bridges. */
+    onEvent?: BridgeAnyEventHandler;
+    /** Lineage for the pack leader. Workers inherit with incremented depth. */
+    lineage?: AgentLineage;
+}
+export interface DelegationRoundRecord {
+    round: number;
+    leaderReasoning: string;
+    delegations: DelegationEntry[];
+    workerResults: Array<{
+        name: string;
+        result: BridgeSendResult;
+    }>;
+    droppedWorkers?: string[];
+}
+export type PackResult = BridgeSendResult & {
+    rounds?: DelegationRoundRecord[];
+    delegationRounds?: number;
+    maxRoundsReached?: boolean;
+    timedOut?: boolean;
+    parseExhausted?: boolean;
+};
+export type PackSendParams = Omit<BridgeSendMessageParams, 'contextId'> & {
+    contextId?: string;
+};
+/**
+ * Structural subset of `Pack` used by run/flow helpers.  Declaring this
+ * here lets those helpers depend on `./types.js` instead of `./pack.js`
+ * and breaks the historical pack.ts ↔ run.ts / flow.ts cycle.  The real
+ * `Pack` class satisfies this shape automatically via duck typing.
+ */
+export interface PackLike {
+    readonly leader: unknown;
+    readonly registry: {
+        get(worker: string): WorkerEntry | undefined;
+    };
+    sendMessage(params: PackSendParams): Promise<PackResult>;
+}
+export type PackEvent = (BridgeSubscriptionEvent & {
+    source: 'leader' | {
+        worker: string;
+    };
+}) | {
+    kind: 'delegation';
+    worker: string;
+    taskId: string;
+    source: 'leader';
+} | {
+    kind: 'worker-result';
+    worker: string;
+    result: BridgeSendResult;
+    source: {
+        worker: string;
+    };
+} | {
+    kind: 'delegation-round';
+    round: number;
+    delegations: DelegationEntry[];
+    source: 'leader';
+} | {
+    kind: 'round-complete';
+    round: number;
+    workerCount: number;
+    source: 'leader';
+} | {
+    kind: 'delegation-malformed';
+    raw: string;
+    error: string;
+    round: number;
+    source: 'leader';
+} | {
+    kind: 'delegation-retry';
+    attempt: number;
+    round: number;
+    source: 'leader';
+} | {
+    kind: 'worker-added';
+    name: string;
+    source: 'leader';
+} | {
+    kind: 'worker-removed';
+    name: string;
+    source: 'leader';
+} | {
+    kind: 'worker-cancelled';
+    name: string;
+    taskIds: string[];
+    source: 'leader';
+} | {
+    kind: 'context-budget-warning';
+    estimatedPct: number;
+    round: number;
+    source: 'leader';
+};
+export interface PackSession {
+    send(message: string, opts?: Omit<PackSendParams, 'message' | 'contextId'>): Promise<PackResult>;
+    stream(message: string, opts?: Omit<PackSendParams, 'message' | 'contextId'>): AsyncGenerator<PackEvent>;
+    run(params: PackSessionRunParams): Promise<PackRunResult>;
+    runStream(params: PackSessionRunParams): AsyncGenerator<RunEvent>;
+    reset(): void;
+    readonly contextId: string;
+    /** AbortSignal that is aborted when `reset()` is called. Pass to in-flight work to enable cancellation. */
+    readonly abortSignal: AbortSignal;
+}
+export interface WorkerInspection {
+    name: string;
+    backendType: BackendType;
+    remote: boolean;
+    ready: boolean;
+    skills: SkillRef[];
+    inFlightTasks: number;
+}
+export type PackErrorCode = 'PACK_CLOSED' | 'DUPLICATE_WORKER' | 'WORKER_NOT_FOUND' | 'WORKER_IN_FLIGHT' | 'REGISTRY_LOCKED' | 'MAX_WORKERS_EXCEEDED' | 'WORKER_INIT_FAILED' | 'CONCURRENT_SEND';
+export declare class PackError extends OctoFlowError {
+    readonly workerName?: string;
+    readonly inFlightCount?: number;
+    constructor(code: PackErrorCode, message: string, details?: {
+        workerName?: string;
+        inFlightCount?: number;
+        cause?: unknown;
+    });
+}
+export declare class PackCancelledError extends OctoFlowError {
+    readonly packId: string;
+    constructor(packId: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/orchestration/pack/types.d.ts.map

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

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

@@ -0,0 +1,28 @@
+import { OctoFlowError } from "../../../domain/errors/index.js";
+class PackError extends OctoFlowError {
+  workerName;
+  inFlightCount;
+  constructor(code, message, details) {
+    super(code, message, {
+      ...details?.workerName !== void 0 ? { workerName: details.workerName } : {},
+      ...details?.inFlightCount !== void 0 ? { inFlightCount: details.inFlightCount } : {}
+    });
+    this.name = "PackError";
+    this.workerName = details?.workerName;
+    this.inFlightCount = details?.inFlightCount;
+    if (details?.cause) this.cause = details.cause;
+  }
+}
+class PackCancelledError extends OctoFlowError {
+  packId;
+  constructor(packId) {
+    super("PACK_CANCELLED", `Pack execution cancelled (packId=${packId})`);
+    this.name = "PackCancelledError";
+    this.packId = packId;
+  }
+}
+export {
+  PackCancelledError,
+  PackError
+};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/runtime/orchestration/pack/types.ts"],
+  "sourcesContent": ["import type { AgentLineage } from '../../../adapters/agents/registry/types.js';\nimport type {\n  BridgeSendMessageParams,\n  BridgeSendResult,\n  BridgeSubscriptionEvent,\n} from '../../../domain/bridge-api.js';\nimport type { BridgeToolConfig } from '../../../domain/bridge-api.js';\nimport type {\n  BackendName,\n  BackendType,\n  Client,\n  RunResult,\n} from '../../../domain/core-client.js';\nimport type { BridgeCacheOptions } from '../../../domain/core-task.js';\nimport { OctoFlowError } from '../../../domain/errors/index.js';\nimport type { SkillRef } from '../../../domain/shared.js';\nimport type { BridgeOptions } from '../../bridge/bridge.js';\nimport type { BridgePort } from '../../bridge/bridge-port.js';\nimport type { BridgeAnyEventHandler } from '../../bridge/events.js';\nimport type { PackFabricConfig } from '../../bridge/fabric-types.js';\nimport type { BridgePlugin } from '../../bridge/plugins.js';\nimport type {\n  FlowConfig,\n  LoopConfig,\n  PackRunResult,\n  PackSessionRunParams,\n  RunEvent,\n} from '../run/types.js';\nimport type { McpServerConfig, PackToolsConfig } from './pack-mcp-types.js';\nexport type {\n  McpServerConfig,\n  McpServerTransport,\n  PackToolsConfig,\n} from './pack-mcp-types.js';\nexport type WorkerContextPolicy = 'per-task' | 'per-worker' | 'shared-pack';\nexport interface DelegationEntry {\n  worker: string;\n  task: string;\n  strategy?: 'sequential' | 'parallel';\n  timeoutMs?: number;\n  priority?: 'high' | 'normal' | 'low';\n}\n\nexport type DelegationParseResult =\n  | { kind: 'none' }\n  | { kind: 'ok'; entries: DelegationEntry[] }\n  | { kind: 'malformed'; raw: string; error: string };\n\nexport interface DelegationDriver {\n  parse(responseText: string): DelegationParseResult;\n  buildManifest(workers: WorkerEntry[]): string;\n  buildCorrectionPrompt(raw: string, error: string): string;\n}\nexport interface WorkerEntry {\n  name: string;\n  description?: string;\n  client: Client | null;\n  bridge?: BridgePort;\n  /** Manifest routing tags derived from `LocalWorkerConfig.tags`. */\n  skills?: SkillRef[];\n  backendType: BackendType;\n  remote: boolean;\n}\n\nexport interface LocalWorkerConfig {\n  kind?: 'local';\n  name: string;\n  description?: string;\n  priority?: BackendName[];\n  systemPrompt?: string;\n  model?: string;\n  /**\n   * Manifest routing tags \u2014 displayed in the leader's delegation manifest so\n   * the leader LLM can route tasks to the right specialist worker.\n   *\n   * These are **metadata only** and have zero runtime effect on the worker's\n   * actual capabilities. To give a worker access to SKILL.md files use\n   * `agentSkills`; for MCP servers use `mcpServers`; for inline tool\n   * definitions use `tools`.\n   */\n  tags?: string[];\n  /**\n   * Inline tool definitions and/or MCP servers delivered to this worker's\n   * bridge at runtime. Uses the same `BridgeToolConfig` shape as\n   * `BridgeOptions.tools`:\n   *\n   * - `definitions` \u2014 function-call schemas (native for API backends,\n   *   prompt-injected for CLI backends).\n   * - `servers` \u2014 MCP server processes (claude-code-cli only; API backends\n   *   ignore servers and use `definitions` instead).\n   * - `allowedTools` \u2014 optional allowlist applied before delivery.\n   */\n  tools?: BridgeToolConfig;\n  runner?: BridgeOptions['runner'];\n  plugins?: BridgePlugin[];\n  mcpServers?: BridgeOptions['mcpServers'];\n  mcpOptions?: BridgeOptions['mcpOptions'];\n  /**\n   * Native SKILL.md skill runner for this worker. Discovers and injects skill\n   * catalogs into the worker's system prompt at startup. Use `additionalPaths`\n   * to point at specific skill directories, or `bundles` to pre-load skill\n   * metadata produced by `loadSkillBundle()`.\n   */\n  agentSkills?: BridgeOptions['agentSkills'];\n  getToolsFromLocalContext?: BridgeOptions['getToolsFromLocalContext'];\n  localContext?: BridgeOptions['localContext'];\n  /**\n   * Retry count on transient worker-run failures. Forwarded into the worker\n   * bridge's `retries` option and ultimately into the constructed backend\n   * client. Defaults to `0`.\n   */\n  retries?: number;\n}\n\nexport interface RemoteWorkerConfig {\n  kind: 'remote';\n  name: string;\n  description?: string;\n  url: string;\n  apiKey?: string;\n  /** Manifest routing tags \u2014 see `LocalWorkerConfig.tags`. */\n  tags?: string[];\n}\n\nexport interface CustomWorkerConfig {\n  kind: 'custom';\n  name: string;\n  description?: string;\n  bridge?: BridgePort;\n  client?: Client;\n  /** Manifest routing tags \u2014 see `LocalWorkerConfig.tags`. */\n  tags?: string[];\n}\n\n/**\n * Minimal structural shape of an agent handle that can back a `kind:'agent'` worker.\n * Compatible with `AgentHandle<AgentType>` \u2014 kept as a structural alias here to\n * avoid a circular import with `agent-handle.ts \u2192 pack.ts \u2192 types.ts`.\n */\nexport interface WorkerAgentHandle {\n  /** Bridge or Pack instance powering the agent. Duck-typed: Pack-backed runtimes have a `leader` property. */\n  readonly runtime: unknown;\n  /** Shut down and clean up the agent. */\n  close(): Promise<void>;\n}\n\n/**\n * Worker backed by a fully-configured `AgentHandle` \u2014 any `createAgent` mode.\n *\n * This enables **hierarchical packs**: a worker can itself be a `supervisor`,\n * `reflection`, `plan-execute`, or any other agent type. The parent pack\n * dispatches tasks to this worker exactly like any other, and the nested\n * agent handles its own internal orchestration.\n *\n * @example\n * ```ts\n * const pack = await createAgent({\n *   agentType: 'supervisor',\n *   workers: [\n *     {\n *       kind: 'agent',\n *       name: 'deep-reviewer',\n *       handle: await createAgent({ agentType: 'reflection', ... }),\n *     },\n *   ],\n * });\n * ```\n */\nexport interface AgentWorkerConfig {\n  kind: 'agent';\n  name: string;\n  description?: string;\n  /** Manifest routing tags \u2014 see `LocalWorkerConfig.tags`. */\n  tags?: string[];\n  /** A fully initialised agent handle \u2014 Bridge or Pack-backed. */\n  handle: WorkerAgentHandle;\n}\n\nexport type PackWorkerConfig =\n  | LocalWorkerConfig\n  | RemoteWorkerConfig\n  | CustomWorkerConfig\n  | AgentWorkerConfig;\nexport interface PackSharedContext {\n  systemPrompt?: string;\n  protocol?: string[];\n  tools?: PackToolsConfig;\n  cwd?: string;\n  apiKeys?: Record<string, string | undefined>;\n  model?: string;\n  timeoutMs?: number;\n  /** Plugins applied to all bridges (leader + local workers). Worker-specific plugins are appended after shared. */\n  plugins?: BridgePlugin[];\n  /** Bridge-managed MCP/skills defaults applied to leader and local worker bridges. */\n  mcpServers?: BridgeOptions['mcpServers'];\n  mcpOptions?: BridgeOptions['mcpOptions'];\n  agentSkills?: BridgeOptions['agentSkills'];\n  getToolsFromLocalContext?: BridgeOptions['getToolsFromLocalContext'];\n  localContext?: BridgeOptions['localContext'];\n  /** Fabric channels shared across the pack. Requires `createPackAsync()`. */\n  fabric?: PackFabricConfig;\n  /**\n   * Prompt-cache configuration propagated to the leader and all\n   * local worker bridges. Controls cache markers on the stable system-\n   * prompt prefix for cache-aware backends (Anthropic, OpenAI).\n   */\n  cache?: BridgeCacheOptions;\n  /**\n   * When `false`, the leader and worker playbooks are omitted from the\n   * assembled system prompt. Defaults to `true` (current behavior). Opt-out\n   * for quick delegation tasks that don't need the full playbook context\n   *.\n   */\n  includePlaybooks?: boolean;\n  /**\n   * Controls which context id a worker receives for each delegated task.\n   * Defaults to `'shared-pack'` for backward compatibility. Use `'per-task'`\n   * for strict isolation or `'per-worker'` for stable worker-local memory.\n   */\n  workerContextPolicy?: WorkerContextPolicy;\n}\n\nexport interface PackLeaderConfig {\n  priority?: BackendName[];\n  systemPrompt?: string;\n  model?: string;\n  playbook?: string;\n  tools?: { servers?: McpServerConfig[] };\n  plugins?: BridgePlugin[];\n  mcpServers?: BridgeOptions['mcpServers'];\n  mcpOptions?: BridgeOptions['mcpOptions'];\n  agentSkills?: BridgeOptions['agentSkills'];\n  getToolsFromLocalContext?: BridgeOptions['getToolsFromLocalContext'];\n  localContext?: BridgeOptions['localContext'];\n  /** Per-backend host/model overrides for the leader. Same shape as `BridgeOptions.backends`. */\n  backends?: BridgeOptions['backends'];\n}\n\nexport interface PackOptions {\n  shared?: PackSharedContext;\n  leader?: PackLeaderConfig;\n  /** Bridge-managed MCP/skills defaults applied to the pack. `shared`/leader/worker values may extend or override these. */\n  mcpServers?: BridgeOptions['mcpServers'];\n  mcpOptions?: BridgeOptions['mcpOptions'];\n  agentSkills?: BridgeOptions['agentSkills'];\n  getToolsFromLocalContext?: BridgeOptions['getToolsFromLocalContext'];\n  localContext?: BridgeOptions['localContext'];\n  workers: PackWorkerConfig[];\n  strategy?: 'sequential' | 'parallel';\n  workerPlaybook?: string;\n  maxDelegationRounds?: number;\n  /** How many times to retry correcting a malformed delegation block per round. Default: 1. */\n  maxParseRetries?: number;\n  delegationTimeoutMs?: number;\n  maxConcurrency?: number;\n  maxWorkers?: number;\n  contextId?: string;\n  tenant?: string;\n  maxWorkerResultTokens?: number;\n  tokenEstimationFn?: (text: string) => number;\n  delegationDriver?: DelegationDriver;\n  onRemoteWorkerResult?: (name: string, result: RunResult) => void;\n  defaultFlow?: FlowConfig;\n  defaultLoop?: LoopConfig;\n  /** Subscribe to every event emitted by leader and local worker bridges. */\n  onEvent?: BridgeAnyEventHandler;\n  /** Lineage for the pack leader. Workers inherit with incremented depth. */\n  lineage?: AgentLineage;\n}\nexport interface DelegationRoundRecord {\n  round: number;\n  leaderReasoning: string;\n  delegations: DelegationEntry[];\n  workerResults: Array<{ name: string; result: BridgeSendResult }>;\n  droppedWorkers?: string[];\n}\n\nexport type PackResult = BridgeSendResult & {\n  rounds?: DelegationRoundRecord[];\n  delegationRounds?: number;\n  maxRoundsReached?: boolean;\n  timedOut?: boolean;\n  parseExhausted?: boolean;\n};\n\nexport type PackSendParams = Omit<BridgeSendMessageParams, 'contextId'> & {\n  contextId?: string;\n};\n\n/**\n * Structural subset of `Pack` used by run/flow helpers.  Declaring this\n * here lets those helpers depend on `./types.js` instead of `./pack.js`\n * and breaks the historical pack.ts \u2194 run.ts / flow.ts cycle.  The real\n * `Pack` class satisfies this shape automatically via duck typing.\n */\nexport interface PackLike {\n  readonly leader: unknown;\n  readonly registry: {\n    get(worker: string): WorkerEntry | undefined;\n  };\n  sendMessage(params: PackSendParams): Promise<PackResult>;\n}\nexport type PackEvent =\n  | (BridgeSubscriptionEvent & { source: 'leader' | { worker: string } })\n  | { kind: 'delegation'; worker: string; taskId: string; source: 'leader' }\n  | {\n      kind: 'worker-result';\n      worker: string;\n      result: BridgeSendResult;\n      source: { worker: string };\n    }\n  | {\n      kind: 'delegation-round';\n      round: number;\n      delegations: DelegationEntry[];\n      source: 'leader';\n    }\n  | {\n      kind: 'round-complete';\n      round: number;\n      workerCount: number;\n      source: 'leader';\n    }\n  | {\n      kind: 'delegation-malformed';\n      raw: string;\n      error: string;\n      round: number;\n      source: 'leader';\n    }\n  | {\n      kind: 'delegation-retry';\n      attempt: number;\n      round: number;\n      source: 'leader';\n    }\n  | { kind: 'worker-added'; name: string; source: 'leader' }\n  | { kind: 'worker-removed'; name: string; source: 'leader' }\n  | {\n      kind: 'worker-cancelled';\n      name: string;\n      taskIds: string[];\n      source: 'leader';\n    }\n  | {\n      kind: 'context-budget-warning';\n      estimatedPct: number;\n      round: number;\n      source: 'leader';\n    };\nexport interface PackSession {\n  send(\n    message: string,\n    opts?: Omit<PackSendParams, 'message' | 'contextId'>\n  ): Promise<PackResult>;\n  stream(\n    message: string,\n    opts?: Omit<PackSendParams, 'message' | 'contextId'>\n  ): AsyncGenerator<PackEvent>;\n  run(params: PackSessionRunParams): Promise<PackRunResult>;\n  runStream(params: PackSessionRunParams): AsyncGenerator<RunEvent>;\n  reset(): void;\n  readonly contextId: string;\n  /** AbortSignal that is aborted when `reset()` is called. Pass to in-flight work to enable cancellation. */\n  readonly abortSignal: AbortSignal;\n}\nexport interface WorkerInspection {\n  name: string;\n  backendType: BackendType;\n  remote: boolean;\n  ready: boolean;\n  skills: SkillRef[];\n  inFlightTasks: number;\n}\nexport type PackErrorCode =\n  | 'PACK_CLOSED'\n  | 'DUPLICATE_WORKER'\n  | 'WORKER_NOT_FOUND'\n  | 'WORKER_IN_FLIGHT'\n  | 'REGISTRY_LOCKED'\n  | 'MAX_WORKERS_EXCEEDED'\n  | 'WORKER_INIT_FAILED'\n  | 'CONCURRENT_SEND';\n\nexport class PackError extends OctoFlowError {\n  readonly workerName?: string;\n  readonly inFlightCount?: number;\n\n  constructor(\n    code: PackErrorCode,\n    message: string,\n    details?: {\n      workerName?: string;\n      inFlightCount?: number;\n      cause?: unknown;\n    }\n  ) {\n    super(code, message, {\n      ...(details?.workerName !== undefined\n        ? { workerName: details.workerName }\n        : {}),\n      ...(details?.inFlightCount !== undefined\n        ? { inFlightCount: details.inFlightCount }\n        : {}),\n    });\n    this.name = 'PackError';\n    this.workerName = details?.workerName;\n    this.inFlightCount = details?.inFlightCount;\n    if (details?.cause) this.cause = details.cause;\n  }\n}\n\nexport class PackCancelledError extends OctoFlowError {\n  readonly packId: string;\n\n  constructor(packId: string) {\n    super('PACK_CANCELLED', `Pack execution cancelled (packId=${packId})`);\n    this.name = 'PackCancelledError';\n    this.packId = packId;\n  }\n}\n"],
+  "mappings": "AAcA,SAAS,qBAAqB;AAkXvB,MAAM,kBAAkB,cAAc;AAAA,EAClC;AAAA,EACA;AAAA,EAET,YACE,MACA,SACA,SAKA;AACA,UAAM,MAAM,SAAS;AAAA,MACnB,GAAI,SAAS,eAAe,SACxB,EAAE,YAAY,QAAQ,WAAW,IACjC,CAAC;AAAA,MACL,GAAI,SAAS,kBAAkB,SAC3B,EAAE,eAAe,QAAQ,cAAc,IACvC,CAAC;AAAA,IACP,CAAC;AACD,SAAK,OAAO;AACZ,SAAK,aAAa,SAAS;AAC3B,SAAK,gBAAgB,SAAS;AAC9B,QAAI,SAAS,MAAO,MAAK,QAAQ,QAAQ;AAAA,EAC3C;AACF;AAEO,MAAM,2BAA2B,cAAc;AAAA,EAC3C;AAAA,EAET,YAAY,QAAgB;AAC1B,UAAM,kBAAkB,oCAAoC,MAAM,GAAG;AACrE,SAAK,OAAO;AACZ,SAAK,SAAS;AAAA,EAChB;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,3 @@
+import type { WorkerContextPolicy } from './types.js';
+export declare function resolveWorkerContextId(policy: WorkerContextPolicy | undefined, packContextId: string, workerName: string, workerContextIds: Map<string, string>): string;
+//# sourceMappingURL=worker-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker-context.d.ts","sourceRoot":"","sources":["../../../../src/runtime/orchestration/pack/worker-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,MAAM,CAgBR"}

package/dist/runtime/orchestration/pack/worker-context.js

@@ -0,0 +1,23 @@
+import crypto from "node:crypto";
+import { assertNever } from "../../../utils/assert-never.js";
+function resolveWorkerContextId(policy, packContextId, workerName, workerContextIds) {
+  const resolved = policy ?? "shared-pack";
+  switch (resolved) {
+    case "per-task":
+      return crypto.randomUUID();
+    case "per-worker": {
+      if (!workerContextIds.has(workerName)) {
+        workerContextIds.set(workerName, crypto.randomUUID());
+      }
+      return workerContextIds.get(workerName);
+    }
+    case "shared-pack":
+      return packContextId;
+    default:
+      return assertNever(resolved, "resolveWorkerContextId");
+  }
+}
+export {
+  resolveWorkerContextId
+};
+//# sourceMappingURL=worker-context.js.map

package/dist/runtime/orchestration/pack/worker-context.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/runtime/orchestration/pack/worker-context.ts"],
+  "sourcesContent": ["import crypto from 'node:crypto';\n\nimport { assertNever } from '../../../utils/assert-never.js';\nimport type { WorkerContextPolicy } from './types.js';\n\nexport function resolveWorkerContextId(\n  policy: WorkerContextPolicy | undefined,\n  packContextId: string,\n  workerName: string,\n  workerContextIds: Map<string, string>\n): string {\n  const resolved = policy ?? 'shared-pack';\n  switch (resolved) {\n    case 'per-task':\n      return crypto.randomUUID();\n    case 'per-worker': {\n      if (!workerContextIds.has(workerName)) {\n        workerContextIds.set(workerName, crypto.randomUUID());\n      }\n      return workerContextIds.get(workerName)!;\n    }\n    case 'shared-pack':\n      return packContextId;\n    default:\n      return assertNever(resolved, 'resolveWorkerContextId');\n  }\n}\n"],
+  "mappings": "AAAA,OAAO,YAAY;AAEnB,SAAS,mBAAmB;AAGrB,SAAS,uBACd,QACA,eACA,YACA,kBACQ;AACR,QAAM,WAAW,UAAU;AAC3B,UAAQ,UAAU;AAAA,IAChB,KAAK;AACH,aAAO,OAAO,WAAW;AAAA,IAC3B,KAAK,cAAc;AACjB,UAAI,CAAC,iBAAiB,IAAI,UAAU,GAAG;AACrC,yBAAiB,IAAI,YAAY,OAAO,WAAW,CAAC;AAAA,MACtD;AACA,aAAO,iBAAiB,IAAI,UAAU;AAAA,IACxC;AAAA,IACA,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO,YAAY,UAAU,wBAAwB;AAAA,EACzD;AACF;",
+  "names": []
+}