@qduc/term2 0.7.2 → 0.8.0

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

@@ -0,0 +1,179 @@
+import { it, expect } from 'vitest';
+import { RetryEventPresenter } from './retry-event-presenter.js';
+it('RetryEventPresenter handles transient retry (initial source)', () => {
+    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,
+    });
+    expect(presentation.event).toEqual({
+        type: 'retry',
+        toolName: 'turn',
+        attempt: 2,
+        maxRetries: 5,
+        errorMessage: 'Upstream down',
+        retryType: 'upstream',
+    });
+    expect(presentation.logMessage).toBe('Transient upstream error detected, retrying turn');
+    expect(presentation.logFields).toEqual({
+        eventType: 'retry.transient',
+        retryType: 'upstream',
+        retryAttempt: 2,
+        maxRetries: 5,
+        errorMessage: 'Upstream down',
+        delayMs: 1000,
+    });
+});
+it('RetryEventPresenter handles transient retry (continuation source)', () => {
+    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,
+    });
+    expect(presentation.event).toEqual({
+        type: 'retry',
+        toolName: 'continuation',
+        attempt: 3,
+        maxRetries: 5,
+        errorMessage: 'String error message',
+        retryType: 'upstream',
+    });
+    expect(presentation.logMessage).toBe('Transient error in continuation, retrying');
+    expect(presentation.logFields).toEqual({
+        eventType: 'retry.transient',
+        retryType: 'upstream',
+        retryAttempt: 3,
+        maxRetries: 5,
+        errorMessage: 'String error message',
+        delayMs: 2000,
+    });
+});
+it('RetryEventPresenter handles service-tier fallback', () => {
+    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,
+    });
+    expect(presentation.event).toEqual({
+        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',
+    });
+    expect(presentation.logMessage).toBe('Flex service tier timed out, retrying with standard service tier');
+    expect(presentation.logFields).toEqual({
+        eventType: 'retry.flex_service_tier',
+        retryType: 'flex_service_tier',
+        retryAttempt: 1,
+        maxRetries: 1,
+        errorMessage: 'Flex timeout',
+    });
+});
+it('RetryEventPresenter handles transport downgrade', () => {
+    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,
+    });
+    expect(presentation.event).toEqual({
+        type: 'retry',
+        toolName: 'transport',
+        attempt: 1,
+        maxRetries: 1,
+        errorMessage: 'WebSocket retries exhausted. Falling back to HTTP transport and retrying.',
+        retryType: 'upstream',
+    });
+    expect(presentation.logMessage).toBe('Transient upstream error exhausted WS retries, forcing HTTP fallback');
+    expect(presentation.logFields).toEqual({
+        eventType: 'retry.transport_fallback',
+        retryType: 'upstream',
+        retryAttempt: 1,
+        maxRetries: 1,
+        errorMessage: 'WS connection closed',
+    });
+});
+it('RetryEventPresenter handles model retry', () => {
+    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,
+    });
+    expect(presentation.event).toEqual({
+        type: 'retry',
+        toolName: 'model',
+        attempt: 1,
+        maxRetries: 4,
+        errorMessage: 'Model hallucinated tool call',
+        retryType: 'behavior',
+    });
+    expect(presentation.logMessage).toBe('Recoverable model error detected, retrying');
+    expect(presentation.logFields).toEqual({
+        eventType: 'retry.model_error',
+        retryType: 'hallucination',
+        retryAttempt: 1,
+        maxRetries: 4,
+        errorMessage: 'Model hallucinated tool call',
+    });
+});
+it('RetryEventPresenter handles model retry with specific event', () => {
+    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,
+    });
+    expect(presentation.event).toBe(mockRetryEvent);
+    expect(presentation.logMessage).toBe('Recoverable model error detected, retrying');
+});
+//# sourceMappingURL=retry-event-presenter.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retry-event-presenter.test.js","sourceRoot":"","sources":["../../../source/services/retry/retry-event-presenter.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;IACtE,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,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;QACjC,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,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IACzF,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC;QACrC,SAAS,EAAE,iBAAiB;QAC5B,SAAS,EAAE,UAAU;QACrB,YAAY,EAAE,CAAC;QACf,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,eAAe;QAC7B,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;IAC3E,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,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;QACjC,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,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IAClF,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC;QACrC,SAAS,EAAE,iBAAiB;QAC5B,SAAS,EAAE,UAAU;QACrB,YAAY,EAAE,CAAC;QACf,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,sBAAsB;QACpC,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;IAC3D,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,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;QACjC,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,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;IACzG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC;QACrC,SAAS,EAAE,yBAAyB;QACpC,SAAS,EAAE,mBAAmB;QAC9B,YAAY,EAAE,CAAC;QACf,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,cAAc;KAC7B,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;IACzD,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,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;QACjC,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,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;IAC7G,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC;QACrC,SAAS,EAAE,0BAA0B;QACrC,SAAS,EAAE,UAAU;QACrB,YAAY,EAAE,CAAC;QACf,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,sBAAsB;KACrC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACjD,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,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;QACjC,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,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IACnF,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC;QACrC,SAAS,EAAE,mBAAmB;QAC9B,SAAS,EAAE,eAAe;QAC1B,YAAY,EAAE,CAAC;QACf,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,8BAA8B;KAC7C,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;IACrE,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,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAChD,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;AACrF,CAAC,CAAC,CAAC"}

