@qduc/term2 0.7.3 → 0.9.0

package/dist/services/retry/recovery-policy.test.js

@@ -0,0 +1,103 @@
+import { it, expect } from 'vitest';
+import { DefaultConversationRecoveryPolicy } from './recovery-policy.js';
+const policy = new DefaultConversationRecoveryPolicy();
+const baseCounts = () => ({
+    transientRetryCount: 0,
+    serviceTierFallbackCount: 0,
+    modelRetryCount: 0,
+    transportDowngradeCount: 0,
+});
+const baseRecoveryContext = (overrides = {}) => ({
+    failure: { kind: 'unrecoverable' },
+    gen: 1,
+    stream: null,
+    retryCounts: baseCounts(),
+    freshStartRetriesAllowed: true,
+    ...overrides,
+});
+it('service_tier_fallback produces retry_fresh with delta input and useStandardServiceTier', () => {
+    const result = policy.plan(baseRecoveryContext({ failure: { kind: 'service_tier_fallback' } }));
+    expect(result).toEqual({ kind: 'retry_fresh', inputMode: 'delta', useStandardServiceTier: true });
+});
+it('transient failure with resumable stream replays full history', () => {
+    const result = policy.plan(baseRecoveryContext({
+        failure: { kind: 'transient', attempt: 1, delayMs: 500 },
+        stream: { state: {}, lastResponseId: 'resp-123' },
+    }));
+    expect(result).toEqual({ kind: 'retry_fresh', inputMode: 'full_history' });
+});
+it('transient failure without stream produces retry_fresh with full_history', () => {
+    const result = policy.plan(baseRecoveryContext({
+        failure: { kind: 'transient', attempt: 2, delayMs: 1000 },
+        stream: null,
+    }));
+    expect(result).toEqual({ kind: 'retry_fresh', inputMode: 'full_history' });
+});
+it('transport_downgrade produces retry_fresh with full_history', () => {
+    const result = policy.plan(baseRecoveryContext({ failure: { kind: 'transport_downgrade' } }));
+    expect(result).toEqual({ kind: 'retry_fresh', inputMode: 'full_history' });
+});
+it('model_retry with stream produces replay_turn without rollback and with errorContext', () => {
+    const result = policy.plan(baseRecoveryContext({
+        failure: { kind: 'model_retry', errorContext: 'Previous attempt failed' },
+        stream: { state: {} },
+    }));
+    expect(result).toEqual({
+        kind: 'replay_turn',
+        inputMode: 'full_history',
+        rollbackUserMessage: false,
+        errorContext: 'Previous attempt failed',
+    });
+});
+it('model_retry without stream produces replay_turn with rollback', () => {
+    const result = policy.plan(baseRecoveryContext({
+        failure: { kind: 'model_retry' },
+        stream: null,
+    }));
+    expect(result).toEqual({ kind: 'replay_turn', inputMode: 'full_history', rollbackUserMessage: true });
+});
+it('unrecoverable produces terminate with empty events', () => {
+    const result = policy.plan(baseRecoveryContext({ failure: { kind: 'unrecoverable' } }));
+    expect(result).toEqual({ kind: 'terminate', events: [] });
+});
+it('fresh-start retries disabled converts non-unrecoverable failure without stream to terminate', () => {
+    const result = policy.plan(baseRecoveryContext({
+        failure: { kind: 'transient', attempt: 1, delayMs: 500 },
+        stream: null,
+        freshStartRetriesAllowed: false,
+    }));
+    expect(result).toEqual({ kind: 'terminate', events: [] });
+});
+it('fresh-start retries disabled terminates transport recovery even when stream exists', () => {
+    const result = policy.plan(baseRecoveryContext({
+        failure: { kind: 'transient', attempt: 1, delayMs: 500 },
+        stream: { state: { _x: 1 }, lastResponseId: undefined },
+        freshStartRetriesAllowed: false,
+    }));
+    expect(result).toEqual({ kind: 'terminate', events: [] });
+});
+// ── nextRetryCounts ────────────────────────────────────────────
+it('nextRetryCounts increments transient count for transient failure', () => {
+    const result = policy.nextRetryCounts(baseCounts(), { kind: 'transient', attempt: 3, delayMs: 500 });
+    expect(result.transientRetryCount).toBe(3);
+    expect(result.serviceTierFallbackCount).toBe(0);
+});
+it('nextRetryCounts increments service tier fallback count', () => {
+    const result = policy.nextRetryCounts(baseCounts(), { kind: 'service_tier_fallback' });
+    expect(result.serviceTierFallbackCount).toBe(1);
+});
+it('nextRetryCounts resets transient and increments transport downgrade', () => {
+    const result = policy.nextRetryCounts({ ...baseCounts(), transientRetryCount: 5 }, { kind: 'transport_downgrade' });
+    expect(result.transientRetryCount).toBe(0);
+    expect(result.transportDowngradeCount).toBe(1);
+});
+it('nextRetryCounts increments model retry count', () => {
+    const result = policy.nextRetryCounts(baseCounts(), { kind: 'model_retry', errorContext: 'x' });
+    expect(result.modelRetryCount).toBe(1);
+});
+it('nextRetryCounts returns unchanged counts for unrecoverable', () => {
+    const counts = baseCounts();
+    const result = policy.nextRetryCounts(counts, { kind: 'unrecoverable' });
+    expect(result).toEqual(counts);
+});
+//# sourceMappingURL=recovery-policy.test.js.map

