@zhixuan92/multi-model-agent-core 3.12.7 → 4.0.0

package/dist/escalation/delegate-with-escalation.js

@@ -0,0 +1,205 @@
+// NOTE: Despite the name "delegateWithEscalation", this function does NOT
+// perform status-level tier escalation. Escalation policy lives in
+// escalation/policy.ts and is invoked via runWithFallback by the
+// lifecycle review-chain handlers. This function only handles transient
+// retries (api_error / network_error).
+import { retryableFor } from '../error-codes.js';
+import { hasCompletedWork, extractToolName } from '../providers/stall-detector.js';
+function deriveCause(status, errorCode) {
+    if (errorCode === 'degenerate_exhausted')
+        return 'degenerate_exhausted';
+    if (status === 'ok')
+        return 'finished';
+    if (status === 'incomplete')
+        return 'incomplete';
+    if (status === 'unavailable')
+        return 'error';
+    return status;
+}
+const TRANSIENT_STATUSES = new Set(['api_error', 'provider_transport_failure']);
+const TIMEOUT_STATUS = 'timeout';
+const MAX_RETRIES = 2;
+const BASE_DELAY_MS = 1000;
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+function maxRetriesForStatus(status) {
+    if (TRANSIENT_STATUSES.has(status))
+        return MAX_RETRIES;
+    if (status === TIMEOUT_STATUS)
+        return 1;
+    return 0;
+}
+export async function delegateWithEscalation(task, chain, options = {}) {
+    if (chain.length === 0) {
+        throw new Error('delegateWithEscalation called with empty chain');
+    }
+    const safeSink = options.onProgress
+        ? (event) => {
+            try {
+                options.onProgress(event);
+            }
+            catch {
+            }
+        }
+        : undefined;
+    const attempts = [];
+    for (let i = 0; i < chain.length; i++) {
+        const provider = chain[i];
+        if (i > 0 && safeSink) {
+            const prev = attempts[attempts.length - 1].record;
+            safeSink({
+                kind: 'escalation_start',
+                previousProvider: prev.provider,
+                previousReason: prev.reason ?? `status=${prev.status}`,
+                nextProvider: provider.name,
+            });
+        }
+        let initialPromptLengthChars = 0;
+        let initialPromptHash = '';
+        let result;
+        let cumulativeCostUSD = 0;
+        for (let attempt = 0;; attempt++) {
+            const adjustedMaxCostUSD = task.maxCostUSD !== undefined ? Math.max(0, task.maxCostUSD - cumulativeCostUSD) : undefined;
+            // Cap per-call timeout at the remaining task-level budget. When the
+            // deadline is in the past, force a 1ms timeout so the runner returns
+            // immediately with whatever salvage it has — synthesized into a
+            // task_wall_clock outcome below.
+            let effectiveTimeoutMs = task.timeoutMs;
+            if (options.taskDeadlineMs !== undefined) {
+                const remaining = options.taskDeadlineMs - Date.now();
+                const remainingClamped = remaining > 0 ? remaining : 1;
+                effectiveTimeoutMs =
+                    effectiveTimeoutMs !== undefined
+                        ? Math.min(effectiveTimeoutMs, remainingClamped)
+                        : remainingClamped;
+            }
+            // ProviderConfig.type is one of: 'claude' | 'claude-compatible' | 'openai-compatible' | 'codex'.
+            // InternalRunnerEvent.providerType only allows the three runner families;
+            // map 'claude-compatible' onto 'claude' (same runner backend).
+            const cfgType = provider.config.type;
+            const providerTypeName = cfgType === 'claude' || cfgType === 'claude-compatible' ? 'claude' :
+                cfgType === 'codex' ? 'codex' :
+                    'openai-compatible';
+            safeSink?.({
+                kind: 'worker_start',
+                model: provider.config.model,
+                providerType: providerTypeName,
+                tier: options.assignedTier ?? 'standard',
+            });
+            result = await provider.run(task.prompt, {
+                tools: task.tools,
+                timeoutMs: effectiveTimeoutMs,
+                abortSignal: options.abortSignal,
+                cwd: task.cwd,
+                effort: task.effort,
+                sandboxPolicy: task.sandboxPolicy,
+                expectedCoverage: task.expectedCoverage,
+                skipCompletionHeuristic: task.skipCompletionHeuristic,
+                mainModel: task.mainModel,
+                maxCostUSD: adjustedMaxCostUSD,
+                formatConstraints: task.formatConstraints,
+                customToolset: task.customToolset,
+                onProgress: safeSink,
+                onInitialRequest: (meta) => {
+                    initialPromptLengthChars = meta.lengthChars;
+                    initialPromptHash = meta.sha256;
+                },
+            });
+            const maxRetries = maxRetriesForStatus(result.status);
+            if (result.status === 'ok' || maxRetries === 0 || attempt >= maxRetries)
+                break;
+            const attemptCost = result.cost?.costUSD ?? 0;
+            cumulativeCostUSD += attemptCost;
+            if (task.maxCostUSD !== undefined && cumulativeCostUSD >= task.maxCostUSD)
+                break;
+            // Don't burn the retry budget on a doomed call: if the task-level
+            // deadline is already past or the stall watchdog aborted, stop trying.
+            if (options.taskDeadlineMs !== undefined && Date.now() >= options.taskDeadlineMs)
+                break;
+            if (options.abortSignal?.aborted)
+                break;
+            const delayMs = BASE_DELAY_MS * Math.pow(2, attempt);
+            safeSink?.({ kind: 'retry', attempt: attempt + 1, previousStatus: result.status, delayMs });
+            await sleep(delayMs);
+        }
+        const record = {
+            provider: provider.name,
+            status: result.status,
+            turns: result.turns,
+            inputTokens: result.usage.inputTokens,
+            outputTokens: result.usage.outputTokens,
+            costUSD: result.cost?.costUSD ?? null,
+            initialPromptLengthChars,
+            initialPromptHash,
+            reason: result.status === 'ok'
+                ? undefined
+                : (result.error || `status=${result.status}`),
+        };
+        attempts.push({ result, record });
+        if (result.status === 'ok') {
+            const terminationReason = {
+                cause: 'finished',
+                turnsUsed: result.turns,
+                hasFileArtifacts: result.filesWritten.length > 0,
+                usedShell: result.toolCalls.some(tc => extractToolName(tc) === 'runShell'),
+                workerSelfAssessment: result.workerStatus ?? null,
+                wasPromoted: false,
+            };
+            return { ...result, terminationReason, escalationLog: attempts.map((a) => a.record) };
+        }
+        // Skip the next provider in the fallback chain if the task-level
+        // deadline has been hit or the stall watchdog aborted.
+        if (options.taskDeadlineMs !== undefined && Date.now() >= options.taskDeadlineMs) {
+            break;
+        }
+        if (options.abortSignal?.aborted) {
+            break;
+        }
+        if (options.explicitlyPinned) {
+            return {
+                ...result,
+                errorCode: result.errorCode ?? result.status,
+                retryable: result.retryable ?? retryableFor(result.status),
+                escalationLog: attempts.map((a) => a.record),
+            };
+        }
+    }
+    const realContentAttempts = attempts.filter((a) => !a.result.outputIsDiagnostic);
+    const pool = realContentAttempts.length > 0 ? realContentAttempts : attempts;
+    let best = pool[0].result;
+    for (const a of pool) {
+        if (a.result.output.length > best.output.length) {
+            best = a.result;
+        }
+    }
+    const baseStatus = best.status === 'ok' ? 'incomplete' : best.status;
+    // C2: Promote incomplete → ok when agent self-assessed as done AND produced work artifacts
+    // OR verified with shell (ran tests/builds) even without writing files
+    const outputIsSubstantive = best.output.trim().length > 0 && !best.outputIsDiagnostic;
+    const hasShellVerification = best.toolCalls.some(tc => extractToolName(tc) === 'runShell');
+    const finalStatus = baseStatus === 'incomplete' &&
+        best.workerStatus === 'done' &&
+        outputIsSubstantive &&
+        (best.filesWritten.length > 0 || hasCompletedWork(best.toolCalls) || hasShellVerification || task.skipCompletionHeuristic === true)
+        ? 'ok'
+        : baseStatus;
+    const wasPromoted = finalStatus === 'ok' && baseStatus === 'incomplete';
+    const terminationReason = {
+        cause: deriveCause(finalStatus, best.errorCode),
+        turnsUsed: best.turns,
+        hasFileArtifacts: best.filesWritten.length > 0,
+        usedShell: best.toolCalls.some(tc => extractToolName(tc) === 'runShell'),
+        workerSelfAssessment: best.workerStatus ?? null,
+        wasPromoted,
+    };
+    return {
+        ...best,
+        status: finalStatus,
+        terminationReason,
+        errorCode: best.errorCode ?? finalStatus,
+        retryable: best.retryable ?? retryableFor(finalStatus),
+        escalationLog: attempts.map((a) => a.record),
+    };
+}
+//# sourceMappingURL=delegate-with-escalation.js.map

