condukt 0.25.0 → 0.27.0

package/dist/runtimes/claude/session-epoch.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Session compaction epochs — reference-proxy parity (opencode.py
+ * `_epoch_*`, tests/test_session_epoch.py).
+ *
+ * A post-compaction conversation must read as a NEW session upstream
+ * (fresh routing affinity + cache namespace), and every session is
+ * era-labeled from birth (`{id}-e0`; the kill-switch restores verbatim).
+ * A frozen cache pin (cached flat while input grows) with no compaction
+ * in sight never recovers on its own, so N consecutive materially
+ * deficient frozen turns rotate a persistent `-rM` marker (superseded by
+ * the next compaction bump). The suffix advances only on shrink +
+ * novelty + calm (compaction) or on a confirmed stagnation streak, never
+ * mid-conversation otherwise.
+ *
+ * Pure logic only: no I/O, no clocks. Callers own the per-session state
+ * map, persistence, and logging.
+ */
+export declare const SESSION_EPOCH_DEFAULTS: {
+    /** Fire only below 60% of the tracked max. */
+    readonly ratio: 0.6;
+    /** Tracked max must reach 40K est tokens (compaction-scale only). */
+    readonly preFloor: 40000;
+    /** Shrunken request must still be 25K+ (excludes subagent-scale traffic). */
+    readonly postFloor: 25000;
+    /** Pre-shrink head steady this many consecutive turns. */
+    readonly calm: 3;
+    /** "Steady" = size within 75% of tracked max (growth counts). */
+    readonly steady: 0.75;
+    /** Adopt upward jumps only within 1.5x (rewind guard / rebase). */
+    readonly growthCap: 1.5;
+    /** Requests before another bump/rotation may fire. */
+    readonly cooldown: 5;
+    /** Bounded msgs-hash history per session (rewind guard). */
+    readonly seenMax: 64;
+    /** GC sessions unseen this long. */
+    readonly ttlMs: number;
+    /** Cached flat within ±this many tokens across turns. */
+    readonly rotateBand: 5000;
+    /** Frozen value must exceed this (cold all-zero streaks never fire). */
+    readonly rotateMinPin: 10000;
+    /** input − cached must exceed this (near-whole-prefix eras never fire). */
+    readonly rotateMinGap: 10000;
+    /** Consecutive frozen turns to arm (6th continuing turn rotates). */
+    readonly rotateStreak: 5;
+    /** input − cached at/above this takes the fast tier. */
+    readonly rotateFastGap: 25000;
+    /** Consecutive frozen turns to arm the fast tier. */
+    readonly rotateFastStreak: 3;
+};
+export type SessionEpochConstants = {
+    readonly [K in keyof typeof SESSION_EPOCH_DEFAULTS]: number;
+};
+export declare function epochConstants(overrides?: Partial<SessionEpochConstants>): SessionEpochConstants;
+/** Per-base-session epoch + stagnation tracking state. */
+export interface SessionEpochState {
+    epoch: number;
+    rot: number;
+    max: number;
+    calm: number;
+    seen: string[];
+    cooldown: number;
+    lastSeen: number;
+    rebaseSize: number;
+    rebaseHits: number;
+    streak: number;
+    prevIn: number | null;
+    prevCached: number | null;
+    prevSize: number | null;
+    streakHead: string | null;
+}
+export declare function initialEpochState(now?: number): SessionEpochState;
+/** (size_est_tokens, msgs_hash, head) for triggers, or null on failure. */
+export interface EpochFingerprint {
+    readonly size: number;
+    readonly msgsHash: string;
+    readonly head: string;
+}
+/**
+ * `head` is the (system, tools) hash pair — stable across normal turns
+ * (messages grow; sys/tools don't), so it names the conversation phase
+ * for both novelty (compaction) and head-stability (stagnation) checks.
+ */
+export declare function epochFingerprint(body: unknown): EpochFingerprint | null;
+/** Pure trigger predicate: shrink + novelty + calm (+ cooldown + floors). */
+export declare function shouldFire(state: SessionEpochState, size: number, msgsHash: string, c: SessionEpochConstants): boolean;
+/**
+ * Non-firing update. `max` ratchets up only within the growth cap — an
+ * abrupt multi-x jump is a rewind-to-old and adopts only if the new
+ * level persists `calm` consecutive (band-matched) turns (rebase); a
+ * one-turn excursion is abandoned on return. Small/interleaved traffic
+ * resets calm.
+ */
+export declare function trackLocked(state: SessionEpochState, size: number, msgsHash: string | null, c: SessionEpochConstants): void;
+/**
+ * Pure stagnation predicate: the pin is frozen AND the freeze is
+ * material AND the turn continues the run. Shares the epoch cooldown;
+ * `gap` (previous measured input − cached) selects the tier: at/above
+ * 25K the fast tier (3-turn streak), above 10K the slow tier (5).
+ */
+export declare function rotationArmed(state: SessionEpochState, size: number, head: string | null, c: SessionEpochConstants): boolean;
+/**
+ * Record a completed turn's outcome for the stagnation detector.
+ * `measured` false (estimated/failed usage) skips WITHOUT touching
+ * state — an observation gap must neither confirm nor reset the streak.
+ * Streak counts consecutive frozen turns with baseline 1 (the first
+ * observed turn adopts the head as the run baseline); any violation
+ * (cache jump, input drop, head change) restarts at 0. Never throws.
+ */
+export declare function noteTurn(state: SessionEpochState, body: unknown, inTokens: number, cacheTokens: number, measured: boolean, c: SessionEpochConstants, now?: number): boolean;
+/**
+ * Exact-compaction bump (the in-process bridge observes the SDK's
+ * compact boundary; the reference proxy bumps heuristically on shrink).
+ * Mirrors the reference fire path with an unknown post-compaction body:
+ * `max` re-learns the new level, `seen` starts fresh, rotation is
+ * dropped, and the shared cooldown suppresses a duplicate heuristic
+ * fire on the immediately following shrunken request.
+ */
+export declare function bumpEpochOnCompaction(state: SessionEpochState, c: SessionEpochConstants, now?: number): void;
+export interface EpochVerdict {
+    readonly effectiveSession: string;
+    readonly fired: boolean;
+    readonly rotated: boolean;
+    /**
+     * True when the request carried a usable fingerprint (state was
+     * read/tracked); false for unusable bodies, which are read-only.
+     */
+    readonly observed: boolean;
+    /** Diagnostics for logging/metrics when fired/rotated. */
+    readonly firedDetail?: {
+        readonly prevMax: number;
+        readonly size: number;
+        readonly epoch: number;
+    };
+    readonly rotatedDetail?: {
+        readonly prevCached: number | null;
+        readonly gap: number | null;
+        readonly prevStreak: number;
+        readonly rot: number;
+    };
+}
+/** The single verdict point: suffixed whenever enabled, verbatim otherwise. */
+export declare function suffixedSession(session: string, epoch: number, rot: number, enabled: boolean): string;
+export interface ApplyEpochOptions {
+    readonly enabled: boolean;
+    readonly rotate: boolean;
+    readonly constants: SessionEpochConstants;
+    readonly now?: () => number;
+}
+/**
+ * Resolve the effective upstream session for one request, mutating
+ * `state`. Fail-open throughout: kill-switch off returns the verbatim
+ * session (tracking continues); unusable fingerprints return the stored
+ * epoch with zero state mutation.
+ */
+export declare function applySessionEpoch(base: string, state: SessionEpochState, body: unknown, opts: ApplyEpochOptions): EpochVerdict;
+//# sourceMappingURL=session-epoch.d.ts.map