package/dist/services/retry/recovery-policy.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-policy.test.js","sourceRoot":"","sources":["../../../source/services/retry/recovery-policy.test.ts"],"names":[],"mappings":"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"}

package/dist/services/retry/retry-classifier.d.ts

@@ -0,0 +1,9 @@
+import type { ClassificationContext, ClassifiedFailure } from './retry-contracts.js';
+import type { ConversationAgentClient } from '../conversation-agent-client.js';
+export declare class DefaultRetryClassifier {
+    private agentClient;
+    private random;
+    constructor(agentClient: ConversationAgentClient, random?: () => number);
+    classify(context: ClassificationContext): ClassifiedFailure;
+}
+//# sourceMappingURL=retry-classifier.d.ts.map

package/dist/services/retry/retry-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-classifier.d.ts","sourceRoot":"","sources":["../../../source/services/retry/retry-classifier.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAW/E,qBAAa,sBAAsB;IACrB,OAAO,CAAC,WAAW;IAA2B,OAAO,CAAC,MAAM;gBAApD,WAAW,EAAE,uBAAuB,EAAU,MAAM,GAAE,MAAM,MAAoB;IAIpG,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,iBAAiB;CAsC5D"}

package/dist/services/retry/retry-classifier.js

@@ -0,0 +1,48 @@
+import { decideRetry } from './conversation-retry-policy.js';
+import { isPreviousResponseNotFoundError, isRetryableTransportError } from './retry-error-classification.js';
+import { extractHistoryLength } from '../stream-snapshot.js';
+const TRANSIENT_BASE_DELAY_MS = 500;
+const TRANSIENT_MAX_DELAY_MS = 30_000;
+const computeTransientDelayMs = (attempt, random) => {
+    const baseDelay = Math.min(TRANSIENT_BASE_DELAY_MS * 2 ** Math.max(0, attempt - 1), TRANSIENT_MAX_DELAY_MS);
+    const jitter = 0.9 + random() * 0.2;
+    return Math.round(baseDelay * jitter);
+};
+export class DefaultRetryClassifier {
+    agentClient;
+    random;
+    constructor(agentClient, random = Math.random) {
+        this.agentClient = agentClient;
+        this.random = random;
+        void this.agentClient;
+    }
+    classify(context) {
+        const { error, retryCounts, stream, maxTransientRetries, maxModelRetries } = context;
+        const hallucinationDecision = decideRetry(error, retryCounts.modelRetryCount, Boolean(stream), extractHistoryLength(stream), maxModelRetries);
+        if (hallucinationDecision.kind === 'retry') {
+            return {
+                kind: 'model_retry',
+                errorContext: hallucinationDecision.shouldInjectErrorContext
+                    ? hallucinationDecision.errorContextMessage
+                    : undefined,
+                retryEvent: hallucinationDecision.retryEvent,
+            };
+        }
+        if (isPreviousResponseNotFoundError(error)) {
+            const nextAttempt = retryCounts.transientRetryCount + 1;
+            if (nextAttempt > maxTransientRetries) {
+                return { kind: 'unrecoverable' };
+            }
+            return { kind: 'transport_downgrade' };
+        }
+        if (isRetryableTransportError(error).retryable) {
+            const nextAttempt = retryCounts.transientRetryCount + 1;
+            if (nextAttempt > maxTransientRetries) {
+                return { kind: 'unrecoverable' };
+            }
+            return { kind: 'transient', attempt: nextAttempt, delayMs: computeTransientDelayMs(nextAttempt, this.random) };
+        }
+        return { kind: 'unrecoverable' };
+    }
+}
+//# sourceMappingURL=retry-classifier.js.map

