@orion-agents/orion-code 0.1.0

package/dist/services/provider-diagnostics.js

@@ -0,0 +1,314 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMProviderError = void 0;
+exports.redactProviderSecrets = redactProviderSecrets;
+exports.diagnoseProviderError = diagnoseProviderError;
+exports.toLLMProviderError = toLLMProviderError;
+exports.formatProviderErrorMessage = formatProviderErrorMessage;
+exports.diagnoseProviderConfig = diagnoseProviderConfig;
+const model_context_1 = require("./model-context");
+const environment_1 = require("../product/environment");
+class LLMProviderError extends Error {
+    constructor(diagnostic) {
+        super(formatProviderErrorMessage(diagnostic));
+        this.name = 'LLMProviderError';
+        this.diagnostic = diagnostic;
+    }
+}
+exports.LLMProviderError = LLMProviderError;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function stringValue(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value : undefined;
+}
+function numberValue(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function codeValue(value) {
+    if (typeof value === 'string' && value.trim().length > 0)
+        return value;
+    if (typeof value === 'number' && Number.isFinite(value))
+        return String(value);
+    return undefined;
+}
+function redactProviderSecrets(input) {
+    return input
+        .replace(/\b(https?:\/\/)([^/\s@]+)@/gi, '$1[REDACTED]@')
+        .replace(/([?&](?:api[_-]?key|key|token|secret|authorization)=)[^&\s#]+/gi, '$1[REDACTED]')
+        .replace(/\bsk-[A-Za-z0-9_-]{8,}\b/g, 'sk-***')
+        .replace(/\bBearer\s+[A-Za-z0-9._~+/=-]{8,}/gi, 'Bearer [REDACTED]')
+        .replace(/\b(api[_-]?key|token|secret|authorization)\s*[:=]\s*["']?[^"'\s,;]+/gi, '$1=[REDACTED]');
+}
+function compactProviderMessage(input) {
+    const compact = redactProviderSecrets(input).replace(/\s+/g, ' ').trim();
+    return compact.length > 600 ? `${compact.slice(0, 597)}...` : compact;
+}
+function extractErrorParts(error) {
+    const messages = [];
+    let status;
+    let code;
+    let type;
+    if (error instanceof Error) {
+        messages.push(error.message);
+    }
+    else if (typeof error === 'string') {
+        messages.push(error);
+    }
+    if (isRecord(error)) {
+        status = numberValue(error.status) ?? numberValue(error.statusCode);
+        code = codeValue(error.code);
+        type = stringValue(error.type);
+        const topLevelMessage = stringValue(error.message);
+        if (topLevelMessage)
+            messages.push(topLevelMessage);
+        const response = isRecord(error.response) ? error.response : undefined;
+        status = status ?? numberValue(response?.status);
+        const body = isRecord(error.error)
+            ? error.error
+            : isRecord(error.body)
+                ? error.body
+                : undefined;
+        const nestedError = isRecord(body?.error) ? body.error : undefined;
+        code = code ?? codeValue(body?.code) ?? codeValue(nestedError?.code);
+        type = type ?? stringValue(body?.type) ?? stringValue(nestedError?.type);
+        const bodyMessage = stringValue(body?.message) ?? stringValue(nestedError?.message);
+        if (bodyMessage)
+            messages.push(bodyMessage);
+    }
+    if (messages.length === 0) {
+        messages.push(String(error));
+    }
+    return {
+        status,
+        code,
+        type,
+        message: compactProviderMessage([...new Set(messages)].join(' | ')),
+    };
+}
+function matchesAny(text, patterns) {
+    return patterns.some(pattern => pattern.test(text));
+}
+function hintFor(type) {
+    switch (type) {
+        case 'model_not_found':
+            return `Model was not found by the provider. Check ${environment_1.ENV.MODEL} and the provider model ID.`;
+        case 'invalid_endpoint':
+            return `Endpoint appears invalid or unreachable. Check ${environment_1.ENV.API_BASE_URL} and use the provider OpenAI-compatible base URL.`;
+        case 'auth_failed':
+            return `Provider authentication failed. Check ${environment_1.ENV.API_KEY} and make sure it matches the configured endpoint.`;
+        case 'quota_or_credit_exhausted':
+            return 'Provider quota or credit appears insufficient. Recharge the provider account or switch model/provider.';
+        case 'rate_limit':
+            return 'Provider rate limit was reached. Wait before retrying, reduce request rate, or switch model/provider.';
+        case 'provider_busy':
+            return `Provider is busy or overloaded. Retry later or configure ${environment_1.ENV.FALLBACK_MODEL}.`;
+        case 'unknown_provider_error':
+            return 'Provider request failed. Check provider status and model/endpoint configuration.';
+    }
+}
+function retryableFor(type, status, message) {
+    if (type === 'rate_limit' || type === 'provider_busy')
+        return true;
+    if (type === 'auth_failed' || type === 'quota_or_credit_exhausted' || type === 'model_not_found')
+        return false;
+    // invalid_endpoint: network-level errors (DNS, connection refused) are retryable;
+    // configuration errors (invalid URL, unsupported protocol) are not.
+    if (type === 'invalid_endpoint') {
+        if (message && /\b(econnrefused|etimedout|enotfound|econnreset|epipe|network|connection)\b/i.test(message))
+            return true;
+        return false;
+    }
+    if (status === 500 || status === 502 || status === 503 || status === 504)
+        return true;
+    if (!message)
+        return false;
+    return matchesAny(message.toLowerCase(), [
+        /\btimeout\b/,
+        /\beconnreset\b/,
+        /\bconnection\b/,
+        /\bepipe\b/,
+        /\bnetwork\b/,
+        /\btemporarily unavailable\b/,
+    ]);
+}
+function diagnoseProviderError(error) {
+    const parts = extractErrorParts(error);
+    const text = [parts.message, parts.code, parts.type].filter(Boolean).join(' ').toLowerCase();
+    const code = parts.code?.toLowerCase();
+    let type = 'unknown_provider_error';
+    if (code === 'model_not_found'
+        || matchesAny(text, [
+            /\bmodel_not_found\b/,
+            /\bmodel not found\b/,
+            /\bmodel .*not found\b/,
+            /\bmodel .*does not exist\b/,
+            /\bunknown model\b/,
+        ])) {
+        type = 'model_not_found';
+    }
+    else if (code === '11210'
+        || matchesAny(text, [
+            /\bnotenoughcverror\b/,
+            /\bnot enough cverror\b/,
+            /\bcode:\s*11210\b/,
+            /\binsufficient_quota\b/,
+            /\binsufficient quota\b/,
+            /\bquota exceeded\b/,
+            /\bcredit exhausted\b/,
+            /\binsufficient credit\b/,
+            /\bbilling hard limit\b/,
+        ])) {
+        type = 'quota_or_credit_exhausted';
+    }
+    else if (code === 'invalid_api_key'
+        || parts.status === 401
+        || parts.status === 403
+        || matchesAny(text, [
+            /\binvalid api key\b/,
+            /\binvalid_api_key\b/,
+            /\bauthentication\b/,
+            /\bauthorization failed\b/,
+            /\bunauthorized\b/,
+            /\bforbidden\b/,
+            /\baccess denied\b/,
+            /\btoken expired\b/,
+        ])) {
+        type = 'auth_failed';
+    }
+    else if (parts.status === 429
+        || matchesAny(text, [
+            /\brate limit\b/,
+            /\btoo many requests\b/,
+            /\bapi-limit\b/,
+            /\bapi_limit\b/,
+            /\bapi limit\b/,
+            /\brequest limit\b/,
+            /\brequests per minute\b/,
+            /\btokens per minute\b/,
+            /\btemporarily throttled\b/,
+            /\b429\b/,
+        ])) {
+        type = 'rate_limit';
+    }
+    else if (parts.status === 529
+        || matchesAny(text, [
+            /\bcode:\s*10012\b/,
+            /\bengineinternalerror\b/,
+            /\bsystem is busy\b/,
+            /\bservice is busy\b/,
+            /\bserver is busy\b/,
+            /\boverloaded\b/,
+            /\btry again later\b/,
+        ])) {
+        type = 'provider_busy';
+    }
+    else if (parts.status === 404
+        || matchesAny(text, [
+            /\binvalid url\b/,
+            /\berr_invalid_url\b/,
+            /\bunsupported protocol\b/,
+            /\bgetaddrinfo enotfound\b/,
+            /\benotfound\b/,
+            /\beconnrefused\b/,
+            /\bfetch failed\b/,
+        ])) {
+        type = 'invalid_endpoint';
+    }
+    return {
+        type,
+        retryable: retryableFor(type, parts.status, text),
+        status: parts.status,
+        code: parts.code,
+        providerMessage: parts.message,
+        hint: hintFor(type),
+    };
+}
+function toLLMProviderError(error) {
+    if (error instanceof LLMProviderError)
+        return error;
+    if (error instanceof Error && error.name === 'AbortError')
+        return error;
+    return new LLMProviderError(diagnoseProviderError(error));
+}
+function formatProviderErrorMessage(diagnostic) {
+    const status = diagnostic.status ? ` status=${diagnostic.status}` : '';
+    const code = diagnostic.code ? ` code=${diagnostic.code}` : '';
+    return `LLM provider error [${diagnostic.type}${status}${code}]: ${diagnostic.hint}`;
+}
+function endpointDiagnostics(baseUrl) {
+    if (!baseUrl) {
+        return {
+            status: 'ok',
+            endpoint: '(default OpenAI-compatible endpoint)',
+            detail: ['endpoint=(default OpenAI-compatible endpoint)'],
+        };
+    }
+    const endpoint = compactProviderMessage(baseUrl);
+    let url;
+    try {
+        url = new URL(baseUrl);
+    }
+    catch {
+        return {
+            status: 'fail',
+            endpoint,
+            detail: [`endpoint=${endpoint}`, 'endpointStatus=invalid URL'],
+        };
+    }
+    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+        return {
+            status: 'fail',
+            endpoint,
+            detail: [`endpoint=${endpoint}`, `endpointStatus=unsupported protocol ${url.protocol}`],
+        };
+    }
+    if (/\/(?:chat\/completions|responses|messages)\/?$/i.test(url.pathname)) {
+        return {
+            status: 'warn',
+            endpoint,
+            detail: [
+                `endpoint=${endpoint}`,
+                'endpointStatus=looks like a request path; configure the provider base URL instead',
+            ],
+        };
+    }
+    return {
+        status: 'ok',
+        endpoint,
+        detail: [`endpoint=${endpoint}`, 'endpointStatus=valid URL syntax'],
+    };
+}
+function worseStatus(left, right) {
+    if (left === 'fail' || right === 'fail')
+        return 'fail';
+    if (left === 'warn' || right === 'warn')
+        return 'warn';
+    return 'ok';
+}
+function diagnoseProviderConfig(input) {
+    const model = input.model.trim() || '(not set)';
+    const modelContext = (0, model_context_1.resolveModelContext)(model);
+    const endpoint = endpointDiagnostics(input.baseUrl);
+    const modelStatus = model === '(not set)' || modelContext.source === 'default' ? 'warn' : 'ok';
+    const keyStatus = input.apiKey ? 'ok' : 'fail';
+    const status = worseStatus(worseStatus(endpoint.status, modelStatus), keyStatus);
+    const provider = modelContext.provider ?? 'unknown';
+    return {
+        status,
+        summary: `${model} via ${provider}, endpoint ${endpoint.endpoint}`,
+        detail: [
+            `model=${model}`,
+            `provider=${provider}`,
+            `modelSource=${modelContext.source}`,
+            `matchedModel=${modelContext.matchedId}`,
+            `contextWindow=${modelContext.contextWindow}`,
+            `maxOutputTokens=${modelContext.maxOutputTokens ?? '(unknown)'}`,
+            ...endpoint.detail,
+            `apiKey=${input.apiKey ? 'configured' : 'missing'}`,
+            `fallbackModel=${input.fallbackModel || '(none)'}`,
+            'networkCheck=skipped',
+        ],
+    };
+}
+//# sourceMappingURL=provider-diagnostics.js.map

package/dist/services/provider-diagnostics.js.map

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

package/dist/services/provider-resilience/circuit-breaker.d.ts

@@ -0,0 +1,32 @@
+/**
+ * v0.2.25 — Provider Circuit Breaker.
+ *
+ * Prevents repeated requests to a failing provider. Counts logical request
+ * failures (not individual attempts), with half-open probing.
+ */
+import type { CircuitState } from './types';
+export interface CircuitBreakerConfig {
+    failureThreshold: number;
+    windowMs: number;
+    cooldownMs: number;
+}
+export declare class ProviderCircuitBreaker {
+    private state;
+    private failures;
+    private openedAt;
+    private probeActive;
+    private readonly config;
+    constructor(config?: Partial<CircuitBreakerConfig>);
+    get currentState(): CircuitState;
+    /** Check if a request can proceed. Returns false if circuit is open. */
+    allowRequest(): boolean;
+    /** Record a successful logical request. */
+    recordSuccess(): void;
+    /** Record a failed logical request (retry_exhausted or failed_fast). */
+    recordFailure(): void;
+    /** Force close (e.g., on user resume or provider recovery). */
+    reset(): void;
+    private get cooldownUntil();
+    private pruneFailures;
+}
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/services/provider-resilience/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../../src/services/provider-resilience/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAYD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;gBAElC,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAIlD,IAAI,YAAY,IAAI,YAAY,CAE/B;IAED,wEAAwE;IACxE,YAAY,IAAI,OAAO;IAqBvB,2CAA2C;IAC3C,aAAa,IAAI,IAAI;IAUrB,wEAAwE;IACxE,aAAa,IAAI,IAAI;IAmBrB,+DAA+D;IAC/D,KAAK,IAAI,IAAI;IAMb,OAAO,KAAK,aAAa,GAExB;IAED,OAAO,CAAC,aAAa;CAItB"}

package/dist/services/provider-resilience/circuit-breaker.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * v0.2.25 — Provider Circuit Breaker.
+ *
+ * Prevents repeated requests to a failing provider. Counts logical request
+ * failures (not individual attempts), with half-open probing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderCircuitBreaker = void 0;
+const DEFAULT_CONFIG = {
+    failureThreshold: 5,
+    windowMs: 60000,
+    cooldownMs: 30000,
+};
+class ProviderCircuitBreaker {
+    constructor(config) {
+        this.state = 'closed';
+        this.failures = [];
+        this.openedAt = 0;
+        this.probeActive = false;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    get currentState() {
+        return this.state;
+    }
+    /** Check if a request can proceed. Returns false if circuit is open. */
+    allowRequest() {
+        this.pruneFailures();
+        if (this.state === 'closed')
+            return true;
+        if (this.state === 'open') {
+            if (Date.now() >= this.cooldownUntil) {
+                // Transition to half-open, allow one probe.
+                this.state = 'half_open';
+                this.probeActive = true;
+                return true;
+            }
+            return false;
+        }
+        // half_open: only allow if no probe is active.
+        if (this.probeActive)
+            return false;
+        this.probeActive = true;
+        return true;
+    }
+    /** Record a successful logical request. */
+    recordSuccess() {
+        if (this.state === 'half_open') {
+            this.state = 'closed';
+            this.probeActive = false;
+            this.failures = [];
+        }
+        // In closed state, just prune.
+        this.pruneFailures();
+    }
+    /** Record a failed logical request (retry_exhausted or failed_fast). */
+    recordFailure() {
+        this.pruneFailures();
+        this.failures.push({ timestamp: Date.now() });
+        if (this.state === 'half_open') {
+            // Probe failed — reopen.
+            this.state = 'open';
+            this.openedAt = Date.now();
+            this.probeActive = false;
+            return;
+        }
+        if (this.failures.length >= this.config.failureThreshold) {
+            this.state = 'open';
+            this.openedAt = Date.now();
+            this.probeActive = false;
+        }
+    }
+    /** Force close (e.g., on user resume or provider recovery). */
+    reset() {
+        this.state = 'closed';
+        this.failures = [];
+        this.probeActive = false;
+    }
+    get cooldownUntil() {
+        return this.openedAt + this.config.cooldownMs;
+    }
+    pruneFailures() {
+        const cutoff = Date.now() - this.config.windowMs;
+        this.failures = this.failures.filter(f => f.timestamp > cutoff);
+    }
+}
+exports.ProviderCircuitBreaker = ProviderCircuitBreaker;
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/services/provider-resilience/circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../../src/services/provider-resilience/circuit-breaker.ts"],"names":[],"mappings":"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"}

package/dist/services/provider-resilience/coordinator.d.ts

@@ -0,0 +1,38 @@
+/**
+ * v0.2.25 — Provider Resilience Coordinator.
+ *
+ * Single owner of all Provider retry decisions. Replaces withRetry() in llm.ts
+ * and the global fallback mutable state. All root/child/compact requests go
+ * through this coordinator.
+ */
+import type { ProviderRequestContext, ProviderRequestDiagnosticsV2, ProviderResilienceConfig } from './types';
+export declare class ProviderResilienceCoordinator {
+    private readonly config;
+    constructor(config?: Partial<ProviderResilienceConfig>);
+    /** Execute a logical request with full retry/fallback/recovery logic. */
+    execute<T>(ctx: ProviderRequestContext, transport: (attempt: number, signal?: AbortSignal) => Promise<{
+        response: T;
+        usage?: {
+            promptTokens: number;
+            completionTokens: number;
+            totalTokens: number;
+        };
+        providerRequestId?: string;
+    }>, options?: {
+        onStreamChunk?: (text: string) => void;
+        buildRecoveryRequest?: (partialText: string) => Promise<unknown>;
+    }): Promise<{
+        result: T;
+        diagnostics: ProviderRequestDiagnosticsV2;
+    }>;
+    getConfig(): ProviderResilienceConfig;
+    private startAttempt;
+    private computeBackoff;
+    private sleep;
+}
+export declare class ProviderRetryExhaustedError extends Error {
+    readonly diagnostics: ProviderRequestDiagnosticsV2;
+    readonly recoverableTurnFailure = true;
+    constructor(diagnostics: ProviderRequestDiagnosticsV2, reason: string);
+}
+//# sourceMappingURL=coordinator.d.ts.map

package/dist/services/provider-resilience/coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../../src/services/provider-resilience/coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,sBAAsB,EAEtB,4BAA4B,EAC5B,wBAAwB,EAEzB,MAAM,SAAS,CAAC;AAIjB,qBAAa,6BAA6B;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;gBAEtC,MAAM,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC;IAItD,yEAAyE;IACnE,OAAO,CAAC,CAAC,EACb,GAAG,EAAE,sBAAsB,EAC3B,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC;QAAE,QAAQ,EAAE,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,YAAY,EAAE,MAAM,CAAC;YAAC,gBAAgB,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAC3L,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QACvC,oBAAoB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAClE,GACA,OAAO,CAAC;QAAE,MAAM,EAAE,CAAC,CAAC;QAAC,WAAW,EAAE,4BAA4B,CAAA;KAAE,CAAC;IAkGpE,SAAS,IAAI,wBAAwB;IAIrC,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,KAAK;CAYd;AAED,qBAAa,2BAA4B,SAAQ,KAAK;IAIlD,QAAQ,CAAC,WAAW,EAAE,4BAA4B;IAHpD,QAAQ,CAAC,sBAAsB,QAAQ;gBAG5B,WAAW,EAAE,4BAA4B,EAClD,MAAM,EAAE,MAAM;CAKjB"}

package/dist/services/provider-resilience/coordinator.js

@@ -0,0 +1,155 @@
+"use strict";
+/**
+ * v0.2.25 — Provider Resilience Coordinator.
+ *
+ * Single owner of all Provider retry decisions. Replaces withRetry() in llm.ts
+ * and the global fallback mutable state. All root/child/compact requests go
+ * through this coordinator.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderRetryExhaustedError = exports.ProviderResilienceCoordinator = void 0;
+const crypto_1 = require("crypto");
+const types_1 = require("./types");
+const error_classifier_1 = require("./error-classifier");
+class ProviderResilienceCoordinator {
+    constructor(config) {
+        this.config = { ...types_1.DEFAULT_PROVIDER_RESILIENCE_CONFIG, ...config };
+    }
+    /** Execute a logical request with full retry/fallback/recovery logic. */
+    async execute(ctx, transport, options) {
+        const diagnostics = {
+            logicalRequestId: ctx.logicalRequestId,
+            operation: ctx.operation,
+            requestedModel: ctx.requestedModel,
+            sdkRetriesDisabled: true,
+            finalState: 'succeeded',
+            attempts: [],
+            retryCount: 0,
+            recoveryCount: 0,
+            fallbackCount: 0,
+            totalBackoffMs: 0,
+            usageConfidence: 'unknown',
+            unknownBilledAttemptCount: 0,
+        };
+        let streamState = null;
+        const startedAt = Date.now();
+        let lastError;
+        for (let attempt = 1; attempt <= this.config.maxTotalAttempts; attempt++) {
+            // Check elapsed budget
+            if (Date.now() - startedAt >= this.config.maxElapsedMs) {
+                diagnostics.finalState = 'retry_exhausted';
+                throw new ProviderRetryExhaustedError(diagnostics, 'max elapsed time exceeded');
+            }
+            // Check abort
+            if (ctx.abortSignal?.aborted) {
+                diagnostics.finalState = 'aborted';
+                throw new ProviderRetryExhaustedError(diagnostics, 'aborted by signal');
+            }
+            const attemptRecord = this.startAttempt(ctx, attempt, diagnostics);
+            diagnostics.attempts.push(attemptRecord);
+            try {
+                const result = await transport(attempt, ctx.abortSignal);
+                attemptRecord.outcome = 'succeeded';
+                attemptRecord.endedAt = Date.now();
+                if (result.usage)
+                    attemptRecord.usage = result.usage;
+                if (result.providerRequestId)
+                    attemptRecord.providerRequestId = result.providerRequestId;
+                diagnostics.finalModel = ctx.requestedModel;
+                diagnostics.finalState = streamState ? 'recovered' : 'succeeded';
+                if (result.usage)
+                    diagnostics.usageConfidence = 'exact';
+                return { result: result.response, diagnostics };
+            }
+            catch (error) {
+                lastError = error;
+                attemptRecord.endedAt = Date.now();
+                attemptRecord.outcome = 'failed';
+                const classification = (0, error_classifier_1.classifyProviderError)(error, attemptRecord.semanticDeltaSeen);
+                attemptRecord.failureKind = classification.kind;
+                attemptRecord.retryDisposition = classification.disposition;
+                attemptRecord.retryAfterMs = classification.retryAfterMs;
+                attemptRecord.status = classification.status;
+                switch (classification.disposition) {
+                    case 'fail_fast':
+                        diagnostics.finalState = 'failed_fast';
+                        throw new ProviderRetryExhaustedError(diagnostics, `fail fast: ${classification.kind}`);
+                    case 'retry_precommit':
+                    case 'recover_stream':
+                        if (attempt >= this.config.maxTotalAttempts) {
+                            diagnostics.finalState = 'retry_exhausted';
+                            throw new ProviderRetryExhaustedError(diagnostics, `max attempts (${this.config.maxTotalAttempts}) reached`);
+                        }
+                        const delay = this.computeBackoff(attempt, classification.retryAfterMs);
+                        attemptRecord.backoffMs = delay;
+                        diagnostics.totalBackoffMs += delay;
+                        diagnostics.retryCount++;
+                        if (classification.disposition === 'recover_stream') {
+                            diagnostics.recoveryCount++;
+                        }
+                        await this.sleep(delay, ctx.abortSignal);
+                        break;
+                    case 'fallback_once':
+                        diagnostics.fallbackCount++;
+                        break;
+                    case 'defer_until_cooldown':
+                        diagnostics.finalState = 'retry_exhausted';
+                        throw new ProviderRetryExhaustedError(diagnostics, 'provider cooldown active');
+                }
+            }
+        }
+        diagnostics.finalState = 'retry_exhausted';
+        throw new ProviderRetryExhaustedError(diagnostics, `max attempts exhausted: ${String(lastError)}`);
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    startAttempt(ctx, attempt, diag) {
+        return {
+            attemptId: (0, crypto_1.randomUUID)().slice(0, 8),
+            logicalRequestId: ctx.logicalRequestId,
+            attemptNumber: attempt,
+            model: ctx.requestedModel,
+            startedAt: Date.now(),
+            endedAt: 0,
+            semanticDeltaSeen: false,
+            visibleTextBytes: 0,
+            toolCallDeltaSeen: false,
+            terminalFinishReasonSeen: false,
+            outcome: 'failed',
+        };
+    }
+    computeBackoff(attempt, retryAfterMs) {
+        if (retryAfterMs && retryAfterMs > 0 && retryAfterMs <= this.config.maxRetryAfterMs) {
+            return Math.max(retryAfterMs, this.config.minRateLimitDelayMs);
+        }
+        const cap = Math.min(this.config.maxDelayMs, this.config.baseDelayMs * Math.pow(2, attempt - 1));
+        return cap / 2 + Math.floor(Math.random() * (cap / 2));
+    }
+    sleep(ms, signal) {
+        return new Promise((resolve, reject) => {
+            if (signal?.aborted) {
+                resolve();
+                return;
+            }
+            const timer = setTimeout(resolve, ms);
+            const onAbort = () => {
+                clearTimeout(timer);
+                signal?.removeEventListener('abort', onAbort);
+                resolve(); // Don't reject — abort is not an error for backoff
+            };
+            signal?.addEventListener('abort', onAbort, { once: true });
+        });
+    }
+}
+exports.ProviderResilienceCoordinator = ProviderResilienceCoordinator;
+class ProviderRetryExhaustedError extends Error {
+    constructor(diagnostics, reason) {
+        super(`Provider retry exhausted: ${reason}`);
+        this.diagnostics = diagnostics;
+        this.recoverableTurnFailure = true;
+        this.name = 'ProviderRetryExhaustedError';
+    }
+}
+exports.ProviderRetryExhaustedError = ProviderRetryExhaustedError;
+//# sourceMappingURL=coordinator.js.map