package/dist/escalation/delegate-with-escalation.js.map

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

package/dist/escalation/escalation-policy.d.ts

@@ -0,0 +1,18 @@
+import type { AgentType } from '../types.js';
+export type ToolCategory = 'artifact_producing' | 'read_only' | 'research' | 'assist';
+export declare const ATTEMPT_BUDGETS: Record<ToolCategory, number>;
+export declare class EscalationPolicy {
+    /**
+     * Returns the tier to use for the implementer at the given chain attempt.
+     * Per spec § C9 (overall.md lines 1247-1252): attempts 0 and 1 hold the caller's tier;
+     * attempt 2 (the 3rd try) rotates to otherTier. attempt >= 3 means budget exhausted.
+     */
+    rotateImpl(currentTier: AgentType, attempt: number): AgentType;
+    /**
+     * Reviewer always sits on otherTier of the current implementer tier.
+     * On attempt 2 when implementer rotated, reviewer auto-flips back to the caller's original tier.
+     */
+    rotateReviewer(currentImplTier: AgentType): AgentType;
+    attemptBudget(category: ToolCategory): number;
+}
+//# sourceMappingURL=escalation-policy.d.ts.map

package/dist/escalation/escalation-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation-policy.d.ts","sourceRoot":"","sources":["../../src/escalation/escalation-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,MAAM,MAAM,YAAY,GAAG,oBAAoB,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEtF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAKxD,CAAC;AAEF,qBAAa,gBAAgB;IAC3B;;;;OAIG;IACH,UAAU,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS;IAO9D;;;OAGG;IACH,cAAc,CAAC,eAAe,EAAE,SAAS,GAAG,SAAS;IAIrD,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM;CAG9C"}

