octoflow-core 1.0.0

package/dist/runtime/orchestration/pack/pack-mesh.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/runtime/orchestration/pack/pack-mesh.ts"],
+  "sourcesContent": ["import type { A2AClientOptions } from '../../../adapters/transport/client.js';\nimport { A2AClient } from '../../../adapters/transport/client.js';\nimport type { TopicChannel } from '../../bridge/topic-channel.js';\nimport type {\n  JsonValue,\n  TopicEmitOptions,\n  TopicEvent,\n} from '../../bridge/topic-types.js';\n\nexport interface MeshEntry {\n  packId: string;\n  capabilities: string[];\n  metadata: Record<string, unknown>;\n}\n\nexport interface RemoteMeshEntry extends MeshEntry {\n  url: string;\n  apiKey?: string;\n}\n\nexport interface MeshPresenceEvent {\n  packId: string;\n  status: 'online' | 'offline';\n  capabilities: string[];\n  timestamp: number;\n}\n\nexport interface MeshDeliveryErrorEvent {\n  targetPackId: string;\n  messageId: string;\n  from: string;\n  to: string;\n  error: { name: string; message: string };\n  timestamp: number;\n}\n\nexport interface MeshMessage {\n  id: string;\n  from: string;\n  to: string; // packId or '*' for broadcast\n  payload: JsonValue;\n  replyTo?: string;\n  timestamp: number;\n}\n\nexport interface MeshRequestOptions {\n  timeoutMs?: number;\n}\n\n\nfunction isRecord(value: JsonValue): value is { [key: string]: JsonValue } {\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction meshMessageFromJson(value: JsonValue): MeshMessage | null {\n  if (!isRecord(value)) return null;\n  const { id, from, to, payload, timestamp, replyTo } = value;\n  if (\n    typeof id !== 'string' ||\n    typeof from !== 'string' ||\n    typeof to !== 'string' ||\n    payload === undefined ||\n    typeof timestamp !== 'number'\n  ) {\n    return null;\n  }\n  return {\n    id,\n    from,\n    to,\n    payload,\n    timestamp,\n    ...(typeof replyTo === 'string' ? { replyTo } : {}),\n  };\n}\n\nfunction meshMessageToJson(message: MeshMessage): JsonValue {\n  return {\n    id: message.id,\n    from: message.from,\n    to: message.to,\n    payload: message.payload,\n    timestamp: message.timestamp,\n    ...(message.replyTo ? { replyTo: message.replyTo } : {}),\n  };\n}\n\nfunction deliveryErrorToJson(event: MeshDeliveryErrorEvent): JsonValue {\n  return {\n    targetPackId: event.targetPackId,\n    messageId: event.messageId,\n    from: event.from,\n    to: event.to,\n    error: { name: event.error.name, message: event.error.message },\n    timestamp: event.timestamp,\n  };\n}\n\nfunction presenceToJson(event: MeshPresenceEvent): JsonValue {\n  return {\n    packId: event.packId,\n    status: event.status,\n    capabilities: [...event.capabilities],\n    timestamp: event.timestamp,\n  };\n}\n\ntype MessageHandler = (msg: MeshMessage) => void;\n\nconst MESH_EMIT: TopicEmitOptions = { publisher: 'mesh' };\n\nfunction generateMeshMsgId(from: string, to: string, counter: number): string {\n  return `mesh-${from}-${to}-${counter}-${Date.now()}`;\n}\n\nfunction summarizeError(error: unknown): { name: string; message: string } {\n  if (error instanceof Error) {\n    return { name: error.name, message: error.message };\n  }\n  return { name: 'Error', message: String(error) };\n}\n\n/**\n * PackMesh \u2014 first-class pack-to-pack communication runtime.\n *\n * Provides: registration, discovery, targeted send, broadcast,\n * request/reply, and presence notifications \u2014 all via the mesh.* TopicChannel prefix.\n */\nexport class PackMesh {\n  private readonly packs = new Map<string, MeshEntry>();\n  private readonly remotePacks = new Map<string, A2AClient>();\n  private readonly handlers = new Map<string, Set<MessageHandler>>();\n  private readonly subscriptions: Array<() => void> = [];\n  private closed = false;\n  private msgCounter = 0;\n\n  constructor(private readonly channel: TopicChannel) {\n    const unsub = this.channel.subscribePrefix(\n      'mesh.msg.',\n      (event: TopicEvent) => {\n        const msg = meshMessageFromJson(event.payload);\n        if (!msg) return;\n        const targetFromTopic = event.topic.slice('mesh.msg.'.length);\n        this.deliverToTarget(targetFromTopic, msg);\n      }\n    );\n    this.subscriptions.push(unsub);\n  }\n\n  register(entry: MeshEntry): void {\n    this.assertOpen();\n    if (this.packs.has(entry.packId)) {\n      throw new Error(`PackMesh: pack \"${entry.packId}\" is already registered`);\n    }\n    this.packs.set(entry.packId, entry);\n    this.emitPresence(entry.packId, 'online', entry.capabilities);\n  }\n\n  registerRemote(entry: RemoteMeshEntry): void {\n    this.assertOpen();\n    if (this.packs.has(entry.packId)) {\n      throw new Error(`PackMesh: pack \"${entry.packId}\" is already registered`);\n    }\n    const clientOpts: A2AClientOptions = { url: entry.url };\n    if (entry.apiKey) {\n      clientOpts.apiKey = entry.apiKey;\n    }\n    this.remotePacks.set(entry.packId, new A2AClient(clientOpts));\n    this.packs.set(entry.packId, entry);\n    this.emitPresence(entry.packId, 'online', entry.capabilities);\n  }\n\n  unregister(packId: string): void {\n    this.assertOpen();\n    const entry = this.packs.get(packId);\n    if (!entry) {\n      throw new Error(`PackMesh: pack \"${packId}\" is not registered`);\n    }\n    this.packs.delete(packId);\n    this.handlers.delete(packId);\n    this.remotePacks.delete(packId);\n    this.emitPresence(packId, 'offline', entry.capabilities);\n  }\n\n  list(): MeshEntry[] {\n    return [...this.packs.values()];\n  }\n\n  discover(capability: string): MeshEntry[] {\n    return [...this.packs.values()].filter((e) =>\n      e.capabilities.includes(capability)\n    );\n  }\n\n  onMessage(packId: string, handler: MessageHandler): () => void {\n    let handlers = this.handlers.get(packId);\n    if (!handlers) {\n      handlers = new Set();\n      this.handlers.set(packId, handlers);\n    }\n    handlers.add(handler);\n    const captured = handlers;\n    return () => {\n      captured.delete(handler);\n    };\n  }\n\n  send(from: string, to: string, payload: JsonValue): MeshMessage {\n    this.assertOpen();\n    this.assertRegistered(from);\n    this.assertRegistered(to);\n\n    const msg: MeshMessage = {\n      id: generateMeshMsgId(from, to, ++this.msgCounter),\n      from,\n      to,\n      payload,\n      timestamp: Date.now(),\n    };\n    this.channel.emit(`mesh.msg.${to}`, meshMessageToJson(msg), MESH_EMIT);\n    return msg;\n  }\n\n  broadcast(from: string, payload: JsonValue): void {\n    this.assertOpen();\n    this.assertRegistered(from);\n\n    const msg: MeshMessage = {\n      id: generateMeshMsgId(from, '*', ++this.msgCounter),\n      from,\n      to: '*',\n      payload,\n      timestamp: Date.now(),\n    };\n\n    const targets = [...this.packs.keys()].filter((id) => id !== from);\n    for (const target of targets) {\n      this.channel.emit(\n        `mesh.msg.${target}`,\n        meshMessageToJson(msg),\n        MESH_EMIT\n      );\n    }\n  }\n\n  /**\n   * Multicast \u2014 targeted fan-out to every pack matching a capability, excluding sender.\n   * Returns one MeshMessage per recipient. Empty subset returns [] without throwing.\n   * Each message carries its own concrete `to: packId` (not '*'), so recipients see\n   * a targeted delivery indistinguishable from {@link send}.\n   */\n  multicast(\n    from: string,\n    capability: string,\n    payload: JsonValue\n  ): MeshMessage[] {\n    this.assertOpen();\n    this.assertRegistered(from);\n\n    const recipients = [...this.packs.values()].filter(\n      (entry) =>\n        entry.packId !== from && entry.capabilities.includes(capability)\n    );\n\n    const messages: MeshMessage[] = [];\n    for (const recipient of recipients) {\n      const msg: MeshMessage = {\n        id: generateMeshMsgId(from, recipient.packId, ++this.msgCounter),\n        from,\n        to: recipient.packId,\n        payload,\n        timestamp: Date.now(),\n      };\n      this.channel.emit(\n        `mesh.msg.${recipient.packId}`,\n        meshMessageToJson(msg),\n        MESH_EMIT\n      );\n      messages.push(msg);\n    }\n    return messages;\n  }\n\n  async request(\n    from: string,\n    to: string,\n    payload: JsonValue,\n    options: MeshRequestOptions = {}\n  ): Promise<MeshMessage> {\n    this.assertOpen();\n    this.assertRegistered(from);\n    this.assertRegistered(to);\n\n    const timeoutMs = options.timeoutMs ?? 30_000;\n    const msg: MeshMessage = {\n      id: generateMeshMsgId(from, to, ++this.msgCounter),\n      from,\n      to,\n      payload,\n      timestamp: Date.now(),\n    };\n\n    return new Promise<MeshMessage>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        cleanup();\n        reject(\n          new Error(\n            `PackMesh: request from \"${from}\" to \"${to}\" timed out after ${timeoutMs}ms`\n          )\n        );\n      }, timeoutMs);\n\n      const cleanup = this.onMessage(from, (reply) => {\n        if (reply.replyTo === msg.id) {\n          clearTimeout(timer);\n          cleanup();\n          resolve(reply);\n        }\n      });\n\n      this.channel.emit(\n        `mesh.msg.${to}`,\n        meshMessageToJson(msg),\n        MESH_EMIT\n      );\n    });\n  }\n\n  reply(original: MeshMessage, payload: JsonValue): MeshMessage {\n    this.assertOpen();\n    const replyMsg: MeshMessage = {\n      id: generateMeshMsgId(original.to, original.from, ++this.msgCounter),\n      from: original.to,\n      to: original.from,\n      payload,\n      replyTo: original.id,\n      timestamp: Date.now(),\n    };\n    this.channel.emit(\n      `mesh.msg.${original.from}`,\n      meshMessageToJson(replyMsg),\n      MESH_EMIT\n    );\n    return replyMsg;\n  }\n\n  close(): void {\n    if (this.closed) return;\n    this.closed = true;\n    const ids = [...this.packs.keys()];\n    for (const id of ids) {\n      const entry = this.packs.get(id)!;\n      this.packs.delete(id);\n      this.emitPresence(id, 'offline', entry.capabilities);\n    }\n    this.handlers.clear();\n    this.remotePacks.clear();\n    for (const unsub of this.subscriptions) {\n      unsub();\n    }\n    this.subscriptions.length = 0;\n  }\n\n  private deliverToTarget(targetPackId: string, msg: MeshMessage): void {\n    const remote = this.remotePacks.get(targetPackId);\n    if (remote) {\n      void remote.run(JSON.stringify(msg)).catch((error: unknown) => {\n        this.emitDeliveryError(targetPackId, msg, error);\n      });\n      return;\n    }\n    const set = this.handlers.get(targetPackId);\n    if (!set) return;\n    for (const handler of set) {\n      try {\n        handler(msg);\n      } catch {\n        /* isolated per-handler */\n      }\n    }\n  }\n\n  private emitDeliveryError(\n    targetPackId: string,\n    msg: MeshMessage,\n    error: unknown\n  ): void {\n    const event: MeshDeliveryErrorEvent = {\n      targetPackId,\n      messageId: msg.id,\n      from: msg.from,\n      to: msg.to,\n      error: summarizeError(error),\n      timestamp: Date.now(),\n    };\n    try {\n      this.channel.emit(\n        'mesh.delivery.error',\n        deliveryErrorToJson(event),\n        MESH_EMIT\n      );\n    } catch {\n      // Diagnostics are best-effort; preserve the existing send/broadcast semantics.\n    }\n  }\n\n  private emitPresence(\n    packId: string,\n    status: 'online' | 'offline',\n    capabilities: string[]\n  ): void {\n    const event: MeshPresenceEvent = {\n      packId,\n      status,\n      capabilities,\n      timestamp: Date.now(),\n    };\n    this.channel.emit(\n      `mesh.presence.${status}`,\n      presenceToJson(event),\n      MESH_EMIT\n    );\n  }\n\n  private assertOpen(): void {\n    if (this.closed) {\n      throw new Error('PackMesh: mesh is closed');\n    }\n  }\n\n  private assertRegistered(packId: string): void {\n    if (!this.packs.has(packId)) {\n      throw new Error(`PackMesh: pack \"${packId}\" is not registered`);\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/runtime/orchestration/pack/pack-plugin-helpers.d.ts

@@ -0,0 +1,3 @@
+import type { PackOptions } from './types.js';
+export declare function pluginNamesRequiringAsync(options: PackOptions): string[];
+//# sourceMappingURL=pack-plugin-helpers.d.ts.map

package/dist/runtime/orchestration/pack/pack-plugin-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-plugin-helpers.d.ts","sourceRoot":"","sources":["../../../../src/runtime/orchestration/pack/pack-plugin-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,EAAE,CAiBxE"}

package/dist/runtime/orchestration/pack/pack-plugin-helpers.js

@@ -0,0 +1,16 @@
+function pluginNamesRequiringAsync(options) {
+  const workerPlugins = options.workers.flatMap(
+    (worker) => worker.kind === "remote" || worker.kind === "custom" || worker.kind === "agent" ? [] : worker.plugins ?? []
+  );
+  return [
+    ...options.shared?.plugins ?? [],
+    ...options.leader?.plugins ?? [],
+    ...workerPlugins
+  ].filter(
+    (plugin) => plugin.enabled !== false && typeof plugin.setup === "function"
+  ).map((plugin) => plugin.name);
+}
+export {
+  pluginNamesRequiringAsync
+};
+//# sourceMappingURL=pack-plugin-helpers.js.map

package/dist/runtime/orchestration/pack/pack-plugin-helpers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/runtime/orchestration/pack/pack-plugin-helpers.ts"],
+  "sourcesContent": ["import type { PackOptions } from './types.js';\n\nexport function pluginNamesRequiringAsync(options: PackOptions): string[] {\n  const workerPlugins = options.workers.flatMap((worker) =>\n    worker.kind === 'remote' ||\n    worker.kind === 'custom' ||\n    worker.kind === 'agent'\n      ? []\n      : (worker.plugins ?? [])\n  );\n  return [\n    ...(options.shared?.plugins ?? []),\n    ...(options.leader?.plugins ?? []),\n    ...workerPlugins,\n  ]\n    .filter(\n      (plugin) => plugin.enabled !== false && typeof plugin.setup === 'function'\n    )\n    .map((plugin) => plugin.name);\n}\n"],
+  "mappings": "AAEO,SAAS,0BAA0B,SAAgC;AACxE,QAAM,gBAAgB,QAAQ,QAAQ;AAAA,IAAQ,CAAC,WAC7C,OAAO,SAAS,YAChB,OAAO,SAAS,YAChB,OAAO,SAAS,UACZ,CAAC,IACA,OAAO,WAAW,CAAC;AAAA,EAC1B;AACA,SAAO;AAAA,IACL,GAAI,QAAQ,QAAQ,WAAW,CAAC;AAAA,IAChC,GAAI,QAAQ,QAAQ,WAAW,CAAC;AAAA,IAChC,GAAG;AAAA,EACL,EACG;AAAA,IACC,CAAC,WAAW,OAAO,YAAY,SAAS,OAAO,OAAO,UAAU;AAAA,EAClE,EACC,IAAI,CAAC,WAAW,OAAO,IAAI;AAChC;",
+  "names": []
+}

