agentfootprint 7.25.0 → 7.27.0

package/dist/esm/core/agent/stages/outputRetry.d.ts

@@ -0,0 +1,34 @@
+/**
+ * outputRetry — the branch that asks again when the answer failed the schema.
+ *
+ * Mounted as a THIRD branch of the Route decider, and only on an agent that
+ * opted into `.outputSchema(parser, { retries })`. It carries `{ loopTo }`
+ * to the same target the `tool-calls` branch loops to, which is the whole
+ * mechanism: a retry is not a special mode, it is one more ordinary turn of
+ * the ReAct loop. The injection engine re-evaluates, the slots recompose,
+ * the cache decides, the model is called — so the attempt gets its own
+ * `iteration_start` / `llm_start` / `llm_end` bracket and its own `cost.tick`
+ * against `costBudget`.
+ *
+ * That is the difference from the in-stage schema retry the reliability gate
+ * has done since v2.13. There, N attempts happen inside ONE `call-llm` stage:
+ * one bracket for all of them, and one cost tick carrying only the last
+ * attempt's usage — attempts that were genuinely billed and are invisible in
+ * the recording. Here every attempt is a turn, and the recording says so.
+ *
+ * The two layers compose rather than collide. With `.reliability()` also
+ * configured, its in-stage rules run FIRST and decide what to do with a
+ * response before it is committed; `retries` governs answers that WERE
+ * committed and turned out invalid.
+ *
+ * Pure function apart from its enforcement config — no closure over Agent
+ * class state.
+ */
+import type { TypedScope } from 'footprintjs';
+import { type ResolvedOutputEnforcement } from '../outputEnforcement.js';
+import type { AgentState } from '../types.js';
+/**
+ * Build the retry stage. `enforcement.retries` is the cap the decider already
+ * checked before routing here — this stage does the work of asking again.
+ */
+export declare function buildOutputRetryStage(enforcement: ResolvedOutputEnforcement): (scope: TypedScope<AgentState>) => void;

package/dist/esm/core/agent/stages/outputRetry.js

@@ -0,0 +1,98 @@
+/**
+ * outputRetry — the branch that asks again when the answer failed the schema.
+ *
+ * Mounted as a THIRD branch of the Route decider, and only on an agent that
+ * opted into `.outputSchema(parser, { retries })`. It carries `{ loopTo }`
+ * to the same target the `tool-calls` branch loops to, which is the whole
+ * mechanism: a retry is not a special mode, it is one more ordinary turn of
+ * the ReAct loop. The injection engine re-evaluates, the slots recompose,
+ * the cache decides, the model is called — so the attempt gets its own
+ * `iteration_start` / `llm_start` / `llm_end` bracket and its own `cost.tick`
+ * against `costBudget`.
+ *
+ * That is the difference from the in-stage schema retry the reliability gate
+ * has done since v2.13. There, N attempts happen inside ONE `call-llm` stage:
+ * one bracket for all of them, and one cost tick carrying only the last
+ * attempt's usage — attempts that were genuinely billed and are invisible in
+ * the recording. Here every attempt is a turn, and the recording says so.
+ *
+ * The two layers compose rather than collide. With `.reliability()` also
+ * configured, its in-stage rules run FIRST and decide what to do with a
+ * response before it is committed; `retries` governs answers that WERE
+ * committed and turned out invalid.
+ *
+ * Pure function apart from its enforcement config — no closure over Agent
+ * class state.
+ */
+import { typedEmit } from '../../../recorders/core/typedEmit.js';
+import { buildCorrectiveTurn, correctiveMessageHash, recordOutputAttempt, } from '../outputEnforcement.js';
+/**
+ * Build the retry stage. `enforcement.retries` is the cap the decider already
+ * checked before routing here — this stage does the work of asking again.
+ */
+export function buildOutputRetryStage(enforcement) {
+    return (scope) => {
+        const iteration = scope.iteration;
+        const failure = scope.outputSchemaFailure;
+        if (failure === undefined) {
+            // Unreachable through the decider, which writes the carrier immediately
+            // before routing here. Returning quietly rather than throwing keeps a
+            // hand-built chart that mounts this branch without the decider from
+            // taking down a run over a missing diagnostic.
+            return;
+        }
+        const failedAnswer = scope.llmLatestContent;
+        const [answerTurn, correctionTurn] = buildCorrectiveTurn(failedAnswer, failure, {
+            attempt: failure.attempt,
+            // The total the run may spend: the first attempt plus its retries.
+            totalAttempts: enforcement.retries + 1,
+        });
+        const hash = correctiveMessageHash(correctionTurn.content);
+        // The conversation, as it really went: the answer that failed, then the
+        // correction. A plain local array — a TypedScope array read is a live
+        // proxy view, and both the commit and the event payload below must be
+        // detached plain data.
+        const newHistory = [
+            ...scope.history,
+            answerTurn,
+            correctionTurn,
+        ];
+        scope.history = newHistory;
+        recordOutputAttempt(scope, {
+            attempt: failure.attempt,
+            iteration,
+            outcome: 'retried',
+            stage: failure.stage,
+            error: failure.error,
+            ...(failure.path !== undefined && { path: failure.path }),
+            correctiveMessageHash: hash,
+        });
+        typedEmit(scope, 'agentfootprint.agent.output_schema_retry', {
+            attempt: failure.attempt,
+            // What is left AFTER this correction — `0` means this is the last ask.
+            retriesRemaining: enforcement.retries - failure.attempt,
+            iteration,
+            stage: failure.stage,
+            error: failure.error,
+            ...(failure.path !== undefined && { path: failure.path }),
+            correctiveMessageHash: hash,
+        });
+        // Close this iteration's bracket before the loop turns. Every recorder
+        // that synthesizes steps counts on `iteration_start` and `iteration_end`
+        // pairing per `iterIndex`, and the crash-checkpoint tracker takes its
+        // history snapshot from this payload — so a retry that skipped it would
+        // leave a run with one more start than end and a checkpoint one turn
+        // behind the conversation.
+        typedEmit(scope, 'agentfootprint.agent.iteration_end', {
+            turnIndex: 0,
+            iterIndex: iteration,
+            toolCallCount: 0,
+            history: newHistory,
+        });
+        // A retry consumes an iteration, exactly as a tool call does. It is one
+        // more real turn against the agent's declared budget, and the iteration
+        // counter is the vocabulary every bracket in the run is keyed on.
+        scope.iteration = iteration + 1;
+    };
+}
+//# sourceMappingURL=outputRetry.js.map