package/dist/escalation/escalation-policy.js

@@ -0,0 +1,34 @@
+import { otherTier } from '../config/tier-policy-registry.js';
+export const ATTEMPT_BUDGETS = {
+    artifact_producing: 7, // 3 spec + 3 quality + 1 diff
+    read_only: 2, // 1 implementer + 1 annotator (no rework)
+    research: 3, // explore-style (no review)
+    assist: 1, // register_context_block, retry_tasks — sync state ops, no rework
+};
+export class EscalationPolicy {
+    /**
+     * Returns the tier to use for the implementer at the given chain attempt.
+     * Per spec § C9 (overall.md lines 1247-1252): attempts 0 and 1 hold the caller's tier;
+     * attempt 2 (the 3rd try) rotates to otherTier. attempt >= 3 means budget exhausted.
+     */
+    rotateImpl(currentTier, attempt) {
+        if (attempt < 0)
+            throw new Error(`attempt must be >= 0, got ${attempt}`);
+        if (attempt >= 3)
+            throw new Error(`per-chain attempt budget exhausted (attempt=${attempt}); chain should have terminated`);
+        if (attempt === 2)
+            return otherTier(currentTier); // 3rd attempt rotates
+        return currentTier; // attempts 0 + 1 hold caller tier
+    }
+    /**
+     * Reviewer always sits on otherTier of the current implementer tier.
+     * On attempt 2 when implementer rotated, reviewer auto-flips back to the caller's original tier.
+     */
+    rotateReviewer(currentImplTier) {
+        return otherTier(currentImplTier);
+    }
+    attemptBudget(category) {
+        return ATTEMPT_BUDGETS[category];
+    }
+}
+//# sourceMappingURL=escalation-policy.js.map

package/dist/escalation/escalation-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation-policy.js","sourceRoot":"","sources":["../../src/escalation/escalation-policy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAI9D,MAAM,CAAC,MAAM,eAAe,GAAiC;IAC3D,kBAAkB,EAAE,CAAC,EAAK,8BAA8B;IACxD,SAAS,EAAE,CAAC,EAAe,0CAA0C;IACrE,QAAQ,EAAE,CAAC,EAAgB,4BAA4B;IACvD,MAAM,EAAE,CAAC,EAAkB,kEAAkE;CAC9F,CAAC;AAEF,MAAM,OAAO,gBAAgB;IAC3B;;;;OAIG;IACH,UAAU,CAAC,WAAsB,EAAE,OAAe;QAChD,IAAI,OAAO,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,EAAE,CAAC,CAAC;QACzE,IAAI,OAAO,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,OAAO,iCAAiC,CAAC,CAAC;QAC3H,IAAI,OAAO,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC,WAAW,CAAC,CAAC,CAAG,sBAAsB;QAC1E,OAAO,WAAW,CAAC,CAAkC,kCAAkC;IACzF,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,eAA0B;QACvC,OAAO,SAAS,CAAC,eAAe,CAAC,CAAC;IACpC,CAAC;IAED,aAAa,CAAC,QAAsB;QAClC,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/escalation/fallback-helpers.d.ts

