@qduc/term2 0.7.3 → 0.9.0

package/dist/services/recovery-executor.test.d.ts

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

package/dist/services/recovery-executor.test.d.ts.map

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

package/dist/services/recovery-executor.test.js

@@ -0,0 +1,192 @@
+import test from 'ava';
+import { ConversationStore } from './conversation-store.js';
+import { DefaultRecoveryExecutor } from './recovery-executor.js';
+import { ProviderContinuity } from './provider-continuity.js';
+import { SessionToolTracker } from './session-tool-tracker.js';
+const baseCounts = () => ({
+    transientRetryCount: 0,
+    serviceTierFallbackCount: 0,
+    modelRetryCount: 0,
+    transportDowngradeCount: 0,
+});
+const makeExecutor = () => {
+    const conversationStore = new ConversationStore();
+    const toolTracker = new SessionToolTracker(conversationStore);
+    const providerContinuity = new ProviderContinuity();
+    const deps = { toolTracker, conversationStore, providerContinuity };
+    const executor = new DefaultRecoveryExecutor(deps);
+    return { executor, deps };
+};
+const baseRecoveryState = (overrides = {}) => ({
+    ledgerSnapshot: [],
+    addedUserMessage: false,
+    stream: null,
+    ...overrides,
+});
+test('resume_stream returns run instruction with resume state', (t) => {
+    const { executor } = makeExecutor();
+    const mockState = { _currentTurn: 'x' };
+    const result = executor.apply({
+        plan: { kind: 'resume_stream', state: mockState, previousResponseId: 'resp-1' },
+        state: baseRecoveryState(),
+        retryCounts: baseCounts(),
+    });
+    t.is(result.kind, 'run');
+    if (result.kind !== 'run')
+        return;
+    t.true(result.instruction.skipUserMessage);
+    t.is(result.instruction.resumeState, mockState);
+    t.is(result.instruction.resumePreviousResponseId, 'resp-1');
+});
+test('replay_turn with rollback removes user message and clears continuity', (t) => {
+    const { executor, deps } = makeExecutor();
+    deps.conversationStore.addUserMessage('hello');
+    deps.providerContinuity.update('resp-old');
+    const result = executor.apply({
+        plan: { kind: 'replay_turn', inputMode: 'full_history', rollbackUserMessage: true },
+        state: baseRecoveryState({ addedUserMessage: true }),
+        retryCounts: baseCounts(),
+    });
+    t.is(result.kind, 'run');
+    t.is(deps.providerContinuity.previousResponseId, null);
+    t.is(deps.conversationStore.getHistory().length, 0);
+    if (result.kind !== 'run')
+        return;
+    t.false(result.instruction.skipUserMessage);
+});
+test('replay_turn without rollback keeps user message', (t) => {
+    const { executor, deps } = makeExecutor();
+    deps.conversationStore.addUserMessage('hello');
+    const result = executor.apply({
+        plan: { kind: 'replay_turn', inputMode: 'full_history', rollbackUserMessage: false },
+        state: baseRecoveryState({ addedUserMessage: true }),
+        retryCounts: baseCounts(),
+    });
+    t.is(result.kind, 'run');
+    t.is(deps.conversationStore.getHistory().length, 1);
+    if (result.kind !== 'run')
+        return;
+    t.true(result.instruction.skipUserMessage);
+});
+test('replay_turn with errorContext injects error context into conversation store', (t) => {
+    const { executor, deps } = makeExecutor();
+    deps.conversationStore.addUserMessage('hello');
+    executor.apply({
+        plan: {
+            kind: 'replay_turn',
+            inputMode: 'full_history',
+            rollbackUserMessage: false,
+            errorContext: 'Previous attempt failed',
+        },
+        state: baseRecoveryState({ addedUserMessage: true }),
+        retryCounts: baseCounts(),
+    });
+    const history = deps.conversationStore.getHistory();
+    const errorItem = history.find((item) => typeof item === 'object' &&
+        item !== null &&
+        'content' in item &&
+        typeof item.content === 'string' &&
+        item.content.includes('Previous attempt failed'));
+    t.truthy(errorItem, 'should have injected error context into history');
+});
+test('retry_fresh with stream reconciles history and restores ledger', (t) => {
+    const { executor, deps } = makeExecutor();
+    deps.conversationStore.addUserMessage('hello');
+    deps.providerContinuity.update('resp-old');
+    const completedEntry = {
+        turnId: 'turn-1',
+        callId: 'call-read',
+        toolName: 'read_file',
+        status: 'completed',
+        startedAt: '2026-01-01T00:00:00.000Z',
+        completedAt: '2026-01-01T00:00:01.000Z',
+        historyItems: [],
+    };
+    const result = executor.apply({
+        plan: { kind: 'retry_fresh', inputMode: 'full_history' },
+        state: baseRecoveryState({
+            stream: { completed: Promise.resolve(undefined) },
+            ledgerSnapshot: [completedEntry],
+        }),
+        retryCounts: baseCounts(),
+    });
+    t.is(result.kind, 'run');
+    t.is(deps.providerContinuity.previousResponseId, null);
+});
+test('retry_fresh without stream preserves user message and clears continuity', (t) => {
+    const { executor, deps } = makeExecutor();
+    deps.conversationStore.addUserMessage('hello');
+    deps.providerContinuity.update('resp-old');
+    const result = executor.apply({
+        plan: { kind: 'retry_fresh', inputMode: 'full_history' },
+        state: baseRecoveryState({ addedUserMessage: true, stream: null }),
+        retryCounts: baseCounts(),
+    });
+    t.is(result.kind, 'run');
+    t.is(deps.providerContinuity.previousResponseId, null);
+    t.is(deps.conversationStore.getHistory().length, 1);
+});
+test('retry_fresh with useStandardServiceTier passes flag through', (t) => {
+    const { executor, deps } = makeExecutor();
+    deps.conversationStore.addUserMessage('hello');
+    deps.providerContinuity.update('resp-old');
+    const result = executor.apply({
+        plan: { kind: 'retry_fresh', inputMode: 'delta', useStandardServiceTier: true },
+        state: baseRecoveryState({ addedUserMessage: true, stream: null }),
+        retryCounts: baseCounts(),
+    });
+    t.is(result.kind, 'run');
+    if (result.kind !== 'run')
+        return;
+    t.true(result.useStandardServiceTier);
+});
+test('terminate removes user message when added without stream', (t) => {
+    const { executor, deps } = makeExecutor();
+    deps.conversationStore.addUserMessage('hello');
+    const result = executor.apply({
+        plan: { kind: 'terminate', events: [{ type: 'error', message: 'failed' }] },
+        state: baseRecoveryState({ addedUserMessage: true, stream: null }),
+        retryCounts: baseCounts(),
+    });
+    t.is(result.kind, 'terminated');
+    t.is(deps.conversationStore.getHistory().length, 0);
+    if (result.kind !== 'terminated')
+        return;
+    t.is(result.events.length, 1);
+    t.is(result.events[0].type, 'error');
+});
+test('terminate with stream marks open calls aborted and reconciles history', (t) => {
+    const { executor, deps } = makeExecutor();
+    deps.conversationStore.addUserMessage('hello');
+    const result = executor.apply({
+        plan: { kind: 'terminate', events: [{ type: 'error', message: 'stream failed' }] },
+        state: baseRecoveryState({ addedUserMessage: true, stream: { completed: Promise.resolve(undefined) } }),
+        retryCounts: baseCounts(),
+    });
+    t.is(result.kind, 'terminated');
+    if (result.kind !== 'terminated')
+        return;
+    t.is(result.events[0].type, 'error');
+});
+test('terminate includes tool_recovery event when there are recovered calls', (t) => {
+    const { executor, deps } = makeExecutor();
+    deps.conversationStore.addUserMessage('hello');
+    deps.toolTracker.ledger.recordFunctionCall({
+        type: 'function_call',
+        callId: 'call-1',
+        name: 'shell',
+        arguments: '{}',
+    });
+    deps.toolTracker.ledger.recordAbortedApproval('aborted', 'aborted', 'call-1');
+    const result = executor.apply({
+        plan: { kind: 'terminate', events: [] },
+        state: baseRecoveryState({ stream: { completed: Promise.resolve(undefined) } }),
+        retryCounts: baseCounts(),
+    });
+    t.is(result.kind, 'terminated');
+    if (result.kind !== 'terminated')
+        return;
+    const recoveryEvent = result.events.find((e) => e.type === 'tool_recovery');
+    t.truthy(recoveryEvent);
+});
+//# sourceMappingURL=recovery-executor.test.js.map

