agentfootprint 1.6.1 → 1.8.0

package/dist/lib/narrative/agentRenderer.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Agent NarrativeRenderer — LLM-optimized narrative for agent loop execution.
+ * Agent NarrativeFormatter — LLM-optimized narrative for agent loop execution.
  *
  * Designed for LLM follow-up reasoning: the narrative answers "what happened?"
  * so a downstream LLM can ask informed questions about the agent's execution.
@@ -91,7 +91,14 @@ const DEFAULT_LIMITS = {
     result: 100,
     systemPrompt: 200,
     parsedContent: 100,
-    toolResult: 80,
+    // Tool results can contain diagnostic fields the library injects for
+    // debuggers — `expectedSchema`, `receivedArguments`, `escalation`,
+    // `repeatedFailures`. Truncating at 80 hides those after the opening
+    // `{"error":true,"message":"..."}` prefix, making it look like the LLM
+    // is being fed a bare error when in fact it has all the context it needs
+    // to self-correct. Bump to 400 so the fields are visible in BTS. Consumers
+    // who want the raw content use `verbose: true` (Infinity).
+    toolResult: 400,
     toolArgs: 60,
     message: 100,
 };
@@ -142,19 +149,28 @@ function formatToolDescriptions(rawValue) {
     const names = rawValue.map((t) => t.name ?? '?').join(', ');
     return `Tools: [${names}]`;
 }
+/**
+ * Format a single tool call as `name({...})` — always including the paren
+ * group so that empty arguments render as `name({})` rather than `name`.
+ *
+ * This matters for debugging: when the LLM calls a tool with missing
+ * required fields, the bug signal is precisely that `arguments` is `{}`
+ * (or contains the wrong keys). Hiding that behind a bare `name` used to
+ * make every failing-loop narrative look like a healthy one — you couldn't
+ * tell that the args were empty until you dug into the raw snapshot.
+ */
+function formatToolCallSignature(tc, limits) {
+    const name = tc.name ?? '?';
+    const args = tc.arguments ?? {};
+    const argsStr = JSON.stringify(args);
+    return `${name}(${truncate(argsStr, limits.toolArgs)})`;
+}
 function formatParsedResponse(rawValue, limits) {
     if (!rawValue || typeof rawValue !== 'object')
         return 'Parsed: (unknown)';
     const r = rawValue;
     if (r.hasToolCalls && Array.isArray(r.toolCalls)) {
-        const toolSummaries = r.toolCalls.map((tc) => {
-            const name = tc.name ?? '?';
-            if (tc.arguments && Object.keys(tc.arguments).length > 0) {
-                const argsStr = JSON.stringify(tc.arguments);
-                return `${name}(${truncate(argsStr, limits.toolArgs)})`;
-            }
-            return name;
-        });
+        const toolSummaries = r.toolCalls.map((tc) => formatToolCallSignature(tc, limits));
         return `Parsed: tool_calls → [${toolSummaries.join(', ')}]`;
     }
     if (typeof r.content === 'string') {
@@ -189,16 +205,24 @@ function formatAdapterRawResponse(rawValue, limits) {
     if (r.content && r.content.length > 0) {
         parts.push(`Reasoning: "${truncate(r.content, limits.parsedContent)}"`);
     }
-    // Tool calls summary
+    // Tool calls summary — include arguments so the reader can see at a glance
+    // whether the LLM actually passed required fields. Previously this showed
+    // only names, which hid the common failure mode where the LLM retries the
+    // same call with empty / wrong arguments.
     if (r.toolCalls && r.toolCalls.length > 0) {
-        const names = r.toolCalls.map((tc) => tc.name ?? '?').join(', ');
-        parts.push(`→ tool_calls: [${names}]`);
+        const signatures = r.toolCalls.map((tc) => formatToolCallSignature(tc, limits)).join(', ');
+        parts.push(`→ tool_calls: [${signatures}]`);
     }
     return parts.join('\n  ');
 }
 // ── Renderer factory ─────────────────────────────────────────────────────────
 /**
- * Create an agent-optimized NarrativeRenderer.
+ * Create an agent-optimized narrative formatter.
+ *
+ * Returns the `NarrativeRenderer` type (structurally identical to
+ * footprintjs's new `NarrativeFormatter`). Once a newer footprintjs
+ * release is consumed here, migrate the return type to
+ * `NarrativeFormatter` — no behavioural change.
  *
  * Usage:
  * ```typescript
@@ -299,6 +323,47 @@ function createAgentRenderer(options) {
         renderSelected(ctx) {
             return `Selected ${ctx.selected.length}/${ctx.total}: ${ctx.selected.join(', ')}`;
         },
+        /**
+         * Custom render for agentfootprint's emit-channel events. Recognizes the
+         * adapter-level request/response events and produces compact, diagnostic
+         * narrative lines that surface the exact shape of what the adapter sent
+         * and received — the key visibility for debugging LLM behavior like
+         * "why is the model calling with empty args?".
+         *
+         * Returns `undefined` for unrecognized event names so the default
+         * library template handles them.
+         */
+        renderEmit(ctx) {
+            if (ctx.name === 'agentfootprint.llm.request') {
+                const p = ctx.payload;
+                const toolsDetail = p.toolsWithRequired
+                    .map((t) => {
+                    const req = t.required.length ? ` required:[${t.required.join(',')}]` : '';
+                    return `${t.name}${req}`;
+                })
+                    .join(', ');
+                return (`LLM request (iter ${p.iteration}): ${p.messageCount} msgs [${p.messageRoles.join(',')}], ` + `${p.toolCount} tools — ${toolsDetail}`);
+            }
+            if (ctx.name === 'agentfootprint.llm.response') {
+                const p = ctx.payload;
+                const usage = p.usage
+                    ? `${p.usage.inputTokens ?? '?'}in/${p.usage.outputTokens ?? '?'}out`
+                    : '';
+                const stop = p.stopReason ? ` stop=${p.stopReason}` : '';
+                const toolCallsDetail = p.toolCalls.length
+                    ? ` calls=[${p.toolCalls
+                        .map((tc) => `${tc.name}(${JSON.stringify(tc.arguments)})`)
+                        .join(', ')}]`
+                    : '';
+                const contentPreview = p.content && p.content.length > 0
+                    ? ` content="${p.content.length > 60 ? p.content.slice(0, 57) + '...' : p.content}"`
+                    : '';
+                return (`LLM response (iter ${p.iteration}, ${p.latencyMs}ms, ${usage}${stop}):` +
+                    `${contentPreview}${toolCallsDetail}`);
+            }
+            // Unrecognized event — fall back to default library template.
+            return undefined;
+        },
     };
 }
 exports.createAgentRenderer = createAgentRenderer;