package/dist/esm/core/agent/stages/outputRetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputRetry.js","sourceRoot":"","sources":["../../../../../src/core/agent/stages/outputRetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACjE,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,GAEpB,MAAM,yBAAyB,CAAC;AAGjC;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAAsC;IAEtC,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,MAAM,SAAS,GAAG,KAAK,CAAC,SAAmB,CAAC;QAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,mBAAmB,CAAC;QAC1C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,wEAAwE;YACxE,sEAAsE;YACtE,oEAAoE;YACpE,+CAA+C;YAC/C,OAAO;QACT,CAAC;QAED,MAAM,YAAY,GAAG,KAAK,CAAC,gBAA0B,CAAC;QACtD,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC,GAAG,mBAAmB,CAAC,YAAY,EAAE,OAAO,EAAE;YAC9E,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,mEAAmE;YACnE,aAAa,EAAE,WAAW,CAAC,OAAO,GAAG,CAAC;SACvC,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,qBAAqB,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAE3D,wEAAwE;QACxE,sEAAsE;QACtE,sEAAsE;QACtE,uBAAuB;QACvB,MAAM,UAAU,GAAiB;YAC/B,GAAI,KAAK,CAAC,OAAiC;YAC3C,UAAU;YACV,cAAc;SACf,CAAC;QACF,KAAK,CAAC,OAAO,GAAG,UAAU,CAAC;QAE3B,mBAAmB,CAAC,KAAK,EAAE;YACzB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS;YACT,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;YACzD,qBAAqB,EAAE,IAAI;SAC5B,CAAC,CAAC;QAEH,SAAS,CAAC,KAAK,EAAE,0CAA0C,EAAE;YAC3D,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,uEAAuE;YACvE,gBAAgB,EAAE,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO;YACvD,SAAS;YACT,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;YACzD,qBAAqB,EAAE,IAAI;SAC5B,CAAC,CAAC;QAEH,uEAAuE;QACvE,yEAAyE;QACzE,sEAAsE;QACtE,wEAAwE;QACxE,qEAAqE;QACrE,2BAA2B;QAC3B,SAAS,CAAC,KAAK,EAAE,oCAAoC,EAAE;YACrD,SAAS,EAAE,CAAC;YACZ,SAAS,EAAE,SAAS;YACpB,aAAa,EAAE,CAAC;YAChB,OAAO,EAAE,UAAU;SACpB,CAAC,CAAC;QAEH,wEAAwE;QACxE,wEAAwE;QACxE,kEAAkE;QAClE,KAAK,CAAC,SAAS,GAAG,SAAS,GAAG,CAAC,CAAC;IAClC,CAAC,CAAC;AACJ,CAAC"}

package/dist/esm/core/agent/stages/route.d.ts

