agentfootprint 2.14.5 → 3.1.0

package/dist/esm/core/agent/buildAgentChart.js

@@ -15,45 +15,55 @@
  *
  * Chart shape:
  *
- *     Seed
+ *     Initialize
  *       → [memory READ subflows for each .memory()]
- *       → InjectionEngine (subflow)
- *       → SystemPrompt (slot subflow)
- *       → Messages (slot subflow)
- *       → Tools (slot subflow)
- *       → CacheDecision (subflow)
+ *       → InjectionEngine (subflow)               ← loop target (tool-calls loops here)
+ *       → Context (selector, PARALLEL fan-out, failFast)
+ *             ⇉ {System Prompt ‖ Messages ‖ Tools}  (slot subflows)
+ *             → converge
  *       → UpdateSkillHistory
- *       → CacheGate (decider) → ApplyMarkers / SkipCaching
- *       → IterationStart
- *       → CallLLM
- *       → Route (decider) → tool-calls (pausable) / final (subflow)
- *                                                        |
- *                          ┌────── PrepareFinal           ▼
+ *       → Cache (sf-cache subflow: decideCacheMarkers → CacheGate
+ *                → ApplyMarkers / SkipCaching)
+ *       → CallLLM (also emits the per-iteration iteration_start marker)
+ *       → [NormalizeThinking] (subflow, only when a ThinkingHandler resolved)
+ *       → Route (decider)
+ *             ├─ tool-calls (pausable) → loopTo(InjectionEngine)   ← branch-sourced loop
+ *             └─ final (subflow) → terminal leaf
+ *                          ┌────── PrepareFinal
  *                          ├──── [memory WRITE subflows]
  *                          └──── BreakFinal ($break)
- *       loopTo(InjectionEngine)
  *
  * (When v2.11.x reliability is configured, the reliability gate chart
- * mounts as a subflow between IterationStart and CallLLM with a
- * TranslateFailFast stage after it. Lands in the next commit.)
+ * mounts as a subflow before CallLLM with a TranslateFailFast stage
+ * after it. Lands in the next commit.)
  */
 import { ArrayMergeMode } from 'footprintjs/advanced';
-import { flowChart } from 'footprintjs';
+import { flowChart, select } from 'footprintjs';
 import { STAGE_IDS, SUBFLOW_IDS } from '../../conventions.js';
 import { memoryInjectionKey } from '../../memory/define.types.js';
 import { unwrapMemoryFlowChart } from '../../memory/define.js';
 import { mountMemoryRead, mountMemoryWrite } from '../../memory/wire/mountMemoryPipeline.js';
 import { breakFinalStage } from './stages/breakFinal.js';
 import { prepareFinalStage } from './stages/prepareFinal.js';