package/dist/services/retry/retry-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-classifier.js","sourceRoot":"","sources":["../../../source/services/retry/retry-classifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,+BAA+B,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAE7G,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAG7D,MAAM,uBAAuB,GAAG,GAAG,CAAC;AACpC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAEtC,MAAM,uBAAuB,GAAG,CAAC,OAAe,EAAE,MAAoB,EAAU,EAAE;IAChF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,uBAAuB,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAAC;IAC5G,MAAM,MAAM,GAAG,GAAG,GAAG,MAAM,EAAE,GAAG,GAAG,CAAC;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,MAAM,OAAO,sBAAsB;IACb;IAA8C;IAAlE,YAAoB,WAAoC,EAAU,SAAuB,IAAI,CAAC,MAAM;QAAhF,gBAAW,GAAX,WAAW,CAAyB;QAAU,WAAM,GAAN,MAAM,CAA4B;QAClG,KAAK,IAAI,CAAC,WAAW,CAAC;IACxB,CAAC;IAED,QAAQ,CAAC,OAA8B;QACrC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,mBAAmB,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;QAErF,MAAM,qBAAqB,GAAG,WAAW,CACvC,KAAK,EACL,WAAW,CAAC,eAAe,EAC3B,OAAO,CAAC,MAAM,CAAC,EACf,oBAAoB,CAAC,MAAM,CAAC,EAC5B,eAAe,CAChB,CAAC;QACF,IAAI,qBAAqB,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC3C,OAAO;gBACL,IAAI,EAAE,aAAa;gBACnB,YAAY,EAAE,qBAAqB,CAAC,wBAAwB;oBAC1D,CAAC,CAAC,qBAAqB,CAAC,mBAAmB;oBAC3C,CAAC,CAAC,SAAS;gBACb,UAAU,EAAE,qBAAqB,CAAC,UAAU;aAC7C,CAAC;QACJ,CAAC;QAED,IAAI,+BAA+B,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,MAAM,WAAW,GAAG,WAAW,CAAC,mBAAmB,GAAG,CAAC,CAAC;YACxD,IAAI,WAAW,GAAG,mBAAmB,EAAE,CAAC;gBACtC,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;YACnC,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC;QACzC,CAAC;QAED,IAAI,yBAAyB,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,CAAC;YAC/C,MAAM,WAAW,GAAG,WAAW,CAAC,mBAAmB,GAAG,CAAC,CAAC;YACxD,IAAI,WAAW,GAAG,mBAAmB,EAAE,CAAC;gBACtC,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;YACnC,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,uBAAuB,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACjH,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;IACnC,CAAC;CACF"}

package/dist/services/retry/retry-classifier.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=retry-classifier.test.d.ts.map

package/dist/services/retry/retry-classifier.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-classifier.test.d.ts","sourceRoot":"","sources":["../../../source/services/retry/retry-classifier.test.ts"],"names":[],"mappings":""}

package/dist/services/retry/retry-classifier.test.js

