agentfootprint 1.22.0 → 2.0.1

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

@@ -1,628 +0,0 @@
-/**
- * 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, decide } 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 { getTextContent } from '../../types/content';
-import { lastAssistantMessage } from '../../memory';
-import { mountMemoryRead, mountMemoryWrite } from '../../memory/wire/mountMemoryPipeline';
-import { AgentPattern } from './types';
-import { applyInstructionOverrides, buildInstructionsToLLMSubflow } from '../instructions';
-import { assistantMessage } from '../../types/messages';
-// ── 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.
- *
- * The `final` branch is a SUBFLOW that owns its own post-work:
- * Finalize → (optional commit / memory-write) → Break. This keeps
- * branch-specific work inside the branch — no post-decider trailing
- * stages gated on flags. Tool-calls is a separate branch with its own
- * subflow.
- */
-function defaultAgentRouting(toolExecutionSubflow, finalBranchSubflow) {
-    return {
-        deciderName: 'RouteResponse',
-        deciderId: 'route-response',
-        deciderDescription: 'Route to tool execution or finalization based on LLM response',
-        // Filter-form decide() — captures structured evidence
-        // `{ key: 'hasToolCalls', op: 'eq', threshold: true, actual: ..., result: ... }`
-        // on FlowRecorder.onDecision (and the commit log's decision record),
-        // which is what explainability consumers query post-hoc.
-        //
-        // ParseResponse lifts `parsedResponse.hasToolCalls` to the flat
-        // `scope.hasToolCalls` field so we can use filter form — v1 filter
-        // DSL is flat-keys-only, no nested access.
-        //
-        // Returns the full DecisionResult (NOT `.branch`): DeciderHandler
-        // recognizes the DECISION_RESULT symbol brand and extracts evidence.
-        // Returning a bare string would drop the evidence entirely.
-        decider: (scope) => decide(scope, [
-            {
-                when: { hasToolCalls: { eq: true } },
-                then: 'tool-calls',
-                label: 'LLM requested tool calls — execute them',
-            },
-        ], '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: 'subflow',
-                chart: finalBranchSubflow,
-                name: 'Finalize',
-                mount: {
-                    inputMapper: (parent) => ({
-                        messages: parent.messages,
-                        maxIterations: parent.maxIterations,
-                        maxIterationsReached: parent.maxIterationsReached,
-                        identity: parent.identity,
-                        turnNumber: parent.turnNumber,
-                        contextTokensRemaining: parent.contextTokensRemaining,
-                    }),
-                    outputMapper: (sf) => ({
-                        result: sf.result,
-                    }),
-                    // Inner Break at end of subflow → parent $break, ending the loop.
-                    propagateBreak: true,
-                },
-            },
-        ],
-        defaultBranch: 'final',
-    };
-}
-/**
- * Build the `final` branch subflow. This subflow runs exclusively on
- * the final branch — tool-calls iterations never enter it — so its
- * stages run only once per `.run()` and are unconditional. Structure:
- *
- *   Finalize → [PackageForWrite + sf-memory-write]? → Break
- *
- * Finalize writes `result`. The optional middle stages persist the turn
- * when `memoryPipeline.write` is configured. Break terminates the loop;
- * the subflow mount's `propagateBreak: true` lifts it into the parent.
- */
-function buildFinalBranchSubflow(config) {
-    let b = flowChart('Finalize', finalizeStage, 'finalize', undefined, 'Extract final answer from last assistant message');
-    if (config.memoryPipeline?.write) {
-        b = b.addFunction('PackageForWrite', (scope) => {
-            const msgs = scope.messages ?? [];
-            scope.newMessages = msgs.filter((m) => m.role !== 'system');
-        }, 'package-for-write', 'Package messages for the memory write subflow');
-        // Delegates to the `mountMemoryWrite` wire helper — defaults match
-        // the scope field names used above (identity/turnNumber/contextTokensRemaining/newMessages).
-        b = mountMemoryWrite(b, { pipeline: config.memoryPipeline });
-    }
-    b = b.addFunction('Break', (scope) => scope.$break(), 'break', 'Terminate the agent loop');
-    return b.build();
-}
-/**
- * Finalize stage — write the final answer into scope.result.
- *
- * Pure data work: extracts text from the last assistant message and
- * writes `result`. No loop control — the final-branch subflow's Break
- * stage owns termination.
- *
- * Also emits `agentfootprint.agent.turn_complete` on the emit channel,
- * mirroring the existing `agentfootprint.llm.request/response` events
- * emitted by CallLLM. Gives external consumers a structured turn-end
- * signal with the reason (natural vs forced) and iteration count.
- */
-const finalizeStage = (scope) => {
-    const messages = scope.messages ?? [];
-    const lastAsst = lastAssistantMessage(messages);
-    const lastAsstText = lastAsst ? getTextContent(lastAsst.content) : '';
-    const exhausted = scope.maxIterationsReached === true;
-    if (exhausted) {
-        const maxIter = scope.maxIterations ?? 10;
-        scope.result =
-            lastAsstText ||
-                `Agent stopped after ${maxIter} iterations without a final answer. The LLM may be stuck in a tool-error retry loop — check the execution trace.`;
-    }
-    else {
-        scope.result = lastAsstText;
-    }
-    scope.$emit('agentfootprint.agent.turn_complete', {
-        iterations: scope.loopCount ?? 0,
-        reason: exhausted ? 'max_iterations' : 'final',
-        resultLength: (scope.result ?? '').length,
-    });
-};
-/**
- * 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;
-    // 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);
-            }
-        }
-    }
-    // Strict follow-up tracking is now OWNED BY THE CALLER. buildAgentLoop
-    // doesn't buffer state between runs — consumers (AgentRunner) implement
-    // `config.onInstructionsFired` to track strict firings in their own
-    // per-run state. This lets the chart be built ONCE and reused across
-    // many `.run()` calls without state leaking between turns.
-    const onInstructionsFired = config.onInstructionsFired;
-    // Build call stages. Stream lifecycle events flow through the emit
-    // channel (see callLLMStage / streamingCallLLMStage) — no closure
-    // capture of per-run stream handlers. AgentRunner attaches a
-    // StreamEventRecorder per-run to forward emits to the user callback.
-    const callLLM = config.streaming
-        ? createStreamingCallLLMStage(config.provider, {
-            responseFormat: config.responseFormat,
-        })
-        : createCallLLMStage(config.provider, {
-            responseFormat: config.responseFormat,
-        });
-    const toolExecutionSubflow = buildToolExecutionSubflow({
-        registry: config.registry,
-        toolProvider: config.toolProvider,
-        parallel: config.parallelTools === true,
-        ...(config.maxIdenticalFailures !== undefined && {
-            maxIdenticalFailures: config.maxIdenticalFailures,
-        }),
-        // Always pass instruction config — even without build-time instructions,
-        // tool handlers can return runtime instructions/followUps. The
-        // `onStreamEvent` inside is populated by toolExecutionSubflow's own
-        // stage wrapper as a scope-emit adapter.
-        instructionConfig: {
-            instructionsByToolId,
-            onInstructionsFired,
-            decideFunctions: decideFunctions.size > 0 ? decideFunctions : undefined,
-            agentResponseRules: hasAgentInstructions
-                ? config.agentInstructions.flatMap((i) => i.onToolResult ?? [])
-                : undefined,
-        },
-    });
-    // Two distinct Seed stage implementations — no runtime boolean.
-    // The flowchart is built differently for standalone vs subflow composition.
-    //
-    // Per-run data (the user's message, accumulated conversation history)
-    // flows in through `scope.$getArgs()` — NOT through closure captures of
-    // `seedMessages` / `existingMessages`. This lets AgentRunner build the
-    // chart ONCE at construction and pass new inputs via `run({ input })`
-    // every turn, instead of rebuilding the whole chart per call.
-    //
-    // Back-compat: if `seed.messages` / `seed.existingMessages` are
-    // provided AND args don't override, the closure values are still used
-    // so existing single-shot tests keep working.
-    const initialDecision = config.initialDecision ?? {};
-    const seedStandalone = (scope) => {
-        const args = scope.$getArgs() ?? {};
-        const argUserMessage = args['seed:userMessage'];
-        const argExisting = args['seed:existingMessages'];
-        const argMessages = args['seed:messages'];
-        // Carry-over decision scope from the caller's previous run. When the
-        // agent is reused across multiple `.run()` calls (multi-turn chat),
-        // decision fields written by tools on turn N should still be visible
-        // on turn N+1 — otherwise skill-gated tool visibility (autoActivate)
-        // resets between turns and the LLM silently loses its active skill.
-        // See AgentRunner.lastDecision for the capture side.
-        const argSeedDecision = args['seed:initialDecision'];
-        const effectiveExisting = argExisting ?? existingMessages;
-        const effectiveIncoming = argMessages !== undefined
-            ? argMessages
-            : argUserMessage !== undefined
-                ? argUserMessage
-                    ? [userMessage(argUserMessage)]
-                    : []
-                : seedMessages;
-        scope.messages = [...effectiveExisting, ...effectiveIncoming];
-        scope.loopCount = 0;
-        scope.maxIterations = maxIterations;
-        if (hasAgentInstructions) {
-            scope.decision = { ...(argSeedDecision ?? initialDecision) };
-        }
-    };
-    const seedSubflow = (scope) => {
-        // In subflow mode the parent's inputMapper pipes the user turn
-        // through `scope.message` — that's the contract for mounting agent
-        // loops inside other flowcharts (FlowChart/Conditional/Swarm specs).
-        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');
-    // ── Memory pipeline: read-side mount ────────────────────────
-    //
-    // Mounted BEFORE the loop body so both Regular (`call-llm`) and
-    // Dynamic (`sf-system-prompt` / `sf-instructions-to-llm`) loop targets
-    // skip over it on re-entry. Memory context is a per-TURN concern —
-    // the store doesn't change mid-turn, so re-reading on every iteration
-    // is pure waste. Runs exactly once per `.run()`.
-    //
-    // A small MemorySeed stage runs first to copy identity / turnNumber /
-    // contextTokensRemaining from `scope.$getArgs()` into scope state.
-    // The subflow itself reads from parent scope via inputMapper, loads
-    // relevant entries from the store, picks what fits the budget, and
-    // writes `memoryInjection` (system messages) back for AssemblePrompt
-    // to prepend.
-    if (config.memoryPipeline) {
-        const memoryPipeline = config.memoryPipeline;
-        builder = builder.addFunction('MemorySeed', (scope) => {
-            const args = scope.$getArgs() ?? {};
-            const identity = args['memory:identity'];
-            const turnNumber = args['memory:turnNumber'];
-            const budget = args['memory:contextTokensRemaining'];
-            if (!identity && isDevMode()) {
-                console.warn('[agentfootprint] .memoryPipeline() used without identity — falling back to ' +
-                    '{ conversationId: "default" }. Pass `run(msg, { identity: { conversationId, ... } })` ' +
-                    'to scope memory per user / session.');
-            }
-            scope.identity = identity ?? { conversationId: 'default' };
-            scope.turnNumber = turnNumber ?? 1;
-            scope.contextTokensRemaining = budget ?? 4000;
-        }, 'memory-seed', 'Seed memory identity / turn / budget from run() args');
-        // Delegates to the `mountMemoryRead` wire helper — defaults match
-        // what we'd inline (identity/turnNumber/contextTokensRemaining/newMessages →
-        // sf-memory-read, outputs `memoryInjection`). Keeps the helper and
-        // the agent loop in lockstep and avoids maintaining two copies.
-        builder = mountMemoryRead(builder, { pipeline: memoryPipeline });
-    }
-    // Mount InstructionsToLLM subflow BEFORE the 3 API slots (only when instructions registered).
-    //
-    // arrayMerge: Replace is REQUIRED here — without it, Dynamic ReAct loops
-    // concatenate promptInjections/toolInjections across iterations. That
-    // both (a) inflates the system prompt on every turn and (b) sends the
-    // same tool names twice to Anthropic on iteration 2+, which rejects with
-    // "tools: Tool names must be unique." sf-messages and sf-tools below
-    // already have this flag for the same reason.
-    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,
-            }),
-            arrayMerge: ArrayMergeMode.Replace,
-        });
-    }
-    // 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,
-        }),
-        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;
-        const injection = scope.memoryInjection ?? [];
-        // Build the final prompt: system prompt → memory injection → user
-        // messages. Memory comes AFTER the system prompt (role instructions)
-        // but BEFORE the ongoing dialogue, matching the conceptual ordering
-        // "your role, what you know from before, what the user just said."
-        const nonSystem = messages.filter((m) => m.role !== 'system');
-        const prefix = [];
-        if (sysPrompt)
-            prefix.push(systemMessage(sysPrompt));
-        prefix.push(...injection);
-        scope.messages = [...prefix, ...nonSystem];
-    };
-    // AssemblePrompt: prepend system message + memory injection
-    builder = builder.addFunction('AssemblePrompt', assemblePromptStage, 'assemble-prompt', 'Prepend system prompt + memory injection 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 ──
-    // Priority: explicit config.routing (Swarm) > routeExtensions (user .route()) > default
-    const finalBranchSubflow = buildFinalBranchSubflow(config);
-    const routing = config.routing
-        ? config.routing
-        : config.routeExtensions && config.routeExtensions.length > 0
-            ? extendDefaultRouting(defaultAgentRouting(toolExecutionSubflow, finalBranchSubflow), config.routeExtensions)
-            : defaultAgentRouting(toolExecutionSubflow, finalBranchSubflow);
-    // 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 the
-    // defaultBranch and set `maxIterationsReached` so the default branch
-    // (Finalize, Swarm's fallback, user-supplied terminal, etc.) can
-    // surface the fact that this was a forced termination.
-    const safeDecider = (scope, breakFn, streamCb) => {
-        const loopCount = scope.loopCount ?? 0;
-        const maxIter = scope.maxIterations ?? 10;
-        if (loopCount >= maxIter) {
-            scope.maxIterationsReached = true;
-            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();
-    // No post-decider memory stages: the final branch subflow owns
-    // finalize + commit/memory-write + break. Tool-calls branch falls
-    // through to loopTo below and iterates cleanly.
-    // 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);
-    if (options?.captureSpec) {
-        const spec = builder.toSpec();
-        return { chart: builder.build(), spec };
-    }
-    return { chart: builder.build() };
-}
-/**
- * Wrap a base RoutingConfig with user-defined extensions.
- *
- * User extensions run BEFORE the base decider. First matching `when` predicate wins.
- * If no extension matches, base routing applies. Runners are mounted as subflows
- * when they expose `.toFlowChart()`; otherwise they are wrapped with runnerAsStage.
- */
-function extendDefaultRouting(base, extensions) {
-    // Each user branch is a TERMINAL fn stage: run the runner, write the content as the
-    // agent's final result, and break the loop. We don't mount as a subflow because we
-    // need terminate semantics in the parent loop — a subflow would return control to
-    // the decider and keep looping. Drill-down via runner.toFlowChart() is a future
-    // enhancement; for Phase 1 we optimize for correctness and simplicity.
-    const userBranches = extensions.map((ext, idx) => {
-        const id = ext.id ?? `route-${idx}`;
-        return {
-            id,
-            kind: 'fn',
-            fn: createRouteExtensionStage(ext.runner),
-            name: id,
-            description: `User routing branch '${id}'`,
-        };
-    });
-    const extendedBranches = [...userBranches, ...base.branches];
-    return {
-        deciderName: base.deciderName,
-        deciderId: base.deciderId,
-        deciderDescription: base.deciderDescription,
-        decider: (scope, breakFn, streamCb) => {
-            // User predicates evaluated first — first match wins.
-            for (let i = 0; i < extensions.length; i++) {
-                try {
-                    if (extensions[i].when(scope)) {
-                        return userBranches[i].id;
-                    }
-                }
-                catch (err) {
-                    // Predicate errors fall through to base routing (fail-open).
-                    // Warn in dev so the silent skip is visible — matches the
-                    // library-wide "silent skips must surface in dev" rule.
-                    if (isDevMode()) {
-                        console.warn(`[agentfootprint] .route() branch '${userBranches[i].id}' predicate threw — ` +
-                            `falling through to default routing.`, err);
-                    }
-                }
-            }
-            return base.decider(scope, breakFn, streamCb);
-        },
-        branches: extendedBranches,
-        defaultBranch: base.defaultBranch,
-    };
-}
-/**
- * Build a terminal stage fn that invokes a user-provided runner, writes its content
- * as the agent's final answer, and breaks the loop.
- *
- * Called when a user `.route()` branch predicate fires. The runner receives the last
- * user message as input; its output content becomes the agent's assistant response.
- */
-function createRouteExtensionStage(runner) {
-    return async (scope) => {
-        const messages = scope.messages ?? [];
-        const lastUser = [...messages].reverse().find((m) => m.role === 'user');
-        const input = typeof lastUser?.content === 'string'
-            ? lastUser.content
-            : Array.isArray(lastUser?.content)
-                ? lastUser.content
-                    .map((b) => (typeof b?.text === 'string' ? b.text : ''))
-                    .filter(Boolean)
-                    .join('\n')
-                : '';
-        const env = scope.$getEnv();
-        const signal = env?.signal;
-        const timeoutMs = env?.timeoutMs;
-        const output = await runner.run(input, { signal, timeoutMs });
-        const content = typeof output?.content === 'string' ? output.content : '';
-        // Append the runner's answer as an assistant message so downstream
-        // observers (narrative, recorders) see a coherent conversation.
-        scope.messages = [...messages, assistantMessage(content)];
-        scope.result = content;
-        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

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