@@ -0,0 +1,22 @@
+import type { Provider, AgentType, RunResult } from '../types.js';
+/** Two providers are "identical" iff they resolve to the same effective backend
+ *  (type + model + baseUrl + apiKey wiring). When an operator points both tiers
+ *  at the same backend (one-provider deployment), cross-tier fallback is
+ *  structurally pointless — alt would just hit the same place. Comparing the
+ *  serialized config catches this without a new operator-facing flag. */
+export declare function providersIdentical(a: Provider, b: Provider): boolean;
+/** Lifecycle helper: builds the synthetic RunResult expected when both tiers are
+ *  unavailable. Status is the new 'unavailable' value (NOT 'api_error') so
+ *  re-passing the synthetic into runWithFallback's isTransportFailure cannot
+ *  retrigger fallback.
+ *
+ *  IMPORTANT: This shape MUST satisfy `RunResult` (see types.ts). Confirmed
+ *  required fields: output, status, usage, turns, filesRead, filesWritten,
+ *  toolCalls, outputIsDiagnostic, escalationLog. All other RunResult fields
+ *  are optional. */
+export declare function makeSyntheticRunResult(assigned: AgentType, errorCode: string): RunResult;
+export declare function isReviewTransportFailure(r: {
+    status?: string;
+}): boolean;
+export declare function scoreWork<T>(r: T | undefined): number;
+//# sourceMappingURL=fallback-helpers.d.ts.map

package/dist/escalation/fallback-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback-helpers.d.ts","sourceRoot":"","sources":["../../src/escalation/fallback-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAElE;;;;yEAIyE;AACzE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAEpE;AAED;;;;;;;;oBAQoB;AACpB,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,CAgBxF;AAED,wBAAgB,wBAAwB,CACtC,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACrB,OAAO,CAET;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,SAAS,GAAG,MAAM,CAMrD"}

package/dist/escalation/fallback-helpers.js

@@ -0,0 +1,46 @@
+/** Two providers are "identical" iff they resolve to the same effective backend
+ *  (type + model + baseUrl + apiKey wiring). When an operator points both tiers
+ *  at the same backend (one-provider deployment), cross-tier fallback is
+ *  structurally pointless — alt would just hit the same place. Comparing the
+ *  serialized config catches this without a new operator-facing flag. */
+export function providersIdentical(a, b) {
+    return JSON.stringify(a.config) === JSON.stringify(b.config);
+}
+/** Lifecycle helper: builds the synthetic RunResult expected when both tiers are
+ *  unavailable. Status is the new 'unavailable' value (NOT 'api_error') so
+ *  re-passing the synthetic into runWithFallback's isTransportFailure cannot
+ *  retrigger fallback.
+ *
+ *  IMPORTANT: This shape MUST satisfy `RunResult` (see types.ts). Confirmed
+ *  required fields: output, status, usage, turns, filesRead, filesWritten,
+ *  toolCalls, outputIsDiagnostic, escalationLog. All other RunResult fields
+ *  are optional. */
+export function makeSyntheticRunResult(assigned, errorCode) {
+    return {
+        status: 'unavailable',
+        output: '',
+        outputIsDiagnostic: true,
+        error: `runWithFallback: both tiers unavailable (assigned=${assigned})`,
+        errorCode,
+        retryable: false,
+        turns: 0,
+        usage: { inputTokens: 0, outputTokens: 0, cachedReadTokens: 0, cachedNonReadTokens: 0 },
+        filesRead: [],
+        filesWritten: [],
+        toolCalls: [],
+        escalationLog: [],
+        parsedFindings: null,
+    };
+}
+export function isReviewTransportFailure(r) {
+    return r.status === 'api_error' || r.status === 'provider_transport_failure' || r.status === 'timeout';
+}
+export function scoreWork(r) {
+    if (!r)
+        return 0;
+    const usage = r.usage ?? {};
+    const turns = r.turns ?? 0;
+    const filesWritten = (r.filesWritten ?? []).length ?? 0;
+    return turns + filesWritten + (usage.inputTokens ?? 0) / 1000;
+}
+//# sourceMappingURL=fallback-helpers.js.map

