agentfootprint 9.136.0 → 9.138.0

package/dist/esm/recorders/observability/recordRun.js

@@ -49,16 +49,19 @@
  *
  * WHAT IT DOES NOT DO
  * ───────────────────
- * It attaches no OTHER recorders. `narrative()` and `metrics()` are the
+ * It attaches no OTHER recorders by default. `narrative()` and `metrics()` are the
  * consumer's choice — their data rides the snapshot when attached, and
  * each viewer says so when it isn't there (a Gantt with no timings shows
  * execution ORDER and says so; a story panel falls back to "X executed.
  * Wrote: y"). Attaching them behind the consumer's back would make every
  * recording pay for panels most runs never open.
+ * The explicit `trustBoundaries` option adds typed metadata capture, not an
+ * engine attachment. Its bundle is overlaid only when exporting a recording.
  */
 import { DEFAULT_MAX_EVENTS, eventTail } from '../../events/eventTail.js';
 import { boundaryRecorder } from './BoundaryRecorder.js';
 import { summarizeEmbeddings } from './embeddingSummary.js';
+import { trustBoundaryRecorder, } from '../../lib/trust-boundaries/index.js';
 // FOLD · the one owner of the finished run's record — shared state, commit log and every attached recorder's data
 // consumers read this and never re-derive it: localObservability.ts's `includeSnapshot` branch and src/artifacts/recordingArtifact.ts, which stores the JSON TEXT
 // detached: NO for the snapshot half — parts of it are the runner's own objects by reference: the argument
