agent-nuvira 3.3.13 → 3.3.14

package/dist/learning/exhaustion-report.js

@@ -0,0 +1,239 @@
+/**
+ * The honest EXHAUSTION REPORT (fix_model_routing P4, invariants 2, 4 and 7).
+ *
+ * WHY THIS EXISTS. When every reachable model has been tried and the task is
+ * still not delivered, the old answer was a one-line apology plus — worse — a
+ * question: *"Want me to retry? Reply yes."* That makes the USER the retry
+ * button, which is the single clearest way to fail them: a competent operator
+ * does not walk back to the requester to ask permission to try the next worker,
+ * and they certainly do not do it after the requester already asked once. The
+ * user's own words: *"if user need to say retry that we are failing."*
+ *
+ * So the report's job is to say, in plain language and with NO follow-up
+ * question:
+ *
+ *   1. what was tried, per model, and why each one did not answer;
+ *   2. which targets are exhausted vs. DEAD vs. merely COOLING DOWN, and the
+ *      WALL-CLOCK TIME each cooling one frees up (a wait length is unactionable;
+ *      "free at 18:42" is something a person can plan around);
+ *   3. what the system itself is doing about it (routing to an untried model,
+ *      or waiting for a window) — stated as the system's job, not the user's;
+ *   4. the concrete levers only the user can pull: recharge/replace a rejected
+ *      credential, knowingly accept a weaker model, or narrow the ask.
+ *
+ * DETERMINISTIC AND LLM-FREE on purpose. A failure explanation that is itself
+ * generated can hallucinate a reason or a time, and this text is the only thing
+ * the user has left to trust. Every line here comes from measured state: the
+ * failover walk's own attempt log, the routing exclusion ledger, and the pool
+ * count — the SAME sources enforcement reads, so the report can never disagree
+ * with what routing actually did.
+ *
+ * It DELIBERATELY does not duplicate `renderModelBreadthReport`'s job of
+ * explaining a failure to a caller that still has a retry mechanism available;
+ * it is the terminal, "there is nothing left" message, and its distinguishing
+ * features are the absolute clocks, the named levers and the refusal to ask the
+ * user to trigger anything.
+ */
+/** `18:42` in the operator's own clock. Deterministic given a timestamp. */
+export function formatClockTime(ts) {
+    const d = new Date(ts);
+    const hh = String(d.getHours()).padStart(2, '0');
+    const mm = String(d.getMinutes()).padStart(2, '0');
+    return `${hh}:${mm}`;
+}
+/** `2m`, `55m`, `3h` — a wait a person can read. */
+export function formatWaitShort(ms) {
+    if (ms < 60_000)
+        return `${Math.max(1, Math.round(ms / 1000))}s`;
+    if (ms < 3_600_000)
+        return `${Math.round(ms / 60_000)}m`;
+    return `${Math.round(ms / 3_600_000)}h`;
+}
+/**
+ * A phrase for a failure kind, in the vocabulary the user can act on.
+ *
+ * Exported so a caller RECORDING an attempt (chat's own walk) writes the same
+ * words the report will print — the alternative is a raw provider message
+ * reaching the user, which is how a JSON quota dump once got delivered verbatim
+ * as an answer.
+ */
+export function describeFailureKind(kind) {
+    switch (kind) {
+        case 'empty-response':
+            return 'answered with nothing (no text, no tool call)';
+        case 'rate-limit':
+            return 'out of quota for now';
+        case 'auth':
+            return 'rejected its credential';
+        case 'timeout':
+            return 'timed out';
+        case 'network':
+            return 'unreachable (network)';
+        case 'model-not-found':
+            return 'model not found on that provider';
+        case 'context-window':
+            return 'the prompt was too large for its window';
+        case 'server':
+            return 'provider-side error';
+        case 'skipped':
+            return 'was not tried';
+        default:
+            return kind && kind !== 'unknown' ? kind : 'failed';
+    }
+}
+/**
+ * Build the report. Pure: same inputs, same text — no clock reads, no network,
+ * no model call (pass `now` explicitly; absent means "measured here").
+ */
+export function buildExhaustionReport(input) {
+    const now = input.now ?? Date.now();
+    const attempts = input.attempts ?? [];
+    const exclusions = input.exclusions ?? [];
+    const triedAttempts = attempts.filter((a) => !a.skipped);
+    const skippedAttempts = attempts.filter((a) => a.skipped);
+    const isRuling = (e) => e.source === 'registry' && !!e.model;
+    const retired = exclusions.filter(isRuling).map((e) => `${e.provider}/${e.model}`);
+    const cooling = exclusions.filter((e) => !isRuling(e));
+    const tried = triedAttempts.map((a) => {
+        const reason = a.reason?.trim() ? a.reason : describeFailureKind(a.kind);
+        return `${a.provider}/${a.model} — ${reason}`;
+    });
+    const unavailable = [];
+    for (const e of cooling) {
+        const target = e.model ? `${e.provider}/${e.model}` : e.provider;
+        const freeAt = e.expiresAt && e.expiresAt > now ? e.expiresAt : undefined;
+        unavailable.push({
+            target,
+            reason: describeFailureKind(e.kind),
+            ...(freeAt ? { freeAt } : {}),
+        });
+    }
+    // Every exclusion that will heal is a legitimate wait option; take the soonest.
+    const nextFreeAt = unavailable.reduce((acc, u) => (u.freeAt === undefined ? acc : acc === undefined || u.freeAt < acc ? u.freeAt : acc), undefined);
+    const poolMeasured = typeof input.poolSize === 'number';
+    const poolSize = input.poolSize ?? 0;
+    const poolProviders = input.poolProviders ?? 0;
+    // A routing gap: the pool was measured, models were reached, and eligible
+    // models remained untouched. Presenting that as an outage is the dishonesty
+    // the user called out when a healthy pool sat unused behind "no model
+    // available".
+    const routingGap = poolMeasured && triedAttempts.length > 0 && poolSize > triedAttempts.length;
+    const emptyPool = poolMeasured && poolSize === 0;
+    const parts = [];
+    const attemptCount = triedAttempts.length;
+    parts.push(input.task
+        ? `I couldn't finish: ${input.task.slice(0, 120)}`
+        : "I couldn't finish this one.");
+    const cause = input.cause?.trim();
+    if (cause)
+        parts.push(`Reason: ${cause}`);
+    if (attemptCount > 0) {
+        parts.push('');
+        parts.push(`Tried ${attemptCount} model${attemptCount === 1 ? '' : 's'}, and every one of them was unable to do it:`);
+        for (const line of tried.slice(0, 8))
+            parts.push(`  • ${line}`);
+        if (tried.length > 8)
+            parts.push(`  • …and ${tried.length - 8} more`);
+    }
+    else if (skippedAttempts.length > 0) {
+        parts.push('');
+        parts.push(`No model could even be called: ${skippedAttempts.length} candidate${skippedAttempts.length === 1 ? ' was' : 's were'} ruled out before a request went out.`);
+    }
+    if (unavailable.length > 0) {
+        parts.push('');
+        parts.push('Unavailable right now, and when each comes back:');
+        for (const u of unavailable.slice(0, 8)) {
+            const when = u.freeAt ? `free at ${formatClockTime(u.freeAt)} (about ${formatWaitShort(u.freeAt - now)})` : 'no reset window — this one needs a fix, not patience';
+            parts.push(`  • ${u.target} — ${u.reason}; ${when}`);
+        }
+    }
+    if (retired.length > 0) {
+        parts.push('');
+        parts.push('Ruled out (that model does not exist on that provider):');
+        for (const r of retired.slice(0, 4))
+            parts.push(`  • ${r}`);
+    }
+    let poolClaim;
+    if (poolMeasured && !emptyPool) {
+        poolClaim = `${poolSize} model${poolSize === 1 ? '' : 's'} across ${poolProviders} provider${poolProviders === 1 ? '' : 's'} were eligible at the time.`;
+        parts.push('');
+        parts.push(poolClaim);
+    }
+    // ── What the SYSTEM is doing (never a question to the user) ──────────────
+    parts.push('');
+    if (routingGap) {
+        parts.push(`This was a routing gap, not a shortage: only ${attemptCount} of ${poolSize} eligible models were actually tried. The next attempt routes to an untried model automatically — you do not need to trigger anything.`);
+    }
+    else if (emptyPool) {
+        parts.push('No model was eligible at all — the pool is empty (no usable credential, or every model is ruled out).');
+    }
+    else if (attemptCount === 0) {
+        parts.push('The model layer failed before it could try anything, which is a transport problem rather than a missing model.');
+    }
+    // ── The levers only the user can pull ────────────────────────────────────
+    const options = [];
+    const needsKey = exclusions.filter((e) => e.kind === 'auth');
+    if (needsKey.length > 0) {
+        options.push({
+            code: 'recharge',
+            text: `Recharge or replace the credential for ${[...new Set(needsKey.map((e) => e.provider))].join(', ')} — it was rejected, so no amount of waiting fixes it.`,
+        });
+    }
+    const quotaBound = exclusions.filter((e) => e.kind === 'rate-limit');
+    if (quotaBound.length > 0) {
+        options.push({
+            code: 'recharge',
+            text: `Raise the quota / add a key for ${[...new Set(quotaBound.map((e) => e.provider))].join(', ')} if you need this done sooner than their reset window.`,
+        });
+    }
+    if (nextFreeAt !== undefined) {
+        options.push({
+            code: 'wait',
+            text: `Wait — a capable model frees up at ${formatClockTime(nextFreeAt)}, about ${formatWaitShort(nextFreeAt - now)} from now. Ask again after that and it will be used automatically.`,
+        });
+    }
+    options.push({
+        code: 'weaker-model',
+        text: 'Allow a weaker or cheaper model for this task and accept that its answer may need more checking.',
+    });
+    options.push({
+        code: 'narrow',
+        text: 'Narrow the ask — one file, one change, or one question at a time — so a smaller (or cheaper) model can finish it.',
+    });
+    if (options.length > 0) {
+        parts.push('');
+        parts.push('Things that would unblock it:');
+        for (const o of options)
+            parts.push(`  • ${o.text}`);
+    }
+    return {
+        headline: parts[0],
+        tried,
+        unavailable,
+        retired,
+        ...(poolClaim ? { poolClaim } : {}),
+        routingGap,
+        ...(nextFreeAt !== undefined ? { nextFreeAt } : {}),
+        options,
+        text: parts.join('\n'),
+    };
+}
+/**
+ * The report, or `undefined` when there is genuinely nothing concrete to say.
+ *
+ * Silent-when-empty is deliberate: a caller that already has an actionable line
+ * ("the provider rejected the key") must keep it rather than trade it for an
+ * empty report. "Concrete" means exactly one thing — a model was reached, or
+ * something was ruled out. A report with neither is not evidence of exhaustion.
+ */
+export function renderExhaustionReport(input) {
+    const attempts = input.attempts ?? [];
+    const exclusions = input.exclusions ?? [];
+    // A measured pool size is NOT evidence: a governance refusal, a bad pin or a
+    // caller bug all fail with a perfectly healthy pool and no attempt at all, and
+    // dressing those up as exhaustion would be a new lie in place of the old one.
+    if (attempts.length === 0 && exclusions.length === 0)
+        return undefined;
+    return buildExhaustionReport(input).text;
+}
+//# sourceMappingURL=exhaustion-report.js.map