+import { buildCacheSubflow } from './buildCacheSubflow.js';
 /**
  * Build the agent's complete FlowChart from the supplied deps.
  */
 export function buildAgentChart(deps) {
+    // ReAct loop semantics. 'classic' caches the static slots (engineer
+    // system-prompt + tools only on the first turn); 'dynamic' (default)
+    // re-engineers all 3 slots every turn. Drives the Context selector below.
+    const reactMode = deps.reactMode ?? 'dynamic';
     // ── Final-branch subflow ─────────────────────────────────────
     // Split so memory-write subflows can mount BETWEEN setting
     // finalContent and breaking the ReAct loop. PrepareFinal captures
     // the turn payload; BreakFinal terminates the loop.
-    let finalBranchBuilder = flowChart('PrepareFinal', prepareFinalStage, 'prepare-final', undefined, 'Capture turn payload (finalContent + newMessages)');
+    let finalBranchBuilder = flowChart('PrepareFinal', prepareFinalStage, 'prepare-final', {
+        ...(deps.structureRecorders !== undefined && {
+            structureRecorders: [...deps.structureRecorders],
+        }),
+        description: 'Capture turn payload (finalContent + newMessages)',
+    });
     for (const m of deps.memories) {
         if (m.write) {
             finalBranchBuilder = mountMemoryWrite(finalBranchBuilder, {
@@ -77,8 +87,16 @@ export function buildAgentChart(deps) {
     // (Lens + FlowchartRecorder) detect Agent-primitive subflows via
     // this prefix and flag them as true agent boundaries (separate
     // from LLMCall subflows which use `LLMCall:` prefix).
-    let builder = flowChart('Seed', deps.seed, STAGE_IDS.SEED, undefined, 'Agent: ReAct loop');
-    // Memory READ subflows — mounted between Seed and InjectionEngine
+    let builder = flowChart('Initialize', deps.seed, STAGE_IDS.SEED, {
+        ...(deps.structureRecorders !== undefined && {
+            structureRecorders: [...deps.structureRecorders],
+        }),
+        // Tag the mode so the Lens can label the run. Keep the `Agent:` taxonomy
+        // prefix (consumers detect Agent boundaries by it). Dynamic keeps the
+        // historical 'Agent: ReAct loop' string for byte-stability.
+        description: reactMode === 'classic' ? 'Agent: Classic ReAct loop' : 'Agent: ReAct loop',
+    });
+    // Memory READ subflows — mounted between Initialize and InjectionEngine
     // for TURN_START timing (default). Each memory writes to its own
     // scope key (`memoryInjection_${id}`) so multiple `.memory()`
     // registrations layer without colliding.
@@ -118,7 +136,48 @@ export function buildAgentChart(deps) {
         // 8 → 16 → 24 → 32 cumulative injections per turn.
         arrayMerge: ArrayMergeMode.Replace,
     })
-        .addSubFlowChartNext(SUBFLOW_IDS.SYSTEM_PROMPT, deps.systemPromptSubflow, 'System Prompt', {
+        // ── Context assembly: the 3 slots run in PARALLEL (selector fan-out) ──
+        // The slots are genuinely INDEPENDENT — each reads ONLY InjectionEngine's
+        // activeInjections + seed state, and each writes a DISJOINT output key
+        // (systemPromptInjections / messagesInjections / toolsInjections +
+        // dynamicToolSchemas). None reads another slot's output. Running them
+        // sequentially was an accident of chaining; the fork makes the execution
+        // tree tell the truth (and the Lens merge-tree renders the real shape).
+        // The selector picks ALL 3 every iteration (unconditional fan-out).
+        // failFast: true — a REQUIRED slot that throws aborts the whole turn,
+        // matching the old sequential-throw behavior. WITHOUT it the default
+        // Promise.allSettled would SWALLOW a failing slot and call the LLM with a
+        // half-built request (the documented request-assembly footgun).
+        // ── Context selector — THE one place Classic and Dynamic differ ──────
+        // The 3 slots are always selector BRANCHES (so they stay drawn in the
+        // chart in both modes); WHICH ones get selected per turn is the whole
+        // Classic-vs-Dynamic difference:
+        //   • dynamic — pick all 3 EVERY turn (activations can change per turn:
+        //     a skill fires, a rule matches, a tool-return steers the next turn).
+        //   • classic — pick all 3 on the FIRST turn, then ONLY messages. The
+        //     static slots aren't re-selected, so their turn-1 outputs persist in
+        //     scope (that IS the cache — the flat builder has no per-turn reset),
+        //     and only the message list rebuilds each iteration. The Lens shows
+        //     this directly: after turn 1 only the Messages branch lights up.
+        .addSelectorFunction('Context', ((scope) => {
+        const firstTurn = (scope.iteration ?? 1) <= 1;
+        const includeStatic = reactMode === 'dynamic' || firstTurn;
+        return select(scope, [
+            {
+                when: () => includeStatic,
+                then: SUBFLOW_IDS.SYSTEM_PROMPT,
+                label: 'engineer system-prompt',
+            },
+            { when: () => true, then: SUBFLOW_IDS.MESSAGES, label: 'engineer messages' },
+            { when: () => includeStatic, then: SUBFLOW_IDS.TOOLS, label: 'engineer tools' },
+        ]);
+    }), STAGE_IDS.CONTEXT, reactMode === 'classic'
+        ? 'Assemble request context: messages every turn; system-prompt + tools cached after turn 1'
+        : 'Assemble request context: system-prompt + messages + tools (parallel)', { failFast: true })
+        // Each branch keeps its inputMapper + outputMapper + arrayMerge:Replace
+        // VERBATIM from the former sequential mounts. Replace (not concat) is
+        // load-bearing: the loopTo would otherwise accumulate injections/tools.
+        .addSubFlowChartBranch(SUBFLOW_IDS.SYSTEM_PROMPT, deps.systemPromptSubflow, 'System Prompt', {
         inputMapper: (parent) => ({
             userMessage: parent.userMessage,
             iteration: parent.iteration,
@@ -127,7 +186,7 @@ export function buildAgentChart(deps) {
         outputMapper: (sf) => ({ systemPromptInjections: sf.systemPromptInjections }),
         arrayMerge: ArrayMergeMode.Replace,
     })
-        .addSubFlowChartNext(SUBFLOW_IDS.MESSAGES, deps.messagesSubflow, 'Messages', {
+        .addSubFlowChartBranch(SUBFLOW_IDS.MESSAGES, deps.messagesSubflow, 'Messages', {
         inputMapper: (parent) => ({
             messages: parent.history,
             iteration: parent.iteration,
@@ -136,7 +195,7 @@ export function buildAgentChart(deps) {
         outputMapper: (sf) => ({ messagesInjections: sf.messagesInjections }),
         arrayMerge: ArrayMergeMode.Replace,
     })
-        .addSubFlowChartNext(SUBFLOW_IDS.TOOLS, deps.toolsSubflow, 'Tools', {
+        .addSubFlowChartBranch(SUBFLOW_IDS.TOOLS, deps.toolsSubflow, 'Tools', {
         inputMapper: (parent) => ({
             iteration: parent.iteration,
             activeInjections: parent.activeInjections,
@@ -158,9 +217,30 @@ export function buildAgentChart(deps) {
         // duplicates that providers reject.
         arrayMerge: ArrayMergeMode.Replace,
     })
-        // ── Cache layer (v2.6) ─────────────────────────────────────
-        .addSubFlowChartNext(SUBFLOW_IDS.CACHE_DECISION, deps.cacheDecisionSubflow, 'CacheDecision', {
+        .end();
+    // ── Skill-churn window (cache concern) ──────────────────────────
+    // UpdateSkillHistory stays in the MAIN loop (NOT inside sf-cache): the
+    // skillHistory rolling window must persist across iterations, so keeping
+    // it here lets it live in parent scope without round-tripping through the
+    // subflow. It feeds sf-cache's CacheGate churn check, and sits right where
+    // the tool-driven skill activation flows into it.
+    //
+    // CONDITIONAL MOUNT: only when skills are registered. With no skills the
+    // window records "no skill" every iteration and CacheGate's churn rule can
+    // never fire — so the stage is omitted entirely (no dead weight, no
+    // misleading box). Mirrors the read_skill auto-attach + NormalizeThinking.
+    if (deps.hasSkills) {
+        builder = builder.addFunction('UpdateSkillHistory', deps.updateSkillHistoryStage, STAGE_IDS.UPDATE_SKILL_HISTORY, 'Update skill-history rolling window for CacheGate churn detection');
+    }
+    builder = builder
+        // sf-cache: decideCacheMarkers → CacheGate → apply/skip, collapsed into
+        // ONE box. Pure provider-agnostic DECISION layer — reads the turn's state,
+        // outputs only the gated cacheMarkers (Replace, not concat, across the
+        // loop). The attached provider's CacheStrategy turns markers into wire
+        // format later. See buildCacheSubflow.ts.
+        .addSubFlowChartNext(SUBFLOW_IDS.CACHE, buildCacheSubflow(), 'Cache', {
         inputMapper: (parent) => ({
+            // decideCacheMarkers inputs
             activeInjections: parent.activeInjections ?? [],
             iteration: parent.iteration ?? 1,
             maxIterations: parent.maxIterations ?? deps.maxIterations,
@@ -171,24 +251,16 @@ export function buildAgentChart(deps) {
             cumulativeInputTokens: parent.totalInputTokens ?? 0,
             systemPromptCachePolicy: deps.systemPromptCachePolicy,
             cachingDisabled: parent.cachingDisabled ?? false,
+            // CacheGate inputs (read-only: skillHistory is updated in the main
+            // loop above, so it is NOT mapped back out)
+            recentHitRate: parent.recentHitRate,
+            skillHistory: parent.skillHistory ?? [],
         }),
         outputMapper: (sf) => ({ cacheMarkers: sf.cacheMarkers }),
         arrayMerge: ArrayMergeMode.Replace,
     })
-        .addFunction('UpdateSkillHistory', deps.updateSkillHistoryStage, STAGE_IDS.UPDATE_SKILL_HISTORY, 'Update skill-history rolling window for CacheGate churn detection')
-        .addDeciderFunction('CacheGate', deps.cacheGateDecide, STAGE_IDS.CACHE_GATE, 'Gate cache-marker application: kill switch / hit-rate / skill-churn')
-        .addFunctionBranch(STAGE_IDS.APPLY_MARKERS, 'ApplyMarkers', 
-    // Pass-through stage — markers stay in scope as-is.
-    // BuildLLMRequest (Phase 7+) reads them on the next stage.
-    () => undefined, 'Proceed with cache markers from CacheDecision')
-        .addFunctionBranch(STAGE_IDS.SKIP_CACHING, 'SkipCaching', 
-    // Clear markers so BuildLLMRequest sees an empty list and
-    // makes the request unmodified.
-    (scope) => {
-        scope.cacheMarkers = [];
-    }, 'Skip caching this iteration')
-        .end()
-        .addFunction('IterationStart', deps.iterationStart, 'iteration-start', 'Iteration begin marker')
+        // CallLLM emits the per-iteration `iteration_start` marker itself (no
+        // dedicated IterationStart stage — emitting is passive observability).
         .addFunction('CallLLM', deps.callLLM, STAGE_IDS.CALL_LLM, 'LLM invocation');
     // v2.14 — conditional NormalizeThinking sub-subflow. Mounted ONLY
     // when a ThinkingHandler resolved (auto-wired by provider.name OR
@@ -210,7 +282,15 @@ export function buildAgentChart(deps) {
     }
     builder = builder
         .addDeciderFunction('Route', deps.routeDecider, SUBFLOW_IDS.ROUTE, 'ReAct routing')
-        .addPausableFunctionBranch('tool-calls', 'ToolCalls', deps.toolCallsHandler, 'Tool execution (pausable via pauseHere)')
+        .addPausableFunctionBranch('tool-calls', 'ToolCalls', deps.toolCallsHandler, 'Tool execution (pausable via pauseHere)', 
+    // Branch-sourced loop: tool-calls loops back to the InjectionEngine so
+    // EVERY iteration re-evaluates triggers against the freshest context (the
+    // just-appended tool result). Sourced from the BRANCH (not the decider) so
+    // the chart reads honestly — `ToolCalls → InjectionEngine` loops, `Final`
+    // terminates. Survives pause/resume (human-in-the-loop tool approval): the
+    // engine resolves the subflow loop target on resume — footprintjs
+    // FlowChartExecutor.resume + test/lib/pause/resume-branch-loop-subflow.
+    { loopTo: SUBFLOW_IDS.INJECTION_ENGINE })
         .addSubFlowChartBranch(SUBFLOW_IDS.FINAL, finalBranchChart, 'Final', {
         // Pass through the read-only state the sub-chart needs;
         // OMIT keys the sub-chart writes (finalContent, newMessages)
@@ -224,19 +304,18 @@ export function buildAgentChart(deps) {
         outputMapper: (sf) => ({
             finalContent: sf.finalContent,
         }),
-        // BreakFinal's $break() must reach the outer loopTo so the
-        // ReAct iteration terminates; without this the inner break
-        // only exits the sub-chart and the outer loop continues.
+        // With the branch-sourced loop, `final` is a terminal LEAF — it ends the
+        // run on its own (no decider `next` to suppress). propagateBreak is kept
+        // so BreakFinal's $break() still surfaces a terminal onBreak signal to the
+        // parent (observability) and stays correct if a decider-level `next` is
+        // ever reintroduced.
         propagateBreak: true,
     })
         .setDefault(SUBFLOW_IDS.FINAL)
-        .end()
-        // Dynamic ReAct: loop back to the InjectionEngine so EVERY iteration
-        // re-evaluates triggers (rule predicates, on-tool-return,
-        // llm-activated) against the freshest context (the just-appended
-        // tool result). Without this, the InjectionEngine runs ONCE per
-        // turn — quietly breaking the framework's "Dynamic ReAct" claim.
-        .loopTo(SUBFLOW_IDS.INJECTION_ENGINE);
+        .end();
+    // The ReAct loop is now sourced from the `tool-calls` branch (the
+    // `{ loopTo }` above), not the decider — so `Final` is a plain terminal leaf
+    // and the chart draws `ToolCalls → InjectionEngine` for the loop edge.
     return builder.build();
 }
 //# sourceMappingURL=buildAgentChart.js.map

package/dist/esm/core/agent/buildAgentChart.js.map

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

package/dist/esm/core/agent/buildAgentMessageApiChart.js

@@ -0,0 +1,197 @@
+/**
+ * buildAgentMessageApiChart — the Agent (ReAct) form of the messageAPI
+ * merge-tree, as ONE FLAT main chart (no inner LLM-call sub-box).
+ *
+ * The whole ReAct cycle lives directly in the single Agent chart:
+ *
+ *   Context (ROOT selector — inits + picks which context slots to engineer)
+ *     ├─ system-prompt ┐
+ *     ├─ messages ─────┼─→ messageAPI → Call-LLM
+ *     └─ tools ────────┘
+ *        → Route (decider) → [ ToolCalls (execute) → loop ] / Final (response)
+ *   loopTo(Context)
+ *
+ * WHY flat (the user's call): the entire agent — context engineering, the LLM
+ * call, routing, tool execution, the loop, and the final response — is ONE
+ * visible flowchart in ONE Agent box. No nested LLM-call box: Lens wraps the
+ * whole chart in the Agent main-box and renders the slots as pills. This is
+ * simpler than the composed (sf-llm-call subflow) shape and avoids box-in-box
+ * nesting entirely.
+ *
+ * The three context slots are DIRECT children of Context; all converge at
+ * messageAPI (which assembles system-prompt + messages); Call-LLM then sends
+ * the assembled payload plus the tool schemas. Route decides tool-calls (loop)
+ * vs final (terminate). The same chart serves Static and Dynamic agents — only
+ * which slots the Context selector lights per iteration differs.
+ */
+import { flowChartSelector, select } from 'footprintjs';
+import { SUBFLOW_IDS } from '../../conventions.js';
+import { typedEmit } from '../../recorders/core/typedEmit.js';
+import { buildSystemPromptSlot } from '../slots/buildSystemPromptSlot.js';
+import { buildMessagesSlot } from '../slots/buildMessagesSlot.js';
+import { buildToolsSlot } from '../slots/buildToolsSlot.js';
+/** Route branch ids. */
+const ROUTE_TOOL_CALLS = 'tool-calls';
+const ROUTE_FINAL = SUBFLOW_IDS.FINAL;
+/**
+ * Build the Agent merge-tree chart as one flat ReAct flowchart.
+ */
+export function buildAgentMessageApiChart(deps) {
+    const { provider, model, systemPrompt, tools } = deps;
+    const maxIterations = deps.maxIterations ?? 5;
+    // ── Context: ROOT selector. Inits per-call state on the first turn (the
+    // folded-in seed — Context is the chart's first node); on ReAct loop re-entry
+    // it leaves state intact (the iteration was bumped by ToolCalls). Returns the
+    // three context slots to engineer. ──
+    const contextSelector = (scope) => {
+        if (scope.iteration === undefined) {
+            const args = scope.$getArgs();
+            scope.userMessage = args.message;
+            scope.history = [{ role: 'user', content: args.message }];
+            scope.iteration = 1;
+            scope.systemPromptInjections = [];
+            scope.messagesInjections = [];
+            scope.toolSchemas = [];
+            scope.assembledSystem = '';
+            scope.assembledMessages = [];
+            scope.answer = '';
+            scope.toolCalls = [];
+            scope.finalContent = '';
+        }
+        return select(scope, [
+            { when: () => true, then: SUBFLOW_IDS.SYSTEM_PROMPT, label: 'engineer system-prompt' },
+            { when: () => true, then: SUBFLOW_IDS.MESSAGES, label: 'engineer messages' },
+            { when: () => true, then: SUBFLOW_IDS.TOOLS, label: 'engineer tools' },
+        ]);
+    };
+    // ── messageAPI: assemble system-prompt + messages (the join after the slots
+    // converge). tools is a separate field Call-LLM reads directly. ──
+    const messageApiStage = (scope) => {
+        const sysInjections = (scope.systemPromptInjections ?? []);
+        scope.assembledSystem = sysInjections
+            .map((r) => r.rawContent ?? '')
+            .filter((s) => s.length > 0)
+            .join('\n\n');
+        scope.assembledMessages = [...(scope.history ?? [])];
+    };
+    // ── Call-LLM: send the assembled payload + the tool schemas. ──
+    const callLLM = async (scope) => {
+        const system = scope.assembledSystem;
+        const messages = (scope.assembledMessages ?? []);
+        const toolSchemas = (scope.toolSchemas ?? []);
+        typedEmit(scope, 'agentfootprint.stream.llm_start', {
+            iteration: scope.iteration,
+            provider: provider.name,
+            model,
+            systemPromptChars: system.length,
+            messagesCount: messages.length,
+            toolsCount: toolSchemas.length,
+        });
+        const startMs = Date.now();
+        const response = await provider.complete({
+            ...(system.length > 0 && { systemPrompt: system }),
+            messages,
+            ...(toolSchemas.length > 0 && { tools: toolSchemas }),
+            model,
+        });
+        scope.answer = response.content;
+        scope.toolCalls = response.toolCalls;
+        typedEmit(scope, 'agentfootprint.stream.llm_end', {
+            iteration: scope.iteration,
+            content: response.content,
+            toolCallCount: response.toolCalls.length,
+            usage: response.usage,
+            stopReason: response.stopReason,
+            durationMs: Date.now() - startMs,
+        });
+    };
+    // ── Route: ReAct decider — tool-calls (loop) vs final (terminate). ──
+    const routeDecider = (scope) => {
+        const calls = (scope.toolCalls ?? []);
+        if (calls.length > 0 && scope.iteration < maxIterations)
+            return ROUTE_TOOL_CALLS;
+        return ROUTE_FINAL;
+    };
+    // ── ToolCalls: execute the LLM's requested tools, append results, bump the
+    // iteration, loop. ──
+    const toolExec = async (scope) => {
+        const calls = (scope.toolCalls ?? []);
+        const newHistory = [...(scope.history ?? [])];
+        for (const call of calls) {
+            typedEmit(scope, 'agentfootprint.stream.tool_start', {
+                toolCallId: call.id,
+                toolName: call.name,
+                args: call.args,
+            });
+            const result = `[${call.name} result]`; // demo executor — real agents wire a registry
+            newHistory.push({ role: 'tool', content: result, toolCallId: call.id });
+            typedEmit(scope, 'agentfootprint.stream.tool_end', {
+                toolCallId: call.id,
+                result,
+                durationMs: 0,
+            });
+        }
+        scope.history = newHistory;
+        scope.toolCalls = [];
+        scope.iteration = scope.iteration + 1;
+    };
+    // ── Final: the agent's response — terminate the loop, capture the answer. ──
+    const finalStage = (scope) => {
+        scope.finalContent = scope.answer;
+        scope.$break('agent reached final answer');
+    };
+    // ── Build ONE flat chart: Context(root) → 3 slots → messageAPI → Call-LLM
+    //    → Route → [ToolCalls → loop] / Final. ──
+    return (flowChartSelector('Context', contextSelector, 'context', {
+        ...(deps.structureRecorders !== undefined && {
+            structureRecorders: [...deps.structureRecorders],
+        }),
+        // 'Agent:' taxonomy marker → Lens renders this as an Agent group.
+        description: 'Agent: ReAct loop',
+    })
+        // Three DIRECT context slots — all converge at messageAPI.
+        .addSubFlowChartBranch(SUBFLOW_IDS.SYSTEM_PROMPT, buildSystemPromptSlot({ prompt: systemPrompt, reason: 'agent messageAPI' }), 'System Prompt', {
+        inputMapper: (parent) => ({
+            userMessage: parent.userMessage,
+            iteration: parent.iteration,
+        }),
+        outputMapper: (sf) => ({
+            systemPromptInjections: sf.systemPromptInjections,
+        }),
+    })
+        .addSubFlowChartBranch(SUBFLOW_IDS.MESSAGES, buildMessagesSlot(), 'Messages', {
+        inputMapper: (parent) => ({
+            messages: parent.history,
+            iteration: parent.iteration,
+        }),
+        outputMapper: (sf) => ({ messagesInjections: sf.messagesInjections }),
+    })
+        .addSubFlowChartBranch(SUBFLOW_IDS.TOOLS, buildToolsSlot({ tools }), 'Tools', {
+        inputMapper: (parent) => ({ iteration: parent.iteration }),
+        outputMapper: (sf) => ({ toolSchemas: sf.toolSchemas }),
+        // tools is a SEPARATE Anthropic wire field — it BYPASSES messageAPI
+        // (which assembles only system+messages) and pairs with its output at
+        // Call-LLM. `convergeAt` makes the structure edge `sf-tools → call-llm`
+        // instead of the default `sf-tools → message-api`, so Call-LLM reads as a
+        // true 2-parent merge {messageAPI, tools}. (toolSchemas already rides
+        // shared scope; this only makes the diagram faithful.)
+        convergeAt: 'call-llm',
+    })
+        .end()
+        // messageAPI assembles ONLY system+messages; Call-LLM then sends that
+        // payload + the tool schemas (the 2-parent merge above).
+        .addFunction('messageAPI', messageApiStage, 'message-api', 'Assemble system + messages into the LLM request')
+        .addFunction('CallLLM', callLLM, 'call-llm', 'Send the assembled request + tools to the LLM')
+        // Route → [ToolCalls → loop back to Context] / [Final → terminate].
+        .addDeciderFunction('Route', routeDecider, SUBFLOW_IDS.ROUTE, 'ReAct routing')
+        .addFunctionBranch(ROUTE_TOOL_CALLS, 'ToolCalls', toolExec, 'Execute tool calls')
+        // ReAct: the loop is sourced from the TOOL-CALLS branch (after executing
+        // tools, re-engineer context next turn) — NOT from the Route decider. Final
+        // terminates as a leaf (its $break is the terminal boundary signal).
+        .loopTo('context')
+        .addFunctionBranch(ROUTE_FINAL, 'Final', finalStage, 'Terminate the ReAct loop (response)')
+        .setDefault(ROUTE_FINAL)
+        .end()
+        .build());
+}
+//# sourceMappingURL=buildAgentMessageApiChart.js.map

package/dist/esm/core/agent/buildAgentMessageApiChart.js.map

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

package/dist/esm/core/agent/buildCacheSubflow.js

@@ -0,0 +1,58 @@
+/**
+ * buildCacheSubflow — the per-turn prompt-cache decision, as ONE subflow.
+ *
+ * Collapses the cache machinery into a single `sf-cache` boundary so the
+ * agent chart reads cleanly (one "Cache" box you can drill into) while the
+ * execution tree stays honest:
+ *
+ *     decideCacheMarkers  →  CacheGate (decider)  →  ApplyMarkers / SkipCaching
+ *
+ * Layering (see src/cache/types.ts):
+ *   - This subflow is the provider-AGNOSTIC DECISION layer — it only computes
+ *     and gates provider-neutral `CacheMarker[]`. It knows nothing about any
+ *     provider.
+ *   - The provider-SPECIFIC MECHANISM (Anthropic `cache_control`, OpenAI
+ *     automatic, …) is the attached provider's `CacheStrategy`, selected by
+ *     `provider.name`, applied later when the request is built.
+ *
+ * Why `UpdateSkillHistory` is NOT in here: the `skillHistory` rolling window
+ * must persist across loop iterations. Keeping `UpdateSkillHistory` in the
+ * main loop (just before this subflow) lets `skillHistory` live in the parent
+ * scope without round-tripping through this subflow's in/out mappers — the
+ * subflow stays pure (reads the turn's state, writes only `cacheMarkers`).
+ *
+ * Deps-free: every input (`activeInjections`, `iteration`, `skillHistory`,
+ * `recentHitRate`, `systemPromptCachePolicy`, …) is supplied by the PARENT's
+ * `inputMapper` at the mount site; the output is just `cacheMarkers`.
+ */
+import { flowChart } from 'footprintjs';
+import { decideCacheMarkers } from '../../cache/CacheDecisionSubflow.js';
+import { cacheGateDecide } from '../../cache/CacheGateDecider.js';
+import { STAGE_IDS } from '../../conventions.js';
+/**
+ * Build the `sf-cache` subflow chart. Called by `buildAgentChart` and
+ * `buildDynamicAgentChart` and mounted via `addSubFlowChartNext(
+ * SUBFLOW_IDS.CACHE, buildCacheSubflow(), 'Cache', { inputMapper,
+ * outputMapper, arrayMerge: Replace })`.
+ */
+export function buildCacheSubflow() {
+    return flowChart('CacheDecision', 
+    // Root stage = the cache-decision function (a chart cannot start with a
+    // nested subflow). Exported from CacheDecisionSubflow.ts and reused here —
+    // the cache decision is the root of sf-cache, no logic duplication.
+    decideCacheMarkers, 'decide-cache-markers', {
+        description: 'CacheDecision: walk activeInjections, evaluate cache directives, emit CacheMarker[]',
+    })
+        .addDeciderFunction('CacheGate', cacheGateDecide, STAGE_IDS.CACHE_GATE, 'Gate cache-marker application: kill switch / hit-rate / skill-churn')
+        .addFunctionBranch(STAGE_IDS.APPLY_MARKERS, 'ApplyMarkers', 
+    // Pass-through — markers stay in scope; the request build reads them.
+    () => undefined, 'Proceed with cache markers from CacheDecision')
+        .addFunctionBranch(STAGE_IDS.SKIP_CACHING, 'SkipCaching', 
+    // Clear markers so the request is built unmodified this iteration.
+    (scope) => {
+        scope.cacheMarkers = [];
+    }, 'Skip caching this iteration')
+        .end()
+        .build();
+}
+//# sourceMappingURL=buildCacheSubflow.js.map

package/dist/esm/core/agent/buildCacheSubflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildCacheSubflow.js","sourceRoot":"","sources":["../../../../src/core/agent/buildCacheSubflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,SAAS,EAAkB,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,SAAS,CACd,eAAe;IACf,wEAAwE;IACxE,2EAA2E;IAC3E,oEAAoE;IACpE,kBAA2B,EAC3B,sBAAsB,EACtB;QACE,WAAW,EACT,qFAAqF;KACxF,CACF;SACE,kBAAkB,CACjB,WAAW,EACX,eAAwB,EACxB,SAAS,CAAC,UAAU,EACpB,qEAAqE,CACtE;SACA,iBAAiB,CAChB,SAAS,CAAC,aAAa,EACvB,cAAc;IACd,sEAAsE;IACtE,GAAG,EAAE,CAAC,SAAS,EACf,+CAA+C,CAChD;SACA,iBAAiB,CAChB,SAAS,CAAC,YAAY,EACtB,aAAa;IACb,mEAAmE;IACnE,CAAC,KAAK,EAAE,EAAE;QACP,KAA8C,CAAC,YAAY,GAAG,EAAE,CAAC;IACpE,CAAC,EACD,6BAA6B,CAC9B;SACA,GAAG,EAAE;SACL,KAAK,EAAE,CAAC;AACb,CAAC"}