agentfootprint 1.0.0

package/dist/esm/lib/instructions/template.js

@@ -0,0 +1,82 @@
+/**
+ * InstructionTemplate — generates LLM-facing text from resolved instructions.
+ *
+ * The template controls HOW instructions appear in the recency window.
+ * The developer writes structured data (inject text, follow-up bindings).
+ * The template formats it for the LLM.
+ *
+ * Pluggable: organizations can customize the voice and format.
+ * Default template works well for all model families.
+ */
+// ── Default Template ────────────────────────────────────────────────────
+/**
+ * Default instruction template — works well across Claude, GPT, and Llama.
+ *
+ * Uses clear delimiters and structured follow-up format:
+ * ```
+ * [INSTRUCTION] Be empathetic. Do NOT promise reversal.
+ *
+ * [AVAILABLE ACTION]
+ * Action: Retrieve detailed denial reasoning
+ * Tool: get_execution_trace
+ * Parameters: {"traceId":"tr_8f3a"}
+ * Use when: User asks why or wants details
+ * ```
+ */
+function defaultFormatInject(text) {
+    return `[INSTRUCTION] ${text}`;
+}
+function defaultFormatFollowUp(fu) {
+    const lines = [
+        '[AVAILABLE ACTION]',
+        `Action: ${fu.description}`,
+        `Tool: ${fu.toolId}`,
+        `Parameters: ${JSON.stringify(fu.params)}`,
+        `Use when: ${fu.condition}`,
+    ];
+    return lines.join('\n');
+}
+function defaultFormatBlock(parts) {
+    return parts.join('\n\n');
+}
+// ── Render Function ─────────────────────────────────────────────────────
+/**
+ * Render resolved instructions into LLM-facing text.
+ *
+ * Takes the output of `evaluateInstructions()` (already sorted in injection order)
+ * and produces a single string to append to the tool result message.
+ *
+ * Returns `undefined` if no instructions have injectable content.
+ *
+ * @example
+ * ```typescript
+ * const fired = evaluateInstructions(tool.instructions, ctx);
+ * const text = renderInstructions(fired);
+ * if (text) {
+ *   toolResultMessage.content += '\n\n' + text;
+ * }
+ * ```
+ */
+export function renderInstructions(instructions, template) {
+    if (instructions.length === 0)
+        return undefined;
+    const formatText = template?.formatText ?? defaultFormatInject;
+    const formatFollowUp = template?.formatFollowUp ?? defaultFormatFollowUp;
+    const formatBlock = template?.formatBlock ?? defaultFormatBlock;
+    const parts = [];
+    for (const instr of instructions) {
+        // Follow-up first (structured action), then inject (behavioral guidance)
+        // Within each instruction, follow-up before inject so the LLM reads
+        // "here's what you can do" before "here's how to behave"
+        if (instr.resolvedFollowUp) {
+            parts.push(formatFollowUp(instr.resolvedFollowUp));
+        }
+        if (instr.text) {
+            parts.push(formatText(instr.text));
+        }
+    }
+    if (parts.length === 0)
+        return undefined;
+    return formatBlock(parts);
+}
+//# sourceMappingURL=template.js.map

package/dist/esm/lib/instructions/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../../src/lib/instructions/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA6BH,2EAA2E;AAE3E;;;;;;;;;;;;;GAaG;AACH,SAAS,mBAAmB,CAAC,IAAY;IACvC,OAAO,iBAAiB,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,SAAS,qBAAqB,CAAC,EAAoB;IACjD,MAAM,KAAK,GAAG;QACZ,oBAAoB;QACpB,WAAW,EAAE,CAAC,WAAW,EAAE;QAC3B,SAAS,EAAE,CAAC,MAAM,EAAE;QACpB,eAAe,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE;QAC1C,aAAa,EAAE,CAAC,SAAS,EAAE;KAC5B,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAe;IACzC,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,2EAA2E;AAE3E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB,CAChC,YAAmC,EACnC,QAA8B;IAE9B,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAEhD,MAAM,UAAU,GAAG,QAAQ,EAAE,UAAU,IAAI,mBAAmB,CAAC;IAC/D,MAAM,cAAc,GAAG,QAAQ,EAAE,cAAc,IAAI,qBAAqB,CAAC;IACzE,MAAM,WAAW,GAAG,QAAQ,EAAE,WAAW,IAAI,kBAAkB,CAAC;IAEhE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QACjC,yEAAyE;QACzE,oEAAoE;QACpE,yDAAyD;QACzD,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC"}