package/dist/runtime/orchestration/pack/pack-stream.d.ts

@@ -0,0 +1,18 @@
+import type { AgentLineage } from '../../../adapters/agents/registry/types.js';
+import type { BridgePort } from '../../bridge/bridge-port.js';
+import type { WorkerRegistry } from './registry.js';
+import type { DelegationDriver, PackEvent, PackOptions, PackSendParams } from './types.js';
+interface PackStreamContext {
+    leader: BridgePort;
+    registry: WorkerRegistry;
+    driver: DelegationDriver;
+    options: PackOptions;
+    lineage: AgentLineage;
+    packId: string;
+    closed: boolean;
+    workerTaskCounts: Map<string, number>;
+    workerContextIds: Map<string, string>;
+}
+export declare function streamPackDelegation(ctx: PackStreamContext, params: PackSendParams): AsyncGenerator<PackEvent>;
+export {};
+//# sourceMappingURL=pack-stream.d.ts.map

package/dist/runtime/orchestration/pack/pack-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-stream.d.ts","sourceRoot":"","sources":["../../../../src/runtime/orchestration/pack/pack-stream.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAS/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAU9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EACV,gBAAgB,EAChB,SAAS,EACT,WAAW,EACX,cAAc,EACf,MAAM,YAAY,CAAC;AAIpB,UAAU,iBAAiB;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AA4CD,wBAAuB,oBAAoB,CACzC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,cAAc,GACrB,cAAc,CAAC,SAAS,CAAC,CAqQ3B"}

