agentfootprint 2.14.5 → 3.1.0

package/dist/types/core/agent/buildAgentChart.d.ts

@@ -15,29 +15,29 @@
  *
  * 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 type { FlowChart } from 'footprintjs';
+import type { FlowChart, StructureRecorder } from 'footprintjs';
 import type { CachePolicy } from '../../cache/types.js';
 import type { MemoryDefinition } from '../../memory/define.types.js';
 /**
@@ -55,7 +55,6 @@ export interface AgentChartDeps {
      *  inputMapper for max-iteration policies. */
     readonly maxIterations: number;
     readonly seed: (scope: never) => void;
-    readonly iterationStart: (scope: never) => void;
     readonly callLLM: (scope: never) => Promise<void>;
     readonly routeDecider: (scope: never) => 'tool-calls' | 'final';
     readonly toolCallsHandler: import('footprintjs').PausableHandler<never>;
@@ -71,9 +70,29 @@ export interface AgentChartDeps {
      * zero overhead for non-thinking agents (build-time conditional mount).
      */
     readonly thinkingSubflow?: FlowChart;
-    readonly cacheDecisionSubflow: FlowChart;
     readonly updateSkillHistoryStage: (scope: never) => void;
-    readonly cacheGateDecide: (scope: never) => unknown;
+    /**
+     * Whether ≥1 Skill is registered. The `UpdateSkillHistory` stage (and
+     * therefore the cache's skill-churn rule) is mounted ONLY when true:
+     * with no skills the window would record "no skill" every iteration and
+     * `detectSkillChurn` could never fire, so the stage would be pure dead
+     * weight + a misleading box. Mirrors the `skills.length > 0` gate that
+     * auto-attaches `read_skill`, and the `thinkingSubflow` conditional mount.
+     */
+    readonly hasSkills: boolean;
+    /**
+     * ReAct loop semantics. `'dynamic'` (default) re-runs the InjectionEngine +
+     * all 3 slots every iteration (loop → InjectionEngine). `'classic'`
+     * engineers context ONCE (InjectionEngine + system-prompt + tools up front)
+     * and loops only the Messages slot (loop → Messages). See AgentOptions.reactMode.
+     */
+    readonly reactMode?: 'classic' | 'dynamic';
+    /** Structure recorders threaded into both `flowChart()` calls (the
+     *  main chart and the PrepareFinal sub-chart). Each recorder
+     *  observes per-node build events (`onStageAdded` /
+     *  `onSubflowMounted` / etc.) for the Agent's chart. Undefined when
+     *  the consumer didn't attach any. */
+    readonly structureRecorders?: readonly StructureRecorder[];
 }
 /**
  * Build the agent's complete FlowChart from the supplied deps.

package/dist/types/core/agent/buildAgentChart.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildAgentChart.d.ts","sourceRoot":"","sources":["../../../../src/core/agent/buildAgentChart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAQrE;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAE/C;uEACmE;IACnE,QAAQ,CAAC,uBAAuB,EAAE,WAAW,CAAC;IAE9C;kDAC8C;IAC9C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAG/B,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,YAAY,GAAG,OAAO,CAAC;IAChE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,aAAa,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IAGxE,QAAQ,CAAC,sBAAsB,EAAE,SAAS,CAAC;IAC3C,QAAQ,CAAC,mBAAmB,EAAE,SAAS,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,CAAC;IAGrC,QAAQ,CAAC,oBAAoB,EAAE,SAAS,CAAC;IACzC,QAAQ,CAAC,uBAAuB,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACzD,QAAQ,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;CACrD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,CAuP/D"}
+{"version":3,"file":"buildAgentChart.d.ts","sourceRoot":"","sources":["../../../../src/core/agent/buildAgentChart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAc,MAAM,aAAa,CAAC;AAE5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AASrE;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAE/C;uEACmE;IACnE,QAAQ,CAAC,uBAAuB,EAAE,WAAW,CAAC;IAE9C;kDAC8C;IAC9C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAG/B,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,YAAY,GAAG,OAAO,CAAC;IAChE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,aAAa,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IAGxE,QAAQ,CAAC,sBAAsB,EAAE,SAAS,CAAC;IAC3C,QAAQ,CAAC,mBAAmB,EAAE,SAAS,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,CAAC;IAMrC,QAAQ,CAAC,uBAAuB,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEzD;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAG3C;;;;0CAIsC;IACtC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,CAqT/D"}

package/dist/types/core/agent/buildAgentMessageApiChart.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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 type { FlowChart } from 'footprintjs';
+import type { LLMProvider, LLMToolSchema } from '../../adapters/types.js';
+export interface AgentMessageApiChartDeps {
+    readonly provider: LLMProvider;
+    readonly model: string;
+    readonly systemPrompt: string;
+    readonly tools: readonly LLMToolSchema[];
+    readonly maxIterations?: number;
+    readonly structureRecorders?: readonly import('footprintjs').StructureRecorder[];
+}
+/**
+ * Build the Agent merge-tree chart as one flat ReAct flowchart.
+ */
+export declare function buildAgentMessageApiChart(deps: AgentMessageApiChartDeps): FlowChart;
+//# sourceMappingURL=buildAgentMessageApiChart.d.ts.map

