@qduc/term2 0.7.3 → 0.8.0

package/dist/services/retry-error-classification.test.js

@@ -0,0 +1,195 @@
+import test from 'ava';
+import { APIConnectionError, APIConnectionTimeoutError, InternalServerError, RateLimitError } from 'openai';
+import { ModelBehaviorError } from '@openai/agents';
+import { OpenAICompatibleError, OpenRouterError } from '../providers/common/provider-errors.js';
+import { isNetworkProtocolError, isRetryableTransportError, isTransientRetryableError, } from './retry-error-classification.js';
+function asInstanceOf(prototype, props) {
+    return Object.assign(Object.create(prototype), props);
+}
+function createLoggerMock() {
+    const calls = [];
+    return {
+        calls,
+        logger: {
+            info(message, meta) {
+                calls.push({ message, meta });
+            },
+        },
+    };
+}
+test('isNetworkProtocolError correctly flags network protocol errors', (t) => {
+    t.true(isNetworkProtocolError({ code: 'ENOTFOUND' }));
+    t.true(isNetworkProtocolError({ code: 'ECONNREFUSED' }));
+    t.true(isNetworkProtocolError({ code: 'ETIMEDOUT' }));
+    t.true(isNetworkProtocolError({ code: 'ECONNRESET' }));
+    t.true(isNetworkProtocolError(new Error('Responses websocket connection closed before opening.')));
+    t.true(isNetworkProtocolError(new Error('Responses websocket connection closed before a terminal response event.')));
+    t.true(isNetworkProtocolError(new Error('Responses websocket is not open.')));
+    t.true(isNetworkProtocolError(new Error('unexpected server response: 502')));
+    t.true(isNetworkProtocolError(new Error('Responses websocket connection timed out before opening after 15000ms')));
+    t.true(isNetworkProtocolError(new Error('Responses websocket connection timed out')));
+    t.true(isNetworkProtocolError(new Error('WebSocket first frame timeout after 5000ms')));
+    t.true(isNetworkProtocolError({ name: 'InvalidStateError', message: 'Socket is closing' }));
+    t.false(isNetworkProtocolError(new Error('unexpected server response: 401')));
+    t.false(isNetworkProtocolError(new Error('unexpected server response: 403')));
+    t.false(isNetworkProtocolError(new Error('unexpected server response: 429')));
+    t.false(isNetworkProtocolError(new Error('unexpected server response: 400')));
+    t.false(isNetworkProtocolError(new Error('unexpected server response: 404')));
+    t.true(isNetworkProtocolError(new Error('unexpected server response: 502')));
+    t.false(isNetworkProtocolError(new Error('Something else went wrong')));
+    t.false(isNetworkProtocolError({}));
+    t.false(isNetworkProtocolError(null));
+});
+test('isRetryableTransportError separates retryable errors from HTTP fallback candidates', (t) => {
+    t.deepEqual(isRetryableTransportError(new Error('WebSocket first frame timeout after 5000ms')), {
+        retryable: true,
+        transportFallback: true,
+    });
+    t.deepEqual(isRetryableTransportError(new Error('WebSocket connection closed before response completed (code=1006)')), {
+        retryable: true,
+        transportFallback: true,
+    });
+    t.deepEqual(isRetryableTransportError(new Error('WebSocket connection closed before response completed (code=1001)')), {
+        retryable: true,
+        transportFallback: true,
+    });
+    t.deepEqual(isRetryableTransportError(new Error('WebSocket connection closed before response completed (code=1012)')), {
+        retryable: true,
+        transportFallback: true,
+    });
+    t.deepEqual(isRetryableTransportError(new Error('WebSocket connection closed before response completed (code=1008)')), {
+        retryable: true,
+        transportFallback: true,
+    });
+    t.deepEqual(isRetryableTransportError(new Error('unexpected server response: 401')), {
+        retryable: false,
+        transportFallback: false,
+    });
+});
+test('isRetryableTransportError logs websocket close code at info level', (t) => {
+    const { calls, logger } = createLoggerMock();
+    const decision = isRetryableTransportError(new Error('WebSocket connection closed before response completed (code=1006)'), logger);
+    t.deepEqual(decision, { retryable: true, transportFallback: true });
+    t.is(calls.length, 1);
+    t.is(calls[0]?.message, 'WebSocket close code detected');
+    t.deepEqual(calls[0]?.meta, {
+        eventType: 'retry.websocket_close_code_detected',
+        category: 'retry',
+        closeCode: '1006',
+        errorMessage: 'WebSocket connection closed before response completed (code=1006)',
+    });
+});
+test('isTransientRetryableError: OpenAI SDK errors are retryable', (t) => {
+    t.true(isTransientRetryableError(asInstanceOf(APIConnectionError.prototype, { message: 'conn error' })));
+    t.true(isTransientRetryableError(asInstanceOf(APIConnectionTimeoutError.prototype, { message: 'timeout' })));
+    t.true(isTransientRetryableError(asInstanceOf(InternalServerError.prototype, { message: 'ise', status: 500 })));
+    t.true(isTransientRetryableError(asInstanceOf(RateLimitError.prototype, { message: 'rate limit', status: 429 })));
+});
+test('isTransientRetryableError: OpenRouter 429/5xx are retryable', (t) => {
+    t.true(isTransientRetryableError(new OpenRouterError('rate limited', 429, {})));
+    t.true(isTransientRetryableError(new OpenRouterError('server error', 500, {})));
+    t.true(isTransientRetryableError(new OpenRouterError('bad gateway', 502, {})));
+    t.false(isTransientRetryableError(new OpenRouterError('not found', 404, {})));
+});
+test('isTransientRetryableError: OpenAI-compatible 429/5xx are retryable', (t) => {
+    t.true(isTransientRetryableError(new OpenAICompatibleError('rate limited', 429, {})));
+    t.true(isTransientRetryableError(new OpenAICompatibleError('server error', 503, {})));
+    t.false(isTransientRetryableError(new OpenAICompatibleError('bad request', 400, {})));
+});
+test('isTransientRetryableError: generic errors with 429/5xx status are retryable', (t) => {
+    const err429 = new Error('too many requests');
+    err429.status = 429;
+    t.true(isTransientRetryableError(err429));
+    const err503 = new Error('service unavailable');
+    err503.statusCode = 503;
+    t.true(isTransientRetryableError(err503));
+});
+test('isTransientRetryableError: generic errors with rate-limit message are retryable', (t) => {
+    t.true(isTransientRetryableError(new Error("We're currently processing too many requests — please try again later.")));
+    t.true(isTransientRetryableError(new Error('Rate limit exceeded')));
+    t.true(isTransientRetryableError(new Error('rate_limit retry after 10s')));
+});
+test('isTransientRetryableError: websocket response completion closes are retryable unless policy close code is present', (t) => {
+    t.true(isTransientRetryableError(new Error('WebSocket connection closed before response completed')));
+    t.true(isTransientRetryableError(new Error('WebSocket connection closed before response completed (code=1006)')));
+    t.true(isTransientRetryableError(new Error('WebSocket connection closed before response completed (code=1001)')));
+    t.true(isTransientRetryableError(new Error('WebSocket connection closed before response completed (code=1011)')));
+    t.true(isTransientRetryableError(new Error('WebSocket connection closed before response completed (code=1012)')));
+    t.true(isTransientRetryableError(new Error('WebSocket connection closed before response completed (code=1013)')));
+    t.true(isTransientRetryableError(new Error('WebSocket closed before response.completed (code 1006: Connection ended)')));
+    t.false(isTransientRetryableError(new Error('WebSocket connection closed before response completed (code=1008, reason="rate limit exceeded")')));
+    t.false(isTransientRetryableError(new Error('WebSocket connection closed before response completed (code=1002)')));
+    t.false(isTransientRetryableError(new Error('WebSocket connection closed before response completed (code=1003)')));
+});
+test('isTransientRetryableError logs websocket close code at info level', (t) => {
+    const { calls, logger } = createLoggerMock();
+    t.true(isTransientRetryableError(new Error('WebSocket connection closed before response completed (code=1012, reason="service restart")'), logger));
+    t.is(calls.length, 1);
+    t.is(calls[0]?.message, 'WebSocket close code detected');
+    t.deepEqual(calls[0]?.meta, {
+        eventType: 'retry.websocket_close_code_detected',
+        category: 'retry',
+        closeCode: '1012',
+        errorMessage: 'WebSocket connection closed before response completed (code=1012, reason="service restart")',
+    });
+});
+test('isTransientRetryableError: terminated errors are retryable', (t) => {
+    t.true(isTransientRetryableError('terminated'));
+    t.true(isTransientRetryableError('terminated: other side closed'));
+    t.true(isTransientRetryableError(new Error('terminated')));
+    t.true(isTransientRetryableError(new Error('terminated: other side closed')));
+});
+test('isTransientRetryableError: non-retryable errors return false', (t) => {
+    t.false(isTransientRetryableError(new Error('something else')));
+    t.false(isTransientRetryableError(new ModelBehaviorError('Tool x not found')));
+    t.false(isTransientRetryableError(null));
+    t.false(isTransientRetryableError('string error'));
+    t.false(isTransientRetryableError('unterminated string'));
+    t.false(isTransientRetryableError(new Error('unterminated string')));
+    t.false(isTransientRetryableError(42));
+});
+test('isTransientRetryableError: stream parsing and JSON syntax errors are retryable', (t) => {
+    t.true(isTransientRetryableError(new Error("Expecting ',' delimiter: line 1 column 680 (char 679)")));
+    t.true(isTransientRetryableError(new SyntaxError('Unexpected end of JSON input')));
+    t.true(isTransientRetryableError(new Error('Unexpected token < in JSON at position 0')));
+    t.true(isTransientRetryableError(new SyntaxError('Expected double-quoted property name in JSON at position 39')));
+    // Undici throws a bare `new TypeError()` (empty message, no code) when the
+    // TLS socket closes mid-response-body. Stack originates in #onSocketClose.
+    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');
+    t.true(isNetworkProtocolError(undiciSocketClose));
+    t.true(isTransientRetryableError(undiciSocketClose));
+    t.deepEqual(isRetryableTransportError(undiciSocketClose), { retryable: true, transportFallback: true });
+    // Non-undici TypeError with empty message must NOT be flagged.
+    const plainTypeError = new TypeError();
+    plainTypeError.stack = 'TypeError\n    at userCode (file.ts:1:1)';
+    t.false(isNetworkProtocolError(plainTypeError));
+    t.false(isTransientRetryableError(plainTypeError));
+    // TypeError with a real message must NOT be flagged as a socket close.
+    const typedValueError = new TypeError('Cannot read properties of undefined');
+    t.false(isNetworkProtocolError(typedValueError));
+    // Re-wrapped undici socket close: plain Error with message "TypeError"
+    // and the original undici stack frames. Intermediate layers (SDK wrappers,
+    // stream collectors) may re-wrap the canonical bare TypeError into this form.
+    const rewrappedUndiciSocketClose = new Error('TypeError');
+    rewrappedUndiciSocketClose.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');
+    t.true(isNetworkProtocolError(rewrappedUndiciSocketClose));
+    t.true(isTransientRetryableError(rewrappedUndiciSocketClose));
+    t.deepEqual(isRetryableTransportError(rewrappedUndiciSocketClose), { retryable: true, transportFallback: true });
+    // Plain Error with message "TypeError" but NO undici stack must NOT be flagged.
+    const plainErrorWithTypeError = new Error('TypeError');
+    plainErrorWithTypeError.stack = 'Error: TypeError\n    at userCode (file.ts:1:1)';
+    t.false(isNetworkProtocolError(plainErrorWithTypeError));
+    t.false(isTransientRetryableError(plainErrorWithTypeError));
+});
+//# sourceMappingURL=retry-error-classification.test.js.map