@@ -0,0 +1,206 @@
+import { it, expect } from 'vitest';
+import { ModelBehaviorError } from '@openai/agents';
+import { OpenAICompatibleError } from '../../providers/common/provider-errors.js';
+import { DefaultRetryClassifier } from './retry-classifier.js';
+const makeClassifier = (agentClient = {}, random = Math.random) => new DefaultRetryClassifier(agentClient, random);
+const baseCounts = () => ({
+    transientRetryCount: 0,
+    serviceTierFallbackCount: 0,
+    modelRetryCount: 0,
+    transportDowngradeCount: 0,
+});
+const baseContext = (overrides = {}) => ({
+    error: new Error('boom'),
+    retryCounts: baseCounts(),
+    stream: null,
+    maxTransientRetries: 5,
+    ...overrides,
+});
+it('classify does not return service_tier_fallback when already attempted', () => {
+    const classifier = makeClassifier({ shouldRetryWithoutFlexServiceTier: () => true });
+    const result = classifier.classify(baseContext({
+        retryCounts: { ...baseCounts(), serviceTierFallbackCount: 1 },
+    }));
+    expect(result.kind).not.toBe('service_tier_fallback');
+});
+it('classify does not call forceTransportDowngrade for non-retryable errors', () => {
+    let downgradeCalled = false;
+    const classifier = makeClassifier({
+        forceTransportDowngrade: () => {
+            downgradeCalled = true;
+            return true;
+        },
+    });
+    const result = classifier.classify(baseContext({ error: new Error('boom') }));
+    expect(result.kind).toBe('unrecoverable');
+    expect(downgradeCalled).toBe(false);
+});
+it('classify returns model_retry for recoverable model error with error context', () => {
+    const classifier = makeClassifier();
+    const result = classifier.classify(baseContext({
+        error: new ModelBehaviorError('Tool fake_tool not found'),
+        stream: { completed: Promise.resolve(undefined) },
+        retryCounts: baseCounts(),
+    }));
+    expect(result.kind).toBe('model_retry');
+    if (result.kind !== 'model_retry')
+        return;
+    expect(result.errorContext).toBeTruthy();
+    expect(result.errorContext.includes('fake_tool')).toBe(true);
+});
+it('classify returns model_retry without error context when stream produced no history', () => {
+    const classifier = makeClassifier();
+    const result = classifier.classify(baseContext({
+        error: new ModelBehaviorError('Tool fake_tool not found'),
+        stream: null,
+    }));
+    expect(result.kind).toBe('model_retry');
+    if (result.kind !== 'model_retry')
+        return;
+    expect(result.errorContext).toBe(undefined);
+});
+it('classify returns unrecoverable when all retry limits are exhausted', () => {
+    const classifier = makeClassifier({
+        shouldRetryWithoutFlexServiceTier: () => true,
+        forceTransportDowngrade: () => true,
+    });
+    const result = classifier.classify(baseContext({
+        error: new ModelBehaviorError('Tool fake_tool not found'),
+        retryCounts: {
+            transientRetryCount: 5,
+            serviceTierFallbackCount: 1,
+            modelRetryCount: 2,
+            transportDowngradeCount: 1,
+        },
+    }));
+    expect(result).toEqual({ kind: 'unrecoverable' });
+});
+it('classify returns unrecoverable for generic non-retryable error', () => {
+    const classifier = makeClassifier();
+    const result = classifier.classify(baseContext({ error: new Error('unknown') }));
+    expect(result).toEqual({ kind: 'unrecoverable' });
+});
+it('classify returns unrecoverable for 400 status error', () => {
+    const classifier = makeClassifier();
+    const result = classifier.classify(baseContext({ error: new OpenAICompatibleError('bad request', 400, {}) }));
+    expect(result).toEqual({ kind: 'unrecoverable' });
+});
+it('classify returns transport_downgrade for previous_response_not_found websocket 400 payload', () => {
+    const classifier = makeClassifier();
+    const error = Object.assign(new Error('Unexpected server response: 400 {"error":{"code":"previous_response_not_found","message":"Previous response not found"}}'), { status: 400 });
+    expect(classifier.classify(baseContext({ error })).kind).toBe('transport_downgrade');
+});
+it('classify leaves unrelated websocket 400 errors unrecoverable', () => {
+    const classifier = makeClassifier();
+    const error = Object.assign(new Error('Unexpected server response: 400 {"error":{"code":"invalid_request_error"}}'), {
+        status: 400,
+    });
+    expect(classifier.classify(baseContext({ error }))).toEqual({ kind: 'unrecoverable' });
+});
+it('classify returns unrecoverable when model retry count exceeds max', () => {
+    const classifier = makeClassifier();
+    const result = classifier.classify(baseContext({
+        error: new ModelBehaviorError('Tool fake_tool not found'),
+        retryCounts: { ...baseCounts(), modelRetryCount: 2 },
+        maxModelRetries: 2,
+    }));
+    expect(result.kind).toBe('unrecoverable');
+});
+it('classify returns transient for undici onSocketClose TypeError mid-stream', () => {
+    const classifier = makeClassifier();
+    const undiciSocketClose = new TypeError();
+    undiciSocketClose.stack = [
+        'TypeError',
+        '    at #onSocketClose (node:internal/deps/undici/undici:15450:20)',
+        '    at TLSSocket.onSocketClose (node:internal/deps/undici/undici:15153:72)',
+        '    at TLSSocket.emit (node:events:520:35)',
+    ].join('\n');
+    const result = classifier.classify(baseContext({
+        error: undiciSocketClose,
+        retryCounts: baseCounts(),
+        maxTransientRetries: 5,
+    }));
+    expect(result.kind).toBe('transient');
+    if (result.kind !== 'transient')
+        return;
+    expect(result.attempt).toBe(1);
+    expect(result.delayMs > 0 && result.delayMs <= 30000).toBe(true);
+});
+it('classify returns transient for ECONNRESET socket error', () => {
+    const classifier = makeClassifier();
+    const result = classifier.classify(baseContext({
+        error: Object.assign(new Error('read ECONNRESET'), { code: 'ECONNRESET' }),
+        maxTransientRetries: 5,
+    }));
+    expect(result.kind).toBe('transient');
+});
+it('classify returns unrecoverable when transient retries are exhausted', () => {
+    const classifier = makeClassifier();
+    const undiciSocketClose = new TypeError();
+    undiciSocketClose.stack = [
+        'TypeError',
+        '    at #onSocketClose (node:internal/deps/undici/undici:15450:20)',
+        '    at TLSSocket.onSocketClose (node:internal/deps/undici/undici:15153:72)',
+    ].join('\n');
+    const result = classifier.classify(baseContext({
+        error: undiciSocketClose,
+        retryCounts: { ...baseCounts(), transientRetryCount: 5 },
+        maxTransientRetries: 5,
+    }));
+    expect(result.kind).toBe('unrecoverable');
+});
+it('classify returns unrecoverable for plain TypeError (non-undici) with empty message', () => {
+    const classifier = makeClassifier();
+    const plain = new TypeError();
+    plain.stack = 'TypeError\n    at userCode (file.ts:1:1)';
+    const result = classifier.classify(baseContext({
+        error: plain,
+        maxTransientRetries: 5,
+    }));
+    expect(result.kind).toBe('unrecoverable');
+});
+it('classify transient attempt count increments with prior transient retries', () => {
+    const classifier = makeClassifier();
+    const undiciSocketClose = new TypeError();
+    undiciSocketClose.stack = ['TypeError', '    at #onSocketClose (node:internal/deps/undici/undici:15450:20)'].join('\n');
+    const result = classifier.classify(baseContext({
+        error: undiciSocketClose,
+        retryCounts: { ...baseCounts(), transientRetryCount: 2 },
+        maxTransientRetries: 5,
+    }));
+    expect(result.kind).toBe('transient');
+    if (result.kind !== 'transient')
+        return;
+    expect(result.attempt).toBe(3);
+});
+it('classify returns transient for re-wrapped undici onSocketClose (Error with message "TypeError")', () => {
+    const classifier = makeClassifier();
+    const rewrapped = new Error('TypeError');
+    rewrapped.stack = [
+        'Error: TypeError',
+        '    at #onSocketClose (node:internal/deps/undici/undici:15450:20)',
+        '    at TLSSocket.onSocketClose (node:internal/deps/undici/undici:15153:72)',
+        '    at TLSSocket.emit (node:events:520:35)',
+    ].join('\n');
+    const result = classifier.classify(baseContext({
+        error: rewrapped,
+        retryCounts: baseCounts(),
+        maxTransientRetries: 5,
+    }));
+    expect(result.kind).toBe('transient');
+    if (result.kind !== 'transient')
+        return;
+    expect(result.attempt).toBe(1);
+    expect(result.delayMs > 0 && result.delayMs <= 30000).toBe(true);
+});
+it('classify returns unrecoverable for plain Error with message "TypeError" but no undici stack', () => {
+    const classifier = makeClassifier();
+    const plain = new Error('TypeError');
+    plain.stack = 'Error: TypeError\n    at userCode (file.ts:1:1)';
+    const result = classifier.classify(baseContext({
+        error: plain,
+        maxTransientRetries: 5,
+    }));
+    expect(result.kind).toBe('unrecoverable');
+});
+//# sourceMappingURL=retry-classifier.test.js.map