package/dist/lib/narrative/agentRenderer.js.map

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

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/Conditional.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Conditional — branch to a runner based on predicates (DAG "if/else").
+ *
+ * Thin wrapper over footprintjs `addDeciderFunction` + `addFunctionBranch`.
+ * A conditional is a top-level routing decision between runners — distinct
+ * from `Agent.route()`, which branches INSIDE a ReAct loop. Use Conditional
+ * when the shape is "pick one runner and return its result" (triage, content
+ * classification, policy routing).
+ *
+ * Predicates are evaluated in the order `.when()` was called; first match
+ * wins. If every predicate misses, the `otherwise` branch runs. A predicate
+ * that throws is treated as a miss (fail-open) and the next branch is tried.
+ *
+ * @example
+ * ```ts
+ * import { Conditional, Agent, RAG } from 'agentfootprint';
+ *
+ * const triage = Conditional.create({ name: 'triage' })
+ *   .when((input) => input.includes('refund'), refundAgent)
+ *   .when((input) => input.length > 500, ragRunner)
+ *   .otherwise(generalAgent)
+ *   .build();
+ *
+ * const result = await triage.run('I want a refund please');
+ * // Narrative: "[triage] Chose refundAgent — predicate 0 matched"
+ * ```
+ *
+ * Conditional is a runner itself — plug it into `FlowChart`, `Parallel`,
+ * `Agent.route()`, or another `Conditional`. Composes like any other concept.
+ *
+ * ## Why this exists alongside footprintjs primitives
+ *
+ * footprintjs gives you `addDeciderFunction` + `addFunctionBranch` + `decide()`
+ * at the stage level. Conditional wraps those so you can compose **runners**
+ * (Agent, RAG, Swarm, user-built) instead of stage functions. Same underlying
+ * engine, same narrative, same evidence capture from `decide()`.
+ */
+import type { FlowChart as FlowChartDef } from 'footprintjs';
+import type { RunnerLike, TraversalResult } from '../types';
+import type { AgentRecorder } from '../core';
+/** Predicate tested against the input string + scope state. */
+export type ConditionalPredicate = (input: string, state: Record<string, unknown>) => boolean;
+interface ConditionalBranch {
+    readonly id: string;
+    readonly name: string;
+    readonly predicate: ConditionalPredicate;
+    readonly runner: RunnerLike;
+}
+export interface ConditionalOptions {
+    /** Name for narrative + spec. Defaults to `'conditional'`. */
+    readonly name?: string;
+}
+/**
+ * Builder for the Conditional concept. Each `.when()` adds a predicate →
+ * runner branch. `.otherwise()` sets the default (required). `.build()`
+ * returns a `ConditionalRunner`.
+ */
+export declare class Conditional {
+    private readonly conditionalName;
+    private readonly branches;
+    private defaultRunner?;
+    private defaultName;
+    private readonly recorders;
+    private constructor();
+    static create(options?: ConditionalOptions): Conditional;
+    /**
+     * Add a predicate → runner branch. Predicates are evaluated in the order
+     * they were added; first match wins. A throwing predicate is treated as a
+     * miss (fail-open) so a faulty branch never blocks a valid one.
+     *
+     * The `id` + optional `name` appear in narrative / decision evidence.
+     */
+    when(predicate: ConditionalPredicate, runner: RunnerLike, options?: {
+        id?: string;
+        name?: string;
+    }): this;
+    /** Set the default runner — runs when every `.when()` predicate misses. */
+    otherwise(runner: RunnerLike, options?: {
+        name?: string;
+    }): this;
+    recorder(rec: AgentRecorder): this;
+    build(): ConditionalRunner;
+}
+interface ConditionalRunnerOptions {
+    readonly name: string;
+    readonly branches: readonly ConditionalBranch[];
+    readonly defaultRunner: RunnerLike;
+    readonly defaultName: string;
+    readonly recorders: readonly AgentRecorder[];
+}
+/**
+ * Runner produced by `Conditional.build()`. Exposes the same surface as other
+ * runners: `run`, `getNarrative`, `getNarrativeEntries`, `getSnapshot`,
+ * `getSpec`, `toFlowChart`. Composes into FlowChart / Parallel / Agent.route
+ * like any other runner.
+ */
+export declare class ConditionalRunner {
+    private readonly opts;
+    private lastExecutor?;
+    private lastSpec?;
+    private readonly narrativeRenderer;
+    constructor(opts: ConditionalRunnerOptions);
+    run(message: string, options?: {
+        signal?: AbortSignal;
+        timeoutMs?: number;
+    }): Promise<TraversalResult>;
+    private buildChart;
+    /** Get the flowchart spec (stage graph metadata). */
+    getSpec(): unknown;
+    /** Expose the flowchart definition so this runner can be mounted as a subflow. */
+    toFlowChart(): FlowChartDef;
+    /** Get the narrative from the last run. */
+    getNarrative(): string[];
+    /** Get structured narrative entries from the last run. */
+    getNarrativeEntries(): import("footprintjs").CombinedNarrativeEntry[];
+    /** Get the full execution snapshot from the last run. */
+    getSnapshot(): import("footprintjs").RuntimeSnapshot | undefined;
+}
+export {};
+//# sourceMappingURL=Conditional.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Conditional.d.ts","sourceRoot":"","sources":["../../../src/concepts/Conditional.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAQH,OAAO,KAAK,EAAE,SAAS,IAAI,YAAY,EAAc,MAAM,aAAa,CAAC;AAEzE,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAoB,MAAM,UAAU,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAM7C,+DAA+D;AAC/D,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;AAE9F,UAAU,iBAAiB;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AASD;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,aAAa,CAAC,CAAa;IACnC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IAEjD,OAAO;IAIP,MAAM,CAAC,MAAM,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW;IAI5D;;;;;;OAMG;IACH,IAAI,CACF,SAAS,EAAE,oBAAoB,EAC/B,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GACvC,IAAI;IAkCP,2EAA2E;IAC3E,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAWhE,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAKlC,KAAK,IAAI,iBAAiB;CAmB3B;AAED,UAAU,wBAAwB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;CAC9C;AAgBD;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAChD,OAAO,CAAC,YAAY,CAAC,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,CAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAyB;gBAE/C,IAAI,EAAE,wBAAwB;IAIpC,GAAG,CACP,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACrD,OAAO,CAAC,eAAe,CAAC;IAuC3B,OAAO,CAAC,UAAU;IAmFlB,qDAAqD;IACrD,OAAO,IAAI,OAAO;IAOlB,kFAAkF;IAClF,WAAW,IAAI,YAAY;IAI3B,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';
@@ -9,4 +9,6 @@ export { Swarm, SwarmRunner } from './Swarm';
 export type { SwarmOptions } from './Swarm';
 export { Parallel, ParallelRunner } from './Parallel';
 export type { ParallelOptions, ParallelResult, BranchResult } from './Parallel';