package/dist/learning/exhaustion-report.js.map

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

package/dist/learning/failure-bookkeeping.d.ts

@@ -67,6 +67,22 @@ export declare function isModelSessionExcluded(session: FailureSessionState, pro
  * session-level exclusion and the breaker's scoring cooldown expire together.
  */
 export declare const RATE_LIMIT_EXCLUSION_MS: number;
+/**
+ * How long a provider × model pair is excluded after it resolved with NOTHING
+ * usable — an HTTP 200 carrying neither answer text nor a tool call (see
+ * `response-usability.ts`).
+ *
+ * MODEL-scoped on purpose, and never escalated to the provider: the transport
+ * worked and the provider answered, so its OTHER models are very often
+ * perfectly healthy — the live case was one local model returning nothing on
+ * five consecutive steps while Gemini sat configured and unused. Two minutes is
+ * long enough to cover a turn plus its retries, short enough that a genuinely
+ * transient empty self-heals with no user action.
+ *
+ * The failover walk (`resilient-call.ts`) uses this same constant for its own
+ * pair exclusion, so the session and cross-pipeline windows cannot drift.
+ */
+export declare const EMPTY_RESPONSE_SESSION_EXCLUSION_MS: number;
 export declare const RAPID_FAILURE_WINDOW_MS: number;
 export declare const RAPID_FAILURE_THRESHOLD = 3;
 export declare const RAPID_FAILURE_COOLDOWN_MS: number;

package/dist/learning/failure-bookkeeping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"failure-bookkeeping.d.ts","sourceRoot":"","sources":["../../src/learning/failure-bookkeeping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAsC1D,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,sBAAsB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C;;;OAGG;IACH,+BAA+B,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C;;;;;;;;;OASG;IACH,mBAAmB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C;;;;;OAKG;IACH,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACvC;AAED;gFACgF;AAChF,eAAO,MAAM,qCAAqC,IAAI,CAAC;AAEvD,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,EAC5B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,GAAG,GAAE,MAAmB,GACvB,OAAO,CAIT;AAID;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAAgB,CAAC;AAarD,eAAO,MAAM,uBAAuB,QAAY,CAAC;AAEjD,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,eAAO,MAAM,yBAAyB,QAAY,CAAC;AAEnD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,EAC5B,YAAY,EAAE,MAAM,EACpB,GAAG,GAAE,MAAmB,GACvB,OAAO,CAMT;AAED,0EAA0E;AAC1E,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,EAC5B,YAAY,EAAE,MAAM,EACpB,GAAG,GAAE,MAAmB,GACvB,OAAO,CAIT;AAED;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,QAAY,CAAC;AAIxD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,mBAAmB,EAC5B,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,OAAO,EACZ,aAAa,EAAE,aAAa,EAC5B,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D,IAAI,CA2KN"}
+{"version":3,"file":"failure-bookkeeping.d.ts","sourceRoot":"","sources":["../../src/learning/failure-bookkeeping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAsC1D,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,sBAAsB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C;;;OAGG;IACH,+BAA+B,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C;;;;;;;;;OASG;IACH,mBAAmB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C;;;;;OAKG;IACH,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACvC;AAED;gFACgF;AAChF,eAAO,MAAM,qCAAqC,IAAI,CAAC;AAEvD,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,EAC5B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,GAAG,GAAE,MAAmB,GACvB,OAAO,CAIT;AAID;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAAgB,CAAC;AAErD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mCAAmC,QAAgB,CAAC;AAajE,eAAO,MAAM,uBAAuB,QAAY,CAAC;AAEjD,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,eAAO,MAAM,yBAAyB,QAAY,CAAC;AAEnD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,EAC5B,YAAY,EAAE,MAAM,EACpB,GAAG,GAAE,MAAmB,GACvB,OAAO,CAMT;AAED,0EAA0E;AAC1E,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,EAC5B,YAAY,EAAE,MAAM,EACpB,GAAG,GAAE,MAAmB,GACvB,OAAO,CAIT;AAED;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,QAAY,CAAC;AAIxD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,mBAAmB,EAC5B,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,OAAO,EACZ,aAAa,EAAE,aAAa,EAC5B,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D,IAAI,CA0MN"}

package/dist/learning/failure-bookkeeping.js

@@ -65,6 +65,22 @@ export function isModelSessionExcluded(session, providerType, model, now = Date.
  * session-level exclusion and the breaker's scoring cooldown expire together.
  */
 export const RATE_LIMIT_EXCLUSION_MS = 2 * 60 * 1000;
+/**
+ * How long a provider × model pair is excluded after it resolved with NOTHING
+ * usable — an HTTP 200 carrying neither answer text nor a tool call (see
+ * `response-usability.ts`).
+ *
+ * MODEL-scoped on purpose, and never escalated to the provider: the transport
+ * worked and the provider answered, so its OTHER models are very often
+ * perfectly healthy — the live case was one local model returning nothing on
+ * five consecutive steps while Gemini sat configured and unused. Two minutes is
+ * long enough to cover a turn plus its retries, short enough that a genuinely
+ * transient empty self-heals with no user action.
+ *
+ * The failover walk (`resilient-call.ts`) uses this same constant for its own
+ * pair exclusion, so the session and cross-pipeline windows cannot drift.
+ */
+export const EMPTY_RESPONSE_SESSION_EXCLUSION_MS = 2 * 60 * 1000;
 // ─── T4 — RPM/TPM rapid-failure breaker ─────────────────────────────────────
 //
 // Free tiers meter requests/tokens PER MINUTE, but a 429 with no reset hint
@@ -265,6 +281,25 @@ export function recordActionFailure(session, providerType, err, configManager, o
         // other keys of the same provider stay usable).
         parkAccountForKey(providerType, options?.apiKey, now + parkMs, failureKind);
     }
+    else if (failureKind === 'empty-response') {
+        // ── An empty completion is a MODEL failure, not a provider outage ──────
+        // The provider answered (HTTP 200, a real response body) and simply carried
+        // no text and no tool call. So the pair is what must rest — exclude it and
+        // leave its SIBLINGS routable, or one dead model would take a healthy
+        // provider's whole model list out of the running. No quota park: nothing was
+        // rate-limited, and the registry already parks this exact pair for
+        // `EMPTY_RESPONSE_PARK_MS` (see `model-registry.recordCall`).
+        const failingModel = options?.model;
+        if (session.sessionFailedModels && failingModel && failingModel !== 'default') {
+            session.sessionFailedModels.set(modelExclusionKey(providerType, failingModel), now + EMPTY_RESPONSE_SESSION_EXCLUSION_MS);
+        }
+        else {
+            // No model attribution available — the provider is the only thing we can
+            // hold back, so fall back to the transient provider exclusion.
+            session.sessionFailedProviders.set(providerType, now + TRANSIENT_FAILURE_EXCLUSION_MS);
+            session.sessionTransientFailedProviders.add(providerType);
+        }
+    }
     else {
         // Server / network / timeout / unknown — transient but definitive enough
         // that the next message shouldn't re-pick this provider. Short cooldown,
@@ -290,11 +325,22 @@ export function recordActionFailure(session, providerType, err, configManager, o
     // ── 6. Shared circuit breaker ─────────────────────────────────────────
     // Repeated failures open the breaker so the auto router deprioritizes the
     // provider by scoring even for transient errors.
-    try {
-        getProviderFallback(configManager).recordFailure(providerType);
-    }
-    catch {
-        // Best-effort — circuit-breaker bookkeeping must not crash a call.
+    //
+    // EXCEPT for an empty-response: the breaker is PROVIDER-scoped, and an empty
+    // completion is a MODEL property — the provider answered, on time, with a
+    // well-formed HTTP 200. Tripping its breaker would deprioritize every healthy
+    // sibling on that provider because one model returned nothing, which is the
+    // same corruption the harness-fault guard at the top of this function exists
+    // to prevent. The pair is already parked in the registry (see
+    // `model-registry.recordCall`), so the model rests without the provider paying
+    // for it.
+    if (failureKind !== 'empty-response') {
+        try {
+            getProviderFallback(configManager).recordFailure(providerType);
+        }
+        catch {
+            // Best-effort — circuit-breaker bookkeeping must not crash a call.
+        }
     }
 }
 //# sourceMappingURL=failure-bookkeeping.js.map

package/dist/learning/failure-bookkeeping.js.map

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

package/dist/learning/gate-friction.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Gate friction — how much the harness speaks to the model in a turn, summarized
+ * from reasoning traces so the dashboard can show the number.
+ *
+ * Counts every `gate` event (a bounded nudge: plan / verification / deliverable /
+ * permission / repeat / action / promise / self-review / diagnosis /
+ * malformed-call / prerequisite) and every `refusal` event (a tool declined a
+ * call). The per-turn distribution is the number Bundle 37b ("deliver gate text
+ * as an acted-on instruction") exists to reduce. This module is the READ side of
+ * `scripts/measure-gate-friction.mjs`, so the dashboard and the CLI report the
+ * same figure from the same rule.
+ *
+ * It also counts narration (Bundle 39): a turn whose final answer reuses the
+ * harness's own distinctive vocabulary — see `harness-narration.ts`.
+ */
+export interface GateFrictionSummary {
+    traces: number;
+    /** Total gate + refusal events across all traces. */
+    events: number;
+    perTurn: {
+        mean: number;
+        median: number;
+        p90: number;
+        max: number;
+        turnsWithAny: number;
+    };
+    /** Per-gate counts, highest first. */
+    byGate: Array<{
+        key: string;
+        count: number;
+    }>;
+    /** Turns whose answer narrated the harness (Bundle 39). */
+    narration: {
+        turns: number;
+        echoedMarker: number;
+    };
+}
+export declare function summarizeGateFriction(raw: unknown): GateFrictionSummary;
+//# sourceMappingURL=gate-friction.d.ts.map

package/dist/learning/gate-friction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-friction.d.ts","sourceRoot":"","sources":["../../src/learning/gate-friction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,sCAAsC;IACtC,MAAM,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9C,2DAA2D;IAC3D,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD;AAyBD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,mBAAmB,CAqDvE"}

package/dist/learning/gate-friction.js

@@ -0,0 +1,91 @@
+/**
+ * Gate friction — how much the harness speaks to the model in a turn, summarized
+ * from reasoning traces so the dashboard can show the number.
+ *
+ * Counts every `gate` event (a bounded nudge: plan / verification / deliverable /
+ * permission / repeat / action / promise / self-review / diagnosis /
+ * malformed-call / prerequisite) and every `refusal` event (a tool declined a
+ * call). The per-turn distribution is the number Bundle 37b ("deliver gate text
+ * as an acted-on instruction") exists to reduce. This module is the READ side of
+ * `scripts/measure-gate-friction.mjs`, so the dashboard and the CLI report the
+ * same figure from the same rule.
+ *
+ * It also counts narration (Bundle 39): a turn whose final answer reuses the
+ * harness's own distinctive vocabulary — see `harness-narration.ts`.
+ */
+import { detectHarnessNarration } from './harness-narration.js';
+function normalize(raw) {
+    const list = Array.isArray(raw)
+        ? raw
+        : raw && typeof raw === 'object' && Array.isArray(raw.traces)
+            ? raw.traces
+            : [];
+    return list.filter((t) => Boolean(t) && typeof t === 'object');
+}
+function finalText(trace) {
+    const steps = trace.steps ?? [];
+    for (let i = steps.length - 1; i >= 0; i--) {
+        const t = steps[i]?.responsePreview;
+        if (t && String(t).trim())
+            return String(t);
+    }
+    return '';
+}
+export function summarizeGateFriction(raw) {
+    const traces = normalize(raw);
+    const byKey = new Map();
+    const perTurn = [];
+    let narrated = 0;
+    let echoed = 0;
+    for (const trace of traces) {
+        let total = 0;
+        const harnessTexts = [];
+        for (const e of trace.events ?? []) {
+            if (!e)
+                continue;
+            if (e.kind === 'gate') {
+                const key = `gate:${e.gate || 'unknown'}`;
+                byKey.set(key, (byKey.get(key) ?? 0) + 1);
+                total += 1;
+                if (e.summary)
+                    harnessTexts.push(e.summary);
+            }
+            else if (e.kind === 'refusal') {
+                const key = `refusal:${e.gate || e.tool || 'unknown'}`;
+                byKey.set(key, (byKey.get(key) ?? 0) + 1);
+                total += 1;
+                if (e.summary)
+                    harnessTexts.push(e.summary);
+                if (e.result)
+                    harnessTexts.push(e.result);
+            }
+        }
+        perTurn.push(total);
+        if (harnessTexts.length > 0) {
+            const text = finalText(trace);
+            if (text.includes('[harness]'))
+                echoed += 1;
+            if (detectHarnessNarration(text, harnessTexts).narrated)
+                narrated += 1;
+        }
+    }
+    const sorted = [...perTurn].sort((a, b) => a - b);
+    const sum = sorted.reduce((n, v) => n + v, 0);
+    const at = (p) => (sorted.length ? sorted[Math.min(sorted.length - 1, Math.floor(p * sorted.length))] : 0);
+    return {
+        traces: traces.length,
+        events: sum,
+        perTurn: {
+            mean: sorted.length ? Math.round((sum / sorted.length) * 100) / 100 : 0,
+            median: at(0.5),
+            p90: at(0.9),
+            max: sorted.length ? sorted[sorted.length - 1] : 0,
+            turnsWithAny: perTurn.filter((n) => n > 0).length,
+        },
+        byGate: [...byKey.entries()]
+            .map(([key, count]) => ({ key, count }))
+            .sort((a, b) => b.count - a.count),
+        narration: { turns: narrated, echoedMarker: echoed },
+    };
+}
+//# sourceMappingURL=gate-friction.js.map

package/dist/learning/gate-friction.js.map

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

package/dist/learning/harness-narration.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Harness-narration detection — did the model NARRATE the harness back at the
+ * user instead of acting on it?
+ *
+ * WHY THIS EXISTS. Bundle 37b made every gate nudge a marked `[harness]`
+ * `system` directive so the model would act on it rather than answer it. That
+ * change is only worth having if it is VERIFIABLE on live traces: some turns
+ * would still produce prose ABOUT the harness (`"the command guard misfired on a
+ * read-only check, so verification was…"`) instead of quietly continuing.
+ *
+ * HOW IT DETECTS, WITHOUT A PHRASE LIST. It does not look for words like
+ * "guard" or "misfire" — that would be a hand-written list of user phrasings,
+ * which this codebase forbids. Instead it takes the harness's OWN text (the
+ * refusals and gate summaries the trace recorded for that turn) and asks whether
+ * the model's answer reuses a DISTINCTIVE token from it: a hyphenated compound
+ * (`state-changing`, `read-only`) or a long word (≥10 chars). Those are the
+ * tokens that carry the harness's specific vocabulary; a shared one means the
+ * model is quoting the loop's language rather than talking about the task.
+ *
+ * The vocabulary is DERIVED at runtime from the harness's own strings, so it
+ * tracks whatever the harness actually says — it can never drift from a list.
+ *
+ * It is a REPORTER, not a gate: it never changes what the turn does. It exists so
+ * "the model stopped narrating the harness" is a measurement (see
+ * `scripts/detect-harness-narration.mjs`).
+ */
+export interface NarrationVerdict {
+    narrated: boolean;
+    /** The distinctive tokens the answer shares with the harness text. */
+    matches: string[];
+}
+/** The pure check. `harnessTexts` are the harness's own strings for this turn. */
+export declare function detectHarnessNarration(finalText: string, harnessTexts: Array<string | undefined | null>): NarrationVerdict;
+//# sourceMappingURL=harness-narration.d.ts.map

package/dist/learning/harness-narration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-narration.d.ts","sourceRoot":"","sources":["../../src/learning/harness-narration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAiBD,kFAAkF;AAClF,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,GAC7C,gBAAgB,CASlB"}

package/dist/learning/harness-narration.js

@@ -0,0 +1,58 @@
+/**
+ * Harness-narration detection — did the model NARRATE the harness back at the
+ * user instead of acting on it?
+ *
+ * WHY THIS EXISTS. Bundle 37b made every gate nudge a marked `[harness]`
+ * `system` directive so the model would act on it rather than answer it. That
+ * change is only worth having if it is VERIFIABLE on live traces: some turns
+ * would still produce prose ABOUT the harness (`"the command guard misfired on a
+ * read-only check, so verification was…"`) instead of quietly continuing.
+ *
+ * HOW IT DETECTS, WITHOUT A PHRASE LIST. It does not look for words like
+ * "guard" or "misfire" — that would be a hand-written list of user phrasings,
+ * which this codebase forbids. Instead it takes the harness's OWN text (the
+ * refusals and gate summaries the trace recorded for that turn) and asks whether
+ * the model's answer reuses a DISTINCTIVE token from it: a hyphenated compound
+ * (`state-changing`, `read-only`) or a long word (≥10 chars). Those are the
+ * tokens that carry the harness's specific vocabulary; a shared one means the
+ * model is quoting the loop's language rather than talking about the task.
+ *
+ * The vocabulary is DERIVED at runtime from the harness's own strings, so it
+ * tracks whatever the harness actually says — it can never drift from a list.
+ *
+ * It is a REPORTER, not a gate: it never changes what the turn does. It exists so
+ * "the model stopped narrating the harness" is a measurement (see
+ * `scripts/detect-harness-narration.mjs`).
+ */
+/**
+ * Tokens specific enough to signal the harness's vocabulary: hyphenated
+ * compounds, or long words. Deliberately NOT common prose (which is why a short
+ * word can never match).
+ */
+function distinctiveTokens(text) {
+    const out = new Set();
+    for (const raw of String(text ?? '').toLowerCase().split(/[^a-z0-9-]+/)) {
+        const t = raw.replace(/^-+|-+$/g, '');
+        if (!t)
+            continue;
+        if (t.length >= 10 || (t.includes('-') && t.length >= 6))
+            out.add(t);
+    }
+    return out;
+}
+/** The pure check. `harnessTexts` are the harness's own strings for this turn. */
+export function detectHarnessNarration(finalText, harnessTexts) {
+    const said = distinctiveTokens(finalText);
+    if (said.size === 0)
+        return { narrated: false, matches: [] };
+    const matches = new Set();
+    for (const h of harnessTexts) {
+        if (!h)
+            continue;
+        for (const t of distinctiveTokens(h))
+            if (said.has(t))
+                matches.add(t);
+    }
+    return { narrated: matches.size > 0, matches: [...matches].sort() };
+}
+//# sourceMappingURL=harness-narration.js.map