package/dist/services/retry/retry-classifier.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-classifier.test.js","sourceRoot":"","sources":["../../../source/services/retry/retry-classifier.test.ts"],"names":[],"mappings":"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"}

package/dist/services/retry/retry-contracts.d.ts

@@ -0,0 +1,99 @@
+import type { RunState } from '@openai/agents';
+import type { AgentStream } from '../agent-stream.js';
+import type { ConversationEvent } from '../conversation/conversation-events.js';
+import type { SavedToolExecution } from '../tool-execution-ledger.js';
+export type ClassifiedFailure = {
+    kind: 'transient';
+    attempt: number;
+    delayMs: number;
+} | {
+    kind: 'service_tier_fallback';
+} | {
+    kind: 'transport_downgrade';
+} | {
+    kind: 'model_retry';
+    errorContext?: string;
+    retryEvent?: import('../conversation/conversation-events.js').ConversationEvent;
+} | {
+    kind: 'unrecoverable';
+};
+export type RecoveryPlan = {
+    kind: 'resume_stream';
+    state: RunState<any, any>;
+    previousResponseId: string | null;
+} | {
+    kind: 'replay_turn';
+    inputMode: 'full_history';
+    rollbackUserMessage: boolean;
+    errorContext?: string;
+} | {
+    kind: 'retry_fresh';
+    inputMode: 'delta' | 'full_history';
+    useStandardServiceTier?: boolean;
+} | {
+    kind: 'terminate';
+    events: ConversationEvent[];
+};
+export type RetryCounts = {
+    transientRetryCount: number;
+    serviceTierFallbackCount: number;
+    modelRetryCount: number;
+    transportDowngradeCount: number;
+};
+export type ClassificationContext = {
+    error: unknown;
+    retryCounts: RetryCounts;
+    stream: AgentStream | null;
+    maxTransientRetries: number;
+    maxModelRetries?: number;
+};
+export type RecoveryContext = {
+    failure: ClassifiedFailure;
+    gen: number;
+    stream: AgentStream | null;
+    retryCounts: RetryCounts;
+    maxModelRetries?: number;
+    freshStartRetriesAllowed: boolean;
+};
+export type RecoveryState = {
+    ledgerSnapshot: SavedToolExecution[];
+    addedUserMessage: boolean;
+    stream: AgentStream | null;
+    currentState?: RunState<any, any>;
+    toolResultCallIds?: string[];
+};
+export type NextRunInstruction = {
+    skipUserMessage: boolean;
+    retryCounts: RetryCounts;
+    maxModelRetries?: number;
+    resumeState?: RunState<any, any>;
+    resumePreviousResponseId?: string | null;
+};
+export type RecoveryInstructions = {
+    delayMs?: number;
+    useStandardServiceTier?: boolean;
+};
+export type RecoveryResult = ({
+    kind: 'run';
+    instruction: NextRunInstruction;
+    events: ConversationEvent[];
+} & RecoveryInstructions) | {
+    kind: 'terminated';
+    events: ConversationEvent[];
+};
+export type RecoveryExecutorInput = {
+    plan: RecoveryPlan;
+    state: RecoveryState;
+    retryCounts: RetryCounts;
+    maxModelRetries?: number;
+};
+export interface RetryClassifier {
+    classify(context: ClassificationContext): ClassifiedFailure;
+}
+export interface ConversationRecoveryPolicy {
+    plan(context: RecoveryContext): RecoveryPlan;
+}
+export interface RecoveryExecutor {
+    apply(input: RecoveryExecutorInput): RecoveryResult;
+}
+//# sourceMappingURL=retry-contracts.d.ts.map