@@ -15,7 +15,8 @@
 import type { TypedScope } from 'footprintjs';
 import type { AgentState } from '../types.js';
 import type { MessageMiddleware } from '../middleware/types.js';
-export type RouteBranch = 'tool-calls' | 'final';
+import { type ResolvedOutputEnforcement } from '../outputEnforcement.js';
+export type RouteBranch = 'tool-calls' | 'final' | 'output-retry';
 export declare const routeDeciderStage: (scope: TypedScope<AgentState>) => RouteBranch;
 /**
  * Build the Route decider, optionally carrying the `'output'` half of the
@@ -43,5 +44,20 @@ export declare const routeDeciderStage: (scope: TypedScope<AgentState>) => Route
  * would be running it over something that is not the output.
  *
  * Empty chain → the exact synchronous decider this file has always exported.
+ *
+ * ## Why the schema is judged HERE too
+ *
+ * The same property that made this the output seam makes it the enforcement
+ * seam. `outputSchema` used to be judged only at the caller's boundary, after
+ * the run — a fine place to reject an answer and a useless place to fix one,
+ * because the loop has already stopped. Judged here, one stage before the
+ * Final branch, the run still HAS a loop: a failed answer can route to
+ * `'output-retry'`, which loops back for one more real turn.
+ *
+ * The judging runs AFTER the message chain, over the content the chain
+ * produced, because that is the string the caller will receive — validating
+ * the pre-chain value would judge an answer nobody gets. A DENIED answer is
+ * never judged or retried: it was withheld on purpose, and re-asking for it
+ * would be the library working around a rule the app wrote.
  */
-export declare function buildRouteDeciderStage(messageMiddleware?: readonly MessageMiddleware[]): (scope: TypedScope<AgentState>) => RouteBranch | Promise<RouteBranch>;
+export declare function buildRouteDeciderStage(messageMiddleware?: readonly MessageMiddleware[], enforcement?: ResolvedOutputEnforcement): (scope: TypedScope<AgentState>) => RouteBranch | Promise<RouteBranch>;

package/dist/esm/core/agent/stages/route.js

@@ -15,20 +15,35 @@
 import { typedEmit } from '../../../recorders/core/typedEmit.js';
 import { runMessageChain } from '../middleware/runChain.js';
 import { recordDecisions } from '../middleware/ledger.js';