package/dist/escalation/fallback-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback-helpers.js","sourceRoot":"","sources":["../../src/escalation/fallback-helpers.ts"],"names":[],"mappings":"AAEA;;;;yEAIyE;AACzE,MAAM,UAAU,kBAAkB,CAAC,CAAW,EAAE,CAAW;IACzD,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;;;oBAQoB;AACpB,MAAM,UAAU,sBAAsB,CAAC,QAAmB,EAAE,SAAiB;IAC3E,OAAO;QACL,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,EAAE;QACV,kBAAkB,EAAE,IAAI;QACxB,KAAK,EAAE,qDAAqD,QAAQ,GAAG;QACvE,SAAS;QACT,SAAS,EAAE,KAAK;QAChB,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE;QACvF,SAAS,EAAE,EAAE;QACb,YAAY,EAAE,EAAE;QAChB,SAAS,EAAE,EAAE;QACb,aAAa,EAAE,EAAE;QACjB,cAAc,EAAE,IAAI;KACrB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,CAAsB;IAEtB,OAAO,CAAC,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,MAAM,KAAK,4BAA4B,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC;AACzG,CAAC;AAED,MAAM,UAAU,SAAS,CAAI,CAAgB;IAC3C,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACjB,MAAM,KAAK,GAAI,CAA0C,CAAC,KAAK,IAAI,EAAE,CAAC;IACtE,MAAM,KAAK,GAAI,CAAwB,CAAC,KAAK,IAAI,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,CAAE,CAAkC,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;IAC1F,OAAO,KAAK,GAAG,YAAY,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;AAChE,CAAC"}

package/dist/escalation/fallback-types.d.ts

@@ -0,0 +1,60 @@
+import type { RunStatus } from '../providers/runner-types.js';
+import type { AgentType, Provider } from '../types.js';
+import type { CanonicalIdentity } from '../config/canonical-model-identity.js';
+export declare const TRANSPORT_FAILURES: ReadonlySet<RunStatus>;
+export type FallbackReason = 'transport_failure' | 'not_configured';
+export type UnavailableMap = Map<AgentType, FallbackReason>;
+/** First-write-wins. Preserves root cause across the loop. */
+export declare function markUnavailable(map: UnavailableMap, tier: AgentType, reason: FallbackReason): void;
+export interface RunWithFallbackInput<T> {
+    assigned: AgentType;
+    providerFor: (tier: AgentType) => Provider | undefined;
+    unavailableTiers: UnavailableMap;
+    isTransportFailure: (result: T) => boolean;
+    /** Caller-supplied status extractor. Replaces unsafe `(result as any).status` casts.
+     *  Returns undefined for results that don't carry a status field (custom T types). */
+    getStatus?: (result: T) => RunStatus | undefined;
+    makeSyntheticFailure: (assigned: AgentType) => T;
+    call: (provider: Provider) => Promise<T>;
+    /** Canonical identities to exclude from candidate selection. When a candidate
+     *  provider's resolved identity matches one in this set, the candidate is skipped
+     *  as a separation violation. If identity resolution throws on a successfully-constructed
+     *  provider, the candidate is also skipped (fail-closed). Provider construction
+     *  failures (providerFor throws/returns undefined) follow the existing unavailable path. */
+    forbiddenIdentities?: CanonicalIdentity[];
+}
+export interface RunWithFallbackResult<T> {
+    result: T;
+    usedTier: AgentType | 'none';
+    /** True iff an alternate tier was actually USED for a provider call (not just considered).
+     *  False when both tiers were unavailable up-front (no provider call made).
+     *  Used by lifecycle to decide whether to emit a `fallback` event (yes iff fallbackFired).
+     *  Distinct from `bothUnavailable` (which means "no usable result"). */
+    fallbackFired: boolean;
+    /** Why the substitution was attempted. Present iff fallbackFired or assignedUnavailableReason set. */
+    fallbackReason?: FallbackReason;
+    /** Status of the call that triggered the substitution (assigned-tier failure). Present iff
+     *  fallbackReason === 'transport_failure' AND a real call occurred. */
+    fallbackTriggeringStatus?: RunStatus;
+    /** True iff the wrapper could not produce a usable result. */
+    bothUnavailable: boolean;
+    /** Why the FINAL tier (alt or assigned) was unavailable. Present iff bothUnavailable. */
+    unavailableReason?: FallbackReason;
+    /** Status of the alt-tier failure that produced bothUnavailable mid-call. Present iff
+     *  bothUnavailable AND mid-call double-failure path AND alt was actually called. */
+    unavailableTriggeringStatus?: RunStatus;
+    /** Why the assigned tier was unavailable up-front (sticky or not-configured). Present iff
+     *  fallbackReason set without calling assigned. Distinct from `fallbackReason` so callers
+     *  can tell "we substituted at the start" vs "we substituted because the assigned call failed". */
+    assignedUnavailableReason?: FallbackReason;
+    /** True iff the final used tier differs in canonical identity from all forbiddenIdentities.
+     *  Set only when forbiddenIdentities was provided. */
+    fallbackSeparationRespected?: boolean;
+    /** Canonical identity of the assigned tier's provider (resolved at selection time). */
+    assignedIdentity?: CanonicalIdentity;
+    /** Canonical identity of the actually-used tier's provider. */
+    usedIdentity?: CanonicalIdentity;
+    /** Higher-work-score of firstResult/altResult on bothUnavailable; null when both have zero work. */
+    salvageResult: T | null;
+}
+//# sourceMappingURL=fallback-types.d.ts.map