package/dist/services/retry/retry-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-contracts.d.ts","sourceRoot":"","sources":["../../../source/services/retry/retry-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAItE,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,uBAAuB,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,qBAAqB,CAAA;CAAE,GAC/B;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,wCAAwC,EAAE,iBAAiB,CAAC;CACjF,GACD;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AAI9B,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACvF;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,cAAc,CAAC;IAAC,mBAAmB,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACvG;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,OAAO,GAAG,cAAc,CAAC;IAAC,sBAAsB,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9F;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAAC;AAIvD,MAAM,MAAM,WAAW,GAAG;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wBAAwB,EAAE,MAAM,CAAC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,uBAAuB,EAAE,MAAM,CAAC;CACjC,CAAC;AAIF,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAIF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wBAAwB,EAAE,OAAO,CAAC;CACnC,CAAC;AAIF,MAAM,MAAM,aAAa,GAAG;IAC1B,cAAc,EAAE,kBAAkB,EAAE,CAAC;IACrC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B,CAAC;AAIF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACjC,wBAAwB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C,CAAC;AAIF,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,cAAc,GACtB,CAAC;IACC,IAAI,EAAE,KAAK,CAAC;IACZ,WAAW,EAAE,kBAAkB,CAAC;IAChC,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B,GAAG,oBAAoB,CAAC,GACzB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAAC;AAExD,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAIF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,iBAAiB,CAAC;CAC7D;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,YAAY,CAAC;CAC9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,KAAK,EAAE,qBAAqB,GAAG,cAAc,CAAC;CACrD"}