package/dist/runtime/orchestration/pack/pack-stream.js

@@ -0,0 +1,269 @@
+import crypto from "node:crypto";
+import { forkLineage } from "../../../adapters/agents/registry/types.js";
+import {
+  buildLeaderFollowUp,
+  dispatchToWorkerWithCallback,
+  readFabricFollowUpSummary
+} from "./dispatch.js";
+import { mergePackEvents } from "./helpers.js";
+import { PackCancelledError } from "./types.js";
+import { resolveWorkerContextId } from "./worker-context.js";
+async function emitSubagentStart(events, workerName, contextId, leaderTaskId, packId, backendType, remote) {
+  await events.emit("subagent:start", {
+    taskId: leaderTaskId ?? "",
+    contextId,
+    backend: remote ? "a2a" : backendType,
+    agentName: workerName,
+    backendType,
+    remote,
+    packId
+  });
+}
+async function emitSubagentStop(events, workerName, contextId, leaderTaskId, packId, backendType, remote, status) {
+  await events.emit("subagent:stop", {
+    taskId: leaderTaskId ?? "",
+    contextId,
+    backend: remote ? "a2a" : backendType,
+    agentName: workerName,
+    backendType,
+    remote,
+    packId,
+    status
+  });
+}
+async function* streamPackDelegation(ctx, params) {
+  const contextId = params.contextId ?? crypto.randomUUID();
+  const maxRounds = ctx.options.maxDelegationRounds ?? 3;
+  const maxRetries = ctx.options.maxParseRetries ?? 1;
+  let round = 0;
+  let retryCount = 0;
+  let leaderTaskId;
+  let leaderInput = {
+    ...params,
+    message: params.message,
+    contextId
+  };
+  while (round < maxRounds) {
+    if (ctx.closed) throw new PackCancelledError(ctx.packId);
+    const leaderEvents = [];
+    let accumulatedText = "";
+    for await (const event of ctx.leader.stream(leaderInput)) {
+      const tagged = { ...event, source: "leader" };
+      yield tagged;
+      leaderEvents.push(event);
+      if (event.kind === "status-update" && event.event.status.message) {
+        const parts = event.event.status.message.parts;
+        for (const p of parts) {
+          if (p.kind === "text") accumulatedText += p.text;
+        }
+      }
+      if (event.kind === "task") {
+        leaderTaskId = event.task.id;
+        const artifact = event.task.artifacts?.find(
+          (a) => a.artifactId === "assistant-response"
+        );
+        if (artifact) {
+          accumulatedText = artifact.parts.filter(
+            (p) => p.kind === "text"
+          ).map((p) => p.text).join("");
+        } else if (event.task.status.message) {
+          accumulatedText = event.task.status.message.parts.filter(
+            (p) => p.kind === "text"
+          ).map((p) => p.text).join("");
+        }
+      }
+    }
+    const parseResult = ctx.driver.parse(accumulatedText);
+    if (parseResult.kind === "malformed" && retryCount < maxRetries) {
+      retryCount++;
+      yield {
+        kind: "delegation-malformed",
+        raw: parseResult.raw,
+        error: parseResult.error,
+        round: round + 1,
+        source: "leader"
+      };
+      yield {
+        kind: "delegation-retry",
+        attempt: retryCount,
+        round: round + 1,
+        source: "leader"
+      };
+      leaderInput = {
+        ...params,
+        message: ctx.driver.buildCorrectionPrompt(
+          parseResult.raw,
+          parseResult.error
+        ),
+        contextId
+      };
+      continue;
+    }
+    retryCount = 0;
+    if (parseResult.kind !== "ok" || parseResult.entries.length === 0) {
+      return;
+    }
+    round++;
+    yield {
+      kind: "delegation-round",
+      round,
+      delegations: parseResult.entries,
+      source: "leader"
+    };
+    const workerSources = [];
+    const workerResults = [];
+    const valid = parseResult.entries.filter(
+      (e) => e.worker !== "leader" && ctx.registry.has(e.worker)
+    );
+    const streamDroppedWorkers = parseResult.entries.filter((e) => e.worker !== "leader" && !ctx.registry.has(e.worker)).map((e) => e.worker);
+    for (const entry of valid) {
+      const worker = ctx.registry.get(entry.worker);
+      yield {
+        kind: "delegation",
+        worker: entry.worker,
+        taskId: leaderTaskId ?? "",
+        source: "leader"
+      };
+      if (worker.bridge) {
+        const workerBridge = worker.bridge;
+        const workerTag = { worker: entry.worker };
+        const packId = ctx.packId;
+        const workerContextId = resolveWorkerContextId(
+          ctx.options.shared?.workerContextPolicy,
+          contextId,
+          entry.worker,
+          ctx.workerContextIds
+        );
+        const workerLineage = forkLineage(ctx.lineage, entry.worker, {
+          taskId: leaderTaskId
+        });
+        const workerGen = async function* () {
+          await emitSubagentStart(
+            ctx.leader.events,
+            entry.worker,
+            workerContextId,
+            leaderTaskId,
+            packId,
+            worker.backendType,
+            worker.remote
+          );
+          let status = "completed";
+          try {
+            for await (const event of workerBridge.stream({
+              approvalMode: params.approvalMode,
+              onError: params.onError,
+              onRetry: params.onRetry,
+              onToolApproval: params.onToolApproval,
+              tenant: params.tenant,
+              timeoutMs: params.timeoutMs,
+              message: {
+                kind: "message",
+                messageId: crypto.randomUUID(),
+                role: "user",
+                parts: [{ kind: "text", text: entry.task }],
+                referenceTaskIds: leaderTaskId ? [leaderTaskId] : void 0
+              },
+              contextId: workerContextId,
+              metadata: {
+                bridge: {
+                  packId,
+                  parentTaskId: leaderTaskId,
+                  agentRole: "worker",
+                  lineage: workerLineage
+                }
+              }
+            })) {
+              if (event.kind === "task") {
+                status = event.task.status.state;
+              }
+              yield event;
+            }
+          } catch (error) {
+            status = "failed";
+            throw error;
+          } finally {
+            await emitSubagentStop(
+              ctx.leader.events,
+              entry.worker,
+              workerContextId,
+              leaderTaskId,
+              packId,
+              worker.backendType,
+              worker.remote,
+              status
+            );
+          }
+        };
+        workerSources.push({ tag: workerTag, iterable: workerGen() });
+      } else if (worker.client) {
+        const result = await dispatchToWorkerWithCallback(worker, entry.task, {
+          contextId: resolveWorkerContextId(
+            ctx.options.shared?.workerContextPolicy,
+            contextId,
+            entry.worker,
+            ctx.workerContextIds
+          ),
+          leaderTaskId,
+          packId: ctx.packId,
+          workerTaskCounts: ctx.workerTaskCounts,
+          lineage: ctx.lineage,
+          forwardedParams: {
+            approvalMode: params.approvalMode,
+            onError: params.onError,
+            onRetry: params.onRetry,
+            onToolApproval: params.onToolApproval,
+            tenant: params.tenant,
+            timeoutMs: params.timeoutMs
+          },
+          events: ctx.leader.events,
+          onRemoteWorkerResult: ctx.options.onRemoteWorkerResult
+        });
+        workerResults.push({ name: entry.worker, result });
+        yield {
+          kind: "worker-result",
+          worker: entry.worker,
+          result,
+          source: { worker: entry.worker }
+        };
+      }
+    }
+    if (workerSources.length > 0) {
+      for await (const workerEvent of mergePackEvents(workerSources)) {
+        yield workerEvent;
+        if (workerEvent.kind === "task" && "source" in workerEvent && typeof workerEvent.source === "object") {
+          const workerName = workerEvent.source.worker;
+          const task = workerEvent.task;
+          workerResults.push({
+            name: workerName,
+            result: {
+              kind: "task",
+              contextId: task.contextId,
+              taskId: task.id,
+              task
+            }
+          });
+        }
+      }
+    }
+    yield {
+      kind: "round-complete",
+      round,
+      workerCount: workerResults.length,
+      source: "leader"
+    };
+    const leaderFabric = ctx.leader.fabric;
+    const fabricSummary = await readFabricFollowUpSummary(leaderFabric);
+    leaderInput = buildLeaderFollowUp(
+      workerResults,
+      round,
+      contextId,
+      ctx.options,
+      streamDroppedWorkers,
+      fabricSummary
+    );
+  }
+}
+export {
+  streamPackDelegation
+};
+//# sourceMappingURL=pack-stream.js.map