package/dist/esm/lib/instructions/types.js

@@ -0,0 +1,83 @@
+/**
+ * LLMInstruction types — co-located behavioral guidance and structured follow-ups for tools.
+ *
+ * Instructions fire when a tool returns a matching result. The framework injects
+ * the instruction text into the LLM's recency window — right next to the tool result,
+ * where the model pays the most attention.
+ *
+ * Two optional fields — fill in what you need:
+ *   `text`: guidance appended to tool result (LLM reads this literally)
+ *   `followUp`: structured next-action binding (framework formats as string)
+ */
+// ── quickBind ───────────────────────────────────────────────────────────
+/**
+ * One-liner shorthand for common follow-up bindings.
+ *
+ * Most follow-ups follow a simple pattern: extract a field from the tool result
+ * and pass it to a target tool with the same parameter name. `quickBind`
+ * eliminates the boilerplate.
+ *
+ * @param toolId - Target tool to call
+ * @param paramNames - Field name(s) to extract from `ctx.content` and pass to target tool.
+ *   Single string or array of strings. The field name in the result must match
+ *   the parameter name in the target tool.
+ * @param options - Optional description and condition overrides.
+ *
+ * @example
+ * ```typescript
+ * // Single param — extract traceId from result, pass to get_trace
+ * followUp: quickBind('get_execution_trace', 'traceId')
+ *
+ * // Equivalent to:
+ * followUp: {
+ *   toolId: 'get_execution_trace',
+ *   params: (ctx) => ({ traceId: ctx.content.traceId }),
+ *   description: 'Follow up with get_execution_trace',
+ *   condition: 'User asks for more details',
+ * }
+ *
+ * // Multiple params
+ * followUp: quickBind('get_step_log', ['executionId', 'stepName'])
+ *
+ * // Custom description and condition
+ * followUp: quickBind('get_trace', 'traceId', {
+ *   description: 'Retrieve denial reasoning',
+ *   condition: 'User asks why their application was denied',
+ * })
+ * ```
+ */
+export function quickBind(toolId, paramNames, options) {
+    const names = Array.isArray(paramNames) ? paramNames : [paramNames];
+    return {
+        toolId,
+        params: (ctx) => {
+            const result = {};
+            const content = ctx.content;
+            for (const name of names) {
+                result[name] = content?.[name];
+            }
+            return result;
+        },
+        description: options?.description ?? `Follow up with ${toolId}`,
+        condition: options?.condition ?? 'User asks for more details',
+    };
+}
+/**
+ * Create a FollowUp binding with explicit params function.
+ *
+ * Preferred over `quickBind` for computed parameters.
+ *
+ * @example
+ * ```typescript
+ * followUp: follow('get_trace', ctx => ({ traceId: ctx.content.traceId }), 'Get denial details')
+ * ```
+ */
+export function follow(toolId, params, description, condition) {
+    return {
+        toolId,
+        params,
+        description,
+        condition: condition ?? 'User asks for more details',
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/esm/lib/instructions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/lib/instructions/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA6RH,2EAA2E;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,SAAS,CACvB,MAAc,EACd,UAA6B,EAC7B,OAAsD;IAEtD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAEpE,OAAO;QACL,MAAM;QACN,MAAM,EAAE,CAAC,GAAuB,EAAE,EAAE;YAClC,MAAM,MAAM,GAA4B,EAAE,CAAC;YAC3C,MAAM,OAAO,GAAG,GAAG,CAAC,OAAkC,CAAC;YACvD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;YACjC,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,kBAAkB,MAAM,EAAE;QAC/D,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,4BAA4B;KAC9D,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,MAAM,CACpB,MAAc,EACd,MAA+D,EAC/D,WAAmB,EACnB,SAAkB;IAElB,OAAO;QACL,MAAM;QACN,MAAM;QACN,WAAW;QACX,SAAS,EAAE,SAAS,IAAI,4BAA4B;KACrD,CAAC;AACJ,CAAC"}

package/dist/esm/lib/loop/buildAgentLoop.js

@@ -0,0 +1,401 @@
+/**
+ * Loop assembler — builds the full agent ReAct loop flowchart.
+ *
+ * Mounts the three API slots as subflows, then wires CallLLM → ParseResponse →
+ * RouteResponse (decider) with branches for tool execution and finalization.
+ *
+ * Supports two loop patterns (AgentPattern enum):
+ *
+ * Regular ReAct (default): loopTo('call-llm')
+ *   Seed → [sf-system-prompt] → [sf-messages] → [sf-tools]
+ *     → AssemblePrompt → CallLLM → ParseResponse
+ *     → RouteResponse(decider) → [CommitMemory?] → loopTo('call-llm')
+ *   Slots resolve ONCE before the loop.
+ *
+ * Dynamic ReAct: loopTo('sf-instructions-to-llm' or 'sf-system-prompt')
+ *   Same flowchart, but loop jumps back to InstructionsToLLM (when configured)
+ *   or SystemPrompt. All slots re-evaluate each iteration.
+ *   Uses arrayMerge: ArrayMergeMode.Replace on Messages/Tools outputMappers
+ *   so arrays are overwritten (not concatenated) on each iteration.
+ *
+ * Design choices:
+ *   - Seed stage initializes loopCount + maxIterations + messages
+ *   - Slot subflows use arrayMerge: Replace to avoid stale array accumulation
+ *   - Each slot is ALWAYS a subflow — zero overhead, free drill-down + narrative
+ *   - RouteResponse is a proper decider — visible in flowchart as diamond with branches
+ *   - Tool execution is a subflow — enables drill-down in BTS
+ *   - Chart is self-contained — no wrapping needed
+ */
+import { flowChart } from 'footprintjs';
+import { ArrayMergeMode } from 'footprintjs/advanced';
+import { systemMessage, userMessage } from '../../types/messages';
+import { buildSystemPromptSubflow } from '../slots/system-prompt';
+import { buildMessagesSubflow } from '../slots/messages';
+import { buildToolsSubflow } from '../slots/tools';
+import { createCallLLMStage } from '../call/callLLMStage';
+import { createStreamingCallLLMStage } from '../call/streamingCallLLMStage';
+import { parseResponseStage } from '../call/parseResponseStage';
+import { buildToolExecutionSubflow } from '../call/toolExecutionSubflow';
+import { createCommitMemoryStage } from '../../stages/commitMemory';
+import { getTextContent } from '../../types/content';
+import { lastAssistantMessage } from '../../memory';
+import { AgentPattern } from './types';
+import { applyInstructionOverrides, buildInstructionsToLLMSubflow } from '../instructions';
+// ── Default Agent Routing ─────────────────────────────────────────────────────
+/**
+ * Default routing for the Agent loop: tool-calls | final.
+ *
+ * Expressed as a RoutingConfig so buildAgentLoop has ONE code path
+ * for both Agent and Swarm routing.
+ */
+function defaultAgentRouting(toolExecutionSubflow, useCommitFlag) {
+    return {
+        deciderName: 'RouteResponse',
+        deciderId: 'route-response',
+        deciderDescription: 'Route to tool execution or finalization based on LLM response',
+        decider: (scope) => {
+            const parsed = scope.parsedResponse;
+            if (parsed?.hasToolCalls)
+                return 'tool-calls';
+            return 'final';
+        },
+        branches: [
+            {
+                id: 'tool-calls',
+                kind: 'subflow',
+                chart: toolExecutionSubflow,
+                name: 'ExecuteTools',
+                mount: {
+                    inputMapper: (parent) => ({
+                        parsedResponse: parent.parsedResponse,
+                        currentMessages: parent.messages,
+                        currentLoopCount: parent.loopCount,
+                        maxIterations: parent.maxIterations,
+                        ...(parent.decision ? { currentDecision: parent.decision } : {}),
+                    }),
+                    outputMapper: (sfOutput) => ({
+                        messages: sfOutput.toolResultMessages,
+                        loopCount: sfOutput.updatedLoopCount,
+                        ...(sfOutput.updatedDecision ? { decision: sfOutput.updatedDecision } : {}),
+                    }),
+                },
+            },
+            {
+                id: 'final',
+                kind: 'fn',
+                fn: createFinalizeStage({ useCommitFlag }),
+                description: 'Extract final answer and stop the loop',
+                name: 'Finalize',
+            },
+        ],
+        defaultBranch: 'final',
+    };
+}
+/**
+ * Well-known scope key for the user message in subflow mode.
+ * Parent charts must set this key in their inputMapper:
+ * `inputMapper: (p) => ({ message: p.userMessage })`
+ */
+export const SUBFLOW_MESSAGE_KEY = 'message';
+export function buildAgentLoop(config, seed, options) {
+    validateConfig(config);
+    const maxIterations = config.maxIterations ?? 10;
+    const seedMessages = seed?.messages ?? [];
+    const existingMessages = seed?.existingMessages ?? [];
+    const subflowMode = seed?.subflowMode ?? false;
+    // Auto-enable useCommitFlag when commitMemory is provided
+    const useCommitFlag = config.useCommitFlag || !!config.commitMemory;
+    // Build slot subflows
+    const systemPromptSubflow = buildSystemPromptSubflow(config.systemPrompt);
+    const messagesSubflow = buildMessagesSubflow(config.messages);
+    const toolsSubflow = buildToolsSubflow(config.tools);
+    // Build instruction config from registry — collect tools that have instructions
+    // Apply agent-level overrides if provided
+    const instructionsByToolId = new Map();
+    for (const tool of config.registry.all()) {
+        const instructed = tool;
+        if (instructed.instructions?.length) {
+            const override = config.instructionOverrides?.get(tool.id);
+            if (override) {
+                instructionsByToolId.set(tool.id, applyInstructionOverrides(instructed.instructions, override));
+            }
+            else {
+                instructionsByToolId.set(tool.id, instructed.instructions);
+            }
+        }
+    }
+    // Instruction tool registration is done by AgentRunner constructor (not here).
+    // decideFunctions are pre-computed and passed via config.decideFunctions.
+    const hasAgentInstructions = config.agentInstructions && config.agentInstructions.length > 0;
+    // Build a fresh local map: start from pre-computed agent-level functions, add per-tool ones.
+    // Uses a local copy — never mutates the cached config.decideFunctions.
+    const decideFunctions = new Map(config.decideFunctions ?? []);
+    for (const [, instructions] of instructionsByToolId) {
+        for (const instr of instructions) {
+            if (instr.decide && !decideFunctions.has(instr.id)) {
+                decideFunctions.set(instr.id, instr.decide);
+            }
+        }
+    }
+    // Capture strict follow-ups that fire during tool execution.
+    // Stored in a closure variable — AgentRunner reads it after run() completes.
+    let lastStrictFollowUp;
+    let lastStrictSourceToolId;
+    const onInstructionsFired = (toolId, fired) => {
+        // Find the first strict follow-up that fired (highest priority wins)
+        if (!lastStrictFollowUp) {
+            for (const instr of fired) {
+                if (instr.resolvedFollowUp?.strict) {
+                    lastStrictFollowUp = instr.resolvedFollowUp;
+                    lastStrictSourceToolId = toolId;
+                    break;
+                }
+            }
+        }
+        // Forward to external callback (InstructionRecorder)
+        config.onInstructionsFired?.(toolId, fired);
+    };
+    // Build call stages — pass onStreamEvent + responseFormat for llm_start/llm_end events
+    const callLLM = config.streaming
+        ? createStreamingCallLLMStage(config.provider, {
+            onStreamEvent: config.onStreamEvent,
+            responseFormat: config.responseFormat,
+        })
+        : createCallLLMStage(config.provider, {
+            onStreamEvent: config.onStreamEvent,
+            responseFormat: config.responseFormat,
+        });
+    const toolExecutionSubflow = buildToolExecutionSubflow({
+        registry: config.registry,
+        toolProvider: config.toolProvider,
+        // Always pass instruction config — even without build-time instructions,
+        // tool handlers can return runtime instructions/followUps.
+        instructionConfig: {
+            instructionsByToolId,
+            onInstructionsFired,
+            decideFunctions: decideFunctions.size > 0 ? decideFunctions : undefined,
+            agentResponseRules: hasAgentInstructions
+                ? config.agentInstructions.flatMap((i) => i.onToolResult ?? [])
+                : undefined,
+            onStreamEvent: config.onStreamEvent,
+        },
+    });
+    // Two distinct Seed stage implementations — no runtime boolean.
+    // The flowchart is built differently for standalone vs subflow composition.
+    const initialDecision = config.initialDecision ?? {};
+    const seedStandalone = (scope) => {
+        scope.messages = [...existingMessages, ...seedMessages];
+        scope.loopCount = 0;
+        scope.maxIterations = maxIterations;
+        if (hasAgentInstructions) {
+            scope.decision = { ...initialDecision };
+        }
+    };
+    const seedSubflow = (scope) => {
+        const msg = scope.message ?? '';
+        scope.messages = msg ? [userMessage(msg)] : [];
+        scope.loopCount = 0;
+        scope.maxIterations = maxIterations;
+        if (hasAgentInstructions) {
+            scope.decision = { ...initialDecision };
+        }
+    };
+    const seedStage = subflowMode ? seedSubflow : seedStandalone;
+    let builder = flowChart('Seed', seedStage, 'seed', undefined, 'Initialize agent loop state');
+    // Mount InstructionsToLLM subflow BEFORE the 3 API slots (only when instructions registered)
+    if (hasAgentInstructions) {
+        const instructionsSubflow = buildInstructionsToLLMSubflow(config.agentInstructions);
+        builder = builder.addSubFlowChartNext('sf-instructions-to-llm', instructionsSubflow, 'InstructionsToLLM', {
+            inputMapper: (parent) => ({
+                decision: parent.decision,
+            }),
+            outputMapper: (sf) => ({
+                promptInjections: sf.promptInjections,
+                toolInjections: sf.toolInjections,
+                responseRules: sf.responseRules,
+                matchedInstructions: sf.matchedInstructions,
+            }),
+        });
+    }
+    // Mount SystemPrompt subflow
+    builder = builder.addSubFlowChartNext('sf-system-prompt', systemPromptSubflow, 'SystemPrompt', {
+        inputMapper: (parent) => ({
+            messages: parent.messages,
+            loopCount: parent.loopCount,
+            ...(parent.promptInjections ? { promptInjections: parent.promptInjections } : {}),
+        }),
+        outputMapper: (sfOutput) => ({
+            systemPrompt: sfOutput.systemPrompt,
+        }),
+    });
+    // Mount Messages subflow
+    // Mount Messages subflow — arrayMerge: 'replace' so messages are overwritten
+    // (not concatenated) on each Dynamic ReAct iteration.
+    builder = builder.addSubFlowChartNext('sf-messages', messagesSubflow, 'Messages', {
+        inputMapper: (parent) => ({
+            currentMessages: parent.messages ?? [],
+            loopCount: parent.loopCount ?? 0,
+        }),
+        outputMapper: (sfOutput) => ({
+            messages: sfOutput.memory_preparedMessages,
+            memory_preparedMessages: sfOutput.memory_preparedMessages,
+            memory_storedHistory: sfOutput.memory_storedHistory,
+        }),
+        arrayMerge: ArrayMergeMode.Replace,
+    });
+    // Mount Tools subflow — arrayMerge: 'replace' so toolDescriptions is overwritten
+    // each iteration (not concatenated). Essential for Dynamic mode where tools change.
+    builder = builder.addSubFlowChartNext('sf-tools', toolsSubflow, 'Tools', {
+        inputMapper: (parent) => ({
+            messages: parent.messages,
+            loopCount: parent.loopCount,
+            ...(parent.toolInjections ? { toolInjections: parent.toolInjections } : {}),
+        }),
+        outputMapper: (sfOutput) => ({
+            toolDescriptions: sfOutput.toolDescriptions,
+        }),
+        arrayMerge: ArrayMergeMode.Replace,
+    });
+    const assemblePromptStage = (scope) => {
+        const messages = scope.messages ?? [];
+        const sysPrompt = scope.systemPrompt;
+        if (sysPrompt) {
+            // Replace existing system message (if any) with current system prompt.
+            // In Dynamic mode, the system prompt changes each iteration (instruction injections).
+            const nonSystem = messages.filter((m) => m.role !== 'system');
+            scope.messages = [systemMessage(sysPrompt), ...nonSystem];
+        }
+    };
+    // AssemblePrompt: prepend system message if not already present
+    builder = builder.addFunction('AssemblePrompt', assemblePromptStage, 'assemble-prompt', 'Prepend system prompt to messages before LLM call');
+    // CallLLM → ParseResponse → Routing(decider)
+    //   Routing is pluggable via config.routing (RoutingConfig).
+    //   Default: RouteResponse → {tool-calls | final}
+    //   Swarm:   RouteSpecialist → {specialist-A | ... | swarm-tools | final}
+    //
+    // Add CallLLM — streaming or non-streaming
+    if (config.streaming) {
+        builder = builder.addStreamingFunction('CallLLM', callLLM, 'call-llm', 'llm-stream', 'Send messages + tools to LLM provider (streaming)');
+    }
+    else {
+        builder = builder.addFunction('CallLLM', callLLM, 'call-llm', 'Send messages + tools to LLM provider');
+    }
+    builder = builder
+        .addFunction('ParseResponse', parseResponseStage, 'parse-response', 'Parse LLM response into structured result');
+    // ── Routing — one code path for both Agent and Swarm ──
+    const routing = config.routing ?? defaultAgentRouting(toolExecutionSubflow, useCommitFlag);
+    // Validate branches
+    if (routing.branches.length === 0) {
+        throw new Error('RoutingConfig must have at least one branch.');
+    }
+    const branchIds = new Set(routing.branches.map((b) => b.id));
+    if (branchIds.size !== routing.branches.length) {
+        throw new Error('RoutingConfig has duplicate branch IDs.');
+    }
+    if (!branchIds.has(routing.defaultBranch)) {
+        throw new Error(`RoutingConfig.defaultBranch '${routing.defaultBranch}' does not match any branch ID: [${[...branchIds].join(', ')}]`);
+    }
+    // Wrap decider with structural maxIterations guard — no custom routing can bypass this.
+    // If loopCount >= maxIterations, force-route to defaultBranch.
+    // The defaultBranch MUST call $break() or breakFn() — validated below.
+    const safeDecider = (scope, breakFn, streamCb) => {
+        const loopCount = scope.loopCount ?? 0;
+        const maxIter = scope.maxIterations ?? 10;
+        if (loopCount >= maxIter)
+            return routing.defaultBranch;
+        return routing.decider(scope, breakFn, streamCb);
+    };
+    let decider = builder.addDeciderFunction(routing.deciderName, safeDecider, routing.deciderId, routing.deciderDescription);
+    for (const branch of routing.branches) {
+        switch (branch.kind) {
+            case 'subflow':
+                decider = decider.addSubFlowChartBranch(branch.id, branch.chart, branch.name ?? branch.id, branch.mount);
+                break;
+            case 'lazy-subflow':
+                decider = decider.addLazySubFlowChartBranch(branch.id, branch.factory, branch.name ?? branch.id, branch.mount);
+                break;
+            case 'fn':
+                decider = decider.addFunctionBranch(branch.id, branch.name ?? branch.id, branch.fn, branch.description);
+                break;
+        }
+    }
+    builder = decider.setDefault(routing.defaultBranch).end();
+    // Mount CommitMemory when persistent memory is configured.
+    // CommitMemory saves full history to store (fire-and-forget) and calls $break().
+    if (config.commitMemory) {
+        const commitMemory = createCommitMemoryStage(config.commitMemory);
+        builder = builder.addFunction('CommitMemory', commitMemory, 'commit-memory', 'Persist conversation history to store');
+    }
+    // Loop target depends on pattern:
+    //   Regular (default): loop to CallLLM — slots resolve once
+    //   Dynamic: loop to InstructionsToLLM (if mounted) or SystemPrompt
+    //     — instructions + all slots re-evaluate each iteration
+    const dynamicTarget = hasAgentInstructions ? 'sf-instructions-to-llm' : 'sf-system-prompt';
+    const loopTarget = config.pattern === AgentPattern.Dynamic
+        ? dynamicTarget
+        : 'call-llm';
+    builder = builder.loopTo(loopTarget);
+    /** Get strict follow-up that fired during the last execution (if any). */
+    const getStrictFollowUp = () => lastStrictFollowUp
+        ? { followUp: lastStrictFollowUp, sourceToolId: lastStrictSourceToolId }
+        : undefined;
+    if (options?.captureSpec) {
+        const spec = builder.toSpec();
+        return { chart: builder.build(), spec, getStrictFollowUp };
+    }
+    return { chart: builder.build(), getStrictFollowUp };
+}
+/**
+ * Create the Finalize stage function (decider 'final' branch).
+ *
+ * Extracts the final answer text from the last assistant message and stops
+ * the loop. When useCommitFlag is set, writes memory_shouldCommit instead
+ * of calling $break() directly — the downstream CommitMemory stage will break.
+ */
+function createFinalizeStage(options) {
+    const { useCommitFlag } = options;
+    return (scope) => {
+        const messages = scope.messages ?? [];
+        const lastAsst = lastAssistantMessage(messages);
+        scope.result = lastAsst ? getTextContent(lastAsst.content) : '';
+        if (useCommitFlag) {
+            scope.memory_shouldCommit = true;
+        }
+        else {
+            scope.$break();
+        }
+    };
+}
+/**
+ * Validate the AgentLoopConfig at build time.
+ */
+const isDevMode = () => typeof process !== 'undefined' && process.env?.['NODE_ENV'] !== 'production';
+function validateConfig(config) {
+    if (!config.provider) {
+        throw new Error('AgentLoopConfig: provider is required');
+    }
+    if (!config.systemPrompt) {
+        throw new Error('AgentLoopConfig: systemPrompt config is required');
+    }
+    if (!config.messages) {
+        throw new Error('AgentLoopConfig: messages config is required');
+    }
+    if (!config.tools) {
+        throw new Error('AgentLoopConfig: tools config is required');
+    }
+    if (!config.registry) {
+        throw new Error('AgentLoopConfig: registry is required');
+    }
+    if (config.maxIterations !== undefined && config.maxIterations < 0) {
+        throw new Error('AgentLoopConfig: maxIterations must be non-negative');
+    }
+    // Dev-mode warning: agentInstructions with activeWhen predicates but no initialDecision
+    if (isDevMode() && config.agentInstructions?.length && !config.initialDecision) {
+        const hasConditional = config.agentInstructions.some((i) => i.activeWhen);
+        if (hasConditional) {
+            console.warn('[agentfootprint] agentInstructions with activeWhen predicates provided but no initialDecision. ' +
+                'Decision scope will be {}, so conditional instructions may never fire.');
+        }
+    }
+}
+//# sourceMappingURL=buildAgentLoop.js.map

package/dist/esm/lib/loop/buildAgentLoop.js.map

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

package/dist/esm/lib/loop/index.js

@@ -0,0 +1,3 @@
+export { buildAgentLoop, SUBFLOW_MESSAGE_KEY } from './buildAgentLoop';
+export { AgentPattern } from './types';
+//# sourceMappingURL=index.js.map

package/dist/esm/lib/loop/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/loop/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}