package/dist/services/recovery-executor.test.js.map

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

package/dist/services/recovery-policy.d.ts

@@ -0,0 +1,6 @@
+import type { ClassifiedFailure, RecoveryContext, RecoveryPlan, RetryCounts } from './retry-contracts.js';
+export declare class DefaultConversationRecoveryPolicy {
+    plan(context: RecoveryContext): RecoveryPlan;
+    nextRetryCounts(current: RetryCounts, failure: ClassifiedFailure): RetryCounts;
+}
+//# sourceMappingURL=recovery-policy.d.ts.map

package/dist/services/recovery-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-policy.d.ts","sourceRoot":"","sources":["../../source/services/recovery-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE1G,qBAAa,iCAAiC;IAC5C,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,YAAY;IA0C5C,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,GAAG,WAAW;CAkB/E"}

package/dist/services/recovery-policy.js

@@ -0,0 +1,56 @@
+export class DefaultConversationRecoveryPolicy {
+    plan(context) {
+        const { failure, stream, freshStartRetriesAllowed } = context;
+        if (!freshStartRetriesAllowed && failure.kind === 'transient') {
+            return { kind: 'terminate', events: [] };
+        }
+        switch (failure.kind) {
+            case 'service_tier_fallback':
+                return { kind: 'retry_fresh', inputMode: 'delta', useStandardServiceTier: true };
+            case 'transient': {
+                return { kind: 'retry_fresh', inputMode: 'full_history' };
+            }
+            case 'transport_downgrade':
+                return { kind: 'retry_fresh', inputMode: 'full_history' };
+            case 'model_retry': {
+                if (stream) {
+                    return {
+                        kind: 'replay_turn',
+                        inputMode: 'full_history',
+                        rollbackUserMessage: false,
+                        errorContext: failure.errorContext,
+                    };
+                }
+                return {
+                    kind: 'replay_turn',
+                    inputMode: 'full_history',
+                    rollbackUserMessage: true,
+                };
+            }
+            case 'unrecoverable':
+                return {
+                    kind: 'terminate',
+                    events: [],
+                };
+        }
+    }
+    nextRetryCounts(current, failure) {
+        switch (failure.kind) {
+            case 'transient':
+                return { ...current, transientRetryCount: failure.attempt };
+            case 'service_tier_fallback':
+                return { ...current, serviceTierFallbackCount: current.serviceTierFallbackCount + 1 };
+            case 'transport_downgrade':
+                return {
+                    ...current,
+                    transientRetryCount: 0,
+                    transportDowngradeCount: current.transportDowngradeCount + 1,
+                };
+            case 'model_retry':
+                return { ...current, modelRetryCount: current.modelRetryCount + 1 };
+            case 'unrecoverable':
+                return current;
+        }
+    }
+}
+//# sourceMappingURL=recovery-policy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-policy.js","sourceRoot":"","sources":["../../source/services/recovery-policy.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,iCAAiC;IAC5C,IAAI,CAAC,OAAwB;QAC3B,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,wBAAwB,EAAE,GAAG,OAAO,CAAC;QAE9D,IAAI,CAAC,wBAAwB,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC9D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAC3C,CAAC;QAED,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,uBAAuB;gBAC1B,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,sBAAsB,EAAE,IAAI,EAAE,CAAC;YAEnF,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC;YAC5D,CAAC;YAED,KAAK,qBAAqB;gBACxB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC;YAE5D,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,IAAI,MAAM,EAAE,CAAC;oBACX,OAAO;wBACL,IAAI,EAAE,aAAa;wBACnB,SAAS,EAAE,cAAc;wBACzB,mBAAmB,EAAE,KAAK;wBAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;qBACnC,CAAC;gBACJ,CAAC;gBACD,OAAO;oBACL,IAAI,EAAE,aAAa;oBACnB,SAAS,EAAE,cAAc;oBACzB,mBAAmB,EAAE,IAAI;iBAC1B,CAAC;YACJ,CAAC;YAED,KAAK,eAAe;gBAClB,OAAO;oBACL,IAAI,EAAE,WAAW;oBACjB,MAAM,EAAE,EAAE;iBACX,CAAC;QACN,CAAC;IACH,CAAC;IAED,eAAe,CAAC,OAAoB,EAAE,OAA0B;QAC9D,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,WAAW;gBACd,OAAO,EAAE,GAAG,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;YAC9D,KAAK,uBAAuB;gBAC1B,OAAO,EAAE,GAAG,OAAO,EAAE,wBAAwB,EAAE,OAAO,CAAC,wBAAwB,GAAG,CAAC,EAAE,CAAC;YACxF,KAAK,qBAAqB;gBACxB,OAAO;oBACL,GAAG,OAAO;oBACV,mBAAmB,EAAE,CAAC;oBACtB,uBAAuB,EAAE,OAAO,CAAC,uBAAuB,GAAG,CAAC;iBAC7D,CAAC;YACJ,KAAK,aAAa;gBAChB,OAAO,EAAE,GAAG,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;YACtE,KAAK,eAAe;gBAClB,OAAO,OAAO,CAAC;QACnB,CAAC;IACH,CAAC;CACF"}

