@agentforge/patterns 0.17.0 → 0.17.1

package/dist/index.cjs

@@ -3573,49 +3573,72 @@ function admitWorkerTopology(workers) {
   let workerCapabilities = Object.freeze(
     Object.fromEntries(topology.map((worker) => [worker.id, worker.capabilities]))
   );
+  const publishRoutingSkills = (updates) => {
+    if (updates.length === 0) {
+      return;
+    }
+    validateIdentities(updates);
+    const replacements = updates.map((update) => {
+      const current = workerCapabilities[update.id];
+      if (!Object.hasOwn(workerCapabilities, update.id) || !current) {
+        throw new WorkerLifecycleError(
+          "unknown-worker",
+          `Cannot update unknown Worker "${update.id}" after compilation.`
+        );
+      }
+      if (update.assertedTools !== void 0) {
+        const assertedTools = [...normalizeWorkerToolNames(update.id, update.assertedTools)].sort();
+        const executableTools = [...current.tools].sort();
+        if (assertedTools.length !== executableTools.length || assertedTools.some((toolName, index) => toolName !== executableTools[index])) {
+          throw new WorkerLifecycleError(
+            "invalid-tool",
+            `Worker "${update.id}" tools do not match its compiled executable tools.`
+          );
+        }
+      }
+      return [
+        update.id,
+        asCompatibleWorkerCapabilities(
+          Object.freeze({
+            ...current,
+            skills: Object.freeze([...update.skills])
+          })
+        )
+      ];
+    });
+    workerCapabilities = Object.freeze({
+      ...workerCapabilities,
+      ...Object.fromEntries(replacements)
+    });
+  };
   return Object.freeze({
     topology,
-    captureWorkerSnapshot: () => workerCapabilities,
-    updateRoutingSkills: (updates) => {
-      if (updates.length === 0) {
-        return;
-      }
-      validateIdentities(updates);
-      const replacements = updates.map((update) => {
-        const current = workerCapabilities[update.id];
-        if (!Object.hasOwn(workerCapabilities, update.id) || !current) {
+    captureSnapshot: (statusOverrides) => {
+      const publishedCapabilities = workerCapabilities;
+      for (const workerId of Object.keys(statusOverrides)) {
+        if (!Object.hasOwn(publishedCapabilities, workerId)) {
           throw new WorkerLifecycleError(
             "unknown-worker",
-            `Cannot update unknown Worker "${update.id}" after compilation.`
+            `Invocation state contains unknown Worker "${workerId}".`
           );
         }
-        if (update.assertedTools !== void 0) {
-          const assertedTools = [
-            ...normalizeWorkerToolNames(update.id, update.assertedTools)
-          ].sort();
-          const executableTools = [...current.tools].sort();
-          if (assertedTools.length !== executableTools.length || assertedTools.some((toolName, index) => toolName !== executableTools[index])) {
-            throw new WorkerLifecycleError(
-              "invalid-tool",
-              `Worker "${update.id}" tools do not match its compiled executable tools.`
-            );
-          }
-        }
-        return [
-          update.id,
-          asCompatibleWorkerCapabilities(
-            Object.freeze({
-              ...current,
-              skills: Object.freeze([...update.skills])
-            })
-          )
-        ];
-      });
-      workerCapabilities = Object.freeze({
-        ...workerCapabilities,
-        ...Object.fromEntries(replacements)
-      });
-    }
+      }
+      return Object.fromEntries(
+        Object.entries(publishedCapabilities).map(([workerId, capabilities]) => {
+          const status = Object.hasOwn(statusOverrides, workerId) ? statusOverrides[workerId] : capabilities;
+          return [
+            workerId,
+            {
+              skills: [...capabilities.skills],
+              tools: [...capabilities.tools],
+              available: status.available,
+              currentWorkload: status.currentWorkload
+            }
+          ];
+        })
+      );
+    },
+    publishRoutingSkills
   });
 }
 function associateWorkerLifecycle(system, lifecycle) {
@@ -3651,45 +3674,21 @@ function createWorkerRegistryData(workers) {
 
 // src/multi-agent/worker-initialization.ts
 var logger4 = createPatternLogger("agentforge:patterns:multi-agent:worker-initialization");
-function initializeWorkerState(topologyCapabilities, invocationWorkers) {
-  for (const workerId of Object.keys(invocationWorkers)) {
-    if (!Object.hasOwn(topologyCapabilities, workerId)) {
-      throw new WorkerLifecycleError(
-        "unknown-worker",
-        `Invocation state contains unknown Worker "${workerId}".`
-      );
-    }
-  }
-  return Object.fromEntries(
-    Object.entries(topologyCapabilities).map(([workerId, capabilities]) => {
-      const status = Object.hasOwn(invocationWorkers, workerId) ? invocationWorkers[workerId] : capabilities;
-      return [
-        workerId,
-        {
-          skills: [...capabilities.skills],
-          tools: [...capabilities.tools],
-          available: status.available,
-          currentWorkload: status.currentWorkload
-        }
-      ];
-    })
-  );
-}
-function createWorkerInitializationNode(captureWorkerSnapshot) {
+function createWorkerInitializationNode(lifecycle) {
   return async (state) => {
-    const topologyCapabilities = captureWorkerSnapshot();
+    const topologyWorkerIds = lifecycle.topology.map((worker) => worker.id);
     logger4.info("Worker initialization started", {
-      workerCount: Object.keys(topologyCapabilities).length,
+      workerCount: topologyWorkerIds.length,
       statusOverrideCount: Object.keys(state.workers).length
     });
     let workers;
     try {
-      workers = initializeWorkerState(topologyCapabilities, state.workers);
+      workers = lifecycle.captureSnapshot(state.workers);
     } catch (error) {
       logger4.error("Worker initialization failed", {
         error: error instanceof Error ? error.message : String(error),
         invocationWorkerIds: Object.keys(state.workers),
-        topologyWorkerIds: Object.keys(topologyCapabilities)
+        topologyWorkerIds
       });
       throw error;
     }
@@ -3759,10 +3758,7 @@ function createCompiledMultiAgentSystem(config, lifecycle = admitWorkerTopology(
   const { supervisor, aggregator, maxIterations = 10, verbose = false, checkpointer } = config;
   const workflow = new import_langgraph4.StateGraph(MultiAgentState);
   const workerIds = [];
-  workflow.addNode(
-    "initializeWorkers",
-    createWorkerInitializationNode(lifecycle.captureWorkerSnapshot)
-  );
+  workflow.addNode("initializeWorkers", createWorkerInitializationNode(lifecycle));
   workflow.addNode("supervisor", createSupervisorNode({ ...supervisor, maxIterations, verbose }));
   for (const workerConfig of lifecycle.topology) {
     workflow.addNode(
@@ -3800,7 +3796,7 @@ function createCompiledMultiAgentSystem(config, lifecycle = admitWorkerTopology(
 
 // src/multi-agent/agent-runtime.ts
 function registerWorkerCapabilities(system, workers) {
-  resolveWorkerLifecycle(system).updateRoutingSkills(
+  resolveWorkerLifecycle(system).publishRoutingSkills(
     workers.map((worker) => ({
       id: worker.name,
       skills: worker.capabilities,

package/dist/index.js

@@ -3473,49 +3473,72 @@ function admitWorkerTopology(workers) {
   let workerCapabilities = Object.freeze(
     Object.fromEntries(topology.map((worker) => [worker.id, worker.capabilities]))
   );
+  const publishRoutingSkills = (updates) => {
+    if (updates.length === 0) {
+      return;
+    }
+    validateIdentities(updates);
+    const replacements = updates.map((update) => {
+      const current = workerCapabilities[update.id];
+      if (!Object.hasOwn(workerCapabilities, update.id) || !current) {
+        throw new WorkerLifecycleError(
+          "unknown-worker",
+          `Cannot update unknown Worker "${update.id}" after compilation.`
+        );
+      }
+      if (update.assertedTools !== void 0) {
+        const assertedTools = [...normalizeWorkerToolNames(update.id, update.assertedTools)].sort();
+        const executableTools = [...current.tools].sort();
+        if (assertedTools.length !== executableTools.length || assertedTools.some((toolName, index) => toolName !== executableTools[index])) {
+          throw new WorkerLifecycleError(
+            "invalid-tool",
+            `Worker "${update.id}" tools do not match its compiled executable tools.`
+          );
+        }
+      }
+      return [
+        update.id,
+        asCompatibleWorkerCapabilities(
+          Object.freeze({
+            ...current,
+            skills: Object.freeze([...update.skills])
+          })
+        )
+      ];
+    });
+    workerCapabilities = Object.freeze({
+      ...workerCapabilities,
+      ...Object.fromEntries(replacements)
+    });
+  };
   return Object.freeze({
     topology,
-    captureWorkerSnapshot: () => workerCapabilities,
-    updateRoutingSkills: (updates) => {
-      if (updates.length === 0) {
-        return;
-      }
-      validateIdentities(updates);
-      const replacements = updates.map((update) => {
-        const current = workerCapabilities[update.id];
-        if (!Object.hasOwn(workerCapabilities, update.id) || !current) {
+    captureSnapshot: (statusOverrides) => {
+      const publishedCapabilities = workerCapabilities;
+      for (const workerId of Object.keys(statusOverrides)) {
+        if (!Object.hasOwn(publishedCapabilities, workerId)) {
           throw new WorkerLifecycleError(
             "unknown-worker",
-            `Cannot update unknown Worker "${update.id}" after compilation.`
+            `Invocation state contains unknown Worker "${workerId}".`
           );
         }
-        if (update.assertedTools !== void 0) {
-          const assertedTools = [
-            ...normalizeWorkerToolNames(update.id, update.assertedTools)
-          ].sort();
-          const executableTools = [...current.tools].sort();
-          if (assertedTools.length !== executableTools.length || assertedTools.some((toolName, index) => toolName !== executableTools[index])) {
-            throw new WorkerLifecycleError(
-              "invalid-tool",
-              `Worker "${update.id}" tools do not match its compiled executable tools.`
-            );
-          }
-        }
-        return [
-          update.id,
-          asCompatibleWorkerCapabilities(
-            Object.freeze({
-              ...current,
-              skills: Object.freeze([...update.skills])
-            })
-          )
-        ];
-      });
-      workerCapabilities = Object.freeze({
-        ...workerCapabilities,
-        ...Object.fromEntries(replacements)
-      });
-    }
+      }
+      return Object.fromEntries(
+        Object.entries(publishedCapabilities).map(([workerId, capabilities]) => {
+          const status = Object.hasOwn(statusOverrides, workerId) ? statusOverrides[workerId] : capabilities;
+          return [
+            workerId,
+            {
+              skills: [...capabilities.skills],
+              tools: [...capabilities.tools],
+              available: status.available,
+              currentWorkload: status.currentWorkload
+            }
+          ];
+        })
+      );
+    },
+    publishRoutingSkills
   });
 }
 function associateWorkerLifecycle(system, lifecycle) {
@@ -3551,45 +3574,21 @@ function createWorkerRegistryData(workers) {
 
 // src/multi-agent/worker-initialization.ts
 var logger4 = createPatternLogger("agentforge:patterns:multi-agent:worker-initialization");
-function initializeWorkerState(topologyCapabilities, invocationWorkers) {
-  for (const workerId of Object.keys(invocationWorkers)) {
-    if (!Object.hasOwn(topologyCapabilities, workerId)) {
-      throw new WorkerLifecycleError(
-        "unknown-worker",
-        `Invocation state contains unknown Worker "${workerId}".`
-      );
-    }
-  }
-  return Object.fromEntries(
-    Object.entries(topologyCapabilities).map(([workerId, capabilities]) => {
-      const status = Object.hasOwn(invocationWorkers, workerId) ? invocationWorkers[workerId] : capabilities;
-      return [
-        workerId,
-        {
-          skills: [...capabilities.skills],
-          tools: [...capabilities.tools],
-          available: status.available,
-          currentWorkload: status.currentWorkload
-        }
-      ];
-    })
-  );
-}
-function createWorkerInitializationNode(captureWorkerSnapshot) {
+function createWorkerInitializationNode(lifecycle) {
   return async (state) => {
-    const topologyCapabilities = captureWorkerSnapshot();
+    const topologyWorkerIds = lifecycle.topology.map((worker) => worker.id);
     logger4.info("Worker initialization started", {
-      workerCount: Object.keys(topologyCapabilities).length,
+      workerCount: topologyWorkerIds.length,
       statusOverrideCount: Object.keys(state.workers).length
     });
     let workers;
     try {
-      workers = initializeWorkerState(topologyCapabilities, state.workers);
+      workers = lifecycle.captureSnapshot(state.workers);
     } catch (error) {
       logger4.error("Worker initialization failed", {
         error: error instanceof Error ? error.message : String(error),
         invocationWorkerIds: Object.keys(state.workers),
-        topologyWorkerIds: Object.keys(topologyCapabilities)
+        topologyWorkerIds
       });
       throw error;
     }
@@ -3659,10 +3658,7 @@ function createCompiledMultiAgentSystem(config, lifecycle = admitWorkerTopology(
   const { supervisor, aggregator, maxIterations = 10, verbose = false, checkpointer } = config;
   const workflow = new StateGraph4(MultiAgentState);
   const workerIds = [];
-  workflow.addNode(
-    "initializeWorkers",
-    createWorkerInitializationNode(lifecycle.captureWorkerSnapshot)
-  );
+  workflow.addNode("initializeWorkers", createWorkerInitializationNode(lifecycle));
   workflow.addNode("supervisor", createSupervisorNode({ ...supervisor, maxIterations, verbose }));
   for (const workerConfig of lifecycle.topology) {
     workflow.addNode(
@@ -3700,7 +3696,7 @@ function createCompiledMultiAgentSystem(config, lifecycle = admitWorkerTopology(
 
 // src/multi-agent/agent-runtime.ts
 function registerWorkerCapabilities(system, workers) {
-  resolveWorkerLifecycle(system).updateRoutingSkills(
+  resolveWorkerLifecycle(system).publishRoutingSkills(
     workers.map((worker) => ({
       id: worker.name,
       skills: worker.capabilities,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge/patterns",
-  "version": "0.17.0",
+  "version": "0.17.1",
   "description": "Production-ready agent workflow patterns for TypeScript including ReAct and Planner-Executor, built on LangGraph.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -41,13 +41,13 @@
     "url": "https://github.com/TVScoundrel/agentforge/issues"
   },
   "dependencies": {
-    "@agentforge/core": "0.17.0",
+    "@agentforge/core": "0.17.1",
     "@langchain/core": "^1.1.17",
     "@langchain/langgraph": "^1.1.2",
     "zod": "^3.23.8"
   },
   "devDependencies": {
-    "@agentforge/testing": "0.17.0",
+    "@agentforge/testing": "0.17.1",
     "@eslint/js": "^9.17.0",
     "@types/node": "^22.10.2",
     "eslint": "^9.17.0",