package/dist/runtimes/claude/session-epoch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-epoch.d.ts","sourceRoot":"","sources":["../../../runtimes/claude/session-epoch.ts"],"names":[],"mappings":"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"}

package/dist/runtimes/claude/session-epoch.js

@@ -0,0 +1,365 @@
+"use strict";
+/**
+ * Session compaction epochs — reference-proxy parity (opencode.py
+ * `_epoch_*`, tests/test_session_epoch.py).
+ *
+ * A post-compaction conversation must read as a NEW session upstream
+ * (fresh routing affinity + cache namespace), and every session is
+ * era-labeled from birth (`{id}-e0`; the kill-switch restores verbatim).
+ * A frozen cache pin (cached flat while input grows) with no compaction
+ * in sight never recovers on its own, so N consecutive materially
+ * deficient frozen turns rotate a persistent `-rM` marker (superseded by
+ * the next compaction bump). The suffix advances only on shrink +
+ * novelty + calm (compaction) or on a confirmed stagnation streak, never
+ * mid-conversation otherwise.
+ *
+ * Pure logic only: no I/O, no clocks. Callers own the per-session state
+ * map, persistence, and logging.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SESSION_EPOCH_DEFAULTS = void 0;
+exports.epochConstants = epochConstants;
+exports.initialEpochState = initialEpochState;
+exports.epochFingerprint = epochFingerprint;
+exports.shouldFire = shouldFire;
+exports.trackLocked = trackLocked;
+exports.rotationArmed = rotationArmed;
+exports.noteTurn = noteTurn;
+exports.bumpEpochOnCompaction = bumpEpochOnCompaction;
+exports.suffixedSession = suffixedSession;
+exports.applySessionEpoch = applySessionEpoch;
+const node_crypto_1 = require("node:crypto");
+const bridge_cache_1 = require("./bridge-cache");
+const translate_chat_1 = require("./translate-chat");
+exports.SESSION_EPOCH_DEFAULTS = {
+    /** Fire only below 60% of the tracked max. */
+    ratio: 0.6,
+    /** Tracked max must reach 40K est tokens (compaction-scale only). */
+    preFloor: 40000,
+    /** Shrunken request must still be 25K+ (excludes subagent-scale traffic). */
+    postFloor: 25000,
+    /** Pre-shrink head steady this many consecutive turns. */
+    calm: 3,
+    /** "Steady" = size within 75% of tracked max (growth counts). */
+    steady: 0.75,
+    /** Adopt upward jumps only within 1.5x (rewind guard / rebase). */
+    growthCap: 1.5,
+    /** Requests before another bump/rotation may fire. */
+    cooldown: 5,
+    /** Bounded msgs-hash history per session (rewind guard). */
+    seenMax: 64,
+    /** GC sessions unseen this long. */
+    ttlMs: 7 * 86400_000,
+    /** Cached flat within ±this many tokens across turns. */
+    rotateBand: 5000,
+    /** Frozen value must exceed this (cold all-zero streaks never fire). */
+    rotateMinPin: 10000,
+    /** input − cached must exceed this (near-whole-prefix eras never fire). */
+    rotateMinGap: 10000,
+    /** Consecutive frozen turns to arm (6th continuing turn rotates). */
+    rotateStreak: 5,
+    /** input − cached at/above this takes the fast tier. */
+    rotateFastGap: 25000,
+    /** Consecutive frozen turns to arm the fast tier. */
+    rotateFastStreak: 3,
+};
+function epochConstants(overrides) {
+    return { ...exports.SESSION_EPOCH_DEFAULTS, ...(overrides ?? {}) };
+}
+function initialEpochState(now = Date.now()) {
+    return {
+        epoch: 0,
+        rot: 0,
+        max: 0,
+        calm: 0,
+        seen: [],
+        cooldown: 0,
+        lastSeen: now,
+        rebaseSize: 0,
+        rebaseHits: 0,
+        streak: 0,
+        prevIn: null,
+        prevCached: null,
+        prevSize: null,
+        streakHead: null,
+    };
+}
+function hash16(value) {
+    return (0, node_crypto_1.createHash)('sha256').update((0, bridge_cache_1.stableJson)(value), 'utf8').digest('hex').slice(0, 16);
+}
+/**
+ * `head` is the (system, tools) hash pair — stable across normal turns
+ * (messages grow; sys/tools don't), so it names the conversation phase
+ * for both novelty (compaction) and head-stability (stagnation) checks.
+ */
+function epochFingerprint(body) {
+    if (!body || typeof body !== 'object' || Array.isArray(body))
+        return null;
+    const b = body;
+    if (!Array.isArray(b['messages']))
+        return null;
+    try {
+        return {
+            size: Math.max(0, Math.floor((0, translate_chat_1.estimateInputTokens)(b))),
+            msgsHash: hash16(b['messages']),
+            head: hash16([b['system'] ?? null, b['tools'] ?? null]),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** Pure trigger predicate: shrink + novelty + calm (+ cooldown + floors). */
+function shouldFire(state, size, msgsHash, c) {
+    if (state.cooldown > 0)
+        return false;
+    if (state.max < c.preFloor)
+        return false;
+    if (size < c.postFloor)
+        return false;
+    if (size >= c.ratio * state.max)
+        return false;
+    if (state.seen.includes(msgsHash))
+        return false;
+    if (state.calm < c.calm)
+        return false;
+    return true;
+}
+/**
+ * Non-firing update. `max` ratchets up only within the growth cap — an
+ * abrupt multi-x jump is a rewind-to-old and adopts only if the new
+ * level persists `calm` consecutive (band-matched) turns (rebase); a
+ * one-turn excursion is abandoned on return. Small/interleaved traffic
+ * resets calm.
+ */
+function trackLocked(state, size, msgsHash, c) {
+    if (size > state.max) {
+        if (state.max === 0 || size <= c.growthCap * state.max) {
+            state.max = size;
+            state.rebaseSize = 0;
+            state.rebaseHits = 0;
+        }
+        else if (state.rebaseSize > 0 &&
+            Math.abs(size - state.rebaseSize) <= (1 - c.steady) * state.rebaseSize) {
+            state.rebaseSize = size;
+            state.rebaseHits += 1;
+            if (state.rebaseHits >= c.calm) {
+                state.max = size;
+                state.rebaseSize = 0;
+                state.rebaseHits = 0;
+            }
+        }
+        else {
+            state.rebaseSize = size;
+            state.rebaseHits = 1;
+        }
+    }
+    else {
+        state.rebaseSize = 0;
+        state.rebaseHits = 0;
+    }
+    if (msgsHash !== null && !state.seen.includes(msgsHash)) {
+        state.seen.push(msgsHash);
+        if (state.seen.length > c.seenMax)
+            state.seen.splice(0, state.seen.length - c.seenMax);
+    }
+    state.calm = size >= c.steady * state.max ? state.calm + 1 : 0;
+    if (state.cooldown > 0)
+        state.cooldown -= 1;
+}
+/**
+ * Pure stagnation predicate: the pin is frozen AND the freeze is
+ * material AND the turn continues the run. Shares the epoch cooldown;
+ * `gap` (previous measured input − cached) selects the tier: at/above
+ * 25K the fast tier (3-turn streak), above 10K the slow tier (5).
+ */
+function rotationArmed(state, size, head, c) {
+    if (state.cooldown > 0)
+        return false;
+    const pi = state.prevIn;
+    const pc = state.prevCached;
+    if (pi === null || pc === null)
+        return false;
+    const gap = pi - pc;
+    let required;
+    if (gap >= c.rotateFastGap)
+        required = c.rotateFastStreak;
+    else if (gap > c.rotateMinGap)
+        required = c.rotateStreak;
+    else
+        return false;
+    if (state.streak < required)
+        return false;
+    if (size < c.postFloor)
+        return false;
+    if (pc < c.rotateMinPin)
+        return false;
+    if (state.prevSize === null || size <= state.prevSize)
+        return false;
+    if (head === null || head !== state.streakHead)
+        return false;
+    return true;
+}
+/**
+ * Record a completed turn's outcome for the stagnation detector.
+ * `measured` false (estimated/failed usage) skips WITHOUT touching
+ * state — an observation gap must neither confirm nor reset the streak.
+ * Streak counts consecutive frozen turns with baseline 1 (the first
+ * observed turn adopts the head as the run baseline); any violation
+ * (cache jump, input drop, head change) restarts at 0. Never throws.
+ */
+function noteTurn(state, body, inTokens, cacheTokens, measured, c, now = Date.now()) {
+    if (!measured)
+        return false;
+    try {
+        if (!Number.isFinite(inTokens) || !Number.isFinite(cacheTokens))
+            return false;
+        const fp = epochFingerprint(body);
+        if (!fp)
+            return false;
+        state.lastSeen = now;
+        if (state.streakHead === null || fp.head !== state.streakHead) {
+            state.streakHead = fp.head;
+            state.prevIn = inTokens;
+            state.prevCached = cacheTokens;
+            state.prevSize = fp.size;
+            state.streak = 1;
+        }
+        else {
+            const prevIn = state.prevIn;
+            const prevCached = state.prevCached;
+            const frozen = prevCached !== null &&
+                prevIn !== null &&
+                Math.abs(cacheTokens - prevCached) <= c.rotateBand &&
+                inTokens > prevIn;
+            state.streak = frozen ? state.streak + 1 : 0;
+            state.prevIn = inTokens;
+            state.prevCached = cacheTokens;
+            state.prevSize = fp.size;
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Exact-compaction bump (the in-process bridge observes the SDK's
+ * compact boundary; the reference proxy bumps heuristically on shrink).
+ * Mirrors the reference fire path with an unknown post-compaction body:
+ * `max` re-learns the new level, `seen` starts fresh, rotation is
+ * dropped, and the shared cooldown suppresses a duplicate heuristic
+ * fire on the immediately following shrunken request.
+ */
+function bumpEpochOnCompaction(state, c, now = Date.now()) {
+    state.epoch += 1;
+    state.max = 0;
+    state.seen = [];
+    state.calm = 0;
+    state.cooldown = c.cooldown;
+    state.rebaseSize = 0;
+    state.rebaseHits = 0;
+    state.rot = 0;
+    state.streak = 0;
+    state.prevIn = null;
+    state.prevCached = null;
+    state.prevSize = null;
+    state.streakHead = null;
+    state.lastSeen = now;
+}
+/** The single verdict point: suffixed whenever enabled, verbatim otherwise. */
+function suffixedSession(session, epoch, rot, enabled) {
+    if (!enabled)
+        return session;
+    let s = `${session}-e${epoch}`;
+    if (rot > 0)
+        s += `-r${rot}`;
+    return s;
+}
+/**
+ * Resolve the effective upstream session for one request, mutating
+ * `state`. Fail-open throughout: kill-switch off returns the verbatim
+ * session (tracking continues); unusable fingerprints return the stored
+ * epoch with zero state mutation.
+ */
+function applySessionEpoch(base, state, body, opts) {
+    const c = opts.constants;
+    const now = opts.now ?? Date.now;
+    const rotateOn = opts.enabled && opts.rotate;
+    let fp = null;
+    try {
+        fp = epochFingerprint(body);
+    }
+    catch {
+        fp = null;
+    }
+    if (!fp) {
+        return {
+            effectiveSession: suffixedSession(base, state.epoch, state.rot, opts.enabled),
+            fired: false,
+            rotated: false,
+            observed: false,
+        };
+    }
+    state.lastSeen = now();
+    try {
+        if (opts.enabled && shouldFire(state, fp.size, fp.msgsHash, c)) {
+            const prevMax = state.max;
+            state.epoch += 1;
+            state.max = fp.size;
+            state.seen = [fp.msgsHash];
+            state.calm = 0;
+            state.cooldown = c.cooldown;
+            state.rebaseSize = 0;
+            state.rebaseHits = 0;
+            state.rot = 0;
+            state.streak = 0;
+            state.prevIn = null;
+            state.prevCached = null;
+            state.prevSize = null;
+            state.streakHead = null;
+            return {
+                effectiveSession: suffixedSession(base, state.epoch, state.rot, opts.enabled),
+                fired: true,
+                rotated: false,
+                observed: true,
+                firedDetail: { prevMax, size: fp.size, epoch: state.epoch },
+            };
+        }
+        if (rotateOn && rotationArmed(state, fp.size, fp.head, c)) {
+            const prevCached = state.prevCached;
+            const prevIn = state.prevIn;
+            const prevStreak = state.streak;
+            state.rot += 1;
+            state.streak = 0;
+            state.prevIn = null;
+            state.prevCached = null;
+            state.prevSize = null;
+            state.streakHead = null;
+            state.cooldown = c.cooldown;
+            return {
+                effectiveSession: suffixedSession(base, state.epoch, state.rot, opts.enabled),
+                fired: false,
+                rotated: true,
+                observed: true,
+                rotatedDetail: {
+                    prevCached,
+                    gap: prevIn !== null && prevCached !== null ? prevIn - prevCached : null,
+                    prevStreak,
+                    rot: state.rot,
+                },
+            };
+        }
+        trackLocked(state, fp.size, fp.msgsHash, c);
+    }
+    catch {
+        /* fail-open: return the stored-epoch verdict below */
+    }
+    return {
+        effectiveSession: suffixedSession(base, state.epoch, state.rot, opts.enabled),
+        fired: false,
+        rotated: false,
+        observed: true,
+    };
+}
+//# sourceMappingURL=session-epoch.js.map

package/dist/runtimes/claude/session-epoch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-epoch.js","sourceRoot":"","sources":["../../../runtimes/claude/session-epoch.ts"],"names":[],"mappings":"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"}

package/dist/runtimes/claude/session-recovery.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Same-session recovery for the Claude runtime (ADR-009, ADR-008 parity).
+ *
+ * The Claude SDK has no empty-turn primitive in string-prompt mode, so
+ * recovery here resumes the failed session and sends one fixed,
+ * task-free continuation. Everything in this module is pure so it can be
+ * unit-tested without a CLI: the session owns the loop and the events.
+ */
+import type { ClaudeResultOutcome } from './message-mapper';
+/**
+ * The idempotent nudge sent after a resume. It must not repeat the original
+ * task: `resume` may already have re-run an interrupted turn on its own
+ * (`resume_reason` frames), and a second full task would duplicate work.
+ */
+export declare const CONTINUATION_PROMPT: string;
+/**
+ * The reconnect step that produced an error. Mirrors the `stage` values on a
+ * `SessionRecoveryEvent` so an `exhausted` event can name what failed.
+ */
+export type ClaudeRecoveryStage = 'fence' | 'client' | 'resume' | 'configuration' | 'audit' | 'continuation';
+/**
+ * A failed recovery step.
+ *
+ * `fatal` marks steps whose failure cannot change its answer on a retry: the
+ * resumed session reported a different id than the one asked for, or the CLI
+ * refused the required permission mode. Every other step is retried until
+ * the continuation count or the recovery budget runs out.
+ */
+export declare class ClaudeResumeAttemptError extends Error {
+    readonly stage: ClaudeRecoveryStage;
+    readonly fatal: boolean;
+    constructor(stage: ClaudeRecoveryStage, message: string, fatal: boolean, options?: {
+        cause?: unknown;
+    });
+}
+export declare function toResumeAttemptError(value: unknown, stage: ClaudeRecoveryStage): ClaudeResumeAttemptError;
+/** The CLI accepted the prompt but the query stream ended with no result. */
+export declare class ClaudeStreamEndedError extends Error {
+    constructor(message?: string);
+}
+/** A requested configuration invariant was not applied by the CLI. */
+export declare class ClaudeConfigurationError extends Error {
+    constructor(message: string);
+}
+export interface ClaudeFailureSignals {
+    /** The terminal message, when the stream produced one. */
+    readonly outcome?: ClaudeResultOutcome;
+    /** Last `assistant.error` value seen during the failed turn. */
+    readonly assistantError?: string;
+    /** A thrown stream/transport error, when the turn never produced a result. */
+    readonly error?: Error;
+    /** condukt aborted the turn; nothing is recoverable. */
+    readonly aborted: boolean;
+}
+export interface ClaudeFailureClassification {
+    readonly recoverable: boolean;
+    /** Human-readable evidence, also used in the `exhausted` reason. */
+    readonly reason: string;
+    readonly statusCode?: number;
+    readonly errorCode?: string;
+    readonly failureKind?: string;
+}
+/** `result.subtype !== 'success'` or a transient API failure flagged in-band. */
+export declare function outcomeIsFailure(outcome: ClaudeResultOutcome): boolean;
+/** The error a terminal result should fail the turn with. */
+export declare function failureFromOutcome(outcome: ClaudeResultOutcome): Error;
+/**
+ * Decides whether resuming the same session can plausibly fix a failed turn.
+ *
+ * Evidence is checked in the order the SDK makes it authoritative:
+ * `startup_failure_reason` and fatal local errors first, then the assistant
+ * error enum, then the HTTP status, then `terminal_reason`, then message
+ * text. A thrown stream error with no explicit signal is treated as a
+ * transport failure and is recoverable; a result error with no evidence is
+ * not retried blindly.
+ */
+export declare function classifyClaudeFailure(signals: ClaudeFailureSignals): ClaudeFailureClassification;
+//# sourceMappingURL=session-recovery.d.ts.map

package/dist/runtimes/claude/session-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-recovery.d.ts","sourceRoot":"","sources":["../../../runtimes/claude/session-recovery.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QAEmC,CAAC;AAEpE;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAC3B,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,eAAe,GACf,OAAO,GACP,cAAc,CAAC;AAEnB;;;;;;;GAOG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IAE/C,QAAQ,CAAC,KAAK,EAAE,mBAAmB;IAEnC,QAAQ,CAAC,KAAK,EAAE,OAAO;gBAFd,KAAK,EAAE,mBAAmB,EACnC,OAAO,EAAE,MAAM,EACN,KAAK,EAAE,OAAO,EACvB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKhC;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,mBAAmB,GACzB,wBAAwB,CAM1B;AAED,6EAA6E;AAC7E,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,SAAgD;CAIpE;AAED,sEAAsE;AACtE,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,oBAAoB;IACnC,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IACvC,gEAAgE;IAChE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AA8DD,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAEtE;AAED,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,KAAK,CAUtE;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,oBAAoB,GAC5B,2BAA2B,CAuH7B"}