package/dist/services/recovery-policy.test.d.ts

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

package/dist/services/recovery-policy.test.d.ts.map

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

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

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

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

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

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

@@ -0,0 +1,63 @@
+export { isTransientRetryableError } from './retry-error-classification.js';
+export declare const MAX_HALLUCINATION_RETRIES = 2;
+export declare const MAX_SUBAGENT_MODEL_RETRIES = 2;
+export declare const DEFAULT_TRANSIENT_RETRIES = 5;
+export declare const getMaxTransientRetries: (providerConfig?: {
+    streamMaxRetries?: number;
+}) => number;
+export declare const MAX_TRANSIENT_RETRIES = 5;
+export declare const isRecoverableModelError: (error: unknown) => boolean;
+export type RetryType = 'hallucination' | 'parsing_error' | 'behavior';
+export interface RetryEventPayload {
+    type: 'retry';
+    toolName: string;
+    attempt: number;
+    maxRetries: number;
+    errorMessage: string;
+    retryType?: RetryType;
+}
+export interface RetryLogPayload {
+    toolName: string;
+    retryType: RetryType;
+    attempt: number;
+    maxRetries: number;
+    errorMessage: string;
+}
+export type RecoverableRetryDecision = {
+    kind: 'no_retry';
+} | {
+    kind: 'retry';
+    message: string;
+    toolName: string;
+    retryType: RetryType;
+    attempt: number;
+    maxRetries: number;
+};
+export type RetryDecision = {
+    kind: 'no_retry';
+} | {
+    kind: 'retry';
+    message: string;
+    retryEvent: RetryEventPayload;
+    logPayload: RetryLogPayload;
+    attempt: number;
+    /** If true, caller should update conversation store from the existing stream and may inject error context. */
+    hadStream: boolean;
+    /** True when stream produced no usable history; caller should inject error-context message. */
+    shouldInjectErrorContext: boolean;
+    errorContextMessage: string;
+    nextRunOptions: {
+        retries: {
+            hallucinationRetryCount: number;
+        };
+        skipUserMessage: boolean;
+    };
+};
+/**
+ * Decides whether a model error is recoverable and returns retry metadata only.
+ * Useful for callers (e.g. subagent manager) that need retry classification
+ * without parent-specific fields like hadStream or nextRunOptions.
+ */
+export declare const decideRecoverableModelRetry: (error: unknown, attemptCount: number, maxRetries?: number) => RecoverableRetryDecision;
+export declare const decideRetry: (error: unknown, attemptCount: number, hadStream: boolean, streamHistoryLength: number, maxRetries?: number) => RetryDecision;
+//# sourceMappingURL=conversation-retry-policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-retry-policy.d.ts","sourceRoot":"","sources":["../../../source/services/retry/conversation-retry-policy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAE5E,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAC5C,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,sBAAsB,GAAI,iBAAiB;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,MACzB,CAAC;AAChE,eAAO,MAAM,qBAAqB,IAA4B,CAAC;AAE/D,eAAO,MAAM,uBAAuB,GAAI,OAAO,OAAO,KAAG,OAYxD,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,eAAe,GAAG,UAAU,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,wBAAwB,GAChC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IACE,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEN,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IACE,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,8GAA8G;IAC9G,SAAS,EAAE,OAAO,CAAC;IACnB,+FAA+F;IAC/F,wBAAwB,EAAE,OAAO,CAAC;IAClC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE;QAAE,OAAO,EAAE;YAAE,uBAAuB,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,eAAe,EAAE,OAAO,CAAA;KAAE,CAAC;CAC5F,CAAC;AAEN;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,GACtC,OAAO,OAAO,EACd,cAAc,MAAM,EACpB,aAAY,MAAkC,KAC7C,wBAoBF,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,OAAO,OAAO,EACd,cAAc,MAAM,EACpB,WAAW,OAAO,EAClB,qBAAqB,MAAM,EAC3B,aAAY,MAAkC,KAC7C,aAmCF,CAAC"}

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