package/dist/services/retry/upstream-retry-policy.d.ts

@@ -0,0 +1,15 @@
+export type UpstreamRetryClassification = {
+    retryable: boolean;
+    status?: number;
+    retryAfterMs?: number;
+    reason?: string;
+};
+export declare const getRetryAfterMs: (source: unknown) => number | undefined;
+export declare function classifyUpstreamRetryableError(error: unknown): UpstreamRetryClassification;
+export declare function computeUpstreamRetryDelayMs({ retryAfterMs, attemptIndex, attemptNumber, random, }: {
+    retryAfterMs?: number;
+    attemptIndex?: number;
+    attemptNumber?: number;
+    random?: () => number;
+}): number;
+//# sourceMappingURL=upstream-retry-policy.d.ts.map

package/dist/services/retry/upstream-retry-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstream-retry-policy.d.ts","sourceRoot":"","sources":["../../../source/services/retry/upstream-retry-policy.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,2BAA2B,GAAG;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AA2DF,eAAO,MAAM,eAAe,GAAI,QAAQ,OAAO,KAAG,MAAM,GAAG,SAK1D,CAAC;AAEF,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,2BAA2B,CAgE1F;AAED,wBAAgB,2BAA2B,CAAC,EAC1C,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,MAAoB,GACrB,EAAE;IACD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CACvB,GAAG,MAAM,CAqBT"}

package/dist/services/retry/upstream-retry-policy.js

