agentfootprint 1.4.2 → 1.7.1

package/dist/recorders/ToolUsageRecorder.js

@@ -2,29 +2,24 @@
 /**
  * ToolUsageRecorder — tracks which tools are called, how often, and latency.
  *
- * Useful for understanding agent behavior: which tools are hot,
- * which are slow, and which are erroring.
- *
- * Usage:
- *   const toolUsage = new ToolUsageRecorder();
- *   agent.recorder(toolUsage);
- *   await agent.run(...);
- *   console.log(toolUsage.getStats());
+ * Extends KeyedRecorder<ToolCallEvent> — Map keyed by runtimeStageId.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ToolUsageRecorder = void 0;
-class ToolUsageRecorder {
+const trace_1 = require("footprintjs/trace");
+class ToolUsageRecorder extends trace_1.KeyedRecorder {
     id;
-    toolCalls = [];
     constructor(id = 'tool-usage-recorder') {
+        super();
         this.id = id;
     }
     onToolCall(event) {
-        this.toolCalls.push(event);
+        this.store(event.runtimeStageId, event);
     }
     getStats() {
+        const calls = this.values();
         const byTool = {};
-        for (const call of this.toolCalls) {
+        for (const call of calls) {
             if (!byTool[call.toolName]) {
                 byTool[call.toolName] = { calls: 0, errors: 0, totalLatencyMs: 0 };
             }
@@ -42,16 +37,25 @@ class ToolUsageRecorder {
             };
         }
         return {
-            totalCalls: this.toolCalls.length,
-            totalErrors: this.toolCalls.filter((c) => c.result.error).length,
+            totalCalls: calls.length,
+            totalErrors: calls.filter((c) => c.result.error).length,
             byTool: result,
         };
     }
     getToolNames() {
-        return [...new Set(this.toolCalls.map((c) => c.toolName))];
+        return [...new Set(this.values().map((c) => c.toolName))];
     }
-    clear() {
-        this.toolCalls = [];
+    toSnapshot() {
+        return {
+            name: 'Tools',
+            description: 'Translator (KeyedRecorder) — per-call tool usage and latency',
+            preferredOperation: 'translate',
+            data: {
+                numericField: 'latencyMs',
+                grandTotal: this.aggregate((sum, e) => sum + e.latencyMs, 0),
+                steps: Object.fromEntries(this.getMap()),
+            },
+        };
     }
 }
 exports.ToolUsageRecorder = ToolUsageRecorder;

package/dist/recorders/ToolUsageRecorder.js.map

@@ -1 +1 @@
-{"version":3,"file":"ToolUsageRecorder.js","sourceRoot":"","sources":["../../src/recorders/ToolUsageRecorder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAiBH,MAAa,iBAAiB;IACnB,EAAE,CAAS;IACZ,SAAS,GAAoB,EAAE,CAAC;IAExC,YAAY,EAAE,GAAG,qBAAqB;QACpC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IAED,UAAU,CAAC,KAAoB;QAC7B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,QAAQ;QACN,MAAM,MAAM,GAA8E,EAAE,CAAC;QAE7F,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;YACrE,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,cAAc,IAAI,IAAI,CAAC,SAAS,CAAC;YACvD,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;YACjC,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAA8B,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnD,MAAM,CAAC,IAAI,CAAC,GAAG;gBACb,GAAG,KAAK;gBACR,gBAAgB,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;aACvF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM;YACjC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM;YAChE,MAAM,EAAE,MAAM;SACf,CAAC;IACJ,CAAC;IAED,YAAY;QACV,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;IACtB,CAAC;CACF;AAhDD,8CAgDC"}
+{"version":3,"file":"ToolUsageRecorder.js","sourceRoot":"","sources":["../../src/recorders/ToolUsageRecorder.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,6CAAkD;AAgBlD,MAAa,iBAAkB,SAAQ,qBAA4B;IACxD,EAAE,CAAS;IAEpB,YAAY,EAAE,GAAG,qBAAqB;QACpC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IAED,UAAU,CAAC,KAAoB;QAC7B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,QAAQ;QACN,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,MAAM,GAA8E,EAAE,CAAC;QAE7F,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;YACrE,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,cAAc,IAAI,IAAI,CAAC,SAAS,CAAC;YACvD,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;YACjC,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAA8B,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnD,MAAM,CAAC,IAAI,CAAC,GAAG;gBACb,GAAG,KAAK;gBACR,gBAAgB,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;aACvF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM;YACvD,MAAM,EAAE,MAAM;SACf,CAAC;IACJ,CAAC;IAED,YAAY;QACV,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,UAAU;QACR,OAAO;YACL,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,8DAA8D;YAC3E,kBAAkB,EAAE,WAAoB;YACxC,IAAI,EAAE;gBACJ,YAAY,EAAE,WAAW;gBACzB,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;gBAC5D,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;aACzC;SACF,CAAC;IACJ,CAAC;CACF;AA1DD,8CA0DC"}

package/dist/streaming/StreamEmitter.js.map

@@ -1 +1 @@
-{"version":3,"file":"StreamEmitter.js","sourceRoot":"","sources":["../../src/streaming/StreamEmitter.ts"],"names":[],"mappings":";;;AAkDA;;;;;GAKG;AACH,MAAa,aAAa;IAChB,QAAQ,GAA8B,EAAE,CAAC;IAEjD,EAAE,CAAC,OAAgC;QACjC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC;QAC7D,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAuB;QAC1B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;YAAC,MAAM,CAAC;gBACP,oDAAoD;YACtD,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAnBD,sCAmBC;AAED;;;;;;;;GAQG;AACH,MAAa,YAAY;IACvB,MAAM,CAAC,MAAM,CAAC,KAAuB;QACnC,OAAO,UAAU,KAAK,CAAC,IAAI,WAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,MAA0B;QACzC,OAAO,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;CACF;AARD,oCAQC"}
+{"version":3,"file":"StreamEmitter.js","sourceRoot":"","sources":["../../src/streaming/StreamEmitter.ts"],"names":[],"mappings":";;;AAgEA;;;;;GAKG;AACH,MAAa,aAAa;IAChB,QAAQ,GAA8B,EAAE,CAAC;IAEjD,EAAE,CAAC,OAAgC;QACjC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC;QAC7D,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAuB;QAC1B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;YAAC,MAAM,CAAC;gBACP,oDAAoD;YACtD,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAnBD,sCAmBC;AAED;;;;;;;;GAQG;AACH,MAAa,YAAY;IACvB,MAAM,CAAC,MAAM,CAAC,KAAuB;QACnC,OAAO,UAAU,KAAK,CAAC,IAAI,WAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,MAA0B;QACzC,OAAO,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;CACF;AARD,oCAQC"}

package/dist/types/adapters/browser/BrowserAnthropicAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BrowserAnthropicAdapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/browser/BrowserAnthropicAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,OAAO,EAKR,MAAM,aAAa,CAAC;AAsDrB,MAAM,WAAW,8BAA8B;IAC7C,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,uBAAwB,YAAW,WAAW;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,8BAA8B;IAO7C,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAQxE,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC,cAAc,CAAC;IAmH/F,OAAO,CAAC,SAAS;YA6CH,QAAQ;CAoDvB"}
+{"version":3,"file":"BrowserAnthropicAdapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/browser/BrowserAnthropicAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,OAAO,EAKR,MAAM,aAAa,CAAC;AAsDrB,MAAM,WAAW,8BAA8B;IAC7C,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,uBAAwB,YAAW,WAAW;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,8BAA8B;IAO7C,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAQxE,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC,cAAc,CAAC;IAmI/F,OAAO,CAAC,SAAS;YA6CH,QAAQ;CAoDvB"}

package/dist/types/concepts/LLMCall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LLMCall.d.ts","sourceRoot":"","sources":["../../../src/concepts/LLMCall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,SAAS,IAAI,aAAa,EAAwC,MAAM,aAAa,CAAC;AAGpG,OAAO,KAAK,EAAE,WAAW,EAAe,OAAO,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAQ7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C,MAAM,WAAW,cAAc;IAC7B,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,WAAW,CAAC;CAC9C;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO;IAIP,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO;IAI/C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5B,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKjC,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAKlC,KAAK,IAAI,aAAa;CAQvB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAC3C,OAAO,CAAC,YAAY,CAAC,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,CAAU;gBAGzB,QAAQ,EAAE,WAAW,EACrB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,GAAE,aAAa,EAAO,EAC/B,SAAS,UAAQ;IAQnB,6DAA6D;IAC7D,WAAW,IAAI,aAAa;IAItB,GAAG,CACP,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,GACxF,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAuDpD,OAAO,CAAC,UAAU;IAyClB,OAAO,IAAI,OAAO;IAOlB,YAAY,IAAI,MAAM,EAAE;IAIxB,WAAW;CAGZ"}
+{"version":3,"file":"LLMCall.d.ts","sourceRoot":"","sources":["../../../src/concepts/LLMCall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,SAAS,IAAI,aAAa,EAAwC,MAAM,aAAa,CAAC;AAIpG,OAAO,KAAK,EAAE,WAAW,EAAe,OAAO,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAQ7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C,MAAM,WAAW,cAAc;IAC7B,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,WAAW,CAAC;CAC9C;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO;IAIP,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO;IAI/C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5B,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKjC,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAKlC,KAAK,IAAI,aAAa;CAQvB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAC3C,OAAO,CAAC,YAAY,CAAC,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,CAAU;gBAGzB,QAAQ,EAAE,WAAW,EACrB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,GAAE,aAAa,EAAO,EAC/B,SAAS,UAAQ;IAQnB,6DAA6D;IAC7D,WAAW,IAAI,aAAa;IAItB,GAAG,CACP,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,GACxF,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IA4DpD,OAAO,CAAC,UAAU;IAyClB,OAAO,IAAI,OAAO;IAOlB,YAAY,IAAI,MAAM,EAAE;IAIxB,WAAW;CAGZ"}

package/dist/types/concepts/RAG.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RAG.d.ts","sourceRoot":"","sources":["../../../src/concepts/RAG.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,SAAS,IAAI,aAAa,EAAwC,MAAM,aAAa,CAAC;AAGpG,OAAO,KAAK,EACV,WAAW,EAEX,iBAAiB,EACjB,eAAe,EAGf,SAAS,EACV,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAW7C,MAAM,WAAW,UAAU;IACzB,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,WAAW,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;CACvC;AAED,qBAAa,GAAG;IACd,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO;IAKP,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,GAAG;IAIvC,yBAAyB;IACzB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5B,wCAAwC;IACxC,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKrB,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK7B,wDAAwD;IACxD,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKjC,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAKlC,kDAAkD;IAClD,KAAK,IAAI,SAAS;CAUnB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,YAAY,CAAC,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,CAAU;IAE3B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;gBAGzC,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,iBAAiB,EAC5B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,eAAe,EAAE,eAAe,EAChC,SAAS,GAAE,aAAa,EAAO,EAC/B,SAAS,UAAQ;IAUnB,6DAA6D;IAC7D,WAAW,IAAI,aAAa;IAItB,GAAG,CACP,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,GACxF,OAAO,CAAC,SAAS,CAAC;IAuDrB,OAAO,CAAC,UAAU;IAyClB,qDAAqD;IACrD,OAAO,IAAI,OAAO;IAOlB,2CAA2C;IAC3C,YAAY,IAAI,MAAM,EAAE;IAIxB,0DAA0D;IAC1D,mBAAmB;IAInB,yDAAyD;IACzD,WAAW;CAGZ"}
+{"version":3,"file":"RAG.d.ts","sourceRoot":"","sources":["../../../src/concepts/RAG.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,SAAS,IAAI,aAAa,EAAwC,MAAM,aAAa,CAAC;AAIpG,OAAO,KAAK,EACV,WAAW,EAEX,iBAAiB,EACjB,eAAe,EAGf,SAAS,EACV,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAW7C,MAAM,WAAW,UAAU;IACzB,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,WAAW,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;CACvC;AAED,qBAAa,GAAG;IACd,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO;IAKP,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,GAAG;IAIvC,yBAAyB;IACzB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5B,wCAAwC;IACxC,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKrB,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK7B,wDAAwD;IACxD,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKjC,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAKlC,kDAAkD;IAClD,KAAK,IAAI,SAAS;CAUnB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,YAAY,CAAC,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,CAAU;IAE3B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;gBAGzC,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,iBAAiB,EAC5B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,eAAe,EAAE,eAAe,EAChC,SAAS,GAAE,aAAa,EAAO,EAC/B,SAAS,UAAQ;IAUnB,6DAA6D;IAC7D,WAAW,IAAI,aAAa;IAItB,GAAG,CACP,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,GACxF,OAAO,CAAC,SAAS,CAAC;IA4DrB,OAAO,CAAC,UAAU;IAyClB,qDAAqD;IACrD,OAAO,IAAI,OAAO;IAOlB,2CAA2C;IAC3C,YAAY,IAAI,MAAM,EAAE;IAIxB,0DAA0D;IAC1D,mBAAmB;IAInB,yDAAyD;IACzD,WAAW;CAGZ"}

package/dist/types/concepts/Swarm.d.ts.map

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

package/dist/types/concepts/index.d.ts

@@ -1,5 +1,5 @@
 export { Agent, AgentRunner } from '../lib/concepts';
-export type { AgentOptions } from '../lib/concepts';
+export type { AgentOptions, CustomRouteBranch, CustomRouteConfig } from '../lib/concepts';
 export { LLMCall, LLMCallRunner } from './LLMCall';
 export type { LLMCallOptions } from './LLMCall';
 export { RAG, RAGRunner } from './RAG';

package/dist/types/concepts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/concepts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,YAAY,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/concepts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,YAAY,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/types/core/recorders.d.ts

@@ -31,6 +31,8 @@ export interface LLMCallEvent {
     readonly turnNumber: number;
     readonly loopIteration: number;
     readonly finishReason?: LLMResponse['finishReason'];
+    /** Unique per-execution-step identifier from footprintjs traversal. */
+    readonly runtimeStageId: string;
     /** System prompt the LLM received (for evaluation context). */
     readonly systemPrompt?: string;
     /** Tool descriptions sent to the LLM (for tool selection evaluation). */