package/dist/types/core/agent/buildAgentMessageApiChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildAgentMessageApiChart.d.ts","sourceRoot":"","sources":["../../../../src/core/agent/buildAgentMessageApiChart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAc,WAAW,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AA8BtF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,OAAO,aAAa,EAAE,iBAAiB,EAAE,CAAC;CAClF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,wBAAwB,GAAG,SAAS,CA8LnF"}

package/dist/types/core/agent/buildCacheSubflow.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 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 { type FlowChart } from 'footprintjs';
+/**
+ * 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 declare function buildCacheSubflow(): FlowChart;
+//# sourceMappingURL=buildCacheSubflow.d.ts.map

package/dist/types/core/agent/buildCacheSubflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildCacheSubflow.d.ts","sourceRoot":"","sources":["../../../../src/core/agent/buildCacheSubflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAMxD;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,SAAS,CAqC7C"}

package/dist/types/core/agent/buildDynamicAgentChart.d.ts

@@ -0,0 +1,57 @@
+/**
+ * buildDynamicAgentChart — the Dynamic-ReAct agent chart, where the
+ * whole LLM turn (context engineering + the call) is ONE `sf-llm-call`
+ * subflow, exactly like the `LLMCall` primitive produces.
+ *
+ * WHY a second builder (vs `buildAgentChart`)
+ * ───────────────────────────────────────────
+ * `buildAgentChart` mounts the LLM as a flat `call-llm` STAGE with the
+ * slot subflows as its siblings. That renders as nothing in Lens — a
+ * bare stage is dropped by the subflow-level collapser, so the slots
+ * have no LLM card to fold into and the chart comes up empty.
+ *
+ * This builder wraps that same region in an `sf-llm-call` SUBFLOW. The
+ * payoff is purely structural — Lens already maps `sf-llm-call → LLM
+ * group` (same boundary `LLMCall` produces), so the Dynamic agent
+ * renders as an LLM group with its slots inside, a peer Tool node, and
+ * the loop arc, with ZERO Lens-specific special-casing.
+ *
+ * The data flow is IDENTICAL to `buildAgentChart` — every stage handler
+ * + slot subflow is reused verbatim from the same `AgentChartDeps`. The
+ * ONLY new thing is the subflow boundary, which means:
+ *
+ *   • A small inner seed (`dynamicTurnSeed`) initialises the per-turn
+ *     working keys the OUTER seed used to set, since the inner subflow
+ *     gets a fresh scope each loop re-entry.
+ *   • Cross-iteration accumulators (token totals, cost counters,
+ *     skill-history) round-trip out→in: the boundary `outputMapper`
+ *     bubbles them to the outer scope, and the next iteration's
+ *     `inputMapper` feeds them back under `prior*` aliases (because
+ *     keys passed via `inputMapper` are FROZEN inside the subflow —
+ *     `ScopeFacade.setValue` throws on them — so the writable working
+ *     key must have a different name from the read-only input).
+ *
+ * Chart shape (mirrors the diagram the team locked):
+ *
+ *     Initialize
+ *       → [memory READ subflows]
+ *       → sf-llm-call  (SUBFLOW — same boundary LLMCall produces)
+ *           dynamicTurnSeed → InjectionEngine
+ *           → Context (selector, PARALLEL fan-out, failFast)
+ *               ⇉ {System Prompt ‖ Messages ‖ Tools} → converge
+ *           → UpdateSkillHistory → Cache (sf-cache subflow)
+ *           → CallLLM (emits iteration_start) → [NormalizeThinking]
+ *       → Route (decider)
+ *            ├─ tool-calls (pausable) → loopTo(sf-llm-call)   ← branch-sourced loop
+ *            └─ sf-final (the answer) → terminal leaf
+ *
+ * Classic ReAct keeps using `buildAgentChart` until its own shape is
+ * designed — this builder is Dynamic-only.
+ */
+import type { FlowChart } from 'footprintjs';
+import type { AgentChartDeps } from './buildAgentChart.js';
+/**
+ * Build the Dynamic-ReAct agent chart from the shared `AgentChartDeps`.
+ */
+export declare function buildDynamicAgentChart(deps: AgentChartDeps): FlowChart;
+//# sourceMappingURL=buildDynamicAgentChart.d.ts.map