package/dist/escalation/fallback-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback-types.d.ts","sourceRoot":"","sources":["../../src/escalation/fallback-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE/E,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,SAAS,CAIpD,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;AACpE,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AAE5D,8DAA8D;AAC9D,wBAAgB,eAAe,CAC7B,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,cAAc,GACrB,IAAI,CAEN;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,QAAQ,EAAE,SAAS,CAAC;IACpB,WAAW,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,QAAQ,GAAG,SAAS,CAAC;IACvD,gBAAgB,EAAE,cAAc,CAAC;IACjC,kBAAkB,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC;IAC3C;0FACsF;IACtF,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,SAAS,GAAG,SAAS,CAAC;IACjD,oBAAoB,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,CAAC,CAAC;IACjD,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACzC;;;;gGAI4F;IAC5F,mBAAmB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,MAAM,EAAE,CAAC,CAAC;IACV,QAAQ,EAAE,SAAS,GAAG,MAAM,CAAC;IAE7B;;;4EAGwE;IACxE,aAAa,EAAE,OAAO,CAAC;IACvB,sGAAsG;IACtG,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;2EACuE;IACvE,wBAAwB,CAAC,EAAE,SAAS,CAAC;IAErC,8DAA8D;IAC9D,eAAe,EAAE,OAAO,CAAC;IACzB,yFAAyF;IACzF,iBAAiB,CAAC,EAAE,cAAc,CAAC;IACnC;wFACoF;IACpF,2BAA2B,CAAC,EAAE,SAAS,CAAC;IAExC;;uGAEmG;IACnG,yBAAyB,CAAC,EAAE,cAAc,CAAC;IAE3C;0DACsD;IACtD,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IACrC,+DAA+D;IAC/D,YAAY,CAAC,EAAE,iBAAiB,CAAC;IAEjC,oGAAoG;IACpG,aAAa,EAAE,CAAC,GAAG,IAAI,CAAC;CACzB"}

package/dist/escalation/fallback-types.js

@@ -0,0 +1,11 @@
+export const TRANSPORT_FAILURES = new Set([
+    'api_error',
+    'provider_transport_failure',
+    'timeout',
+]);
+/** First-write-wins. Preserves root cause across the loop. */
+export function markUnavailable(map, tier, reason) {
+    if (!map.has(tier))
+        map.set(tier, reason);
+}
+//# sourceMappingURL=fallback-types.js.map

package/dist/escalation/fallback-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback-types.js","sourceRoot":"","sources":["../../src/escalation/fallback-types.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,kBAAkB,GAA2B,IAAI,GAAG,CAAC;IAChE,WAAW;IACX,4BAA4B;IAC5B,SAAS;CACV,CAAC,CAAC;AAKH,8DAA8D;AAC9D,MAAM,UAAU,eAAe,CAC7B,GAAmB,EACnB,IAAe,EACf,MAAsB;IAEtB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC"}