package/dist/services/retry-error-classification.test.js.map

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

package/dist/services/retry-event-presenter.d.ts

@@ -0,0 +1,18 @@
+import type { ClassifiedFailure } from './retry-contracts.js';
+import type { ConversationEvent } from './conversation-events.js';
+export type RetryEventPresenterInput = {
+    failure: ClassifiedFailure;
+    maxTransientRetries: number;
+    maxModelRetries?: number;
+    source: 'initial' | 'continuation';
+    error: unknown;
+};
+export type RetryPresentation = {
+    event: ConversationEvent;
+    logMessage: string;
+    logFields: Record<string, any>;
+};
+export declare class RetryEventPresenter {
+    present(input: RetryEventPresenterInput): RetryPresentation;
+}
+//# sourceMappingURL=retry-event-presenter.d.ts.map

package/dist/services/retry-event-presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-event-presenter.d.ts","sourceRoot":"","sources":["../../source/services/retry-event-presenter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,SAAS,GAAG,cAAc,CAAC;IACnC,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,iBAAiB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC,CAAC;AAEF,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,EAAE,wBAAwB,GAAG,iBAAiB;CA+H5D"}

package/dist/services/retry-event-presenter.js

@@ -0,0 +1,124 @@
+export class RetryEventPresenter {
+    present(input) {
+        const { failure, maxTransientRetries, maxModelRetries, source, error } = input;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        switch (failure.kind) {
+            case 'service_tier_fallback': {
+                const event = {
+                    type: 'retry',
+                    toolName: 'service_tier',
+                    attempt: 1,
+                    maxRetries: 1,
+                    errorMessage: 'Flex service tier timed out. Falling back to standard service tier and retrying.',
+                    retryType: 'flex_service_tier',
+                };
+                const logMessage = 'Flex service tier timed out, retrying with standard service tier';
+                const logFields = {
+                    eventType: 'retry.flex_service_tier',
+                    category: 'retry',
+                    phase: 'retry',
+                    retryType: 'flex_service_tier',
+                    retryAttempt: 1,
+                    attempt: 1,
+                    maxRetries: 1,
+                    errorMessage,
+                };
+                return { event, logMessage, logFields };
+            }
+            case 'transient': {
+                const toolName = source === 'continuation' ? 'continuation' : 'turn';
+                const event = {
+                    type: 'retry',
+                    toolName,
+                    attempt: failure.attempt,
+                    maxRetries: maxTransientRetries,
+                    errorMessage,
+                    retryType: 'upstream',
+                };
+                const logMessage = source === 'continuation'
+                    ? 'Transient error in continuation, retrying'
+                    : 'Transient upstream error detected, retrying turn';
+                const logFields = {
+                    eventType: 'retry.transient',
+                    category: 'retry',
+                    phase: 'retry',
+                    retryType: 'upstream',
+                    retryAttempt: failure.attempt,
+                    attempt: failure.attempt,
+                    maxRetries: maxTransientRetries,
+                    errorMessage,
+                    delayMs: failure.delayMs,
+                };
+                return { event, logMessage, logFields };
+            }
+            case 'transport_downgrade': {
+                const event = {
+                    type: 'retry',
+                    toolName: 'transport',
+                    attempt: 1,
+                    maxRetries: 1,
+                    errorMessage: 'WebSocket retries exhausted. Falling back to HTTP transport and retrying.',
+                    retryType: 'upstream',
+                };
+                const logMessage = 'Transient upstream error exhausted WS retries, forcing HTTP fallback';
+                const logFields = {
+                    eventType: 'retry.transport_fallback',
+                    category: 'retry',
+                    phase: 'retry',
+                    retryType: 'upstream',
+                    retryAttempt: 1,
+                    attempt: 1,
+                    maxRetries: 1,
+                    errorMessage,
+                };
+                return { event, logMessage, logFields };
+            }
+            case 'model_retry': {
+                const event = failure.retryEvent ?? {
+                    type: 'retry',
+                    toolName: 'model',
+                    attempt: 1,
+                    maxRetries: maxModelRetries ?? 3,
+                    errorMessage,
+                    retryType: 'behavior',
+                };
+                const logMessage = 'Recoverable model error detected, retrying';
+                const logFields = {
+                    eventType: 'retry.model_error',
+                    category: 'retry',
+                    phase: 'retry',
+                    retryType: 'hallucination',
+                    retryAttempt: 1,
+                    attempt: 1,
+                    maxRetries: maxModelRetries ?? 3,
+                    errorMessage,
+                };
+                return { event, logMessage, logFields };
+            }
+            default: {
+                const toolName = source === 'continuation' ? 'continuation' : 'turn';
+                const event = {
+                    type: 'retry',
+                    toolName,
+                    attempt: 1,
+                    maxRetries: maxTransientRetries,
+                    errorMessage,
+                    retryType: 'upstream',
+                };
+                const logMessage = 'Unknown retry decision';
+                const logFields = {
+                    eventType: 'retry.unknown',
+                    category: 'retry',
+                    phase: 'retry',
+                    retryType: 'upstream',
+                    retryAttempt: 1,
+                    attempt: 1,
+                    maxRetries: maxTransientRetries,
+                    errorMessage,
+                };
+                return { event, logMessage, logFields };
+            }
+        }
+    }
+}
+//# sourceMappingURL=retry-event-presenter.js.map