@@ -0,0 +1,136 @@
+/*
+ * Shared upstream/provider retry policy.
+ *
+ * This module classifies transient provider/upstream failures and computes
+ * backoff for the shared retry loop used by retry-handler, retry-executor,
+ * and provider fallback paths. It does not cover model repair retries or the
+ * user-initiated /retry command flow.
+ */
+import { APIConnectionError, APIConnectionTimeoutError, InternalServerError, RateLimitError } from 'openai';
+import { OpenAICompatibleError, OpenRouterError, LongRetryDelayError } from '../../providers/common/provider-errors.js';
+const RATE_LIMIT_MESSAGE_PATTERNS = ['rate limit', 'too many requests', 'rate_limit'];
+const getMessage = (error) => {
+    if (typeof error === 'string')
+        return error;
+    if (error && typeof error === 'object' && 'message' in error) {
+        return String(error.message ?? '');
+    }
+    return '';
+};
+const parseStatus = (value) => {
+    const status = typeof value === 'number' ? value : parseInt(String(value), 10);
+    return Number.isInteger(status) ? status : undefined;
+};
+const getHeadersSource = (source) => {
+    if (!source || typeof source !== 'object')
+        return undefined;
+    if ('get' in source && typeof source.get === 'function') {
+        return source;
+    }
+    if ('headers' in source) {
+        const headers = source.headers;
+        if (!headers || typeof headers !== 'object')
+            return undefined;
+        return headers;
+    }
+    return source;
+};
+const getHeaderValue = (source, name) => {
+    const headers = getHeadersSource(source);
+    if (!headers)
+        return undefined;
+    if ('get' in headers && typeof headers.get === 'function') {
+        const value = headers.get(name);
+        return value == null ? undefined : String(value);
+    }
+    const wanted = name.toLowerCase();
+    for (const key of Object.keys(headers)) {
+        if (key.toLowerCase() === wanted) {
+            const value = headers[key];
+            return value == null ? undefined : String(value);
+        }
+    }
+    return undefined;
+};
+export const getRetryAfterMs = (source) => {
+    const retryAfter = getHeaderValue(source, 'retry-after');
+    if (retryAfter === undefined)
+        return undefined;
+    const retryAfterSeconds = parseInt(retryAfter, 10);
+    return Number.isFinite(retryAfterSeconds) ? retryAfterSeconds * 1000 : undefined;
+};
+export function classifyUpstreamRetryableError(error) {
+    if (error instanceof LongRetryDelayError) {
+        // Retry-after > 60s — don't retry, the user would wait too long
+        return { retryable: false, reason: 'long-retry-delay' };
+    }
+    if (error instanceof RateLimitError) {
+        const retryAfterMs = getRetryAfterMs(error);
+        if (retryAfterMs !== undefined && retryAfterMs > 60_000) {
+            return { retryable: false, retryAfterMs, reason: 'long-retry-delay' };
+        }
+        return {
+            retryable: true,
+            status: parseStatus(error.status),
+            retryAfterMs,
+            reason: 'openai-sdk',
+        };
+    }
+    if (error instanceof APIConnectionError ||
+        error instanceof APIConnectionTimeoutError ||
+        error instanceof InternalServerError) {
+        return {
+            retryable: true,
+            status: parseStatus(error.status),
+            retryAfterMs: getRetryAfterMs(error),
+            reason: 'openai-sdk',
+        };
+    }
+    if (error instanceof OpenRouterError || error instanceof OpenAICompatibleError) {
+        const status = error.status;
+        const retryable = status === 429 || status >= 500;
+        return {
+            retryable,
+            status,
+            retryAfterMs: getRetryAfterMs(error.headers),
+            reason: 'provider-status',
+        };
+    }
+    if (!error || typeof error !== 'object') {
+        return { retryable: false };
+    }
+    const status = parseStatus(error.status ?? error.statusCode);
+    if (status !== undefined) {
+        return {
+            retryable: status === 429 || status >= 500,
+            status,
+            retryAfterMs: getRetryAfterMs(error),
+            reason: 'generic-status',
+        };
+    }
+    const message = getMessage(error).toLowerCase();
+    const retryable = RATE_LIMIT_MESSAGE_PATTERNS.some((pattern) => message.includes(pattern));
+    return {
+        retryable,
+        retryAfterMs: getRetryAfterMs(error),
+        ...(retryable ? { reason: 'rate-limit-message' } : {}),
+    };
+}
+export function computeUpstreamRetryDelayMs({ retryAfterMs, attemptIndex, attemptNumber, random = Math.random, }) {
+    if (retryAfterMs !== undefined && Number.isFinite(retryAfterMs)) {
+        return retryAfterMs;
+    }
+    if (attemptIndex !== undefined) {
+        const baseDelay = 5000 + random() * 25000;
+        const exponentialDelay = baseDelay * Math.pow(2, attemptIndex);
+        const cappedDelay = Math.min(exponentialDelay, 30000);
+        return random() * cappedDelay;
+    }
+    if (attemptNumber !== undefined) {
+        const baseDelay = Math.min(500 * Math.pow(2, attemptNumber - 1), 30000);
+        const jitter = 0.9 + random() * 0.2;
+        return Math.round(baseDelay * jitter);
+    }
+    throw new Error('computeUpstreamRetryDelayMs requires attemptIndex or attemptNumber when retryAfterMs is not provided');
+}
+//# sourceMappingURL=upstream-retry-policy.js.map

package/dist/services/retry/upstream-retry-policy.js.map

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

package/dist/services/retry/upstream-retry-policy.test.d.ts

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

package/dist/services/retry/upstream-retry-policy.test.d.ts.map

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

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