-export const routeDeciderStage = (scope) => {
+import { judgeAnswer, recordOutputAttempt, } from '../outputEnforcement.js';
+/** The base decision, with the sentence that explains it. Split out so the
+ *  enforcement-enabled path can decide, then judge, then announce ONCE — an
+ *  agent whose answer is about to be re-asked should not have a route event
+ *  saying it finished. */
+function decideBranch(scope) {
     const toolCalls = scope.llmLatestToolCalls;
     const iteration = scope.iteration;
     const chosen = toolCalls.length > 0 && iteration < scope.maxIterations ? 'tool-calls' : 'final';
-    typedEmit(scope, 'agentfootprint.agent.route_decided', {
-        turnIndex: 0,
-        iterIndex: iteration,
+    return {
         chosen,
         rationale: chosen === 'tool-calls'
             ? `LLM requested ${toolCalls.length} tool call(s)`
             : iteration >= scope.maxIterations
                 ? 'maxIterations reached — forcing final'
                 : 'LLM produced no tool calls — final answer',
+    };
+}
+function emitRouteDecided(scope, chosen, rationale) {
+    typedEmit(scope, 'agentfootprint.agent.route_decided', {
+        turnIndex: 0,
+        iterIndex: scope.iteration,
+        chosen,
+        rationale,
     });
+}
+export const routeDeciderStage = (scope) => {
+    const { chosen, rationale } = decideBranch(scope);
+    emitRouteDecided(scope, chosen, rationale);
     return chosen;
 };
 /**
@@ -57,11 +72,28 @@ export const routeDeciderStage = (scope) => {
  * would be running it over something that is not the output.
  *
  * Empty chain → the exact synchronous decider this file has always exported.
+ *
+ * ## Why the schema is judged HERE too
+ *
+ * The same property that made this the output seam makes it the enforcement
+ * seam. `outputSchema` used to be judged only at the caller's boundary, after
+ * the run — a fine place to reject an answer and a useless place to fix one,
+ * because the loop has already stopped. Judged here, one stage before the
+ * Final branch, the run still HAS a loop: a failed answer can route to
+ * `'output-retry'`, which loops back for one more real turn.
+ *
+ * The judging runs AFTER the message chain, over the content the chain
+ * produced, because that is the string the caller will receive — validating
+ * the pre-chain value would judge an answer nobody gets. A DENIED answer is
+ * never judged or retried: it was withheld on purpose, and re-asking for it
+ * would be the library working around a rule the app wrote.
  */
-export function buildRouteDeciderStage(messageMiddleware) {
+export function buildRouteDeciderStage(messageMiddleware, enforcement) {
     const chain = messageMiddleware ?? [];
-    if (chain.length === 0)
+    if (chain.length === 0 && enforcement === undefined)
         return routeDeciderStage;
+    if (enforcement !== undefined)
+        return buildEnforcingDecider(chain, enforcement);
     return async (scope) => {
         const chosen = routeDeciderStage(scope);
         if (chosen !== 'final')
@@ -89,4 +121,77 @@ export function buildRouteDeciderStage(messageMiddleware) {
         return chosen;
     };
 }
+/**
+ * The decider an agent with `.outputSchema(parser, { retries })` runs:
+ * decide, run the output chain if there is one, judge the answer, THEN
+ * announce the branch — so `route_decided` names the branch the run actually
+ * took rather than the one it was heading for.
+ */
+function buildEnforcingDecider(chain, enforcement) {
+    return async (scope) => {
+        const base = decideBranch(scope);
+        if (base.chosen !== 'final') {
+            emitRouteDecided(scope, base.chosen, base.rationale);
+            return base.chosen;
+        }
+        let denied = false;
+        if (chain.length > 0) {
+            const verdict = await runMessageChain(chain, {
+                phase: 'output',
+                content: scope.llmLatestContent,
+                history: [...scope.history],
+                iteration: scope.iteration,
+                ...(scope.runIdentity && { identity: scope.runIdentity }),
+            });
+            recordDecisions(scope, verdict.decisions);
+            if (verdict.kind === 'deny') {
+                denied = true;
+                scope.messageDeniedReason = verdict.reason;
+                scope.messageDeniedPhase = 'output';
+                scope.messageDeniedBy = verdict.middleware;
+            }
+            scope.llmLatestContent = verdict.content;
+        }
+        // A withheld answer is not judged and never re-asked. The app decided
+        // nobody gets this string; asking the model for a better-shaped version
+        // of it would be the library routing around that decision.
+        if (denied) {
+            emitRouteDecided(scope, 'final', base.rationale);
+            return 'final';
+        }
+        const attempt = (scope.outputAttempts?.length ?? 0) + 1;
+        const failure = judgeAnswer(scope.llmLatestContent, enforcement.parser);
+        if (failure === undefined) {
+            recordOutputAttempt(scope, {
+                attempt,
+                iteration: scope.iteration,
+                outcome: 'passed',
+            });
+            emitRouteDecided(scope, 'final', base.rationale);
+            return 'final';
+        }
+        if (attempt <= enforcement.retries) {
+            // The retry stage writes the correction and files the row, because it
+            // is the one that knows what it wrote. This is the hand-off.
+            scope.outputSchemaFailure = { attempt, ...failure };
+            emitRouteDecided(scope, 'output-retry', `final answer failed the output schema (${failure.stage}) — ` +
+                `asking again, attempt ${attempt + 1} of ${enforcement.retries + 1}`);
+            return 'output-retry';
+        }
+        // Out of retries. The answer stands as the run's answer; `runTyped()`
+        // throws on it at the boundary exactly as it did before any of this
+        // existed, and `.outputFallback()` still gets its turn there.
+        recordOutputAttempt(scope, {
+            attempt,
+            iteration: scope.iteration,
+            outcome: 'exhausted',
+            stage: failure.stage,
+            error: failure.error,
+            ...(failure.path !== undefined && { path: failure.path }),
+        });
+        emitRouteDecided(scope, 'final', `final answer failed the output schema (${failure.stage}) and ` +
+            `${enforcement.retries} retry/retries were spent`);
+        return 'final';
+    };
+}
 //# sourceMappingURL=route.js.map

package/dist/esm/core/agent/stages/route.js.map

@@ -1 +1 @@
-{"version":3,"file":"route.js","sourceRoot":"","sources":["../../../../../src/core/agent/stages/route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAIjE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAI1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAA6B,EAAe,EAAE;IAC9E,MAAM,SAAS,GAAG,KAAK,CAAC,kBAAiD,CAAC;IAC1E,MAAM,SAAS,GAAG,KAAK,CAAC,SAAmB,CAAC;IAC5C,MAAM,MAAM,GACV,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC;IAEnF,SAAS,CAAC,KAAK,EAAE,oCAAoC,EAAE;QACrD,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,SAAS;QACpB,MAAM;QACN,SAAS,EACP,MAAM,KAAK,YAAY;YACrB,CAAC,CAAC,iBAAiB,SAAS,CAAC,MAAM,eAAe;YAClD,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,aAAa;gBAClC,CAAC,CAAC,uCAAuC;gBACzC,CAAC,CAAC,2CAA2C;KAClD,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,sBAAsB,CACpC,iBAAgD;IAEhD,MAAM,KAAK,GAAG,iBAAiB,IAAI,EAAE,CAAC;IACtC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,iBAAiB,CAAC;IACjD,OAAO,KAAK,EAAE,KAAK,EAAE,EAAE;QACrB,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO,MAAM,CAAC;QAEtC,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE;YAC3C,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,KAAK,CAAC,gBAAgB;YAC/B,OAAO,EAAE,CAAC,GAAI,KAAK,CAAC,OAAiC,CAAC;YACtD,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;SAC1D,CAAC,CAAC;QACH,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5B,uEAAuE;YACvE,wEAAwE;YACxE,yEAAyE;YACzE,sEAAsE;YACtE,KAAK,CAAC,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;YAC3C,KAAK,CAAC,kBAAkB,GAAG,QAAQ,CAAC;YACpC,KAAK,CAAC,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;QAC7C,CAAC;QACD,wEAAwE;QACxE,qDAAqD;QACrD,KAAK,CAAC,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;QACzC,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../../../../src/core/agent/stages/route.ts"],"names":[],"mappings":"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"}

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

@@ -21,6 +21,7 @@ import type { ReliabilityScope } from '../../reliability/types.js';
 import type { WindowRecord } from './window/types.js';
 import type { MessagesDelivery } from './delivery/types.js';
 import type { MiddlewareDecision } from './middleware/types.js';
+import type { OutputAttempt } from './outputEnforcement.js';
 /**
  * Dials for the deferred observer queue (RFC-001) — only meaningful with
  * `observerDelivery: 'deferred'` (passing them without it throws at
@@ -360,6 +361,23 @@ export interface AgentState {
      *  taken later can find the moment the text changed and who changed it.
      *  Written only by an agent that configured a chain; absent otherwise. */
     middlewareDecisions?: readonly MiddlewareDecision[];
+    /** One row per final-answer attempt, in order: what was answered, whether
+     *  it satisfied the schema, and — when it did not — the validator's own
+     *  words and the correction that went back. Read it from
+     *  `snapshot.sharedState` to see why a run took three turns to answer.
+     *  Written only by an agent that opted into `retries`; absent otherwise. */
+    outputAttempts?: readonly OutputAttempt[];
+    /** In-flight hand-off from the Route decider (which judges the answer and
+     *  picks the branch) to the retry stage (which writes the correction). Not
+     *  a record — the record is `outputAttempts`. Always freshly written by the
+     *  decider immediately before the retry branch runs, so it is never read
+     *  stale. */
+    outputSchemaFailure?: {
+        readonly attempt: number;
+        readonly stage: 'json-parse' | 'schema-validate';
+        readonly error: string;
+        readonly path?: string;
+    };
     /** Set by the seed / prepare-final stage when a `messageMiddleware` returned
      *  `deny`. Read at the API boundary, where it becomes a `MessageDeniedError`.
      *  Never carries the refused content — see MessageDeniedError. */

package/dist/esm/core/outputSchema.d.ts

@@ -69,6 +69,21 @@ export interface OutputSchemaParser<T> {
      */
     readonly description?: string;
 }
+/**
+ * How the schema reaches the model.
+ *
+ *   • `'instruct'` (default) — the shape is described in the system prompt
+ *     and the model is asked for JSON. Works on every provider, because it
+ *     is only words.
+ *   • `'tool-forced'` — the shape is presented as a synthetic tool and the
+ *     provider's tool choice is FORCED to it, so generation is constrained
+ *     at the source instead of requested in prose. Requires a provider that
+ *     declares `carriesForcedToolChoice`; a provider that does not is
+ *     refused BY NAME at run start rather than quietly downgraded, because
+ *     a strategy that silently falls back to the other one is config that
+ *     lies.
+ */
+export type OutputSchemaStrategy = 'instruct' | 'tool-forced';
 /**
  * Optional configuration for `outputSchema`.
  */
@@ -88,6 +103,42 @@ export interface OutputSchemaOptions {
      * domain-specific framing.
      */
     readonly instruction?: string;
+    /**
+     * How many corrective re-asks the run may spend when the final answer
+     * fails the schema. Default `0` — the historical behaviour, where the
+     * first answer is the only answer and `runTyped()` throws on a bad one.
+     *
+     * Each retry is a REAL turn: the failed answer and an authored corrective
+     * message join the conversation, the ReAct loop re-enters, and the next
+     * attempt gets its own `llm_start`/`llm_end` bracket and its own
+     * `cost.tick` against `costBudget`. A retry therefore consumes one
+     * iteration of the agent's budget, the same way a tool call does.
+     *
+     * When the cap is spent the last answer stands and `runTyped()` throws
+     * `OutputSchemaError` exactly as it always has — `.outputFallback()`
+     * composes on top, unchanged.
+     */
+    readonly retries?: number;
+    /**
+     * How the schema reaches the model. Default `'instruct'`.
+     * See {@link OutputSchemaStrategy}.
+     */
+    readonly strategy?: OutputSchemaStrategy;
+    /**
+     * The JSON Schema for the synthetic tool, required by
+     * `strategy: 'tool-forced'` unless the parser can produce one itself
+     * (a `toJsonSchema()` method, which ArkType has). The library will not
+     * infer a shape from a `parse()` function — guessing what your schema
+     * means is not a thing it gets to do.
+     *
+     * This value and the parser CAN disagree. Nothing here prevents that,
+     * and nothing needs to: the forced shape satisfies the wire, the parser
+     * still judges the answer, and a disagreement surfaces as an ordinary
+     * validation failure that the retry loop corrects using the validator's
+     * own words. The schema constrains generation; the parser remains the
+     * judge.
+     */
+    readonly jsonSchema?: Readonly<Record<string, unknown>>;
 }
 /**
  * Thrown by `agent.parseOutput(...)` / `agent.runTyped(...)` when the

package/dist/esm/core/outputSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"outputSchema.js","sourceRoot":"","sources":["../../../src/core/outputSchema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AA6CH;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,SAAS,CAAS;IAClB,KAAK,CAAmC;IAC/B,KAAK,CAAW;IAElC,YACE,OAAe,EACf,IAAqF;QAErF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACxD,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAmC;IACzE,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,sBAAsB,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACnF,OAAO,CACL,2DAA2D;QAC3D,6DAA6D;QAC7D,IAAI,CACL,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAI,GAAW,EAAE,MAA6B;IAC7E,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,iBAAiB,CACzB,gFAAgF,EAChF,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAC/C,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,iBAAiB,CAAC,iEAAiE,EAAE;YAC7F,SAAS,EAAE,GAAG;YACd,KAAK,EAAE,iBAAiB;YACxB,KAAK;SACN,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}
+{"version":3,"file":"outputSchema.js","sourceRoot":"","sources":["../../../src/core/outputSchema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAiGH;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,SAAS,CAAS;IAClB,KAAK,CAAmC;IAC/B,KAAK,CAAW;IAElC,YACE,OAAe,EACf,IAAqF;QAErF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACxD,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAmC;IACzE,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,sBAAsB,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACnF,OAAO,CACL,2DAA2D;QAC3D,6DAA6D;QAC7D,IAAI,CACL,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAI,GAAW,EAAE,MAA6B;IAC7E,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,iBAAiB,CACzB,gFAAgF,EAChF,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAC/C,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,iBAAiB,CAAC,iEAAiE,EAAE;YAC7F,SAAS,EAAE,GAAG;YACd,KAAK,EAAE,iBAAiB;YACxB,KAAK;SACN,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/esm/events/payloads.d.ts

@@ -106,7 +106,13 @@ export interface AgentIterationEndPayload {
 export interface AgentRouteDecidedPayload {
     readonly turnIndex: number;
     readonly iterIndex: number;
-    readonly chosen: 'tool-calls' | 'final';
+    /**
+     * The branch the turn took. `'output-retry'` (7.26) appears only on an
+     * agent built with `.outputSchema(parser, { retries })`, and only on a
+     * turn whose answer failed the schema with retries left — the loop is
+     * about to ask again rather than finish.
+     */
+    readonly chosen: 'tool-calls' | 'final' | 'output-retry';
     readonly rationale?: string;
 }
 export interface AgentHandoffPayload {
@@ -621,6 +627,46 @@ export interface EvalThresholdCrossedPayload {
  * Fires BEFORE PostDecide rules evaluate, so observability sees the
  * failure even if a buggy rule routes to fail-fast or swallows it.
  */
+/**
+ * Emitted (7.26) once per failed final answer that the run is about to
+ * ASK AGAIN about, on an agent built with
+ * `.outputSchema(parser, { retries })`.
+ *
+ * Its sibling `agent.output_schema_validation_failed` reports a failure the
+ * reliability gate is handling INSIDE one `call-llm` stage. This one reports
+ * a failure the LOOP is handling: the corrective message named here joins the
+ * conversation, the ReAct loop re-enters, and the next attempt arrives with
+ * its own `stream.llm_start` / `stream.llm_end` bracket and its own
+ * `cost.tick`. Subscribe to it to see how often a model needs a second ask —
+ * a leading indicator of drift, and of a schema that is harder to hit than
+ * its author thinks.
+ *
+ * Fires from the retry branch, after the corrective turn is committed, so a
+ * consumer that reads `snapshot.sharedState.outputAttempts` finds the
+ * matching row (joined by `correctiveMessageHash`) already there.
+ */
+export interface AgentOutputSchemaRetryPayload {
+    /** 1-based attempt that just failed. `1` is the first answer. */
+    readonly attempt: number;
+    /** Corrective asks left AFTER this one. `0` means this is the last. */
+    readonly retriesRemaining: number;
+    /** The ReAct iteration the failed answer came from. A retry consumes an
+     *  iteration, so the next attempt reports `iteration + 1`. */
+    readonly iteration: number;
+    /** Which half of validation failed — `'json-parse'` (the model emitted
+     *  prose) vs `'schema-validate'` (JSON, wrong shape). They trend
+     *  differently under model drift. */
+    readonly stage: 'json-parse' | 'schema-validate';
+    /** The validator's own message, verbatim. DATA, not narrative: it is
+     *  quoted into the corrective message after an authored frame, and it is
+     *  quoted here the same way. */
+    readonly error: string;
+    /** Failing field path when the parser exposes one (Zod-style issues). */
+    readonly path?: string;
+    /** `fnv1a` of the corrective message that went back to the model — the
+     *  join to the message in `history` and to the `outputAttempts` row. */
+    readonly correctiveMessageHash: string;
+}
 export interface AgentOutputSchemaValidationFailedPayload {
     /** Validation error message (from Zod / parser). */
     readonly message: string;

package/dist/esm/events/registry.d.ts

@@ -16,7 +16,7 @@
  * major bump. See agentfootprint_v2_detailed_design.md for rules.
  */
 import type { AgentfootprintEventEnvelope } from './types.js';
-import type { AgentHandoffPayload, AgentIterationEndPayload, AgentIterationStartPayload, AgentRouteDecidedPayload, AgentTurnEndPayload, AgentTurnStartPayload, CompositionEnterPayload, CompositionExitPayload, ConditionalRouteDecidedPayload, ContextBudgetPressurePayload, ContextEvaluatedPayload, ContextEvictedPayload, ContextInjectedPayload, ContextSlotComposedPayload, CostLimitHitPayload, CostTickPayload, EmbeddingGeneratedPayload, ErrorFatalPayload, ErrorRecoveredPayload, ErrorRetriedPayload, EvalScorePayload, EvalThresholdCrossedPayload, AgentOutputSchemaValidationFailedPayload, AgentThinkingParseFailedPayload, StreamThinkingDeltaPayload, StreamThinkingEndPayload, FallbackTriggeredPayload, LLMEndPayload, LLMStartPayload, LLMTokenPayload, LoopIterationExitPayload, LoopIterationStartPayload, MemoryAttachedPayload, MemoryDetachedPayload, MemoryStrategyAppliedPayload, MemoryWrittenPayload, ParallelBranchCompletePayload, ParallelForkStartPayload, ParallelMergeEndPayload, PauseRequestPayload, PauseResumePayload, CheckInRequestPayload, CheckInDecisionPayload, PermissionCheckPayload, PermissionGateClosedPayload, PermissionHaltPayload, PermissionGateOpenedPayload, CredentialRequestedPayload, CredentialAcquiredPayload, CredentialAuthorizationRequiredPayload, CredentialFailedPayload, ReliabilityFailFastPayload, ReliabilityRetriedPayload, ReliabilityRecoveredPayload, RiskFlaggedPayload, SkillActivatedPayload, SkillDeactivatedPayload, SkillRejectedPayload, ToolEndPayload, ToolsActivatedPayload, ToolsDeactivatedPayload, ToolsDiscoveryStartedPayload, ToolsDiscoveryCompletedPayload, ToolsDiscoveryFailedPayload, ToolsOfferedPayload, ToolStartPayload, ValidationArgsInvalidPayload, MiddlewareDecisionPayload } from './payloads.js';
+import type { AgentHandoffPayload, AgentIterationEndPayload, AgentIterationStartPayload, AgentRouteDecidedPayload, AgentTurnEndPayload, AgentTurnStartPayload, CompositionEnterPayload, CompositionExitPayload, ConditionalRouteDecidedPayload, ContextBudgetPressurePayload, ContextEvaluatedPayload, ContextEvictedPayload, ContextInjectedPayload, ContextSlotComposedPayload, CostLimitHitPayload, CostTickPayload, EmbeddingGeneratedPayload, ErrorFatalPayload, ErrorRecoveredPayload, ErrorRetriedPayload, EvalScorePayload, EvalThresholdCrossedPayload, AgentOutputSchemaValidationFailedPayload, AgentOutputSchemaRetryPayload, AgentThinkingParseFailedPayload, StreamThinkingDeltaPayload, StreamThinkingEndPayload, FallbackTriggeredPayload, LLMEndPayload, LLMStartPayload, LLMTokenPayload, LoopIterationExitPayload, LoopIterationStartPayload, MemoryAttachedPayload, MemoryDetachedPayload, MemoryStrategyAppliedPayload, MemoryWrittenPayload, ParallelBranchCompletePayload, ParallelForkStartPayload, ParallelMergeEndPayload, PauseRequestPayload, PauseResumePayload, CheckInRequestPayload, CheckInDecisionPayload, PermissionCheckPayload, PermissionGateClosedPayload, PermissionHaltPayload, PermissionGateOpenedPayload, CredentialRequestedPayload, CredentialAcquiredPayload, CredentialAuthorizationRequiredPayload, CredentialFailedPayload, ReliabilityFailFastPayload, ReliabilityRetriedPayload, ReliabilityRecoveredPayload, RiskFlaggedPayload, SkillActivatedPayload, SkillDeactivatedPayload, SkillRejectedPayload, ToolEndPayload, ToolsActivatedPayload, ToolsDeactivatedPayload, ToolsDiscoveryStartedPayload, ToolsDiscoveryCompletedPayload, ToolsDiscoveryFailedPayload, ToolsOfferedPayload, ToolStartPayload, ValidationArgsInvalidPayload, MiddlewareDecisionPayload } from './payloads.js';
 export declare const EVENT_NAMES: {
     readonly composition: {
         readonly enter: "agentfootprint.composition.enter";
@@ -36,6 +36,7 @@ export declare const EVENT_NAMES: {
         readonly routeDecided: "agentfootprint.agent.route_decided";
         readonly handoff: "agentfootprint.agent.handoff";
         readonly outputSchemaValidationFailed: "agentfootprint.agent.output_schema_validation_failed";
+        readonly outputSchemaRetry: "agentfootprint.agent.output_schema_retry";
         readonly thinkingParseFailed: "agentfootprint.agent.thinking_parse_failed";
     };
     readonly stream: {
@@ -143,6 +144,7 @@ export interface AgentfootprintEventMap {
     'agentfootprint.agent.route_decided': AgentfootprintEventEnvelope<'agentfootprint.agent.route_decided', AgentRouteDecidedPayload>;
     'agentfootprint.agent.handoff': AgentfootprintEventEnvelope<'agentfootprint.agent.handoff', AgentHandoffPayload>;
     'agentfootprint.agent.output_schema_validation_failed': AgentfootprintEventEnvelope<'agentfootprint.agent.output_schema_validation_failed', AgentOutputSchemaValidationFailedPayload>;
+    'agentfootprint.agent.output_schema_retry': AgentfootprintEventEnvelope<'agentfootprint.agent.output_schema_retry', AgentOutputSchemaRetryPayload>;
     'agentfootprint.agent.thinking_parse_failed': AgentfootprintEventEnvelope<'agentfootprint.agent.thinking_parse_failed', AgentThinkingParseFailedPayload>;
     'agentfootprint.stream.llm_start': AgentfootprintEventEnvelope<'agentfootprint.stream.llm_start', LLMStartPayload>;
     'agentfootprint.stream.llm_end': AgentfootprintEventEnvelope<'agentfootprint.stream.llm_end', LLMEndPayload>;

package/dist/esm/events/registry.js

@@ -37,6 +37,7 @@ export const EVENT_NAMES = {
         routeDecided: 'agentfootprint.agent.route_decided',
         handoff: 'agentfootprint.agent.handoff',
         outputSchemaValidationFailed: 'agentfootprint.agent.output_schema_validation_failed',
+        outputSchemaRetry: 'agentfootprint.agent.output_schema_retry',
         thinkingParseFailed: 'agentfootprint.agent.thinking_parse_failed',
     },
     stream: {
@@ -148,6 +149,7 @@ export const ALL_EVENT_TYPES = [
     'agentfootprint.agent.route_decided',
     'agentfootprint.agent.handoff',
     'agentfootprint.agent.output_schema_validation_failed',
+    'agentfootprint.agent.output_schema_retry',
     'agentfootprint.agent.thinking_parse_failed',
     'agentfootprint.stream.llm_start',
     'agentfootprint.stream.llm_end',

package/dist/esm/events/registry.js.map

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