package/dist/escalation/fallback.d.ts

@@ -1,87 +1,5 @@
-import type { Provider, AgentType, RunResult } from '../types.js';
-import type { RunStatus } from '../runners/types.js';
-import { type CanonicalIdentity } from '../routing/canonical-model-identity.js';
-export declare const TRANSPORT_FAILURES: ReadonlySet<RunStatus>;
-export type FallbackReason = 'transport_failure' | 'not_configured' | 'reviewer_separation_unsatisfiable';
-export type UnavailableMap = Map<AgentType, FallbackReason>;
-/** First-write-wins. Preserves root cause across the loop. */
-export declare function markUnavailable(map: UnavailableMap, tier: AgentType, reason: FallbackReason): void;
-export declare function otherTier(t: AgentType): AgentType;
-/** Two providers are "identical" iff they resolve to the same effective backend
- *  (type + model + baseUrl + apiKey wiring). When an operator points both tiers
- *  at the same backend (one-provider deployment), cross-tier fallback is
- *  structurally pointless — alt would just hit the same place. Comparing the
- *  serialized config catches this without a new operator-facing flag. */
-export declare function providersIdentical(a: Provider, b: Provider): boolean;
-export interface RunWithFallbackInput<T> {
-    assigned: AgentType;
-    providerFor: (tier: AgentType) => Provider | undefined;
-    unavailableTiers: UnavailableMap;
-    isTransportFailure: (result: T) => boolean;
-    /** Caller-supplied status extractor. Replaces unsafe `(result as any).status` casts.
-     *  Returns undefined for results that don't carry a status field (custom T types). */
-    getStatus?: (result: T) => RunStatus | undefined;
-    makeSyntheticFailure: (assigned: AgentType) => T;
-    call: (provider: Provider) => Promise<T>;
-    /** Canonical identities to exclude from candidate selection. When a candidate
-     *  provider's resolved identity matches one in this set, the candidate is skipped
-     *  as a separation violation. If identity resolution throws on a successfully-constructed
-     *  provider, the candidate is also skipped (fail-closed). Provider construction
-     *  failures (providerFor throws/returns undefined) follow the existing unavailable path. */
-    forbiddenIdentities?: CanonicalIdentity[];
-    /** Tier(s) to exclude from candidate selection. When a candidate's tier
-     *  matches an entry in this set, the candidate is skipped with
-     *  `unavailableReason: 'reviewer_separation_unsatisfiable'`. This check
-     *  runs after `forbiddenIdentities` and gates separation by tier rather
-     *  than by model family — same-model/different-tier is allowed. */
-    forbiddenTiers?: AgentType[];
-}
-export interface RunWithFallbackResult<T> {
-    result: T;
-    usedTier: AgentType | 'none';
-    /** True iff an alternate tier was actually USED for a provider call (not just considered).
-     *  False when both tiers were unavailable up-front (no provider call made).
-     *  Used by lifecycle to decide whether to emit a `fallback` event (yes iff fallbackFired).
-     *  Distinct from `bothUnavailable` (which means "no usable result"). */
-    fallbackFired: boolean;
-    /** Why the substitution was attempted. Present iff fallbackFired or assignedUnavailableReason set. */
-    fallbackReason?: FallbackReason;
-    /** Status of the call that triggered the substitution (assigned-tier failure). Present iff
-     *  fallbackReason === 'transport_failure' AND a real call occurred. */
-    fallbackTriggeringStatus?: RunStatus;
-    /** True iff the wrapper could not produce a usable result. */
-    bothUnavailable: boolean;
-    /** Why the FINAL tier (alt or assigned) was unavailable. Present iff bothUnavailable. */
-    unavailableReason?: FallbackReason;
-    /** Status of the alt-tier failure that produced bothUnavailable mid-call. Present iff
-     *  bothUnavailable AND mid-call double-failure path AND alt was actually called. */
-    unavailableTriggeringStatus?: RunStatus;
-    /** Why the assigned tier was unavailable up-front (sticky or not-configured). Present iff
-     *  fallbackReason set without calling assigned. Distinct from `fallbackReason` so callers
-     *  can tell "we substituted at the start" vs "we substituted because the assigned call failed". */
-    assignedUnavailableReason?: FallbackReason;
-    /** True iff the final used tier differs in canonical identity from all forbiddenIdentities.
-     *  Set only when forbiddenIdentities was provided. */
-    fallbackSeparationRespected?: boolean;
-    /** Canonical identity of the assigned tier's provider (resolved at selection time). */
-    assignedIdentity?: CanonicalIdentity;
-    /** Canonical identity of the actually-used tier's provider. */
-    usedIdentity?: CanonicalIdentity;
-    /** Higher-work-score of firstResult/altResult on bothUnavailable; null when both have zero work. */
-    salvageResult: T | null;
-}
+import { type RunWithFallbackInput, type RunWithFallbackResult } from './fallback-types.js';
+export { providersIdentical, makeSyntheticRunResult, isReviewTransportFailure } from './fallback-helpers.js';
+export { TRANSPORT_FAILURES, type FallbackReason, type UnavailableMap, type RunWithFallbackInput, type RunWithFallbackResult } from './fallback-types.js';
 export declare function runWithFallback<T>(input: RunWithFallbackInput<T>): Promise<RunWithFallbackResult<T>>;