@@ -0,0 +1,76 @@
+import { ModelBehaviorError } from '@openai/agents';
+export { isTransientRetryableError } from './retry-error-classification.js';
+export const MAX_HALLUCINATION_RETRIES = 2;
+export const MAX_SUBAGENT_MODEL_RETRIES = 2;
+export const DEFAULT_TRANSIENT_RETRIES = 5;
+export const getMaxTransientRetries = (providerConfig) => providerConfig?.streamMaxRetries ?? DEFAULT_TRANSIENT_RETRIES;
+export const MAX_TRANSIENT_RETRIES = DEFAULT_TRANSIENT_RETRIES;
+export const isRecoverableModelError = (error) => {
+    if (!(error instanceof ModelBehaviorError)) {
+        return false;
+    }
+    const message = error.message.toLowerCase();
+    return ((message.includes('tool') && message.includes('not found')) ||
+        message.includes('model did not produce a final response') ||
+        message.includes('parsing tool arguments') ||
+        message.includes('valid json'));
+};
+/**
+ * Decides whether a model error is recoverable and returns retry metadata only.
+ * Useful for callers (e.g. subagent manager) that need retry classification
+ * without parent-specific fields like hadStream or nextRunOptions.
+ */
+export const decideRecoverableModelRetry = (error, attemptCount, maxRetries = MAX_HALLUCINATION_RETRIES) => {
+    if (!isRecoverableModelError(error) || attemptCount >= maxRetries) {
+        return { kind: 'no_retry' };
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    const lower = message.toLowerCase();
+    const isHallucination = lower.includes('not found');
+    const isParsingError = lower.includes('parsing tool arguments') || lower.includes('valid json');
+    const toolName = isHallucination ? message.match(/Tool (\S+) not found/)?.[1] || 'unknown' : 'unknown';
+    const retryType = isHallucination ? 'hallucination' : isParsingError ? 'parsing_error' : 'behavior';
+    return {
+        kind: 'retry',
+        message,
+        toolName,
+        retryType,
+        attempt: attemptCount + 1,
+        maxRetries,
+    };
+};
+export const decideRetry = (error, attemptCount, hadStream, streamHistoryLength, maxRetries = MAX_HALLUCINATION_RETRIES) => {
+    const decision = decideRecoverableModelRetry(error, attemptCount, maxRetries);
+    if (decision.kind === 'no_retry') {
+        return { kind: 'no_retry' };
+    }
+    const { message, toolName, retryType, attempt } = decision;
+    return {
+        kind: 'retry',
+        message,
+        retryEvent: {
+            type: 'retry',
+            toolName: retryType === 'hallucination' ? toolName : 'model',
+            attempt,
+            maxRetries,
+            errorMessage: message,
+            retryType,
+        },
+        logPayload: {
+            toolName,
+            retryType,
+            attempt,
+            maxRetries,
+            errorMessage: message,
+        },
+        attempt,
+        hadStream,
+        shouldInjectErrorContext: hadStream && streamHistoryLength === 0,
+        errorContextMessage: `[System: Previous attempt failed with error: ${message}. Please retry with corrected output.]`,
+        nextRunOptions: {
+            retries: { hallucinationRetryCount: attempt },
+            skipUserMessage: hadStream,
+        },
+    };
+};
+//# sourceMappingURL=conversation-retry-policy.js.map

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

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

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

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

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

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