package/dist/types/core/agent/buildDynamicAgentChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildDynamicAgentChart.d.ts","sourceRoot":"","sources":["../../../../src/core/agent/buildDynamicAgentChart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AAUzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAgD3D;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,CAkTtE"}

package/dist/types/core/agent/buildMessageApiChart.d.ts

@@ -0,0 +1,48 @@
+/**
+ * buildMessageApiChart — PROOF of the locked "messageAPI merge-tree" shape
+ * (MENTAL_MODEL.md ★ LOCKED DESIGN), LLM-only (no tools subflow yet).
+ *
+ * This is Step 1 of the agreed build order: prove the Context-selector →
+ * slot subflows → messageAPI stage → Call-LLM tree works + renders, BEFORE
+ * bringing it to the Agent (Step 2 adds the tools subflow + the loop).
+ *
+ * Chart shape (LLM-only):
+ *
+ *     Seed
+ *       → Context (SELECTOR stage — picks which slots to engineer)
+ *           ├─ sf-system-prompt ┐   (selected branches run in parallel)
+ *           └─ sf-messages ──────┴─→ messageAPI stage   (the join point)
+ *       → Call-LLM
+ *
+ * WHY a selector (not a plain fork): "Context = Selector stage" — it RETURNS
+ * the list of slot branch ids to engineer this iteration, and `select()`
+ * captures evidence (which slots + why). That is what will unify Static and
+ * Dynamic agent in ONE chart later: Static picks only `messages` per loop;
+ * Dynamic also picks `system-prompt` (and `tools`) when they re-engineer.
+ * The picked-set IS the lit/unlit-pill signal. For this LLM-only proof the
+ * selector picks BOTH slots (a one-shot call engineers everything once).
+ *
+ * WHY messageAPI is a REAL stage: it assembles the LLM request bulk that the
+ * agent's `callLLM` builds invisibly today (callLLM.ts:132) — `systemPrompt`
+ * (separate field) + `messages` (the conversation, incl. tool-results) → the
+ * message-API payload. Making it a stage makes that assembly visible +
+ * inspectable in Lens/Trace. (Tools is a separate field added at Call-LLM —
+ * it joins in Step 2.)
+ *
+ * Slots are REAL subflows (reused verbatim: buildSystemPromptSlot /
+ * buildMessagesSlot) writing the convention INJECTION_KEYS, so ContextRecorder
+ * emits context.injected and Lens renders them — no bespoke collapser.
+ */
+import type { FlowChart } from 'footprintjs';
+import type { LLMProvider } from '../../adapters/types.js';
+export interface MessageApiChartDeps {
+    readonly provider: LLMProvider;
+    readonly model: string;
+    readonly systemPrompt: string;
+    readonly structureRecorders?: readonly import('footprintjs').StructureRecorder[];
+}
+/**
+ * Build the LLM-only messageAPI merge-tree chart.
+ */
+export declare function buildMessageApiChart(deps: MessageApiChartDeps): FlowChart;
+//# sourceMappingURL=buildMessageApiChart.d.ts.map

package/dist/types/core/agent/buildMessageApiChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildMessageApiChart.d.ts","sourceRoot":"","sources":["../../../../src/core/agent/buildMessageApiChart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAuBvE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,OAAO,aAAa,EAAE,iBAAiB,EAAE,CAAC;CAClF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,SAAS,CA8HzE"}