-/** Lifecycle helper: builds the synthetic RunResult expected when both tiers are
- *  unavailable. Status is the new 'unavailable' value (NOT 'api_error') so
- *  re-passing the synthetic into runWithFallback's isTransportFailure cannot
- *  retrigger fallback.
- *
- *  IMPORTANT: This shape MUST satisfy `RunResult` (see types.ts). Confirmed
- *  required fields: output, status, usage, turns, filesRead, filesWritten,
- *  toolCalls, outputIsDiagnostic, escalationLog. All other RunResult fields
- *  are optional. */
-export declare function makeSyntheticRunResult(assigned: AgentType, errorCode: string): RunResult;
-export declare function isReviewTransportFailure(r: {
-    status?: string;
-}): boolean;
 //# sourceMappingURL=fallback.d.ts.map

package/dist/escalation/fallback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../src/escalation/fallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAqC,KAAK,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAEnH,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,SAAS,CAIpD,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,mCAAmC,CAAC;AAC1G,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AAE5D,8DAA8D;AAC9D,wBAAgB,eAAe,CAC7B,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,cAAc,GACrB,IAAI,CAEN;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,GAAG,SAAS,CAEjD;AAED;;;;yEAIyE;AACzE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAEpE;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,QAAQ,EAAE,SAAS,CAAC;IACpB,WAAW,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,QAAQ,GAAG,SAAS,CAAC;IACvD,gBAAgB,EAAE,cAAc,CAAC;IACjC,kBAAkB,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC;IAC3C;0FACsF;IACtF,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,SAAS,GAAG,SAAS,CAAC;IACjD,oBAAoB,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,CAAC,CAAC;IACjD,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACzC;;;;gGAI4F;IAC5F,mBAAmB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAE1C;;;;uEAImE;IACnE,cAAc,CAAC,EAAE,SAAS,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,MAAM,EAAE,CAAC,CAAC;IACV,QAAQ,EAAE,SAAS,GAAG,MAAM,CAAC;IAE7B;;;4EAGwE;IACxE,aAAa,EAAE,OAAO,CAAC;IACvB,sGAAsG;IACtG,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;2EACuE;IACvE,wBAAwB,CAAC,EAAE,SAAS,CAAC;IAErC,8DAA8D;IAC9D,eAAe,EAAE,OAAO,CAAC;IACzB,yFAAyF;IACzF,iBAAiB,CAAC,EAAE,cAAc,CAAC;IACnC;wFACoF;IACpF,2BAA2B,CAAC,EAAE,SAAS,CAAC;IAExC;;uGAEmG;IACnG,yBAAyB,CAAC,EAAE,cAAc,CAAC;IAE3C;0DACsD;IACtD,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IACrC,+DAA+D;IAC/D,YAAY,CAAC,EAAE,iBAAiB,CAAC;IAEjC,oGAAoG;IACpG,aAAa,EAAE,CAAC,GAAG,IAAI,CAAC;CACzB;AAED,wBAAsB,eAAe,CAAC,CAAC,EACrC,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CA0YnC;AAED;;;;;;;;oBAQoB;AACpB,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,CAgBxF;AAED,wBAAgB,wBAAwB,CACtC,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACrB,OAAO,CAET"}
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../src/escalation/fallback.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiF,KAAK,oBAAoB,EAAE,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE3K,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAC7G,OAAO,EAAE,kBAAkB,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,oBAAoB,EAAE,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE1J,wBAAsB,eAAe,CAAC,CAAC,EACrC,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAwVnC"}