@@ -0,0 +1,125 @@
+import { it, expect } from 'vitest';
+import { RateLimitError } from 'openai';
+import { OpenAICompatibleError, OpenRouterError, LongRetryDelayError } from '../../providers/common/provider-errors.js';
+import { classifyUpstreamRetryableError, computeUpstreamRetryDelayMs, getRetryAfterMs, } from './upstream-retry-policy.js';
+function asInstanceOf(prototype, props) {
+    return Object.assign(Object.create(prototype), props);
+}
+it('getRetryAfterMs parses case-insensitive Retry-After from generic Headers-like objects', () => {
+    const headers = {
+        get(name) {
+            return name.toLowerCase() === 'retry-after' ? '12' : null;
+        },
+    };
+    expect(getRetryAfterMs({ headers })).toBe(12000);
+});
+it('getRetryAfterMs ignores invalid Retry-After values', () => {
+    expect(getRetryAfterMs({ headers: { 'retry-after': 'not-a-number' } })).toBe(undefined);
+});
+it('classifyUpstreamRetryableError marks OpenRouter and OpenAI-compatible upstream statuses retryable', () => {
+    const openrouter = classifyUpstreamRetryableError(new OpenRouterError('server error', 503, {}));
+    const compatible = classifyUpstreamRetryableError(new OpenAICompatibleError('rate limited', 429, {}));
+    expect(openrouter).toMatchObject({
+        retryable: true,
+        status: 503,
+        reason: 'provider-status',
+    });
+    expect(compatible).toMatchObject({
+        retryable: true,
+        status: 429,
+        reason: 'provider-status',
+    });
+});
+it('classifyUpstreamRetryableError marks generic 429/5xx and rate-limit messages retryable', () => {
+    const err429 = new Error('too many requests');
+    err429.status = 429;
+    const err503 = new Error('service unavailable');
+    err503.statusCode = 503;
+    expect(classifyUpstreamRetryableError(err429)).toMatchObject({
+        retryable: true,
+        status: 429,
+        reason: 'generic-status',
+    });
+    expect(classifyUpstreamRetryableError(err503)).toMatchObject({
+        retryable: true,
+        status: 503,
+        reason: 'generic-status',
+    });
+    expect(classifyUpstreamRetryableError(new Error('Rate limit exceeded'))).toMatchObject({
+        retryable: true,
+        reason: 'rate-limit-message',
+    });
+});
+it('classifyUpstreamRetryableError keeps non-retryable 400 errors rejected', () => {
+    expect(classifyUpstreamRetryableError(new OpenAICompatibleError('bad request', 400, {}))).toMatchObject({
+        retryable: false,
+        status: 400,
+        reason: 'provider-status',
+    });
+});
+it('computeUpstreamRetryDelayMs uses Retry-After override before jittered backoff', () => {
+    expect(computeUpstreamRetryDelayMs({ retryAfterMs: 7000, attemptIndex: 1, random: () => 0.9 })).toBe(7000);
+    let randomIndex = 0;
+    const randomValues = [0.4, 0.2, 0.5, 0.8];
+    const random = () => {
+        const value = randomValues[randomIndex];
+        randomIndex += 1;
+        return value;
+    };
+    expect(computeUpstreamRetryDelayMs({ attemptIndex: 0, random })).toBe(3000);
+    expect(computeUpstreamRetryDelayMs({ attemptIndex: 1, random })).toBe(24000);
+});
+it('computeUpstreamRetryDelayMs uses session attempt numbers for bounded jitter', () => {
+    let randomIndex = 0;
+    const randomValues = [0, 1];
+    const random = () => {
+        const value = randomValues[randomIndex];
+        randomIndex += 1;
+        return value;
+    };
+    expect(computeUpstreamRetryDelayMs({ attemptNumber: 1, random })).toBe(450);
+    expect(computeUpstreamRetryDelayMs({ attemptNumber: 3, random })).toBe(2200);
+});
+it('classifyUpstreamRetryableError marks RateLimitExceededError non-retryable', () => {
+    expect(classifyUpstreamRetryableError(new LongRetryDelayError(120))).toMatchObject({
+        retryable: false,
+        reason: 'long-retry-delay',
+    });
+    expect(classifyUpstreamRetryableError(new LongRetryDelayError(300))).toMatchObject({
+        retryable: false,
+        reason: 'long-retry-delay',
+    });
+});
+it('classifyUpstreamRetryableError marks RateLimitError with retry-after > 60s non-retryable', () => {
+    const err = new RateLimitError(429, 'rate limited', 'rate limited', { get: () => '120' });
+    expect(classifyUpstreamRetryableError(err)).toMatchObject({
+        retryable: false,
+        reason: 'long-retry-delay',
+    });
+});
+it('classifyUpstreamRetryableError marks RateLimitError with retry-after <= 60s retryable', () => {
+    const err = new RateLimitError(429, 'rate limited', 'rate limited', { get: () => '30' });
+    expect(classifyUpstreamRetryableError(err)).toMatchObject({
+        retryable: true,
+        reason: 'openai-sdk',
+    });
+});
+it('classifyUpstreamRetryableError marks RateLimitError without retry-after retryable', () => {
+    const err = new RateLimitError(429, 'rate limited', 'rate limited', { get: () => null });
+    expect(classifyUpstreamRetryableError(err)).toMatchObject({
+        retryable: true,
+        reason: 'openai-sdk',
+    });
+});
+it('classifyUpstreamRetryableError parses retry-after from generic error headers', () => {
+    const error = asInstanceOf(Error.prototype, { message: 'rate limited' });
+    error.statusCode = 429;
+    error.headers = { 'Retry-After': '7' };
+    expect(classifyUpstreamRetryableError(error)).toMatchObject({
+        retryable: true,
+        status: 429,
+        retryAfterMs: 7000,
+        reason: 'generic-status',
+    });
+});
+//# sourceMappingURL=upstream-retry-policy.test.js.map

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

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

package/dist/services/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-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-classifier.d.ts","sourceRoot":"","sources":["../../source/services/retry-classifier.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAW9E,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;CA8B5D"}

package/dist/services/retry-classifier.js

@@ -0,0 +1,41 @@
+import { decideRetry } from './conversation-retry-policy.js';
+import { 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 (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-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-classifier.js","sourceRoot":"","sources":["../../source/services/retry-classifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAE5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG5D,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,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-classifier.test.d.ts

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

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

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