+export { Conditional, ConditionalRunner } from './Conditional';
+export type { ConditionalOptions, ConditionalPredicate } from './Conditional';
 //# sourceMappingURL=index.d.ts.map

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;AAChF,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC/D,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/types/index.d.ts

@@ -11,7 +11,8 @@
  *   agentfootprint/explain       → Narrative, grounding analysis
  *   agentfootprint/stream        → Real-time lifecycle events
  */
-export { Agent, AgentRunner, LLMCall, LLMCallRunner, RAG, RAGRunner, FlowChart, FlowChartRunner, Swarm, SwarmRunner, Parallel, ParallelRunner, } from './concepts';
+export { Agent, AgentRunner, LLMCall, LLMCallRunner, RAG, RAGRunner, FlowChart, FlowChartRunner, Swarm, SwarmRunner, Parallel, ParallelRunner, Conditional, ConditionalRunner, } from './concepts';
+export type { CustomRouteBranch, CustomRouteConfig, ConditionalOptions, ConditionalPredicate, } from './concepts';
 export { defineTool, askHuman, ToolRegistry } from './tools';
 export { mock, MockAdapter, mockRetriever, MockRetriever, createProvider } from './adapters';
 export { anthropic, openai, ollama, bedrock } from './models';

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;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"}
+{"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,EACd,WAAW,EACX,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GACrB,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;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.