package/dist/services/retry/retry-contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=retry-contracts.js.map

package/dist/services/retry/retry-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-contracts.js","sourceRoot":"","sources":["../../../source/services/retry/retry-contracts.ts"],"names":[],"mappings":""}

package/dist/services/retry/retry-error-classification.d.ts

@@ -0,0 +1,30 @@
+import type { ILoggingService } from '../service-interfaces.js';
+export type RetryableTransportDecision = {
+    retryable: boolean;
+    transportFallback: boolean;
+};
+export declare function isPreviousResponseNotFoundError(error: unknown, seen?: Set<unknown>): boolean;
+/**
+ * Undici's HTTP / WebSocket body parser throws a bare `new TypeError()`
+ * (empty message, no `code`, no `cause`) when the TLS socket closes
+ * mid-response-body. The only reliable signal is the stack: the private
+ * `#onSocketClose` frame in `node:internal/deps/undici/undici`. Detect
+ * that pattern explicitly so we can classify it as a transient transport
+ * error instead of an unrecoverable programmer-error TypeError.
+ *
+ * Intermediate layers (SDK wrappers, stream collectors) may re-wrap the
+ * original TypeError into a plain `Error` with `message: "TypeError"` and
+ * the original undici stack frames. We handle both the canonical bare
+ * TypeError form and the re-wrapped form by checking the stack pattern
+ * as the primary signal, with name/message guards to avoid false positives
+ * from unrelated errors that happen to have `onSocketClose` in their stack.
+ */
+export declare function isUndiciSocketCloseError(error: unknown): boolean;
+export declare function isNetworkProtocolError(error: unknown, seen?: Set<unknown>): boolean;
+export declare const isRetryableTransportError: (error: unknown, logger?: Pick<ILoggingService, "info">) => RetryableTransportDecision;
+/**
+ * Returns true when the error is a transient upstream failure (429 / 5xx /
+ * connection timeout) that is worth retrying automatically.
+ */
+export declare const isTransientRetryableError: (error: unknown, logger?: Pick<ILoggingService, "info">) => boolean;
+//# sourceMappingURL=retry-error-classification.d.ts.map

package/dist/services/retry/retry-error-classification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-error-classification.d.ts","sourceRoot":"","sources":["../../../source/services/retry/retry-error-classification.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;CAC5B,CAAC;AAqCF,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,eAAqB,GAAG,OAAO,CAgBlG;AA6DD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAchE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,eAAqB,GAAG,OAAO,CA4FzF;AAiBD,eAAO,MAAM,yBAAyB,GACpC,OAAO,OAAO,EACd,SAAS,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,KACrC,0BAUF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GAAI,OAAO,OAAO,EAAE,SAAS,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,KAAG,OA4FlG,CAAC"}