@@ -49,6 +51,8 @@ export interface ToolCallEvent {
     readonly args: Record<string, unknown>;
     readonly result: ToolExecutionResult;
     readonly latencyMs: number;
+    /** Unique per-execution-step identifier from footprintjs traversal. */
+    readonly runtimeStageId: string;
 }
 export interface TurnCompleteEvent {
     readonly turnNumber: number;

package/dist/types/core/recorders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recorders.d.ts","sourceRoot":"","sources":["../../../src/core/recorders.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAIvD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAC1C,SAAS,CAAC,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IACtC,UAAU,CAAC,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IACxC,cAAc,CAAC,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAChD,OAAO,CAAC,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IACvC,KAAK,CAAC,IAAI,IAAI,CAAC;CAChB;AAID,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IACpD,+DAA+D;IAC/D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,yEAAyE;IACzE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjF,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wDAAwD;AACxD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B"}
+{"version":3,"file":"recorders.d.ts","sourceRoot":"","sources":["../../../src/core/recorders.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAIvD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAC1C,SAAS,CAAC,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IACtC,UAAU,CAAC,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IACxC,cAAc,CAAC,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAChD,OAAO,CAAC,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IACvC,KAAK,CAAC,IAAI,IAAI,CAAC;CAChB;AAID,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IACpD,uEAAuE;IACvE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,+DAA+D;IAC/D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,yEAAyE;IACzE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjF,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wDAAwD;AACxD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B"}

package/dist/types/executor/agentLoop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentLoop.d.ts","sourceRoot":"","sources":["../../../src/executor/agentLoop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAS/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAMjD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAID,wBAAsB,SAAS,CAC7B,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAkI1B"}
+{"version":3,"file":"agentLoop.d.ts","sourceRoot":"","sources":["../../../src/executor/agentLoop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAS/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAMjD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAID,wBAAsB,SAAS,CAC7B,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAqI1B"}

package/dist/types/index.d.ts

@@ -12,6 +12,7 @@
  *   agentfootprint/stream        → Real-time lifecycle events
  */
 export { Agent, AgentRunner, LLMCall, LLMCallRunner, RAG, RAGRunner, FlowChart, FlowChartRunner, Swarm, SwarmRunner, Parallel, ParallelRunner, } from './concepts';
+export type { CustomRouteBranch, CustomRouteConfig } from './concepts';
 export { defineTool, askHuman, ToolRegistry } from './tools';
 export { mock, MockAdapter, mockRetriever, MockRetriever, createProvider } from './adapters';
 export { anthropic, openai, ollama, bedrock } from './models';
@@ -28,4 +29,9 @@ export { systemMessage, userMessage, assistantMessage, toolResultMessage, textBl
 export { LLMError } from './types';
 export type { Message, ToolCall, LLMProvider, LLMResponse, LLMCallOptions, TokenUsage, LLMToolDescription, ToolDefinition, ToolHandler, ToolResult, AgentResult, AgentRunOptions, RunnerLike, RetrieverProvider, RetrievalChunk, RAGResult, LLMErrorCode, } from './types';
 export type { AgentStreamEvent, AgentStreamEventHandler } from './streaming';
+export { agentLoop } from './executor';
+export type { AgentLoopConfig } from './core/config';
+export { defineInstruction, AgentPattern, quickBind } from './instructions.barrel';
+export type { AgentInstruction, InstructedToolDefinition } from './instructions.barrel';
+export { TokenRecorder, ToolUsageRecorder, TurnRecorder, CostRecorder } from './observe.barrel';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EACL,KAAK,EACL,WAAW,EACX,OAAO,EACP,aAAa,EACb,GAAG,EACH,SAAS,EACT,SAAS,EACT,eAAe,EACf,KAAK,EACL,WAAW,EACX,QAAQ,EACR,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG7D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAClF,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,YAAY,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,aAAa,GACd,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC/E,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9D,OAAO,EACL,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,WAAW,EACX,QAAQ,GACT,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnC,YAAY,EACV,OAAO,EACP,QAAQ,EACR,WAAW,EACX,WAAW,EACX,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,UAAU,EACV,WAAW,EACX,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,YAAY,GACb,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EACL,KAAK,EACL,WAAW,EACX,OAAO,EACP,aAAa,EACb,GAAG,EACH,SAAS,EACT,SAAS,EACT,eAAe,EACf,KAAK,EACL,WAAW,EACX,QAAQ,EACR,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGvE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG7D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAClF,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,YAAY,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,aAAa,GACd,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC/E,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9D,OAAO,EACL,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,WAAW,EACX,QAAQ,GACT,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnC,YAAY,EACV,OAAO,EACP,QAAQ,EACR,WAAW,EACX,WAAW,EACX,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,UAAU,EACV,WAAW,EACX,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,YAAY,GACb,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAG7E,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACnF,YAAY,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAGxF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/types/lib/call/callLLMStage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"callLLMStage.d.ts","sourceRoot":"","sources":["../../../../src/lib/call/callLLMStage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAkB,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAG/D,MAAM,WAAW,mBAAmB;IAClC,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,WAAW,EACrB,gBAAgB,CAAC,EAAE,mBAAmB,GAAG,uBAAuB,WAc3C,WAAW,cAAc,CAAC,mBA0ChD"}
+{"version":3,"file":"callLLMStage.d.ts","sourceRoot":"","sources":["../../../../src/lib/call/callLLMStage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAkB,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAG/D,MAAM,WAAW,mBAAmB;IAClC,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,WAAW,EACrB,gBAAgB,CAAC,EAAE,mBAAmB,GAAG,uBAAuB,WAc3C,WAAW,cAAc,CAAC,mBAqFhD"}

package/dist/types/lib/call/helpers.d.ts

@@ -7,6 +7,47 @@ import type { ToolProvider } from '../../core';
 import type { LLMInstruction, InstructionContext, InstructionTemplate } from '../instructions';
 import type { ResolvedInstruction } from '../instructions';
 import type { AgentStreamEventHandler } from '../../streaming';
+/**
+ * Default threshold for escalating repeated-identical-failure feedback.
+ * Override per-agent with `AgentBuilder.maxIdenticalFailures(n)`; pass `0` to
+ * disable escalation entirely.
+ */
+export declare const REPEATED_FAILURE_ESCALATION_THRESHOLD = 3;
+/**
+ * Stable JSON.stringify — keys sorted at every object level — so two calls
+ * with the same logical arguments but different key insertion order are
+ * treated as identical. Only handles plain JSON values (strings, numbers,
+ * booleans, nulls, arrays, plain objects), which matches the JSON-Schema
+ * shape of tool arguments.
+ */
+export declare function stableStringify(value: unknown): string;
+/**
+ * If the current call is a real error AND the (toolName, args) key has failed
+ * a multiple of `threshold` times (i.e. on the threshold-th, 2×threshold-th,
+ * 3×threshold-th … identical failure), inject an `escalation` field into
+ * the JSON result content.
+ *
+ * ## Why periodic, not one-shot
+ *
+ * A single escalation message early in the loop is easy for an LLM to skim
+ * past — especially when multiple parallel tool calls fail in the same
+ * turn. Firing periodically (every Nth identical failure) keeps nudging
+ * the LLM to change strategy while bounding token bloat to at most
+ * `maxIterations / threshold` escalations per key.
+ *
+ * Returns the possibly-enriched content. Pure — does not mutate inputs.
+ *
+ * Guarantees:
+ *   - No false positives from substring matching (strict JSON parse).
+ *   - Fires at every `N × threshold`-th failure, never between.
+ *   - Stable under argument key reordering (uses `stableStringify`).
+ *   - No-op when `threshold <= 0` (user-disabled).
+ *   - No-op when `didError` is false OR content is non-JSON.
+ */
+export declare function enrichIfRepeatedFailure(resultContent: string, toolCall: ToolCall, priorMessages: readonly Message[], options: {
+    didError: boolean;
+    threshold: number;
+}): string;
 /**
  * Normalize an LLMResponse into an AdapterResult discriminated union.
  */
@@ -60,5 +101,8 @@ export interface ToolCallsResult {
         toolCallId: string;
     };
 }
-export declare function executeToolCalls(toolCalls: ToolCall[], registry: ToolRegistry, messages: Message[], toolProvider?: ToolProvider, signal?: AbortSignal, instructionConfig?: InstructionConfig, decision?: Record<string, unknown>): Promise<ToolCallsResult>;
+export declare function executeToolCalls(toolCalls: ToolCall[], registry: ToolRegistry, messages: Message[], toolProvider?: ToolProvider, signal?: AbortSignal, instructionConfig?: InstructionConfig, decision?: Record<string, unknown>, options?: {
+    parallel?: boolean;
+    maxIdenticalFailures?: number;
+}): Promise<ToolCallsResult>;
 //# sourceMappingURL=helpers.d.ts.map

package/dist/types/lib/call/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/lib/call/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAElB,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE/D;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,GAAG,aAAa,CAgB7E;AAED;;;;GAIG;AACH,oEAAoE;AACpE,MAAM,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAE5F,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,QAAQ,CAAC,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC,CAAC;IACtE,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IACxC,iEAAiE;IACjE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,IAAI,CAAC;IACtF;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACzD;;;;;OAKG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACxD,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,CAAC,EAAE,uBAAuB,CAAC;CAClD;AAED;;;;;;;;;GASG;AACH,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,uEAAuE;IACvE,aAAa,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,QAAQ,EAAE,EACrB,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,OAAO,EAAE,EACnB,YAAY,CAAC,EAAE,YAAY,EAC3B,MAAM,CAAC,EAAE,WAAW,EACpB,iBAAiB,CAAC,EAAE,iBAAiB,EACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,eAAe,CAAC,CAkK1B"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/lib/call/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAElB,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAc/D;;;;GAIG;AACH,eAAO,MAAM,qCAAqC,IAAI,CAAC;AAEvD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAStD;AA8DD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,SAAS,OAAO,EAAE,EACjC,OAAO,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAChD,MAAM,CAqCR;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,GAAG,aAAa,CAgB7E;AAED;;;;GAIG;AACH,oEAAoE;AACpE,MAAM,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAE5F,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,QAAQ,CAAC,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC,CAAC;IACtE,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IACxC,iEAAiE;IACjE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,IAAI,CAAC;IACtF;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACzD;;;;;OAKG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACxD,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,CAAC,EAAE,uBAAuB,CAAC;CAClD;AAED;;;;;;;;;GASG;AACH,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,uEAAuE;IACvE,aAAa,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,QAAQ,EAAE,EACrB,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,OAAO,EAAE,EACnB,YAAY,CAAC,EAAE,YAAY,EAC3B,MAAM,CAAC,EAAE,WAAW,EACpB,iBAAiB,CAAC,EAAE,iBAAiB,EACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9D,OAAO,CAAC,eAAe,CAAC,CAkP1B"}

package/dist/types/lib/call/parseResponseStage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parseResponseStage.d.ts","sourceRoot":"","sources":["../../../../src/lib/call/parseResponseStage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIxD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,CAAC,cAAc,CAAC,GAAG,IAAI,CAoC1E"}
+{"version":3,"file":"parseResponseStage.d.ts","sourceRoot":"","sources":["../../../../src/lib/call/parseResponseStage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIxD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,CAAC,cAAc,CAAC,GAAG,IAAI,CA6C1E"}

package/dist/types/lib/call/streamingCallLLMStage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streamingCallLLMStage.d.ts","sourceRoot":"","sources":["../../../../src/lib/call/streamingCallLLMStage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EACV,WAAW,EAGX,cAAc,EAEf,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAG/D,MAAM,WAAW,4BAA4B;IAC3C,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,WAAW,EACrB,gBAAgB,CAAC,EAAE,4BAA4B,GAAG,uBAAuB,WAWhE,WAAW,cAAc,CAAC,YACvB,MAAM,IAAI,mBACH,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,mBA6F3C"}
+{"version":3,"file":"streamingCallLLMStage.d.ts","sourceRoot":"","sources":["../../../../src/lib/call/streamingCallLLMStage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EACV,WAAW,EAGX,cAAc,EAEf,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAG/D,MAAM,WAAW,4BAA4B;IAC3C,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,WAAW,EACrB,gBAAgB,CAAC,EAAE,4BAA4B,GAAG,uBAAuB,WAWhE,WAAW,cAAc,CAAC,YACvB,MAAM,IAAI,mBACH,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,mBA0I3C"}

package/dist/types/lib/call/toolExecutionSubflow.d.ts

@@ -58,6 +58,18 @@ export interface ToolExecutionSubflowConfig {
     readonly toolProvider?: ToolProvider;
     /** Instruction processing config — when provided, instructions are evaluated after each tool call. */
     readonly instructionConfig?: InstructionConfig;
+    /**
+     * When true, multiple tool calls within a single turn run concurrently via Promise.all.
+     * Results are appended to the conversation in the order the LLM requested them.
+     * Default: false (sequential).
+     */
+    readonly parallel?: boolean;
+    /**
+     * Consecutive-identical-failure threshold for repeated-failure escalation.
+     * Forwarded to `executeToolCalls`. Passing `0` (or any non-positive number)
+     * disables escalation entirely. Defaults to the library default when omitted.
+     */
+    readonly maxIdenticalFailures?: number;
 }
 /**
  * Build the tool execution subflow.

package/dist/types/lib/call/toolExecutionSubflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolExecutionSubflow.d.ts","sourceRoot":"","sources":["../../../../src/lib/call/toolExecutionSubflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKxD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,yBAAyB;IACxC,2EAA2E;IAC3E,cAAc,EAAE,cAAc,CAAC;IAC/B,yEAAyE;IACzE,eAAe,EAAE,OAAO,EAAE,CAAC;IAC3B,kEAAkE;IAClE,gBAAgB,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,kBAAkB,EAAE,OAAO,EAAE,CAAC;IAC9B,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,kEAAkE;IAClE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,0EAA0E;IAC1E,aAAa,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D;AAID,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,sGAAsG;IACtG,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CAChD;AAID;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,0BAA0B,GAAG,SAAS,CA8FvF"}
+{"version":3,"file":"toolExecutionSubflow.d.ts","sourceRoot":"","sources":["../../../../src/lib/call/toolExecutionSubflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKxD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,yBAAyB;IACxC,2EAA2E;IAC3E,cAAc,EAAE,cAAc,CAAC;IAC/B,yEAAyE;IACzE,eAAe,EAAE,OAAO,EAAE,CAAC;IAC3B,kEAAkE;IAClE,gBAAgB,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,kBAAkB,EAAE,OAAO,EAAE,CAAC;IAC9B,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,kEAAkE;IAClE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,0EAA0E;IAC1E,aAAa,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D;AAID,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,sGAAsG;IACtG,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC;AAID;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,0BAA0B,GAAG,SAAS,CAkGvF"}

package/dist/types/lib/concepts/Agent.d.ts

@@ -3,7 +3,7 @@
  * Preserves backward compatibility for imports.
  */
 export { Agent } from './AgentBuilder';
-export type { AgentOptions } from './AgentBuilder';
+export type { AgentOptions, CustomRouteBranch, CustomRouteConfig } from './AgentBuilder';
 export { AgentRunner } from './AgentRunner';
 export type { AgentRunnerOptions } from './AgentRunner';
 //# sourceMappingURL=Agent.d.ts.map

package/dist/types/lib/concepts/Agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Agent.d.ts","sourceRoot":"","sources":["../../../../src/lib/concepts/Agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"Agent.d.ts","sourceRoot":"","sources":["../../../../src/lib/concepts/Agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/types/lib/concepts/AgentBuilder.d.ts

@@ -11,9 +11,33 @@ import type { ToolDefinition, LLMProvider } from '../../types';
 import type { ModelConfig } from '../../models';
 import type { MemoryConfig } from '../../adapters/memory/types';
 import type { AgentRecorder, PromptProvider, ToolProvider } from '../../core';
+import type { RunnerLike } from '../../types/multiAgent';
 import type { InstructionOverride, AgentInstruction } from '../instructions';
 import { AgentPattern } from '../loop';
 import { AgentRunner } from './AgentRunner';
+/**
+ * A single user-defined branch in `Agent.route({...})`.
+ *
+ * The `when` predicate runs BEFORE the default tool-calls/final routing. First match wins.
+ * If no user branch matches, the Agent routes as normal (tool-calls if the LLM requested
+ * tools, final otherwise).
+ *
+ * `runner` must be a RunnerLike — any concept (Agent, LLMCall, RAG, Swarm, etc.) or a
+ * custom object with `.run(input)`. When the branch fires, the runner executes as a
+ * subflow and the returned content replaces the agent's current response.
+ */
+export interface CustomRouteBranch<TScope = any> {
+    /** Predicate evaluated on the agent scope after ParseResponse. First matching branch wins. */
+    readonly when: (scope: TScope) => boolean;
+    /** Runner to execute when the branch fires. */
+    readonly runner: RunnerLike;
+    /** Stable id for narrative + recorder dispatch. Auto-generated if omitted. */
+    readonly id?: string;
+}
+export interface CustomRouteConfig<TScope = any> {
+    /** User-defined branches, evaluated in order before default tool-calls/final. */
+    readonly branches: readonly CustomRouteBranch<TScope>[];
+}
 export interface AgentOptions {
     /** LLMProvider instance or ModelConfig from anthropic()/openai()/bedrock()/ollama(). */
     readonly provider: LLMProvider | ModelConfig;
@@ -36,6 +60,9 @@ export declare class Agent {
     private enableStreaming;
     private enableVerboseNarrative;
     private outputResponseFormat?;
+    private parallelToolsEnabled;
+    private customRoute?;
+    private maxIdenticalFailuresValue?;
     private constructor();
     /**
      * Create an agent builder.
@@ -70,6 +97,69 @@ export declare class Agent {
     maxIterations(n: number): this;
     /** Enable streaming — tokens emitted incrementally via onToken callback. */
     streaming(enabled?: boolean): this;
+    /**
+     * Run multiple tool calls within a single turn concurrently via Promise.all.
+     *
+     * Only beneficial when the LLM requests 2+ independent tool calls in one turn
+     * (e.g., "look up customer, orders, and product in parallel"). Results are
+     * appended to the conversation in the order the LLM requested them.
+     *
+     * **Caveat:** decide() functions on tool-level instructions mutate a shared
+     * Decision Scope — in parallel mode those mutations are not serialized.
+     * If your instructions rely on strict ordering, keep sequential (default).
+     *
+     * @example
+     * ```ts
+     * Agent.create({ provider })
+     *   .tools([getCustomer, getOrders, getProduct])
+     *   .parallelTools(true)
+     *   .build();
+     * ```
+     */
+    parallelTools(enabled?: boolean): this;
+    /**
+     * Register user-defined routing branches evaluated BEFORE the default
+     * `tool-calls | final` routing. First matching `when` predicate wins.
+     *
+     * Useful for injecting escalation paths, safety gates, or bespoke handlers
+     * without touching the Agent loop internals. The default tool-calls and
+     * final branches still apply when no user branch matches.
+     *
+     * @example
+     * ```ts
+     * Agent.create({ provider })
+     *   .tool(searchTool)
+     *   .route({
+     *     branches: [
+     *       { id: 'escalate', when: (s) => s.parsedResponse.content.includes('[ESCALATE]'), runner: humanReviewAgent },
+     *     ],
+     *   })
+     *   .build();
+     * ```
+     */
+    route(config: CustomRouteConfig): this;
+    /**
+     * Set the repeated-identical-failure escalation threshold. When a tool call
+     * with the exact same (name, args) has failed this many times in a row, a
+     * one-shot `escalation` field is injected into that tool result content
+     * urging the LLM to change arguments, switch tools, or finalize. Fires
+     * exactly once per (name, args) key per conversation — further identical
+     * failures are left bare to avoid token bloat.
+     *
+     * Defaults to `3`. Pass `0` to disable escalation entirely.
+     *
+     * @example
+     * ```ts
+     * Agent.create({ provider })
+     *   .tools([...])
+     *   .maxIdenticalFailures(2) // fire escalation after 2 identical failures
+     *   .build();
+     *
+     * // Disable entirely:
+     * Agent.create({ provider }).tools([...]).maxIdenticalFailures(0).build();
+     * ```
+     */
+    maxIdenticalFailures(n: number): this;
     /**
      * Enable verbose narrative — full values, no truncation.
      * Shows complete system prompts, tool results, and LLM outputs in the narrative.

package/dist/types/lib/concepts/AgentBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentBuilder.d.ts","sourceRoot":"","sources":["../../../../src/lib/concepts/AgentBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAkB,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAI7E,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,WAAW,YAAY;IAC3B,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,WAAW,CAAC;IAC7C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAClC,OAAO,CAAC,oBAAoB,CAAC,CAAiB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C,OAAO,CAAC,kBAAkB,CAAC,CAAe;IAC1C,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;IACpE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA0B;IAC5D,OAAO,CAAC,oBAAoB,CAAC,CAAoC;IACjE,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,oBAAoB,CAAC,CAAiB;IAE9C,OAAO;IAKP;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,KAAK;IAI3C,yDAAyD;IACzD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5B;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAK9C,uBAAuB;IACvB,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAKnC,+BAA+B;IAC/B,KAAK,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,IAAI;IAKvC;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAK1C,qCAAqC;IACrC,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAK9B,4EAA4E;IAC5E,SAAS,CAAC,OAAO,UAAO,GAAG,IAAI;IAK/B;;;;OAIG;IACH,OAAO,CAAC,OAAO,UAAO,GAAG,IAAI;IAK7B;;;;;;;;;;;;;;;;;;OAkBG;IACH,YAAY,CACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;KAAE,GACzD,IAAI;IAaP;;;;OAIG;IACH,OAAO,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI;IAK9B;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAKxE;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,KAAK,EAAE,gBAAgB,CAAC,GAAG,CAAC,GAAG,IAAI;IAK/C,kDAAkD;IAClD,YAAY,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI;IAKnD;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAKrF,6CAA6C;IAC7C,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAKlC,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAKlC,2CAA2C;IAC3C,KAAK,IAAI,WAAW;CAqBrB"}
+{"version":3,"file":"AgentBuilder.d.ts","sourceRoot":"","sources":["../../../../src/lib/concepts/AgentBuilder.ts"],"names":[],"mappings":"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"}

package/dist/types/lib/concepts/AgentRunner.d.ts

@@ -7,6 +7,7 @@ import type { FlowChart as FlowChartType } from 'footprintjs';
 import { AgentPattern } from '../loop';
 import type { InstructionOverride, AgentInstruction } from '../instructions';
 import type { AgentStreamEventHandler } from '../../streaming';
+import type { CustomRouteConfig } from './AgentBuilder';
 import { ToolRegistry } from '../../tools';
 import type { LLMProvider, AgentResult, Message, ResponseFormat } from '../../types';
 import type { MemoryConfig } from '../../adapters/memory/types';
@@ -31,6 +32,15 @@ export interface AgentRunnerOptions {
     readonly verboseNarrative?: boolean;
     /** Structured output format — passed through to LLM provider. */
     readonly responseFormat?: ResponseFormat;
+    /** Run tool calls within a single turn concurrently. Default: false. */
+    readonly parallelTools?: boolean;
+    /** User-defined routing branches evaluated before default tool-calls/final. */
+    readonly customRoute?: CustomRouteConfig;
+    /**
+     * Consecutive-identical-failure threshold for escalation. `0` disables.
+     * Defaults to `REPEATED_FAILURE_ESCALATION_THRESHOLD` (3) when omitted.
+     */
+    readonly maxIdenticalFailures?: number;
 }
 export declare class AgentRunner {
     private static _autoExecCounter;
@@ -49,6 +59,9 @@ export declare class AgentRunner {
     private readonly initialDecision?;
     private readonly streamingEnabled;
     private readonly responseFormat?;
+    private readonly parallelToolsEnabled;
+    private readonly customRoute?;
+    private readonly maxIdenticalFailures?;
     private readonly cachedDecideFunctions?;
     private conversationHistory;
     private lastExecutor?;
@@ -87,6 +100,12 @@ export declare class AgentRunner {
      * Use `result.content` and `agent.getNarrative()` for post-resume data.
      */
     resume(humanResponse: string): Promise<AgentResult>;
+    /**
+     * Create a scope recorder that captures LLM responses + context during traversal.
+     * Shared by run() and resume() — eliminates duplication and ensures both paths
+     * track runtimeStageId for stream bridge tool events.
+     */
+    private createLLMCaptureRecorder;
     /** Extract AgentResult from executor state — shared by run() and resume(). */
     private buildResult;
     getNarrative(): string[];

package/dist/types/lib/concepts/AgentRunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentRunner.d.ts","sourceRoot":"","sources":["../../../../src/lib/concepts/AgentRunner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AgentRunner.d.ts","sourceRoot":"","sources":["../../../../src/lib/concepts/AgentRunner.ts"],"names":[],"mappings":"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"}

package/dist/types/lib/concepts/index.d.ts

@@ -1,3 +1,3 @@
 export { Agent, AgentRunner } from './Agent';
-export type { AgentOptions } from './Agent';
+export type { AgentOptions, CustomRouteBranch, CustomRouteConfig } from './Agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/lib/concepts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/concepts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/concepts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC"}

package/dist/types/lib/instructions/InstructionRecorder.d.ts

@@ -75,10 +75,11 @@ export declare class InstructionRecorder implements AgentRecorder {
     getFiringCount(toolId: string, instructionId: string): number;
     /** Get all instruction IDs that fired for a tool. */
     getFiredInstructionIds(toolId: string): string[];
-    /** Serialize for inclusion in executor.getSnapshot().recorders. */
     toSnapshot(): {
         name: string;
-        data: unknown;
+        description: string;
+        preferredOperation: "translate";
+        data: InstructionSummary;
     };
     clear(): void;
 }

package/dist/types/lib/instructions/InstructionRecorder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InstructionRecorder.d.ts","sourceRoot":"","sources":["../../../../src/lib/instructions/InstructionRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAIvD,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACzD,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,0BAA0B;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CACvD;AAID,qBAAa,mBAAoB,YAAW,aAAa;IACvD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,OAAO,CAAC,OAAO,CAAsE;IACrF,OAAO,CAAC,SAAS,CAAqE;gBAE1E,EAAE,SAAyB;IAIvC;;;;;;OAMG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAAE,GAAG,IAAI;IA2BjE,sEAAsE;IACtE,UAAU,IAAI,kBAAkB;IAkChC,sEAAsE;IACtE,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM;IAI7D,qDAAqD;IACrD,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAKhD,mEAAmE;IACnE,UAAU,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE;IAI7C,KAAK,IAAI,IAAI;CAId"}
+{"version":3,"file":"InstructionRecorder.d.ts","sourceRoot":"","sources":["../../../../src/lib/instructions/InstructionRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAIvD,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACzD,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,0BAA0B;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CACvD;AAID,qBAAa,mBAAoB,YAAW,aAAa;IACvD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,OAAO,CAAC,OAAO,CAAsE;IACrF,OAAO,CAAC,SAAS,CAAqE;gBAE1E,EAAE,SAAyB;IAIvC;;;;;;OAMG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAAE,GAAG,IAAI;IA2BjE,sEAAsE;IACtE,UAAU,IAAI,kBAAkB;IAkChC,sEAAsE;IACtE,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM;IAI7D,qDAAqD;IACrD,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAKhD,UAAU;;;;;;IASV,KAAK,IAAI,IAAI;CAId"}

package/dist/types/lib/loop/buildAgentLoop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildAgentLoop.d.ts","sourceRoot":"","sources":["../../../../src/lib/loop/buildAgentLoop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAe7C,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAiB,MAAM,SAAS,CAAC;AAEpF,OAAO,KAAK,EACV,gBAAgB,EAIjB,MAAM,iBAAiB,CAAC;AAwDzB;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAE7C;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB,0EAA0E;IAC1E,iBAAiB,EAAE,MAAM,oBAAoB,GAAG,SAAS,CAAC;CAC3D;AAED,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,eAAe,EACvB,IAAI,CAAC,EAAE,oBAAoB,GAC1B,cAAc,CAAC;AAClB,wBAAgB,cAAc,CAC5B,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,oBAAoB,GAAG,SAAS,EACtC,OAAO,EAAE;IAAE,WAAW,EAAE,IAAI,CAAA;CAAE,GAC7B,eAAe,CAAC"}
+{"version":3,"file":"buildAgentLoop.d.ts","sourceRoot":"","sources":["../../../../src/lib/loop/buildAgentLoop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAgB7C,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAiB,MAAM,SAAS,CAAC;AAEpF,OAAO,KAAK,EACV,gBAAgB,EAIjB,MAAM,iBAAiB,CAAC;AA0DzB;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAE7C;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB,0EAA0E;IAC1E,iBAAiB,EAAE,MAAM,oBAAoB,GAAG,SAAS,CAAC;CAC3D;AAED,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,eAAe,EACvB,IAAI,CAAC,EAAE,oBAAoB,GAC1B,cAAc,CAAC;AAClB,wBAAgB,cAAc,CAC5B,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,oBAAoB,GAAG,SAAS,EACtC,OAAO,EAAE;IAAE,WAAW,EAAE,IAAI,CAAA;CAAE,GAC7B,eAAe,CAAC"}