package/dist/runtime/orchestration/pack/pack-stream.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/runtime/orchestration/pack/pack-stream.ts"],
+  "sourcesContent": ["import crypto from 'node:crypto';\n\nimport type { AgentLineage } from '../../../adapters/agents/registry/types.js';\nimport { forkLineage } from '../../../adapters/agents/registry/types.js';\nimport type {\n  BridgeSendMessageParams,\n  BridgeSendResult,\n  BridgeSubscriptionEvent,\n} from '../../../domain/bridge-api.js';\nimport type { BackendType } from '../../../domain/core-client.js';\nimport type { Part } from '../../../domain/core-task.js';\nimport type { BridgePort } from '../../bridge/bridge-port.js';\nimport type { BridgeEventEmitter } from '../../bridge/events.js';\nimport type { BridgeWithFabric } from '../../bridge/fabric-bridge-types.js';\nimport {\n  buildLeaderFollowUp,\n  dispatchToWorkerWithCallback,\n  readFabricFollowUpSummary,\n} from './dispatch.js';\nimport type { MergeSource } from './helpers.js';\nimport { mergePackEvents } from './helpers.js';\nimport type { WorkerRegistry } from './registry.js';\nimport type {\n  DelegationDriver,\n  PackEvent,\n  PackOptions,\n  PackSendParams,\n} from './types.js';\nimport { PackCancelledError } from './types.js';\nimport { resolveWorkerContextId } from './worker-context.js';\n\ninterface PackStreamContext {\n  leader: BridgePort;\n  registry: WorkerRegistry;\n  driver: DelegationDriver;\n  options: PackOptions;\n  lineage: AgentLineage;\n  packId: string;\n  closed: boolean;\n  workerTaskCounts: Map<string, number>;\n  workerContextIds: Map<string, string>;\n}\n\nasync function emitSubagentStart(\n  events: BridgeEventEmitter,\n  workerName: string,\n  contextId: string,\n  leaderTaskId: string | undefined,\n  packId: string,\n  backendType: BackendType,\n  remote: boolean\n): Promise<void> {\n  await events.emit('subagent:start', {\n    taskId: leaderTaskId ?? '',\n    contextId,\n    backend: remote ? 'a2a' : backendType,\n    agentName: workerName,\n    backendType,\n    remote,\n    packId,\n  });\n}\n\nasync function emitSubagentStop(\n  events: BridgeEventEmitter,\n  workerName: string,\n  contextId: string,\n  leaderTaskId: string | undefined,\n  packId: string,\n  backendType: BackendType,\n  remote: boolean,\n  status: string\n): Promise<void> {\n  await events.emit('subagent:stop', {\n    taskId: leaderTaskId ?? '',\n    contextId,\n    backend: remote ? 'a2a' : backendType,\n    agentName: workerName,\n    backendType,\n    remote,\n    packId,\n    status,\n  });\n}\n\nexport async function* streamPackDelegation(\n  ctx: PackStreamContext,\n  params: PackSendParams\n): AsyncGenerator<PackEvent> {\n  const contextId = params.contextId ?? crypto.randomUUID();\n  const maxRounds = ctx.options.maxDelegationRounds ?? 3;\n  const maxRetries = ctx.options.maxParseRetries ?? 1;\n\n  let round = 0;\n  let retryCount = 0;\n  let leaderTaskId: string | undefined;\n  let leaderInput: BridgeSendMessageParams = {\n    ...params,\n    message: params.message,\n    contextId,\n  };\n\n  while (round < maxRounds) {\n    if (ctx.closed) throw new PackCancelledError(ctx.packId);\n\n    const leaderEvents: BridgeSubscriptionEvent[] = [];\n    let accumulatedText = '';\n\n    for await (const event of ctx.leader.stream(leaderInput)) {\n      const tagged: PackEvent = { ...event, source: 'leader' };\n      yield tagged;\n      leaderEvents.push(event);\n\n      if (event.kind === 'status-update' && event.event.status.message) {\n        const parts = event.event.status.message.parts;\n        for (const p of parts) {\n          if (p.kind === 'text') accumulatedText += p.text;\n        }\n      }\n      if (event.kind === 'task') {\n        leaderTaskId = event.task.id;\n        const artifact = event.task.artifacts?.find(\n          (a) => a.artifactId === 'assistant-response'\n        );\n        if (artifact) {\n          accumulatedText = artifact.parts\n            .filter(\n              (p): p is Extract<Part, { kind: 'text' }> => p.kind === 'text'\n            )\n            .map((p) => p.text)\n            .join('');\n        } else if (event.task.status.message) {\n          accumulatedText = event.task.status.message.parts\n            .filter(\n              (p): p is Extract<Part, { kind: 'text' }> => p.kind === 'text'\n            )\n            .map((p) => p.text)\n            .join('');\n        }\n      }\n    }\n\n    const parseResult = ctx.driver.parse(accumulatedText);\n\n    if (parseResult.kind === 'malformed' && retryCount < maxRetries) {\n      retryCount++;\n      yield {\n        kind: 'delegation-malformed',\n        raw: parseResult.raw,\n        error: parseResult.error,\n        round: round + 1,\n        source: 'leader',\n      };\n      yield {\n        kind: 'delegation-retry',\n        attempt: retryCount,\n        round: round + 1,\n        source: 'leader',\n      };\n      leaderInput = {\n        ...params,\n        message: ctx.driver.buildCorrectionPrompt(\n          parseResult.raw,\n          parseResult.error\n        ),\n        contextId,\n      };\n      continue;\n    }\n\n    retryCount = 0;\n\n    if (parseResult.kind !== 'ok' || parseResult.entries.length === 0) {\n      return;\n    }\n\n    round++;\n    yield {\n      kind: 'delegation-round',\n      round,\n      delegations: parseResult.entries,\n      source: 'leader',\n    };\n\n    const workerSources: MergeSource[] = [];\n    const workerResults: Array<{ name: string; result: BridgeSendResult }> = [];\n    const valid = parseResult.entries.filter(\n      (e) => e.worker !== 'leader' && ctx.registry.has(e.worker)\n    );\n    const streamDroppedWorkers = parseResult.entries\n      .filter((e) => e.worker !== 'leader' && !ctx.registry.has(e.worker))\n      .map((e) => e.worker);\n\n    for (const entry of valid) {\n      const worker = ctx.registry.get(entry.worker)!;\n      yield {\n        kind: 'delegation',\n        worker: entry.worker,\n        taskId: leaderTaskId ?? '',\n        source: 'leader',\n      };\n\n      if (worker.bridge) {\n        const workerBridge = worker.bridge;\n        const workerTag = { worker: entry.worker };\n        const packId = ctx.packId;\n        const workerContextId = resolveWorkerContextId(\n          ctx.options.shared?.workerContextPolicy,\n          contextId,\n          entry.worker,\n          ctx.workerContextIds\n        );\n        const workerLineage = forkLineage(ctx.lineage, entry.worker, {\n          taskId: leaderTaskId,\n        });\n        const workerGen =\n          async function* (): AsyncIterable<BridgeSubscriptionEvent> {\n            await emitSubagentStart(\n              ctx.leader.events,\n              entry.worker,\n              workerContextId,\n              leaderTaskId,\n              packId,\n              worker.backendType,\n              worker.remote\n            );\n            let status = 'completed';\n            try {\n              for await (const event of workerBridge.stream({\n                approvalMode: params.approvalMode,\n                onError: params.onError,\n                onRetry: params.onRetry,\n                onToolApproval: params.onToolApproval,\n                tenant: params.tenant,\n                timeoutMs: params.timeoutMs,\n                message: {\n                  kind: 'message',\n                  messageId: crypto.randomUUID(),\n                  role: 'user',\n                  parts: [{ kind: 'text', text: entry.task }],\n                  referenceTaskIds: leaderTaskId ? [leaderTaskId] : undefined,\n                },\n                contextId: workerContextId,\n                metadata: {\n                  bridge: {\n                    packId,\n                    parentTaskId: leaderTaskId,\n                    agentRole: 'worker',\n                    lineage: workerLineage,\n                  },\n                },\n              })) {\n                if (event.kind === 'task') {\n                  status = event.task.status.state;\n                }\n                yield event;\n              }\n            } catch (error) {\n              status = 'failed';\n              throw error;\n            } finally {\n              await emitSubagentStop(\n                ctx.leader.events,\n                entry.worker,\n                workerContextId,\n                leaderTaskId,\n                packId,\n                worker.backendType,\n                worker.remote,\n                status\n              );\n            }\n          };\n        workerSources.push({ tag: workerTag, iterable: workerGen() });\n      } else if (worker.client) {\n        const result = await dispatchToWorkerWithCallback(worker, entry.task, {\n          contextId: resolveWorkerContextId(\n            ctx.options.shared?.workerContextPolicy,\n            contextId,\n            entry.worker,\n            ctx.workerContextIds\n          ),\n          leaderTaskId,\n          packId: ctx.packId,\n          workerTaskCounts: ctx.workerTaskCounts,\n          lineage: ctx.lineage,\n          forwardedParams: {\n            approvalMode: params.approvalMode,\n            onError: params.onError,\n            onRetry: params.onRetry,\n            onToolApproval: params.onToolApproval,\n            tenant: params.tenant,\n            timeoutMs: params.timeoutMs,\n          },\n          events: ctx.leader.events,\n          onRemoteWorkerResult: ctx.options.onRemoteWorkerResult,\n        });\n        workerResults.push({ name: entry.worker, result });\n        yield {\n          kind: 'worker-result',\n          worker: entry.worker,\n          result,\n          source: { worker: entry.worker },\n        };\n      }\n    }\n\n    if (workerSources.length > 0) {\n      for await (const workerEvent of mergePackEvents(workerSources)) {\n        yield workerEvent;\n        if (\n          workerEvent.kind === 'task' &&\n          'source' in workerEvent &&\n          typeof workerEvent.source === 'object'\n        ) {\n          const workerName = workerEvent.source.worker;\n          const task = (\n            workerEvent as BridgeSubscriptionEvent & { kind: 'task' }\n          ).task;\n          workerResults.push({\n            name: workerName,\n            result: {\n              kind: 'task',\n              contextId: task.contextId,\n              taskId: task.id,\n              task,\n            },\n          });\n        }\n      }\n    }\n\n    yield {\n      kind: 'round-complete',\n      round,\n      workerCount: workerResults.length,\n      source: 'leader',\n    };\n    const leaderFabric = (ctx.leader as Partial<BridgeWithFabric>).fabric;\n    const fabricSummary = await readFabricFollowUpSummary(leaderFabric);\n    leaderInput = buildLeaderFollowUp(\n      workerResults,\n      round,\n      contextId,\n      ctx.options,\n      streamDroppedWorkers,\n      fabricSummary\n    );\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/runtime/orchestration/pack/pack-workers.d.ts

@@ -0,0 +1,27 @@
+import { Bridge } from '../../bridge/bridge.js';
+import type { BridgeOptions } from '../../sessions/bridge-options.js';
+import type { WorkerRegistry } from './registry.js';
+import type { DelegationDriver, PackOptions, PackWorkerConfig } from './types.js';
+export interface WorkerAdminDeps {
+    activeRound: () => boolean;
+    closed: () => boolean;
+    driver: DelegationDriver;
+    getLeader: () => Bridge;
+    getLeaderBridgeOptions: () => BridgeOptions;
+    leaderPlaybook: string;
+    options: PackOptions;
+    registry: WorkerRegistry;
+    setLeader: (bridge: Bridge) => void;
+    setLeaderBridgeOptions: (opts: BridgeOptions) => void;
+    workerPlaybook: string;
+    workerTaskCounts: Map<string, number>;
+}
+export declare function addWorkerImpl(deps: WorkerAdminDeps, config: PackWorkerConfig): Promise<void>;
+export declare function removeWorkerImpl(deps: WorkerAdminDeps, name: string, opts?: {
+    force?: boolean;
+}): Promise<void>;
+export declare function cancelWorkerImpl(deps: WorkerAdminDeps, name: string): {
+    cancelled: number;
+};
+export declare function rebuildLeaderBridgeImpl(deps: WorkerAdminDeps): Promise<void>;
+//# sourceMappingURL=pack-workers.d.ts.map

package/dist/runtime/orchestration/pack/pack-workers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-workers.d.ts","sourceRoot":"","sources":["../../../../src/runtime/orchestration/pack/pack-workers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAMtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,aAAa,CAAC;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,sBAAsB,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACzB,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,MAAM,GACX;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAyBvB;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/dist/runtime/orchestration/pack/pack-workers.js

@@ -0,0 +1,124 @@
+import { Bridge } from "../../bridge/bridge.js";
+import { closeBridgePort } from "../../bridge/bridge-port.js";
+import { createBridge } from "../../bridge/create-bridge.js";
+import { buildWorkerBridgeOptions, createWorkerEntry } from "./dispatch.js";
+import {
+  buildEffectivePromptParts,
+  partsToSystemPromptString
+} from "./helpers.js";
+import { PackError } from "./types.js";
+async function addWorkerImpl(deps, config) {
+  const { activeRound, closed, options, registry, workerPlaybook } = deps;
+  if (closed()) throw new PackError("PACK_CLOSED", "Pack is closed");
+  if (activeRound()) {
+    throw new PackError(
+      "REGISTRY_LOCKED",
+      "Cannot modify workers during active delegation round"
+    );
+  }
+  if (registry.has(config.name)) {
+    throw new PackError(
+      "DUPLICATE_WORKER",
+      `Worker "${config.name}" already exists`,
+      { workerName: config.name }
+    );
+  }
+  if (registry.size() >= (options.maxWorkers ?? 10)) {
+    throw new PackError(
+      "MAX_WORKERS_EXCEEDED",
+      `Cannot add worker "${config.name}": maxWorkers limit reached`
+    );
+  }
+  const entry = createWorkerEntry(config, options, workerPlaybook);
+  registry.register(entry);
+  await rebuildLeaderBridgeImpl(deps);
+}
+async function removeWorkerImpl(deps, name, opts) {
+  const { activeRound, closed, registry, workerTaskCounts } = deps;
+  if (closed()) throw new PackError("PACK_CLOSED", "Pack is closed");
+  if (activeRound()) {
+    throw new PackError(
+      "REGISTRY_LOCKED",
+      "Cannot modify workers during active delegation round"
+    );
+  }
+  if (!registry.has(name)) {
+    throw new PackError("WORKER_NOT_FOUND", `Worker "${name}" not found`, {
+      workerName: name
+    });
+  }
+  const inFlight = workerTaskCounts.get(name) ?? 0;
+  if (inFlight > 0 && !opts?.force) {
+    throw new PackError(
+      "WORKER_IN_FLIGHT",
+      `Worker "${name}" has ${inFlight} in-flight tasks. Use { force: true } to cancel and remove.`,
+      { workerName: name, inFlightCount: inFlight }
+    );
+  }
+  const entry = registry.get(name);
+  if (opts?.force && entry.bridge) await closeBridgePort(entry.bridge);
+  registry.unregister(name);
+  workerTaskCounts.delete(name);
+  await rebuildLeaderBridgeImpl(deps);
+}
+function cancelWorkerImpl(deps, name) {
+  const { options, registry, workerPlaybook, workerTaskCounts } = deps;
+  if (!registry.has(name)) {
+    throw new PackError("WORKER_NOT_FOUND", `Worker "${name}" not found`, {
+      workerName: name
+    });
+  }
+  const entry = registry.get(name);
+  if (!entry.bridge) return { cancelled: 0 };
+  const count = workerTaskCounts.get(name) ?? 0;
+  if (count === 0) return { cancelled: 0 };
+  void closeBridgePort(entry.bridge).catch((err) => {
+    process.stderr.write(
+      `[octoflow] worker "${name}" bridge close error during restart: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+  });
+  entry.bridge = new Bridge(
+    buildWorkerBridgeOptions(name, options, workerPlaybook)
+  );
+  workerTaskCounts.set(name, 0);
+  return { cancelled: count };
+}
+async function rebuildLeaderBridgeImpl(deps) {
+  const {
+    driver,
+    getLeader,
+    getLeaderBridgeOptions,
+    leaderPlaybook,
+    options,
+    registry,
+    setLeader,
+    setLeaderBridgeOptions
+  } = deps;
+  const manifest = driver.buildManifest(registry.all());
+  const leaderPromptParts = buildEffectivePromptParts(
+    options.shared,
+    options.leader ?? {},
+    leaderPlaybook,
+    manifest,
+    options.shared?.cache
+  );
+  const leaderSystemPrompt = partsToSystemPromptString(leaderPromptParts);
+  const nextOptions = {
+    ...getLeaderBridgeOptions(),
+    systemPrompt: leaderSystemPrompt,
+    systemPromptParts: leaderPromptParts
+  };
+  setLeaderBridgeOptions(nextOptions);
+  const oldLeader = getLeader();
+  const newLeader = await createBridge(nextOptions);
+  setLeader(newLeader);
+  await closeBridgePort(oldLeader);
+}
+export {
+  addWorkerImpl,
+  cancelWorkerImpl,
+  rebuildLeaderBridgeImpl,
+  removeWorkerImpl
+};
+//# sourceMappingURL=pack-workers.js.map

package/dist/runtime/orchestration/pack/pack-workers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/runtime/orchestration/pack/pack-workers.ts"],
+  "sourcesContent": ["import { Bridge } from '../../bridge/bridge.js';\nimport { closeBridgePort } from '../../bridge/bridge-port.js';\nimport { createBridge } from '../../bridge/create-bridge.js';\nimport type { BridgeOptions } from '../../sessions/bridge-options.js';\nimport { buildWorkerBridgeOptions, createWorkerEntry } from './dispatch.js';\nimport {\n  buildEffectivePromptParts,\n  partsToSystemPromptString,\n} from './helpers.js';\nimport type { WorkerRegistry } from './registry.js';\nimport type {\n  DelegationDriver,\n  PackOptions,\n  PackWorkerConfig,\n} from './types.js';\nimport { PackError } from './types.js';\nexport interface WorkerAdminDeps {\n  activeRound: () => boolean;\n  closed: () => boolean;\n  driver: DelegationDriver;\n  getLeader: () => Bridge;\n  getLeaderBridgeOptions: () => BridgeOptions;\n  leaderPlaybook: string;\n  options: PackOptions;\n  registry: WorkerRegistry;\n  setLeader: (bridge: Bridge) => void;\n  setLeaderBridgeOptions: (opts: BridgeOptions) => void;\n  workerPlaybook: string;\n  workerTaskCounts: Map<string, number>;\n}\n\nexport async function addWorkerImpl(\n  deps: WorkerAdminDeps,\n  config: PackWorkerConfig\n): Promise<void> {\n  const { activeRound, closed, options, registry, workerPlaybook } = deps;\n  if (closed()) throw new PackError('PACK_CLOSED', 'Pack is closed');\n  if (activeRound()) {\n    throw new PackError(\n      'REGISTRY_LOCKED',\n      'Cannot modify workers during active delegation round'\n    );\n  }\n  if (registry.has(config.name)) {\n    throw new PackError(\n      'DUPLICATE_WORKER',\n      `Worker \"${config.name}\" already exists`,\n      { workerName: config.name }\n    );\n  }\n  if (registry.size() >= (options.maxWorkers ?? 10)) {\n    throw new PackError(\n      'MAX_WORKERS_EXCEEDED',\n      `Cannot add worker \"${config.name}\": maxWorkers limit reached`\n    );\n  }\n\n  const entry = createWorkerEntry(config, options, workerPlaybook);\n  registry.register(entry);\n  await rebuildLeaderBridgeImpl(deps);\n}\n\nexport async function removeWorkerImpl(\n  deps: WorkerAdminDeps,\n  name: string,\n  opts?: { force?: boolean }\n): Promise<void> {\n  const { activeRound, closed, registry, workerTaskCounts } = deps;\n  if (closed()) throw new PackError('PACK_CLOSED', 'Pack is closed');\n  if (activeRound()) {\n    throw new PackError(\n      'REGISTRY_LOCKED',\n      'Cannot modify workers during active delegation round'\n    );\n  }\n  if (!registry.has(name)) {\n    throw new PackError('WORKER_NOT_FOUND', `Worker \"${name}\" not found`, {\n      workerName: name,\n    });\n  }\n\n  const inFlight = workerTaskCounts.get(name) ?? 0;\n  if (inFlight > 0 && !opts?.force) {\n    throw new PackError(\n      'WORKER_IN_FLIGHT',\n      `Worker \"${name}\" has ${inFlight} in-flight tasks. Use { force: true } to cancel and remove.`,\n      { workerName: name, inFlightCount: inFlight }\n    );\n  }\n\n  const entry = registry.get(name)!;\n  if (opts?.force && entry.bridge) await closeBridgePort(entry.bridge);\n\n  registry.unregister(name);\n  workerTaskCounts.delete(name);\n  await rebuildLeaderBridgeImpl(deps);\n}\n\nexport function cancelWorkerImpl(\n  deps: WorkerAdminDeps,\n  name: string\n): { cancelled: number } {\n  const { options, registry, workerPlaybook, workerTaskCounts } = deps;\n  if (!registry.has(name)) {\n    throw new PackError('WORKER_NOT_FOUND', `Worker \"${name}\" not found`, {\n      workerName: name,\n    });\n  }\n\n  const entry = registry.get(name)!;\n  if (!entry.bridge) return { cancelled: 0 };\n\n  const count = workerTaskCounts.get(name) ?? 0;\n  if (count === 0) return { cancelled: 0 };\n\n  void closeBridgePort(entry.bridge).catch((err: unknown) => {\n    process.stderr.write(\n      `[octoflow] worker \"${name}\" bridge close error during restart: ${err instanceof Error ? err.message : String(err)}\\n`\n    );\n  });\n  entry.bridge = new Bridge(\n    buildWorkerBridgeOptions(name, options, workerPlaybook)\n  );\n  workerTaskCounts.set(name, 0);\n\n  return { cancelled: count };\n}\n\nexport async function rebuildLeaderBridgeImpl(\n  deps: WorkerAdminDeps\n): Promise<void> {\n  const {\n    driver,\n    getLeader,\n    getLeaderBridgeOptions,\n    leaderPlaybook,\n    options,\n    registry,\n    setLeader,\n    setLeaderBridgeOptions,\n  } = deps;\n  const manifest = driver.buildManifest(registry.all());\n  const leaderPromptParts = buildEffectivePromptParts(\n    options.shared,\n    options.leader ?? {},\n    leaderPlaybook,\n    manifest,\n    options.shared?.cache\n  );\n  const leaderSystemPrompt = partsToSystemPromptString(leaderPromptParts);\n\n  const nextOptions: BridgeOptions = {\n    ...getLeaderBridgeOptions(),\n    systemPrompt: leaderSystemPrompt,\n    systemPromptParts: leaderPromptParts,\n  };\n  setLeaderBridgeOptions(nextOptions);\n  const oldLeader = getLeader();\n  const newLeader = await createBridge(nextOptions);\n  setLeader(newLeader);\n  await closeBridgePort(oldLeader);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,55 @@
+import type { BridgeOptions, BridgeRuntimeConfigSnapshot } from '../../bridge/bridge.js';
+import { Bridge } from '../../bridge/bridge.js';
+import { TopicChannel } from '../../bridge/topic-channel.js';
+import type { PackRunParams, PackRunResult, RunEvent } from '../run/types.js';
+import { WorkerRegistry } from './registry.js';
+import type { PackEvent, PackOptions, PackResult, PackSendParams, PackSession, PackWorkerConfig, WorkerInspection } from './types.js';
+export { WORKER_PLAYBOOK } from './pack-bootstrap.js';
+export interface PackRuntimeConfigSnapshot {
+    runtime: 'pack';
+    options: PackOptions;
+    leader: BridgeRuntimeConfigSnapshot;
+    workers: WorkerInspection[];
+}
+export declare class Pack {
+    leader: Bridge;
+    readonly registry: WorkerRegistry;
+    private readonly options;
+    private readonly driver;
+    private closed;
+    private closePromise;
+    private activeRound;
+    private readonly packId;
+    private readonly lineage;
+    /** @internal – exposed for `createPackAsync` bridge upgrade. */
+    leaderBridgeOptions: BridgeOptions;
+    private readonly workerTaskCounts;
+    private readonly workerContextIds;
+    private _topics?;
+    get topics(): TopicChannel;
+    constructor(options: PackOptions);
+    private workerAdminDeps;
+    sendMessage(params: PackSendParams): Promise<PackResult>;
+    stream(params: PackSendParams): AsyncGenerator<PackEvent>;
+    private runLeader;
+    private runDispatch;
+    run(params: PackRunParams): Promise<PackRunResult>;
+    runStream(params: PackRunParams): AsyncGenerator<RunEvent>;
+    session(contextId?: string): PackSession;
+    inspectWorkers(): WorkerInspection[];
+    /** Returns the stable UUID that identifies this Pack instance. */
+    getPackId(): string;
+    getConfig(): PackRuntimeConfigSnapshot;
+    addWorker(config: PackWorkerConfig): Promise<void>;
+    removeWorker(name: string, opts?: {
+        force?: boolean;
+    }): Promise<void>;
+    cancelWorker(name: string): {
+        cancelled: number;
+    };
+    cancelAll(): void;
+    close(): void;
+    closeAsync(): Promise<void>;
+}
+export declare function createPack(options: PackOptions): Pack;
+//# sourceMappingURL=pack.d.ts.map