package/dist/services/retry-event-presenter.js.map

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

package/dist/services/retry-event-presenter.test.d.ts

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

package/dist/services/retry-event-presenter.test.d.ts.map

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

package/dist/services/retry-event-presenter.test.js

@@ -0,0 +1,194 @@
+import test from 'ava';
+import { RetryEventPresenter } from './retry-event-presenter.js';
+test('RetryEventPresenter handles transient retry (initial source)', (t) => {
+    const presenter = new RetryEventPresenter();
+    const failure = {
+        kind: 'transient',
+        attempt: 2,
+        delayMs: 1000,
+    };
+    const error = new Error('Upstream down');
+    const presentation = presenter.present({
+        failure,
+        maxTransientRetries: 5,
+        source: 'initial',
+        error,
+    });
+    t.deepEqual(presentation.event, {
+        type: 'retry',
+        toolName: 'turn',
+        attempt: 2,
+        maxRetries: 5,
+        errorMessage: 'Upstream down',
+        retryType: 'upstream',
+    });
+    t.is(presentation.logMessage, 'Transient upstream error detected, retrying turn');
+    t.deepEqual(presentation.logFields, {
+        eventType: 'retry.transient',
+        category: 'retry',
+        phase: 'retry',
+        retryType: 'upstream',
+        retryAttempt: 2,
+        attempt: 2,
+        maxRetries: 5,
+        errorMessage: 'Upstream down',
+        delayMs: 1000,
+    });
+});
+test('RetryEventPresenter handles transient retry (continuation source)', (t) => {
+    const presenter = new RetryEventPresenter();
+    const failure = {
+        kind: 'transient',
+        attempt: 3,
+        delayMs: 2000,
+    };
+    const error = 'String error message';
+    const presentation = presenter.present({
+        failure,
+        maxTransientRetries: 5,
+        source: 'continuation',
+        error,
+    });
+    t.deepEqual(presentation.event, {
+        type: 'retry',
+        toolName: 'continuation',
+        attempt: 3,
+        maxRetries: 5,
+        errorMessage: 'String error message',
+        retryType: 'upstream',
+    });
+    t.is(presentation.logMessage, 'Transient error in continuation, retrying');
+    t.deepEqual(presentation.logFields, {
+        eventType: 'retry.transient',
+        category: 'retry',
+        phase: 'retry',
+        retryType: 'upstream',
+        retryAttempt: 3,
+        attempt: 3,
+        maxRetries: 5,
+        errorMessage: 'String error message',
+        delayMs: 2000,
+    });
+});
+test('RetryEventPresenter handles service-tier fallback', (t) => {
+    const presenter = new RetryEventPresenter();
+    const failure = {
+        kind: 'service_tier_fallback',
+    };
+    const error = new Error('Flex timeout');
+    const presentation = presenter.present({
+        failure,
+        maxTransientRetries: 3,
+        source: 'initial',
+        error,
+    });
+    t.deepEqual(presentation.event, {
+        type: 'retry',
+        toolName: 'service_tier',
+        attempt: 1,
+        maxRetries: 1,
+        errorMessage: 'Flex service tier timed out. Falling back to standard service tier and retrying.',
+        retryType: 'flex_service_tier',
+    });
+    t.is(presentation.logMessage, 'Flex service tier timed out, retrying with standard service tier');
+    t.deepEqual(presentation.logFields, {
+        eventType: 'retry.flex_service_tier',
+        category: 'retry',
+        phase: 'retry',
+        retryType: 'flex_service_tier',
+        retryAttempt: 1,
+        attempt: 1,
+        maxRetries: 1,
+        errorMessage: 'Flex timeout',
+    });
+});
+test('RetryEventPresenter handles transport downgrade', (t) => {
+    const presenter = new RetryEventPresenter();
+    const failure = {
+        kind: 'transport_downgrade',
+    };
+    const error = new Error('WS connection closed');
+    const presentation = presenter.present({
+        failure,
+        maxTransientRetries: 3,
+        source: 'initial',
+        error,
+    });
+    t.deepEqual(presentation.event, {
+        type: 'retry',
+        toolName: 'transport',
+        attempt: 1,
+        maxRetries: 1,
+        errorMessage: 'WebSocket retries exhausted. Falling back to HTTP transport and retrying.',
+        retryType: 'upstream',
+    });
+    t.is(presentation.logMessage, 'Transient upstream error exhausted WS retries, forcing HTTP fallback');
+    t.deepEqual(presentation.logFields, {
+        eventType: 'retry.transport_fallback',
+        category: 'retry',
+        phase: 'retry',
+        retryType: 'upstream',
+        retryAttempt: 1,
+        attempt: 1,
+        maxRetries: 1,
+        errorMessage: 'WS connection closed',
+    });
+});
+test('RetryEventPresenter handles model retry', (t) => {
+    const presenter = new RetryEventPresenter();
+    const failure = {
+        kind: 'model_retry',
+    };
+    const error = new Error('Model hallucinated tool call');
+    const presentation = presenter.present({
+        failure,
+        maxTransientRetries: 3,
+        maxModelRetries: 4,
+        source: 'initial',
+        error,
+    });
+    t.deepEqual(presentation.event, {
+        type: 'retry',
+        toolName: 'model',
+        attempt: 1,
+        maxRetries: 4,
+        errorMessage: 'Model hallucinated tool call',
+        retryType: 'behavior',
+    });
+    t.is(presentation.logMessage, 'Recoverable model error detected, retrying');
+    t.deepEqual(presentation.logFields, {
+        eventType: 'retry.model_error',
+        category: 'retry',
+        phase: 'retry',
+        retryType: 'hallucination',
+        retryAttempt: 1,
+        attempt: 1,
+        maxRetries: 4,
+        errorMessage: 'Model hallucinated tool call',
+    });
+});
+test('RetryEventPresenter handles model retry with specific event', (t) => {
+    const presenter = new RetryEventPresenter();
+    const mockRetryEvent = {
+        type: 'retry',
+        toolName: 'custom-model',
+        attempt: 2,
+        maxRetries: 3,
+        errorMessage: 'Specific model failure',
+        retryType: 'parsing_error',
+    };
+    const failure = {
+        kind: 'model_retry',
+        retryEvent: mockRetryEvent,
+    };
+    const error = new Error('Parsing error');
+    const presentation = presenter.present({
+        failure,
+        maxTransientRetries: 3,
+        source: 'initial',
+        error,
+    });
+    t.is(presentation.event, mockRetryEvent);
+    t.is(presentation.logMessage, 'Recoverable model error detected, retrying');
+});
+//# sourceMappingURL=retry-event-presenter.test.js.map