@@ -82,9 +85,30 @@ import { summarizeEmbeddings } from './embeddingSummary.js';
  * ```
  */
 export function recordRun(runner, options = {}) {
-    return recordRunWhere(runner, keepEveryEvent, options);
+    // Only this opt-in door constructs the optional observer. The Agent's
+    // internal recording coordinator can stay on the default browser graph
+    // without making every consumer carry the trust capture implementation.
+    // Validate capture options before acquiring any subscriptions.
+    const trust = options.trustBoundaries
+        ? trustBoundaryRecorder(options.trustBoundaries === true ? {} : options.trustBoundaries)
+        : undefined;
+    return recordRunWhere(runner, keepEveryEvent, options, trust);
 }
 const keepEveryEvent = () => true;
+/** Dispose all acquired resources; an earlier operation's error stays primary. */
+function disposeSubscriptions(subscriptions, failure) {
+    let firstFailure = failure;
+    for (const unsubscribe of subscriptions) {
+        try {
+            unsubscribe();
+        }
+        catch (error) {
+            firstFailure ??= { error };
+        }
+    }
+    if (firstFailure)
+        throw firstFailure.error;
+}
 /**
  * {@link recordRun} with a timeline that keeps only the events `keep` admits —
  * the Agent's own per-run recording (`artifacts: { recordings: true }`) passes
@@ -94,74 +118,124 @@ const keepEveryEvent = () => true;
  * neither ever carried such a fact.
  *
  * @internal — the Agent's; not on any door. `recordRun` is the public producer
- * and records everything, as it always has.
+ * and records everything, as it always has. Optional typed capture is supplied
+ * by that public factory; this coordinator never constructs another observer.
  */
-export function recordRunWhere(runner, keep, options = {}) {
-    // 1. THE TIMELINE. Subscribed before the run so nothing is missed —
-    //    the dispatcher drops events with no listener rather than queuing
-    //    them, so a late subscription starts mid-story. The bounded tail
-    //    (cap + drop count) is the shared `eventTail` helper, so a
-    //    recording and the self-explaining agent's evidence keep the same
-    //    amount and report a shortfall the same way.
-    const tail = eventTail(options.maxEvents ?? DEFAULT_MAX_EVENTS);
-    const offEvents = runner.on('*', (event) => {
-        if (keep(event))
-            tail.push(event);
-    });
-    // 2. THE BOUNDARIES — all three connections, which is the whole reason
-    //    to call this instead of wiring it yourself. `getCommitCount` reads
-    //    through the runner on every boundary, so it reports the count at
-    //    that moment rather than a number captured now (when it is 0).
-    const keepEmbeddings = options.recordEmbeddings ?? false;
-    const boundary = boundaryRecorder({
-        getCommitCount: () => runner.getCommitCount(),
-        ...(options.boundaryDetail === 'lean' ? { snapshot: 'lean' } : {}),
-        ...(keepEmbeddings ? { recordEmbeddings: true } : {}),
-    });
-    const offAttach = runner.attach(boundary);
-    const offTyped = boundary.subscribe(runner);
-    let stopped = false;
-    return {
-        toRecording: () => ({
-            // Read at freeze time. Before the run there is no snapshot; during
-            // one it grows; after it, it is the finished run's. Unless
-            // `recordEmbeddings` asked for them, raw vectors are summarised to
-            // `{ dims, norm }` here — the snapshot's subflow results carry every
-            // retrieved entry's full vector otherwise, which is what made a
-            // single retrieval turn's recording weigh 2.76 MB in the field. The
-            // summarisation is copy-on-write: parts of the snapshot without
-            // embeddings are the runner's own objects, held by reference, as
-            // before — serialize to detach.
-            snapshot: keepEmbeddings
-                ? runner.getLastSnapshot()
-                : summarizeEmbeddings(runner.getLastSnapshot()),
-            events: keepEmbeddings
-                ? tail.snapshot().events
-                : summarizeEmbeddings(tail.snapshot().events),
-            // The one piece a run does not leave behind — it lives on the
-            // chart, which is built once and never changes.
-            structure: runner.getSpec().buildTimeStructure,
-        }),
-        boundary,
-        get eventCount() {
-            return tail.count;
-        },
-        get droppedEvents() {
-            return tail.dropped;
-        },
-        get firstRetainedEventIndex() {
-            return tail.firstRetainedIndex;
-        },
-        stop: () => {
-            // Idempotent: a consumer that stops in both a finally block and an
-            // unmount handler should not detach someone else's later recorder.
-            if (stopped)
-                return;
-            stopped = true;
-            offEvents();
-            offTyped();
-            offAttach();
-        },
-    };
+export function recordRunWhere(runner, keep, options = {}, trust) {
+    const subscriptions = [];
+    try {
+        // Fan out admitted events from the existing listener. Evaluate `keep` only
+        // once: a stateful membership callback must not admit the timeline but
+        // reject its corresponding fact on a second invocation.
+        let onTrustEvent;
+        const offTrust = trust?.subscribe({
+            on: (_type, listener) => {
+                onTrustEvent = listener;
+                return () => {
+                    onTrustEvent = undefined;
+                };
+            },
+        });
+        if (offTrust)
+            subscriptions.push(offTrust);
+        // 1. THE TIMELINE. Subscribed before the run so nothing is missed —
+        //    the dispatcher drops events with no listener rather than queuing
+        //    them, so a late subscription starts mid-story. The bounded tail
+        //    (cap + drop count) is the shared `eventTail` helper, so a
+        //    recording and the self-explaining agent's evidence keep the same
+        //    amount and report a shortfall the same way.
+        const tail = eventTail(options.maxEvents ?? DEFAULT_MAX_EVENTS);
+        const offEvents = runner.on('*', (event) => {
+            if (keep(event)) {
+                tail.push(event);
+                onTrustEvent?.(event);
+            }
+        });
+        subscriptions.push(offEvents);
+        // 2. THE BOUNDARIES — all three connections, which is the whole reason
+        //    to call this instead of wiring it yourself. `getCommitCount` reads
+        //    through the runner on every boundary, so it reports the count at
+        //    that moment rather than a number captured now (when it is 0).
+        const keepEmbeddings = options.recordEmbeddings ?? false;
+        const boundary = boundaryRecorder({
+            getCommitCount: () => runner.getCommitCount(),
+            ...(options.boundaryDetail === 'lean' ? { snapshot: 'lean' } : {}),
+            ...(keepEmbeddings ? { recordEmbeddings: true } : {}),
+        });
+        const offAttach = runner.attach(boundary);
+        subscriptions.push(offAttach);
+        const offTyped = boundary.subscribe(runner);
+        subscriptions.push(offTyped);
+        let stopped = false;
+        let stoppedSnapshot;
+        const snapshot = () => {
+            const base = stopped ? stoppedSnapshot : runner.getLastSnapshot();
+            const retained = (keepEmbeddings ? base : summarizeEmbeddings(base));
+            if (!trust || retained === undefined)
+                return retained;
+            // One export owner, one row per capture. Never alter the engine snapshot
+            // or replace another recorder's row just because it has the same name.
+            const recorders = retained.recorders ?? [];
+            if (recorders.some((row) => row.id === trust.id)) {
+                throw new Error(`Trust boundary recorder id '${trust.id}' conflicts with an existing recorder`);
+            }
+            return {
+                ...retained,
+                recorders: [...recorders, { id: trust.id, ...trust.toSnapshot() }],
+            };
+        };
+        return {
+            toRecording: () => ({
+                // Read at freeze time. Before the run there is no snapshot; during
+                // one it grows; after it, it is the finished run's. Unless
+                // `recordEmbeddings` asked for them, raw vectors are summarised to
+                // `{ dims, norm }` here — the snapshot's subflow results carry every
+                // retrieved entry's full vector otherwise, which is what made a
+                // single retrieval turn's recording weigh 2.76 MB in the field. The
+                // summarisation is copy-on-write: parts of the snapshot without
+                // embeddings are the runner's own objects, held by reference, as
+                // before — serialize to detach.
+                snapshot: snapshot(),
+                events: keepEmbeddings
+                    ? tail.snapshot().events
+                    : summarizeEmbeddings(tail.snapshot().events),
+                // The one piece a run does not leave behind — it lives on the
+                // chart, which is built once and never changes.
+                structure: runner.getSpec().buildTimeStructure,
+            }),
+            boundary,
+            ...(trust ? { trustBoundaries: trust } : {}),
+            get eventCount() {
+                return tail.count;
+            },
+            get droppedEvents() {
+                return tail.dropped;
+            },
+            get firstRetainedEventIndex() {
+                return tail.firstRetainedIndex;
+            },
+            stop: () => {
+                // Idempotent: a consumer that stops in both a finally block and an
+                // unmount handler should not detach someone else's later recorder.
+                if (stopped)
+                    return;
+                stopped = true;
+                // The timeline and the boundary log end here, so the snapshot does
+                // too: a reused runner's later log is never paired with these events.
+                let failure;
+                try {
+                    stoppedSnapshot = runner.getLastSnapshot();
+                }
+                catch (error) {
+                    failure = { error };
+                }
+                disposeSubscriptions(subscriptions, failure);
+            },
+        };
+    }
+    catch (error) {
+        disposeSubscriptions(subscriptions, { error });
+        throw error;
+    }
 }
 //# sourceMappingURL=recordRun.js.map

package/dist/esm/recorders/observability/recordRun.js.map

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

package/dist/esm/recorders/observability/recordingEnvelope.js

@@ -102,9 +102,11 @@ export class UnsupportedPrivacyModeError extends Error {
             `that admits it is raw, so silently storing the raw bytes under that label is the ` +
             `worse outcome, not the convenient one.\n\n` +
             `Either persist with privacy: { mode: 'full' } and hold the result under the rules raw ` +
-            `run data needs, or redact BEFORE persisting — recordRun(agent, { boundaryDetail: ` +
-            `'lean' }) captures no payloads in the first place, and serializeTrace/redactContent ` +
-            `redact at the serialize boundary.`);
+            `run data needs, or minimize/redact EVERY exported channel before persisting. ` +
+            `recordRun(agent, { boundaryDetail: 'lean' }) removes captured content only from ` +
+            `BoundaryEvents; the event tail and engine state can still contain raw content. ` +
+            `serializeTrace/redactContent operate on their own projection, not an arbitrary ` +
+            `whole recording.`);
         this.name = 'UnsupportedPrivacyModeError';
         this.mode = mode;
     }

package/dist/esm/recorders/observability/recordingEnvelope.js.map

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

package/dist/esm/reliability/failFastRecord.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The fail-fast RECORD and the one error it becomes.
+ *
+ * The reliability loop (`core/agent/stages/reliabilityExecution.ts · failFast`)
+ * ends a run by writing this record and breaking. Whoever owns the run's
+ * outcome turns it into `ReliabilityFailFastError`: the agent's own run
+ * boundary (`Agent · finalizeResult`), or a composition the agent runs inside
+ * (`core-flow/childFailFast.ts`). Every chart boundary between the two carries
+ * the record across — a record left behind a boundary is a run that ends
+ * "successfully" with no answer.
+ */
+import type { AgentState } from '../core/agent/types.js';
+import { ReliabilityFailFastError } from './types.js';
+/** The keys of the record, listed once and checked against `AgentState`. */
+export declare const RELIABILITY_FAIL_KEYS: readonly ["reliabilityFailKind", "reliabilityFailPayload", "reliabilityFailReason", "reliabilityFailCauseMessage", "reliabilityFailCauseName"];
+/** The fail-fast record as a state holds it. */
+export type ReliabilityFailRecord = Pick<AgentState, (typeof RELIABILITY_FAIL_KEYS)[number]>;
+/**
+ * The fail-fast record a state holds: its present keys, or nothing when no
+ * fail-fast fired — so a boundary that spreads it crosses no new key otherwise.
+ */
+export declare function failFastRecordOf(state: Readonly<Record<string, unknown>>): ReliabilityFailRecord | undefined;
+/**
+ * The error a fail-fast record becomes. The cause is rebuilt from the message
+ * and name the record keeps — an `Error` does not survive the state's
+ * `structuredClone`, so the record never held the original.
+ */
+export declare function failFastErrorOf(record: ReliabilityFailRecord, snapshot?: unknown): ReliabilityFailFastError;

package/dist/esm/reliability/failFastRecord.js

@@ -0,0 +1,45 @@
+import { ReliabilityFailFastError } from './types.js';
+/** The keys of the record, listed once and checked against `AgentState`. */
+export const RELIABILITY_FAIL_KEYS = [
+    'reliabilityFailKind',
+    'reliabilityFailPayload',
+    'reliabilityFailReason',
+    'reliabilityFailCauseMessage',
+    'reliabilityFailCauseName',
+];
+/**
+ * The fail-fast record a state holds: its present keys, or nothing when no
+ * fail-fast fired — so a boundary that spreads it crosses no new key otherwise.
+ */
+export function failFastRecordOf(state) {
+    if (state.reliabilityFailKind === undefined)
+        return undefined;
+    const record = {};
+    for (const key of RELIABILITY_FAIL_KEYS) {
+        if (state[key] !== undefined)
+            record[key] = state[key];
+    }
+    return record;
+}
+/**
+ * The error a fail-fast record becomes. The cause is rebuilt from the message
+ * and name the record keeps — an `Error` does not survive the state's
+ * `structuredClone`, so the record never held the original.
+ */
+export function failFastErrorOf(record, snapshot) {
+    const kind = record.reliabilityFailKind ?? 'unknown';
+    let cause;
+    if (record.reliabilityFailCauseMessage !== undefined) {
+        cause = new Error(record.reliabilityFailCauseMessage);
+        if (record.reliabilityFailCauseName !== undefined)
+            cause.name = record.reliabilityFailCauseName;
+    }
+    return new ReliabilityFailFastError({
+        kind,
+        reason: record.reliabilityFailReason ?? kind,
+        ...(cause !== undefined && { cause }),
+        ...(record.reliabilityFailPayload !== undefined && { payload: record.reliabilityFailPayload }),
+        ...(snapshot !== undefined && { snapshot }),
+    });
+}
+//# sourceMappingURL=failFastRecord.js.map

package/dist/esm/reliability/failFastRecord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failFastRecord.js","sourceRoot":"","sources":["../../../src/reliability/failFastRecord.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,qBAAqB;IACrB,wBAAwB;IACxB,uBAAuB;IACvB,6BAA6B;IAC7B,0BAA0B;CACsB,CAAC;AAKnD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAwC;IAExC,IAAI,KAAK,CAAC,mBAAmB,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC9D,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,qBAAqB,EAAE,CAAC;QACxC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,MAA+B,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,MAA6B,EAC7B,QAAkB;IAElB,MAAM,IAAI,GAAG,MAAM,CAAC,mBAAmB,IAAI,SAAS,CAAC;IACrD,IAAI,KAAwB,CAAC;IAC7B,IAAI,MAAM,CAAC,2BAA2B,KAAK,SAAS,EAAE,CAAC;QACrD,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACtD,IAAI,MAAM,CAAC,wBAAwB,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,wBAAwB,CAAC;IAClG,CAAC;IACD,OAAO,IAAI,wBAAwB,CAAC;QAClC,IAAI;QACJ,MAAM,EAAE,MAAM,CAAC,qBAAqB,IAAI,IAAI;QAC5C,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC;QACrC,GAAG,CAAC,MAAM,CAAC,sBAAsB,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,sBAAsB,EAAE,CAAC;QAC9F,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;KAC5C,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/resilience/withCircuitBreaker.js

@@ -239,6 +239,9 @@ export function withCircuitBreaker(inner, options = {}) {
         ...(inner.carriesForcedToolChoice !== undefined && {
             carriesForcedToolChoice: inner.carriesForcedToolChoice,
         }),
+        // And for prompt caching: a breaker never changes what reaches the wire.
+        ...(inner.promptCaching !== undefined && { promptCaching: inner.promptCaching }),
+        ...(inner.thinkingHandler !== undefined && { thinkingHandler: inner.thinkingHandler }),
         async complete(req, hooks) {
             rejectFastIfOpen(hooks);
             try {

package/dist/esm/resilience/withCircuitBreaker.js.map

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

package/dist/esm/resilience/withFallback.js

@@ -39,6 +39,79 @@ function carriedByBoth(a, b) {
     const right = new Set(b.carriesInMessages ?? DEFAULT_CARRIES_IN_MESSAGES);
     return Object.freeze(left.filter((role) => right.has(role)));
 }
+/**
+ * The prompt caching of a pair where either side may serve the call.
+ *
+ * A COST hint, not a meaning: the pair asks the agent for breakpoints when
+ * EITHER side takes them (clamped to the smaller count when both do), and is
+ * automatic when either side caches on its own. Each side is then handed only
+ * what IT declares (`requestFor`) — a side that declared nothing never sees a
+ * `cacheMarkers` field. Usage is reported when either side reports it — a
+ * call the other side served then reads as *unmeasured*, never as a zero.
+ */
+function cachingOfPair(a, b) {
+    const sides = [a.promptCaching, b.promptCaching].filter((c) => c !== undefined);
+    if (sides.length === 0)
+        return undefined;
+    const reportsUsage = sides.some((c) => c.reportsUsage);
+    const breakpoints = sides.flatMap((c) => (c.mode === 'breakpoints' ? [c.maxBreakpoints] : []));
+    if (breakpoints.length > 0) {
+        return Object.freeze({
+            mode: 'breakpoints',
+            maxBreakpoints: Math.min(...breakpoints),
+            reportsUsage,
+        });
+    }
+    return Object.freeze({ mode: 'automatic', reportsUsage });
+}
+/**
+ * The request as ONE side can take it: markers only for a side that declares
+ * breakpoints, sliced to its own count; stripped for any other side.
+ */
+function requestFor(side, req) {
+    const markers = req.cacheMarkers;
+    if (markers === undefined)
+        return req;
+    const caching = side.promptCaching;
+    if (caching?.mode === 'breakpoints') {
+        return markers.length <= caching.maxBreakpoints
+            ? req
+            : { ...req, cacheMarkers: markers.slice(0, caching.maxBreakpoints) };
+    }
+    const rest = { ...req };
+    delete rest.cacheMarkers;
+    return rest;
+}
+function isAnswered(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return false;
+    const by = raw.answeredBy;
+    return (by === 'primary' || by === 'fallback') && 'raw' in raw;
+}
+/**
+ * The thinking handler of a pair. The same handler on both sides is the
+ * pair's. Different handlers (or one side with none) get a DISPATCHING
+ * handler: the pair tags each response's `rawThinking` with the side that
+ * answered (`AnsweredThinking`), and the handler runs that side's own — one
+ * wire's handler on the other's thinking would mis-read it, and dropping
+ * both lost the signed blocks the next call must echo.
+ */
+function thinkingOfPair(a, b) {
+    const [ha, hb] = [a.thinkingHandler, b.thinkingHandler];
+    if (ha === hb)
+        return ha;
+    return {
+        id: `${ha?.id ?? 'none'}-or-${hb?.id ?? 'none'}`,
+        normalize(raw) {
+            if (!isAnswered(raw)) {
+                throw new TypeError("withFallback: this thinking does not say which side answered, so neither side's " +
+                    'handler can read it');
+            }
+            const handler = raw.answeredBy === 'primary' ? ha : hb;
+            return handler === undefined ? [] : handler.normalize(raw.raw);
+        },
+    };
+}
 /**
  * Wrap a primary provider with a fallback. Tries primary first; on
  * error matching the policy, calls the fallback.
@@ -68,6 +141,20 @@ export function withFallback(primary, fallback, options = {}) {
             reason: err instanceof Error ? err.message : String(err),
         });
     }
+    const promptCaching = cachingOfPair(primary, fallback);
+    const thinkingHandler = thinkingOfPair(primary, fallback);
+    const tagsThinking = primary.thinkingHandler !== fallback.thinkingHandler;
+    /** A response as the pair returns it: thinking tagged when the sides differ. */
+    const answered = (res, side) => tagsThinking && res.rawThinking !== undefined
+        ? { ...res, rawThinking: { answeredBy: side, raw: res.rawThinking } }
+        : res;
+    async function* answeredStream(chunks, side) {
+        for await (const chunk of chunks) {
+            yield chunk.response === undefined
+                ? chunk
+                : { ...chunk, response: answered(chunk.response, side) };
+        }
+    }
     const wrapped = {
         name: `${primary.name}|${fallback.name}`,
         // The INTERSECTION, and only the intersection. Either provider may serve
@@ -82,16 +169,21 @@ export function withFallback(primary, fallback, options = {}) {
         // declared partner and one silent one is a pair whose answer is shaped
         // some of the time, which is the shape of guarantee nobody can use.
         carriesForcedToolChoice: (primary.carriesForcedToolChoice ?? false) && (fallback.carriesForcedToolChoice ?? false),
+        // The combination, not the intersection — see `cachingOfPair`.
+        ...(promptCaching !== undefined && { promptCaching }),
+        // The side that answered decides which handler reads its thinking —
+        // see `thinkingOfPair`.
+        ...(thinkingHandler !== undefined && { thinkingHandler }),
         async complete(req, hooks) {
             try {
-                return await primary.complete(req, hooks);
+                return answered(await primary.complete(requestFor(primary, req), hooks), 'primary');
             }
             catch (err) {
                 if (!shouldFallback(err))
                     throw err;
                 onFallback?.(err);
                 reportFellBack(hooks, err);
-                return fallback.complete(req, hooks);
+                return answered(await fallback.complete(requestFor(fallback, req), hooks), 'fallback');
             }
         },
     };
@@ -104,16 +196,17 @@ export function withFallback(primary, fallback, options = {}) {
             // No primary stream support → fallback's stream (or its complete-only).
             // Reports NOTHING: nothing failed here, the primary simply has no
             // `stream()`. Calling this a fallback would be a lie.
+            const fallbackReq = requestFor(fallback, req);
+            const fromFallback = () => answeredStream(fallback.stream
+                ? fallback.stream(fallbackReq, hooks)
+                : completeAsStream(fallback, fallbackReq, hooks), 'fallback');
             if (!primary.stream) {
-                if (fallback.stream)
-                    yield* fallback.stream(req, hooks);
-                else
-                    yield* completeAsStream(fallback, req, hooks);
+                yield* fromFallback();
                 return;
             }
             let yieldedAny = false;
             try {
-                for await (const chunk of primary.stream(req, hooks)) {
+                for await (const chunk of answeredStream(primary.stream(requestFor(primary, req), hooks), 'primary')) {
                     yieldedAny = true;
                     yield chunk;
                 }
@@ -123,10 +216,7 @@ export function withFallback(primary, fallback, options = {}) {
                     throw err;
                 onFallback?.(err);
                 reportFellBack(hooks, err);
-                if (fallback.stream)
-                    yield* fallback.stream(req, hooks);
-                else
-                    yield* completeAsStream(fallback, req, hooks);
+                yield* fromFallback();
             }
         };
     }