package/dist/types/core/agent/stages/callLLM.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"callLLM.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/stages/callLLM.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAEV,WAAW,EAGX,aAAa,EACb,YAAY,EACb,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAI1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAMnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,kCAAkC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;qDACiD;IACjD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC;;sEAEkE;IAClE,QAAQ,CAAC,WAAW,EAAE,SAAS,aAAa,EAAE,CAAC;IAC/C;;;;;uBAKmB;IACnB,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IACzC;;;;;;oCAMgC;IAChC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC1D;;yDAEqD;IACrD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,gBAAgB,GACrB,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAwMlD"}
+{"version":3,"file":"callLLM.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/stages/callLLM.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAEV,WAAW,EAGX,aAAa,EACb,YAAY,EACb,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAI1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAMnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,kCAAkC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;qDACiD;IACjD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC;;sEAEkE;IAClE,QAAQ,CAAC,WAAW,EAAE,SAAS,aAAa,EAAE,CAAC;IAC/C;;;;;uBAKmB;IACnB,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IACzC;;;;;;oCAMgC;IAChC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC1D;;yDAEqD;IACrD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,gBAAgB,GACrB,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAoNlD"}

package/dist/types/core/agent/stages/reliabilityExecution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reliabilityExecution.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/stages/reliabilityExecution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAWvF,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;qEACqE;AACrE,MAAM,MAAM,SAAS,GAAG,CACtB,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE;IACL;;qBAEiB;IACjB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B,KACE,OAAO,CAAC,WAAW,CAAC,CAAC;AAE1B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,QAAQ,EAAE,WAAW,KAAK,IAAI,CAAC;AAEpE;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,iBAAiB,CAAC;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAChB,IAAI,EAAE;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,YAAY,GAAG,iBAAiB,CAAC;QACxC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;CAOF;AAED;0EAC0E;AAC1E,eAAO,MAAM,eAAe,6BAA6B,CAAC;AAE1D;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,iBAAiB,EACzB,eAAe,EAAE,WAAW,EAC5B,mBAAmB,EAAE,MAAM,EAC3B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,SAAS;AACjB;;;;;iEAKiE;AACjE,YAAY,CAAC,EAAE,qBAAqB,GACnC,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAuWlC;AAwCD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,gBAAgB,EAAE,CAAC,SAAI,GAAG,OAAO,CAQlF;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,eAKlC,CAAC"}
+{"version":3,"file":"reliabilityExecution.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/stages/reliabilityExecution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAWvF,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;qEACqE;AACrE,MAAM,MAAM,SAAS,GAAG,CACtB,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE;IACL;;qBAEiB;IACjB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B,KACE,OAAO,CAAC,WAAW,CAAC,CAAC;AAE1B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,QAAQ,EAAE,WAAW,KAAK,IAAI,CAAC;AAEpE;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,iBAAiB,CAAC;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAChB,IAAI,EAAE;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,YAAY,GAAG,iBAAiB,CAAC;QACxC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;CAOF;AAED;0EAC0E;AAC1E,eAAO,MAAM,eAAe,6BAA6B,CAAC;AAE1D;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,iBAAiB,EACzB,eAAe,EAAE,WAAW,EAC5B,mBAAmB,EAAE,MAAM,EAC3B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,SAAS;AACjB;;;;;iEAKiE;AACjE,YAAY,CAAC,EAAE,qBAAqB,GACnC,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CA8ZlC;AAwCD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,gBAAgB,EAAE,CAAC,SAAI,GAAG,OAAO,CAQlF;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,eAKlC,CAAC"}

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

@@ -7,12 +7,15 @@
  * part of the v2.11.1 decomposition. `core/Agent.ts` re-exports them
  * for back-compat (the 28+ existing import sites continue to work).
  */
+import type { StructureRecorder } from 'footprintjs';
+import type { GroupTranslator } from '../translator.js';
 import type { LLMMessage, LLMProvider, LLMToolSchema, PermissionChecker, PricingTable } from '../../adapters/types.js';
 import type { CacheMarker, CacheStrategy } from '../../cache/types.js';
 import type { ActiveInjection } from '../../lib/injection-engine/types.js';
 import type { InjectionRecord } from '../../recorders/core/types.js';
 import type { MemoryIdentity } from '../../memory/identity/types.js';
 import type { ThinkingBlock } from '../../thinking/types.js';