package/dist/services/retry-event-presenter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-event-presenter.test.js","sourceRoot":"","sources":["../../source/services/retry-event-presenter.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,KAAK,CAAC;AACvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,IAAI,CAAC,8DAA8D,EAAE,CAAC,CAAC,EAAE,EAAE;IACzE,MAAM,SAAS,GAAG,IAAI,mBAAmB,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAsB;QACjC,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,IAAI;KACd,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IAEzC,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC;QACrC,OAAO;QACP,mBAAmB,EAAE,CAAC;QACtB,MAAM,EAAE,SAAS;QACjB,KAAK;KACN,CAAC,CAAC;IAEH,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE;QAC9B,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,eAAe;QAC7B,SAAS,EAAE,UAAU;KACtB,CAAC,CAAC;IAEH,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,kDAAkD,CAAC,CAAC;IAClF,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,SAAS,EAAE;QAClC,SAAS,EAAE,iBAAiB;QAC5B,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,OAAO;QACd,SAAS,EAAE,UAAU;QACrB,YAAY,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,eAAe;QAC7B,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,mEAAmE,EAAE,CAAC,CAAC,EAAE,EAAE;IAC9E,MAAM,SAAS,GAAG,IAAI,mBAAmB,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAsB;QACjC,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,IAAI;KACd,CAAC;IACF,MAAM,KAAK,GAAG,sBAAsB,CAAC;IAErC,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC;QACrC,OAAO;QACP,mBAAmB,EAAE,CAAC;QACtB,MAAM,EAAE,cAAc;QACtB,KAAK;KACN,CAAC,CAAC;IAEH,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE;QAC9B,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,cAAc;QACxB,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,sBAAsB;QACpC,SAAS,EAAE,UAAU;KACtB,CAAC,CAAC;IAEH,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,2CAA2C,CAAC,CAAC;IAC3E,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,SAAS,EAAE;QAClC,SAAS,EAAE,iBAAiB;QAC5B,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,OAAO;QACd,SAAS,EAAE,UAAU;QACrB,YAAY,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,sBAAsB;QACpC,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,mDAAmD,EAAE,CAAC,CAAC,EAAE,EAAE;IAC9D,MAAM,SAAS,GAAG,IAAI,mBAAmB,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAsB;QACjC,IAAI,EAAE,uBAAuB;KAC9B,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;IAExC,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC;QACrC,OAAO;QACP,mBAAmB,EAAE,CAAC;QACtB,MAAM,EAAE,SAAS;QACjB,KAAK;KACN,CAAC,CAAC;IAEH,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE;QAC9B,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,cAAc;QACxB,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,kFAAkF;QAChG,SAAS,EAAE,mBAAmB;KAC/B,CAAC,CAAC;IAEH,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,kEAAkE,CAAC,CAAC;IAClG,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,SAAS,EAAE;QAClC,SAAS,EAAE,yBAAyB;QACpC,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,OAAO;QACd,SAAS,EAAE,mBAAmB;QAC9B,YAAY,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,cAAc;KAC7B,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,iDAAiD,EAAE,CAAC,CAAC,EAAE,EAAE;IAC5D,MAAM,SAAS,GAAG,IAAI,mBAAmB,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAsB;QACjC,IAAI,EAAE,qBAAqB;KAC5B,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAEhD,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC;QACrC,OAAO;QACP,mBAAmB,EAAE,CAAC;QACtB,MAAM,EAAE,SAAS;QACjB,KAAK;KACN,CAAC,CAAC;IAEH,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE;QAC9B,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,2EAA2E;QACzF,SAAS,EAAE,UAAU;KACtB,CAAC,CAAC;IAEH,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,sEAAsE,CAAC,CAAC;IACtG,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,SAAS,EAAE;QAClC,SAAS,EAAE,0BAA0B;QACrC,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,OAAO;QACd,SAAS,EAAE,UAAU;QACrB,YAAY,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,sBAAsB;KACrC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yCAAyC,EAAE,CAAC,CAAC,EAAE,EAAE;IACpD,MAAM,SAAS,GAAG,IAAI,mBAAmB,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAsB;QACjC,IAAI,EAAE,aAAa;KACpB,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAExD,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC;QACrC,OAAO;QACP,mBAAmB,EAAE,CAAC;QACtB,eAAe,EAAE,CAAC;QAClB,MAAM,EAAE,SAAS;QACjB,KAAK;KACN,CAAC,CAAC;IAEH,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE;QAC9B,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,OAAO;QACjB,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,8BAA8B;QAC5C,SAAS,EAAE,UAAU;KACtB,CAAC,CAAC;IAEH,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,4CAA4C,CAAC,CAAC;IAC5E,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,SAAS,EAAE;QAClC,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,OAAO;QACd,SAAS,EAAE,eAAe;QAC1B,YAAY,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,8BAA8B;KAC7C,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,6DAA6D,EAAE,CAAC,CAAC,EAAE,EAAE;IACxE,MAAM,SAAS,GAAG,IAAI,mBAAmB,EAAE,CAAC;IAC5C,MAAM,cAAc,GAAG;QACrB,IAAI,EAAE,OAAgB;QACtB,QAAQ,EAAE,cAAc;QACxB,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,wBAAwB;QACtC,SAAS,EAAE,eAAwB;KACpC,CAAC;IACF,MAAM,OAAO,GAAsB;QACjC,IAAI,EAAE,aAAa;QACnB,UAAU,EAAE,cAAc;KAC3B,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IAEzC,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC;QACrC,OAAO;QACP,mBAAmB,EAAE,CAAC;QACtB,MAAM,EAAE,SAAS;QACjB,KAAK;KACN,CAAC,CAAC;IAEH,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IACzC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,4CAA4C,CAAC,CAAC;AAC9E,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,51 @@
+import type { AgentStream } from './agent-stream.js';
+import { decideRetry } from './conversation-retry-policy.js';
+import { ConversationStore } from './conversation-store.js';
+import type { ILoggingService } from './service-interfaces.js';
+import { ToolExecutionLedger, type SavedToolExecution } from './tool-execution-ledger.js';
+import type { ConversationAgentClient } from './conversation-agent-client.js';
+export type RetryDecision = {
+    kind: 'none';
+} | {
+    kind: 'flex_fallback';
+} | {
+    kind: 'transient';
+    delay: number;
+    attempt: number;
+} | {
+    kind: 'transport_downgrade';
+} | {
+    kind: 'hallucination';
+    decision: ReturnType<typeof decideRetry>;
+} | {
+    kind: 'unrecoverable';
+};
+export declare class RetryHandler {
+    private logger;
+    private sessionId;
+    private agentClient;
+    private random;
+    constructor(logger: ILoggingService, sessionId: string, agentClient: ConversationAgentClient, random?: () => number);
+    classifyError(opts: {
+        error: unknown;
+        transientRetryCount: number;
+        transportFallbackRetryCount: number;
+        hallucinationRetryCount: number;
+        flexServiceTierFallbackCount: number;
+        maxTransientRetries: number;
+        stream: AgentStream | null;
+        streamHistoryLength: number;
+        maxModelRetries?: number;
+    }): RetryDecision;
+    getTransientDelay(attempt: number): number;
+    restoreForRetry(opts: {
+        ledgerSnapshot: SavedToolExecution[];
+        stream: AgentStream | null;
+        toolLedger: ToolExecutionLedger;
+        conversationStore: ConversationStore;
+        clearPreviousResponseId: () => void;
+        restoreCompletedToolLedgerEntries: (snapshot: SavedToolExecution[]) => void;
+        removeLastUserMessage?: () => void;
+    }): void;
+}
+//# sourceMappingURL=retry-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retry-handler.d.ts","sourceRoot":"","sources":["../../source/services/retry-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,WAAW,EAA6B,MAAM,gCAAgC,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,EAEL,mBAAmB,EACnB,KAAK,kBAAkB,EACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAE9E,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,qBAAqB,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AAE9B,qBAAa,YAAY;IAErB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,MAAM;gBAHN,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,uBAAuB,EACpC,MAAM,GAAE,MAAM,MAAoB;IAG5C,aAAa,CAAC,IAAI,EAAE;QAClB,KAAK,EAAE,OAAO,CAAC;QACf,mBAAmB,EAAE,MAAM,CAAC;QAC5B,2BAA2B,EAAE,MAAM,CAAC;QACpC,uBAAuB,EAAE,MAAM,CAAC;QAChC,4BAA4B,EAAE,MAAM,CAAC;QACrC,mBAAmB,EAAE,MAAM,CAAC;QAC5B,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;QAC3B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,GAAG,aAAa;IAiEjB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI1C,eAAe,CAAC,IAAI,EAAE;QACpB,cAAc,EAAE,kBAAkB,EAAE,CAAC;QACrC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;QAC3B,UAAU,EAAE,mBAAmB,CAAC;QAChC,iBAAiB,EAAE,iBAAiB,CAAC;QACrC,uBAAuB,EAAE,MAAM,IAAI,CAAC;QACpC,iCAAiC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,KAAK,IAAI,CAAC;QAC5E,qBAAqB,CAAC,EAAE,MAAM,IAAI,CAAC;KACpC,GAAG,IAAI;CA2BT"}