+import type { ReliabilityScope } from '../../reliability/types.js';
 export interface AgentOptions {
     readonly provider: LLMProvider;
     /** Human-friendly name shown in events/metrics. Default: 'Agent'. */
@@ -64,6 +67,85 @@ export interface AgentOptions {
      * once those land in Phase 7+.
      */
     readonly cacheStrategy?: CacheStrategy;
+    /**
+     * Optional build-time recorders threaded into footprintjs's
+     * `flowChart()` factory. Each recorder fires `onStageAdded` once per
+     * node in the Agent's internal chart (Seed, CallLLM, Route, tool
+     * handler, slot mounts, PrepareFinal, BreakFinal), and
+     * `onSubflowMounted` once per mounted subflow. Recorders own their
+     * own accumulators — agentfootprint just threads them through.
+     *
+     * Cascade: each slot subflow (system-prompt, messages, tools)
+     * was built earlier with its OWN recorders (or none).
+     * footprintjs does NOT propagate StructureRecorders into mounted
+     * subflows — attach the same recorders to every nested composition
+     * for full coverage.
+     *
+     * When omitted, no build-time observation is wired up.
+     */
+    readonly structureRecorders?: readonly StructureRecorder[];
+    /**
+     * Optional per-COMPOSITION translator (UI-agnostic). See
+     * `core/translator.ts`. When attached, `agent.getUIGroup()` invokes
+     * it with the Agent's `GroupMetadata` (kind `'Agent'`, id, name,
+     * empty `members[]`, plus `extra.slots` and `extra.toolNames`).
+     * Tools are not `Runner` instances (they're function executors)
+     * so they're conveyed by name in `extra`, not as group members.
+     * Returns `undefined` when omitted.
+     */
+    readonly groupTranslator?: GroupTranslator;
+    /**
+     * Chart structure for the ReAct loop. Default `'flat'` keeps the
+     * historical shape (`buildAgentChart`): the LLM call is a bare
+     * `call-llm` STAGE with the slot subflows as its siblings.
+     *
+     * `'subflow'` wraps the whole LLM turn (injection engine + the 3
+     * slots + cache + the call + thinking) in a single `sf-llm-call`
+     * SUBFLOW — the SAME boundary the `LLMCall` primitive produces. This
+     * is the structurally-correct shape: the LLM invocation IS a subflow,
+     * so Lens (and any explainable-ui consumer) renders it as an LLM
+     * group with its slots inside, with zero bespoke collapsing. Behaviour
+     * is identical to `'flat'`; only the chart's nesting differs.
+     *
+     * Opt-in while the subflow shape proves out; will become the default
+     * once verified end-to-end. See `agent/buildDynamicAgentChart.ts`.
+     */
+    readonly reactStructure?: 'flat' | 'subflow';
+    /**
+     * ReAct loop SEMANTICS — how much of the request is re-engineered each
+     * iteration. Default `'dynamic'`.
+     *
+     * `'dynamic'` (default) — every iteration re-runs the InjectionEngine and
+     * all three slots (system-prompt ‖ messages ‖ tools), because which
+     * injections are active can change per turn (a skill activates, a rule
+     * fires, a tool-return triggers something). The loop targets the
+     * InjectionEngine. This is the right shape when the agent uses skills,
+     * rule/on-tool-return triggers, or any per-turn context steering.
+     *
+     * `'classic'` — textbook ReAct: context is engineered ONCE. The
+     * InjectionEngine, system-prompt and tools run a single time up front;
+     * the loop targets only the Messages slot, so each iteration just appends
+     * the new tool result and re-calls the LLM. Use this when the system
+     * prompt and tool set are fixed for the whole run (the common case). The
+     * chart then reads honestly — `ToolCalls → Messages` loops, the static
+     * slots sit outside the loop.
+     *
+     * Both modes produce identical LLM requests for a static agent (no dynamic
+     * triggers); `'classic'` just avoids re-computing fixed slots and shows in the
+     * chart that only the messages re-run (after turn 1 only the Messages slot
+     * lights up). Implementation-wise the chart is the SAME as Dynamic — the only
+     * difference is that the Context selector stops re-selecting the system-prompt
+     * and tools slots after the first turn, so their outputs are reused.
+     *
+     * CAVEAT: because the static slots are cached after turn 1, `'classic'` is for
+     * agents whose system-prompt + tools are FIXED. If you register skills or
+     * dynamic-trigger injections (rule / on-tool-return / llm-activated), an
+     * activation that happens mid-run would NOT surface into the cached
+     * system-prompt/tools — use `'dynamic'` (the default) for those. Currently
+     * `'classic'` uses the flat chart shape (the `reactStructure: 'subflow'`
+     * grouping re-seeds context every turn by design, so it stays dynamic-only).
+     */
+    readonly reactMode?: 'classic' | 'dynamic';
 }
 export interface AgentInput {
     readonly message: string;
@@ -179,5 +261,19 @@ export interface AgentState {
      *  `scope.history` (ensures Anthropic signature round-trip). Empty
      *  array when no thinking present. */
     thinkingBlocks: readonly ThinkingBlock[];
+    /** Set when the rules-based reliability loop takes the fail-fast path.
+     *  `Agent.run()` reads these from the post-run snapshot and throws a
+     *  typed `ReliabilityFailFastError`. Mirrors `policyHalt*` — because the
+     *  loop stops the chart with `$break` (not a throw), durable scope is the
+     *  only courier of the structured fail context across the break to the
+     *  API boundary. (Telemetry ALSO fires via the `reliability.fail_fast`
+     *  emit event; these scope fields are the business-logic control signal.) */
+    reliabilityFailKind?: string;
+    reliabilityFailPayload?: ReliabilityScope['failPayload'];
+    reliabilityFailReason?: string;
+    /** Originating error message/name — stringified because Error objects
+     *  don't survive footprintjs's `structuredClone` of scope. */
+    reliabilityFailCauseMessage?: string;
+    reliabilityFailCauseName?: string;
 }
 //# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1,24 @@
+/**
+ * humanizeLLMError — turn a raw provider/SDK error into a plain-language
+ * sentence a NON-developer can act on.
+ *
+ * agentfootprint targets vibe-coding / non-developer builders. A raw
+ * "[browser-anthropic] Failed to fetch" or "401 Unauthorized" means
+ * nothing to them. This maps the common failure shapes to a friendly,
+ * actionable message. The raw error is preserved on `.cause` (and via
+ * `wrapLLMError`) so developers can still dig in.
+ *
+ * Pure + dependency-light: string/shape matching only. Extend the cases
+ * as new provider failure modes surface — keep each message short and
+ * tell the user what to DO.
+ */
+/** Map a thrown provider/SDK error to a friendly, actionable sentence. */
+export declare function humanizeLLMError(err: unknown): string;
+/**
+ * Wrap a raw provider error in a fresh Error whose `.message` is the
+ * humanized sentence, preserving the original on `.cause` for developers
+ * (and "Copy for LLM"). Re-throw this from the LLM call site so the
+ * friendly message flows through onError → onRunFailed → the monitor.
+ */
+export declare function wrapLLMError(err: unknown): Error;
+//# sourceMappingURL=humanizeLLMError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"humanizeLLMError.d.ts","sourceRoot":"","sources":["../../../src/core/humanizeLLMError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAUH,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CA8CrD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAIhD"}

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

@@ -1,10 +1,11 @@
 /**
  * Runner — consumer-facing interface for every primitive/composition/pattern.
  *
- * Pattern: Facade (GoF) over ComposableRunner + EventDispatcher.
+ * Pattern: Facade (GoF) over the footprintjs FlowChart + EventDispatcher.
  * Role:    The one object consumers hold. Exposes:
- *            - `.run()` / `.toFlowChart()` (inherited from footprintjs
- *              ComposableRunner — composition + execution)
+ *            - `.run()` (execute)
+ *            - `.getSpec()` (the design-time FlowChart blueprint —
+ *              same value footprintjs's `addSubFlowChart*` accepts)
  *            - `.on() / .off() / .once()` (listener subscription)
  *            - `.attach()` (attach custom CombinedRecorder)
  *            - `.emit()` (consumer-defined custom events on the same
@@ -12,7 +13,7 @@
  * Emits:   N/A — this file defines the INTERFACE. Concrete runners
  *          (LLMCall, Agent, Sequence, etc.) implement it.
  */
-import type { CombinedRecorder, ComposableRunner, FlowchartCheckpoint, RunOptions } from 'footprintjs';
+import type { CombinedRecorder, FlowChart, FlowchartCheckpoint, RunOptions } from 'footprintjs';
 import type { RunnerPauseOutcome } from './pause.js';
 import type { EventListener, ListenOptions, Unsubscribe, WildcardListener, WildcardSubscription } from '../events/dispatcher.js';
 import type { AgentfootprintEvent, AgentfootprintEventType } from '../events/registry.js';
@@ -73,7 +74,52 @@ export interface EnableNamespace {
  * That makes them freely nestable: any runner can be a child of any
  * composition.
  */
-export interface Runner<TIn = unknown, TOut = unknown> extends Omit<ComposableRunner<TIn, TOut>, 'run'> {
+export interface Runner<TIn = unknown, TOut = unknown> {
+    /**
+     * Return the footprintjs FlowChart for this runner — the canonical
+     * design-time blueprint. Stable across calls. Pairs with the run-time
+     * accessors (`getLastSnapshot`, `getCommitCount`) and matches
+     * `ExplainableShell.spec` + `specToReactFlow(spec, ...)` consumer
+     * conventions.
+     *
+     * Subflow mounting (footprintjs `addSubFlowChart*`) accepts the
+     * `FlowChart` value directly:
+     *
+     *   parent.addSubFlowChartNext('sf-agent', child.getSpec(), 'Agent')
+     */
+    getSpec(): FlowChart;
+    /**
+     * Return the consumer-shaped UI group for this runner — produced by
+     * invoking the `groupTranslator` (if one was attached at constructor
+     * time) with this composition's metadata. Returns `undefined` when no
+     * translator was attached.
+     *
+     * Companion of `getSpec()`: `getSpec()` is the canonical (UI-
+     * agnostic) blueprint; `getUIGroup()` is the consumer-shaped view.
+     * Both are stable post-construction.
+     *
+     * See `core/translator.ts` for the `GroupTranslator` /
+     * `GroupMetadata` types.
+     */
+    getUIGroup<T = unknown>(): T | undefined;
+    /**
+     * Translate this runner's group metadata with a CALLER-SUPPLIED
+     * translator that OVERRIDES whatever translator (if any) the runner
+     * was constructed with. Used by parent compositions to apply
+     * per-method translator overrides (e.g.,
+     * `Parallel.create(...).branch('special', runner, { groupTranslator: ... })`
+     * — for the `'special'` branch only, this `override` runs against
+     * `runner`'s own `GroupMetadata` instead of the runner's default
+     * translator).
+     *
+     * NOT cached at the runner level. The caller invokes this exactly
+     * once per build (parent's `buildUIGroupMetadata`) and caches the
+     * resulting `uiGroup` via the parent's `RunnerBase.uiGroupCache`.
+     *
+     * Returns `undefined` when this runner has no group metadata to
+     * translate (i.e., `buildUIGroupMetadata()` returned `undefined`).
+     */
+    getUIGroupWith<T = unknown>(override: import('./translator.js').GroupTranslator): T | undefined;
     /**
      * Execute the runner. On happy-path completion, resolves with `TOut`.
      * If any stage (Agent tool via `pauseHere`, nested runner, or consumer

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

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/core/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACX,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACtF,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EACjB,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AAEjC;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAAC;IAC7C;;;OAGG;IACH,OAAO,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,WAAW,CAAC;IAC5C;;;;;;;;OAQG;IACH,SAAS,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAAC;IACpD;;;;;OAKG;IACH,aAAa,CAAC,IAAI,CAAC,EAAE,0BAA0B,GAAG,WAAW,CAAC;IAC9D;;;;OAIG;IACH,IAAI,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,WAAW,CAAC;IAC5C;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,uBAAuB,GAAG,WAAW,CAAC;CACxD;AAED;;;;;GAKG;AACH,MAAM,WAAW,MAAM,CAAC,GAAG,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO,CACnD,SAAQ,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC;IAChD;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,GAAG,kBAAkB,CAAC,CAAC;IAE1E;;;;;OAKG;IACH,MAAM,CACJ,UAAU,EAAE,mBAAmB,EAC/B,KAAK,CAAC,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,IAAI,GAAG,kBAAkB,CAAC,CAAC;IAEtC,uDAAuD;IACvD,EAAE,CAAC,CAAC,SAAS,uBAAuB,EAClC,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,OAAO,CAAC,EAAE,aAAa,GACtB,WAAW,CAAC;IACf,+EAA+E;IAC/E,EAAE,CAAC,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,WAAW,CAAC;IAEjG,oDAAoD;IACpD,GAAG,CAAC,CAAC,SAAS,uBAAuB,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAClF,GAAG,CAAC,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAElE,oEAAoE;IACpE,IAAI,CAAC,CAAC,SAAS,uBAAuB,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;IAC1F,IAAI,CAAC,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,gBAAgB,GAAG,WAAW,CAAC;IAE1E;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,gBAAgB,GAAG,WAAW,CAAC;IAEhD;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IAEjC;;;;;;OAMG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC5D;AAED,6EAA6E;AAC7E,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,mBAAmB,CAAC"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/core/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACtF,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EACjB,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AAEjC;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAAC;IAC7C;;;OAGG;IACH,OAAO,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,WAAW,CAAC;IAC5C;;;;;;;;OAQG;IACH,SAAS,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAAC;IACpD;;;;;OAKG;IACH,aAAa,CAAC,IAAI,CAAC,EAAE,0BAA0B,GAAG,WAAW,CAAC;IAC9D;;;;OAIG;IACH,IAAI,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,WAAW,CAAC;IAC5C;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,uBAAuB,GAAG,WAAW,CAAC;CACxD;AAED;;;;;GAKG;AACH,MAAM,WAAW,MAAM,CAAC,GAAG,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO;IACnD;;;;;;;;;;;OAWG;IACH,OAAO,IAAI,SAAS,CAAC;IAErB;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,GAAG,SAAS,CAAC;IAEzC;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,OAAO,iBAAiB,EAAE,eAAe,GAAG,CAAC,GAAG,SAAS,CAAC;IAEhG;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,GAAG,kBAAkB,CAAC,CAAC;IAE1E;;;;;OAKG;IACH,MAAM,CACJ,UAAU,EAAE,mBAAmB,EAC/B,KAAK,CAAC,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,IAAI,GAAG,kBAAkB,CAAC,CAAC;IAEtC,uDAAuD;IACvD,EAAE,CAAC,CAAC,SAAS,uBAAuB,EAClC,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,OAAO,CAAC,EAAE,aAAa,GACtB,WAAW,CAAC;IACf,+EAA+E;IAC/E,EAAE,CAAC,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,WAAW,CAAC;IAEjG,oDAAoD;IACpD,GAAG,CAAC,CAAC,SAAS,uBAAuB,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAClF,GAAG,CAAC,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAElE,oEAAoE;IACpE,IAAI,CAAC,CAAC,SAAS,uBAAuB,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;IAC1F,IAAI,CAAC,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,gBAAgB,GAAG,WAAW,CAAC;IAE1E;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,gBAAgB,GAAG,WAAW,CAAC;IAEhD;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IAEjC;;;;;;OAMG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC5D;AAED,6EAA6E;AAC7E,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,mBAAmB,CAAC"}

package/dist/types/core/slots/buildMessagesSlot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildMessagesSlot.d.ts","sourceRoot":"","sources":["../../../../src/core/slots/buildMessagesSlot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AAEzD,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAMzE;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAMD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,kBAAuB,GAAG,SAAS,CA8D5E"}
+{"version":3,"file":"buildMessagesSlot.d.ts","sourceRoot":"","sources":["../../../../src/core/slots/buildMessagesSlot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AAEzD,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAMzE;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAMD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,kBAAuB,GAAG,SAAS,CA4D5E"}

package/dist/types/core/slots/buildSystemPromptSlot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildSystemPromptSlot.d.ts","sourceRoot":"","sources":["../../../../src/core/slots/buildSystemPromptSlot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AAOzD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAE/B,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC;IACzC,yCAAyC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,mFAAmF;IACnF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAWD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,sBAAsB,GAAG,SAAS,CAqE/E"}
+{"version":3,"file":"buildSystemPromptSlot.d.ts","sourceRoot":"","sources":["../../../../src/core/slots/buildSystemPromptSlot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AAOzD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAE/B,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC;IACzC,yCAAyC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,mFAAmF;IACnF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAWD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,sBAAsB,GAAG,SAAS,CAoE/E"}

package/dist/types/core/slots/buildThinkingSubflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildThinkingSubflow.d.ts","sourceRoot":"","sources":["../../../../src/core/slots/buildThinkingSubflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAiB,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAU9E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,CA4ExE"}
+{"version":3,"file":"buildThinkingSubflow.d.ts","sourceRoot":"","sources":["../../../../src/core/slots/buildThinkingSubflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAiB,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAU9E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,CA2ExE"}

package/dist/types/core/slots/buildToolsSlot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildToolsSlot.d.ts","sourceRoot":"","sources":["../../../../src/core/slots/buildToolsSlot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAM7D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,+BAA+B,CAAC;AAGvF;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAC/C,yCAAyC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAMD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAsMjE"}
+{"version":3,"file":"buildToolsSlot.d.ts","sourceRoot":"","sources":["../../../../src/core/slots/buildToolsSlot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAM7D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,+BAA+B,CAAC;AAGvF;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAC/C,yCAAyC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAMD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAkMjE"}