@code-yeongyu/senpi 2026.7.20-2 → 2026.7.20

package/dist/core/retry-fallback/controller.js

@@ -1,157 +0,0 @@
-import { getSupportedThinkingLevels } from "../thinking-levels.js";
-import { baseSelector, candidatesAfter, canonicalizeFallbackChains, formatSelector, parseFallbackSelector, resolveChainKey, } from "./chains.js";
-export class RetryFallbackController {
-    constructor(deps) {
-        this.triedSelectors = new Set();
-        this.deps = deps;
-    }
-    get activeState() {
-        return this.state;
-    }
-    get exhaustedChainKey() {
-        return this.lastExhaustedChainKey;
-    }
-    resetTurn() {
-        this.triedSelectors.clear();
-        this.lastExhaustedChainKey = undefined;
-    }
-    clear() {
-        this.state = undefined;
-        this.resetTurn();
-    }
-    canTryFallback() {
-        return this.nextCandidate(false) !== undefined;
-    }
-    /**
-     * Revert to the chain's original model at a turn boundary. Only fires for
-     * unpinned state under the cooldown-expiry policy once the original selector
-     * is no longer suppressed and is still usable; pinned (refusal) state and the
-     * "never" policy always hold the fallback model.
-     */
-    async maybeRestorePrimary(revertPolicy) {
-        const state = this.state;
-        if (!state || state.pinned || revertPolicy !== "cooldown-expiry")
-            return false;
-        if (this.deps.cooldowns.isSuppressed(state.originalSelector))
-            return false;
-        const selector = parseFallbackSelector(state.originalSelector, this.deps.registry);
-        if (!selector || !this.deps.isAuthAvailable(selector.provider))
-            return false;
-        const model = this.deps.registry.find(selector.provider, selector.id);
-        const current = this.deps.getCurrentSelector();
-        if (!model || !current)
-            return false;
-        // User override wins: only restore the original thinking level when the
-        // current level still equals the level the fallback switch applied. A manual
-        // setThinkingLevel clears lastAppliedThinkingLevel (see noteManualThinkingLevel).
-        const thinking = current.thinkingLevel === state.lastAppliedThinkingLevel
-            ? (state.originalThinkingLevel ?? current.thinkingLevel ?? "off")
-            : (current.thinkingLevel ?? "off");
-        await this.deps.switchModel(model, thinking, "fallback-revert");
-        const from = formatSelector(current.model);
-        this.state = undefined;
-        this.deps.logger.info("fallback_reverted", { from, to: state.originalSelector });
-        this.deps.emit({ type: "retry_fallback_reverted", from, to: state.originalSelector });
-        return true;
-    }
-    /**
-     * A user-driven setThinkingLevel makes the current level a deliberate choice,
-     * so the revert restore-rule must no longer treat it as fallback-applied.
-     */
-    noteManualThinkingLevel() {
-        if (this.state)
-            this.state.lastAppliedThinkingLevel = undefined;
-    }
-    /** A user-driven model change abandons the fallback window entirely. */
-    clearForManualModelChange(model) {
-        if (this.state) {
-            this.deps.logger.info("fallback_cleared_manual", { selector: formatSelector(model) });
-        }
-        this.state = undefined;
-        this.deps.cooldowns.clear(formatSelector(model));
-    }
-    async tryFallback(reason, failure) {
-        const current = this.deps.getCurrentSelector();
-        const candidate = this.nextCandidate();
-        if (!current || !candidate)
-            return false;
-        const currentBase = formatSelector(current.model);
-        if (reason === "transient" || reason === "hard-error") {
-            this.deps.cooldowns.note(currentBase, failure);
-            this.deps.logger.info("cooldown_noted", { selector: currentBase, errorMessage: failure.errorMessage });
-        }
-        const thinking = this.selectThinking(candidate.selector, candidate.model, current.thinkingLevel);
-        await this.deps.switchModel(candidate.model, thinking, "fallback");
-        const from = formatSelector(current.model);
-        const to = formatSelector(candidate.model);
-        this.state = {
-            chainKey: candidate.chainKey,
-            originalSelector: this.state?.originalSelector ?? from,
-            originalThinkingLevel: this.state?.originalThinkingLevel ?? current.thinkingLevel,
-            lastAppliedThinkingLevel: thinking,
-            pinned: this.state?.pinned === true || reason === "refusal",
-        };
-        this.deps.logger.info("fallback_applied", { from, to, chainKey: candidate.chainKey, reason });
-        this.deps.emit({ type: "retry_fallback_applied", from, to, chainKey: candidate.chainKey, reason });
-        return true;
-    }
-    nextCandidate(reserve = true) {
-        const settings = this.deps.getSettings();
-        const current = this.deps.getCurrentSelector();
-        if (!settings.modelFallback || !current)
-            return undefined;
-        const chains = canonicalizeFallbackChains(settings.chains, this.deps.registry);
-        const chainKey = resolveChainKey(current.model, current.thinkingLevel, chains) ?? this.state?.chainKey;
-        const entries = chainKey ? chains[chainKey] : undefined;
-        if (!chainKey || !entries) {
-            if (reserve)
-                this.deps.logger.debug("no_chain", { selector: formatSelector(current.model) });
-            return undefined;
-        }
-        for (const raw of candidatesAfter(entries, formatSelector(current.model, current.thinkingLevel))) {
-            const selector = parseFallbackSelector(raw, this.deps.registry);
-            if (!selector) {
-                this.skip(raw, "unknown");
-                continue;
-            }
-            if (selector.provider === current.model.provider && selector.id === current.model.id) {
-                this.skip(raw, "self");
-                continue;
-            }
-            const base = baseSelector(selector);
-            if (this.triedSelectors.has(base)) {
-                this.skip(raw, "tried");
-                continue;
-            }
-            if (this.deps.cooldowns.isSuppressed(base)) {
-                this.skip(raw, "suppressed");
-                continue;
-            }
-            if (!this.deps.isAuthAvailable(selector.provider)) {
-                this.skip(raw, "unauthenticated");
-                continue;
-            }
-            const model = this.deps.registry.find(selector.provider, selector.id);
-            if (!model) {
-                this.skip(raw, "unknown");
-                continue;
-            }
-            if (reserve)
-                this.triedSelectors.add(base);
-            return { chainKey, selector, model };
-        }
-        this.lastExhaustedChainKey = chainKey;
-        if (reserve)
-            this.deps.logger.info("candidates_exhausted", { chainKey });
-        return undefined;
-    }
-    selectThinking(selector, model, inherited) {
-        const requested = selector.thinkingLevel ?? inherited ?? "off";
-        const supported = getSupportedThinkingLevels(model);
-        return supported.includes(requested) ? requested : (supported[supported.length - 1] ?? "off");
-    }
-    skip(candidate, skipReason) {
-        this.deps.logger.debug("candidate_skipped", { candidate, skipReason });
-    }
-}
-//# sourceMappingURL=controller.js.map

package/dist/core/retry-fallback/controller.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../../src/core/retry-fallback/controller.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type { Api, Model } from \"@earendil-works/pi-ai\";\nimport { getSupportedThinkingLevels } from \"../thinking-levels.ts\";\nimport {\n\tbaseSelector,\n\tcandidatesAfter,\n\tcanonicalizeFallbackChains,\n\ttype FallbackSelector,\n\tformatSelector,\n\tparseFallbackSelector,\n\tresolveChainKey,\n} from \"./chains.ts\";\nimport type { SelectorCooldowns } from \"./cooldown.ts\";\nimport type { FallbackLogger } from \"./log.ts\";\n\nexport interface ActiveFallbackState {\n\tchainKey: string;\n\toriginalSelector: string;\n\toriginalThinkingLevel?: ThinkingLevel;\n\tlastAppliedThinkingLevel?: ThinkingLevel;\n\tpinned: boolean;\n}\n\ntype FallbackReason = \"transient\" | \"refusal\" | \"hard-error\";\n\ninterface FallbackSettings {\n\tmodelFallback: boolean;\n\tchains: Readonly<Record<string, readonly string[]>>;\n}\n\nexport interface RetryFallbackControllerDeps {\n\tgetSettings(): FallbackSettings;\n\tregistry: { find(provider: string, id: string): Model<Api> | undefined; getAll(): Model<Api>[] };\n\tcooldowns: SelectorCooldowns;\n\tlogger: FallbackLogger;\n\tswitchModel(model: Model<Api>, thinking: ThinkingLevel, reason: \"fallback\" | \"fallback-revert\"): Promise<void>;\n\temit(\n\t\tevent:\n\t\t\t| {\n\t\t\t\t\ttype: \"retry_fallback_applied\";\n\t\t\t\t\tfrom: string;\n\t\t\t\t\tto: string;\n\t\t\t\t\tchainKey: string;\n\t\t\t\t\treason: FallbackReason;\n\t\t\t  }\n\t\t\t| { type: \"retry_fallback_reverted\"; from: string; to: string },\n\t): void;\n\tgetCurrentSelector(): { model: Model<Api>; thinkingLevel?: ThinkingLevel } | undefined;\n\tisAuthAvailable(provider: string): boolean;\n}\n\nexport class RetryFallbackController {\n\tprivate readonly deps: RetryFallbackControllerDeps;\n\tprivate readonly triedSelectors = new Set<string>();\n\tprivate state: ActiveFallbackState | undefined;\n\tprivate lastExhaustedChainKey: string | undefined;\n\n\tconstructor(deps: RetryFallbackControllerDeps) {\n\t\tthis.deps = deps;\n\t}\n\n\tget activeState(): Readonly<ActiveFallbackState> | undefined {\n\t\treturn this.state;\n\t}\n\n\tget exhaustedChainKey(): string | undefined {\n\t\treturn this.lastExhaustedChainKey;\n\t}\n\n\tresetTurn(): void {\n\t\tthis.triedSelectors.clear();\n\t\tthis.lastExhaustedChainKey = undefined;\n\t}\n\n\tclear(): void {\n\t\tthis.state = undefined;\n\t\tthis.resetTurn();\n\t}\n\n\tcanTryFallback(): boolean {\n\t\treturn this.nextCandidate(false) !== undefined;\n\t}\n\n\t/**\n\t * Revert to the chain's original model at a turn boundary. Only fires for\n\t * unpinned state under the cooldown-expiry policy once the original selector\n\t * is no longer suppressed and is still usable; pinned (refusal) state and the\n\t * \"never\" policy always hold the fallback model.\n\t */\n\tasync maybeRestorePrimary(revertPolicy: \"cooldown-expiry\" | \"never\"): Promise<boolean> {\n\t\tconst state = this.state;\n\t\tif (!state || state.pinned || revertPolicy !== \"cooldown-expiry\") return false;\n\t\tif (this.deps.cooldowns.isSuppressed(state.originalSelector)) return false;\n\t\tconst selector = parseFallbackSelector(state.originalSelector, this.deps.registry);\n\t\tif (!selector || !this.deps.isAuthAvailable(selector.provider)) return false;\n\t\tconst model = this.deps.registry.find(selector.provider, selector.id);\n\t\tconst current = this.deps.getCurrentSelector();\n\t\tif (!model || !current) return false;\n\t\t// User override wins: only restore the original thinking level when the\n\t\t// current level still equals the level the fallback switch applied. A manual\n\t\t// setThinkingLevel clears lastAppliedThinkingLevel (see noteManualThinkingLevel).\n\t\tconst thinking =\n\t\t\tcurrent.thinkingLevel === state.lastAppliedThinkingLevel\n\t\t\t\t? (state.originalThinkingLevel ?? current.thinkingLevel ?? \"off\")\n\t\t\t\t: (current.thinkingLevel ?? \"off\");\n\t\tawait this.deps.switchModel(model, thinking, \"fallback-revert\");\n\t\tconst from = formatSelector(current.model);\n\t\tthis.state = undefined;\n\t\tthis.deps.logger.info(\"fallback_reverted\", { from, to: state.originalSelector });\n\t\tthis.deps.emit({ type: \"retry_fallback_reverted\", from, to: state.originalSelector });\n\t\treturn true;\n\t}\n\n\t/**\n\t * A user-driven setThinkingLevel makes the current level a deliberate choice,\n\t * so the revert restore-rule must no longer treat it as fallback-applied.\n\t */\n\tnoteManualThinkingLevel(): void {\n\t\tif (this.state) this.state.lastAppliedThinkingLevel = undefined;\n\t}\n\n\t/** A user-driven model change abandons the fallback window entirely. */\n\tclearForManualModelChange(model: Model<Api>): void {\n\t\tif (this.state) {\n\t\t\tthis.deps.logger.info(\"fallback_cleared_manual\", { selector: formatSelector(model) });\n\t\t}\n\t\tthis.state = undefined;\n\t\tthis.deps.cooldowns.clear(formatSelector(model));\n\t}\n\n\tasync tryFallback(\n\t\treason: FallbackReason,\n\t\tfailure: { errorMessage?: string; retryAfterMs?: number },\n\t): Promise<boolean> {\n\t\tconst current = this.deps.getCurrentSelector();\n\t\tconst candidate = this.nextCandidate();\n\t\tif (!current || !candidate) return false;\n\t\tconst currentBase = formatSelector(current.model);\n\t\tif (reason === \"transient\" || reason === \"hard-error\") {\n\t\t\tthis.deps.cooldowns.note(currentBase, failure);\n\t\t\tthis.deps.logger.info(\"cooldown_noted\", { selector: currentBase, errorMessage: failure.errorMessage });\n\t\t}\n\n\t\tconst thinking = this.selectThinking(candidate.selector, candidate.model, current.thinkingLevel);\n\t\tawait this.deps.switchModel(candidate.model, thinking, \"fallback\");\n\t\tconst from = formatSelector(current.model);\n\t\tconst to = formatSelector(candidate.model);\n\t\tthis.state = {\n\t\t\tchainKey: candidate.chainKey,\n\t\t\toriginalSelector: this.state?.originalSelector ?? from,\n\t\t\toriginalThinkingLevel: this.state?.originalThinkingLevel ?? current.thinkingLevel,\n\t\t\tlastAppliedThinkingLevel: thinking,\n\t\t\tpinned: this.state?.pinned === true || reason === \"refusal\",\n\t\t};\n\t\tthis.deps.logger.info(\"fallback_applied\", { from, to, chainKey: candidate.chainKey, reason });\n\t\tthis.deps.emit({ type: \"retry_fallback_applied\", from, to, chainKey: candidate.chainKey, reason });\n\t\treturn true;\n\t}\n\n\tprivate nextCandidate(\n\t\treserve = true,\n\t): { chainKey: string; selector: FallbackSelector; model: Model<Api> } | undefined {\n\t\tconst settings = this.deps.getSettings();\n\t\tconst current = this.deps.getCurrentSelector();\n\t\tif (!settings.modelFallback || !current) return undefined;\n\t\tconst chains = canonicalizeFallbackChains(settings.chains, this.deps.registry);\n\t\tconst chainKey = resolveChainKey(current.model, current.thinkingLevel, chains) ?? this.state?.chainKey;\n\t\tconst entries = chainKey ? chains[chainKey] : undefined;\n\t\tif (!chainKey || !entries) {\n\t\t\tif (reserve) this.deps.logger.debug(\"no_chain\", { selector: formatSelector(current.model) });\n\t\t\treturn undefined;\n\t\t}\n\t\tfor (const raw of candidatesAfter(entries, formatSelector(current.model, current.thinkingLevel))) {\n\t\t\tconst selector = parseFallbackSelector(raw, this.deps.registry);\n\t\t\tif (!selector) {\n\t\t\t\tthis.skip(raw, \"unknown\");\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (selector.provider === current.model.provider && selector.id === current.model.id) {\n\t\t\t\tthis.skip(raw, \"self\");\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst base = baseSelector(selector);\n\t\t\tif (this.triedSelectors.has(base)) {\n\t\t\t\tthis.skip(raw, \"tried\");\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (this.deps.cooldowns.isSuppressed(base)) {\n\t\t\t\tthis.skip(raw, \"suppressed\");\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (!this.deps.isAuthAvailable(selector.provider)) {\n\t\t\t\tthis.skip(raw, \"unauthenticated\");\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst model = this.deps.registry.find(selector.provider, selector.id);\n\t\t\tif (!model) {\n\t\t\t\tthis.skip(raw, \"unknown\");\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (reserve) this.triedSelectors.add(base);\n\t\t\treturn { chainKey, selector, model };\n\t\t}\n\t\tthis.lastExhaustedChainKey = chainKey;\n\t\tif (reserve) this.deps.logger.info(\"candidates_exhausted\", { chainKey });\n\t\treturn undefined;\n\t}\n\n\tprivate selectThinking(\n\t\tselector: FallbackSelector,\n\t\tmodel: Model<Api>,\n\t\tinherited: ThinkingLevel | undefined,\n\t): ThinkingLevel {\n\t\tconst requested = selector.thinkingLevel ?? inherited ?? \"off\";\n\t\tconst supported = getSupportedThinkingLevels(model);\n\t\treturn supported.includes(requested) ? requested : (supported[supported.length - 1] ?? \"off\");\n\t}\n\n\tprivate skip(candidate: string, skipReason: string): void {\n\t\tthis.deps.logger.debug(\"candidate_skipped\", { candidate, skipReason });\n\t}\n}\n"]}

package/dist/core/retry-fallback/cooldown.d.ts

@@ -1,21 +0,0 @@
-/**
- * Runtime-only selector suppression. A SelectorCooldowns instance belongs to one
- * AgentSession and is deliberately never persisted to settings or session files.
- * Callers provide canonical base selectors without a thinking suffix.
- */
-export declare class SelectorCooldowns {
-    private readonly expiresAtBySelector;
-    private readonly now;
-    private readonly random;
-    constructor(now: () => number, random?: () => number);
-    note(baseSelector: string, failure: {
-        retryAfterMs?: number;
-        errorMessage?: string;
-    }): void;
-    isSuppressed(baseSelector: string): boolean;
-    clear(baseSelector: string): void;
-    clearAll(): void;
-    private durationFor;
-    private capacityJitterMs;
-}
-//# sourceMappingURL=cooldown.d.ts.map

package/dist/core/retry-fallback/cooldown.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cooldown.d.ts","sourceRoot":"","sources":["../../../src/core/retry-fallback/cooldown.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA6B;IACjE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IAEtC,YAAY,GAAG,EAAE,MAAM,MAAM,EAAE,MAAM,GAAE,MAAM,MAAoB,EAGhE;IAED,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAE1F;IAED,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAM1C;IAED,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAEhC;IAED,QAAQ,IAAI,IAAI,CAEf;IAED,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,gBAAgB;CAGxB"}

package/dist/core/retry-fallback/cooldown.js

@@ -1,49 +0,0 @@
-/**
- * Runtime-only selector suppression. A SelectorCooldowns instance belongs to one
- * AgentSession and is deliberately never persisted to settings or session files.
- * Callers provide canonical base selectors without a thinking suffix.
- */
-export class SelectorCooldowns {
-    constructor(now, random = Math.random) {
-        this.expiresAtBySelector = new Map();
-        this.now = now;
-        this.random = random;
-    }
-    note(baseSelector, failure) {
-        this.expiresAtBySelector.set(baseSelector, this.now() + this.durationFor(failure));
-    }
-    isSuppressed(baseSelector) {
-        const expiresAt = this.expiresAtBySelector.get(baseSelector);
-        if (expiresAt === undefined)
-            return false;
-        if (this.now() < expiresAt)
-            return true;
-        this.expiresAtBySelector.delete(baseSelector);
-        return false;
-    }
-    clear(baseSelector) {
-        this.expiresAtBySelector.delete(baseSelector);
-    }
-    clearAll() {
-        this.expiresAtBySelector.clear();
-    }
-    durationFor({ retryAfterMs, errorMessage }) {
-        if (retryAfterMs !== undefined && Number.isFinite(retryAfterMs) && retryAfterMs > 0) {
-            return retryAfterMs;
-        }
-        const message = errorMessage?.toLowerCase() ?? "";
-        if (/usage[- ]limit|quota|insufficient_quota|billing/.test(message))
-            return 30 * 60_000;
-        if (/rate[ -]?limit|429|too many requests/.test(message))
-            return 30_000;
-        if (/overloaded|capacity/.test(message))
-            return 45_000 + this.capacityJitterMs();
-        if (/5xx|\b5\d\d\b|server|internal error/.test(message))
-            return 20_000;
-        return 5 * 60_000;
-    }
-    capacityJitterMs() {
-        return Math.round(Math.min(1, Math.max(0, this.random())) * 30_000);
-    }
-}
-//# sourceMappingURL=cooldown.js.map

package/dist/core/retry-fallback/cooldown.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cooldown.js","sourceRoot":"","sources":["../../../src/core/retry-fallback/cooldown.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAK7B,YAAY,GAAiB,EAAE,MAAM,GAAiB,IAAI,CAAC,MAAM;QAJhD,wBAAmB,GAAG,IAAI,GAAG,EAAkB,CAAC;QAKhE,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,YAAoB,EAAE,OAAyD;QACnF,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IACpF,CAAC;IAED,YAAY,CAAC,YAAoB;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC7D,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC1C,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAAE,OAAO,IAAI,CAAC;QACxC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC9C,OAAO,KAAK,CAAC;IACd,CAAC;IAED,KAAK,CAAC,YAAoB;QACzB,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC/C,CAAC;IAED,QAAQ;QACP,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,CAAC;IAClC,CAAC;IAEO,WAAW,CAAC,EAAE,YAAY,EAAE,YAAY,EAAoD;QACnG,IAAI,YAAY,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrF,OAAO,YAAY,CAAC;QACrB,CAAC;QAED,MAAM,OAAO,GAAG,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAClD,IAAI,iDAAiD,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QACxF,IAAI,sCAAsC,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,MAAM,CAAC;QACxE,IAAI,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACjF,IAAI,qCAAqC,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,MAAM,CAAC;QACvE,OAAO,CAAC,GAAG,MAAM,CAAC;IACnB,CAAC;IAEO,gBAAgB;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;IACrE,CAAC;CACD","sourcesContent":["/**\n * Runtime-only selector suppression. A SelectorCooldowns instance belongs to one\n * AgentSession and is deliberately never persisted to settings or session files.\n * Callers provide canonical base selectors without a thinking suffix.\n */\nexport class SelectorCooldowns {\n\tprivate readonly expiresAtBySelector = new Map<string, number>();\n\tprivate readonly now: () => number;\n\tprivate readonly random: () => number;\n\n\tconstructor(now: () => number, random: () => number = Math.random) {\n\t\tthis.now = now;\n\t\tthis.random = random;\n\t}\n\n\tnote(baseSelector: string, failure: { retryAfterMs?: number; errorMessage?: string }): void {\n\t\tthis.expiresAtBySelector.set(baseSelector, this.now() + this.durationFor(failure));\n\t}\n\n\tisSuppressed(baseSelector: string): boolean {\n\t\tconst expiresAt = this.expiresAtBySelector.get(baseSelector);\n\t\tif (expiresAt === undefined) return false;\n\t\tif (this.now() < expiresAt) return true;\n\t\tthis.expiresAtBySelector.delete(baseSelector);\n\t\treturn false;\n\t}\n\n\tclear(baseSelector: string): void {\n\t\tthis.expiresAtBySelector.delete(baseSelector);\n\t}\n\n\tclearAll(): void {\n\t\tthis.expiresAtBySelector.clear();\n\t}\n\n\tprivate durationFor({ retryAfterMs, errorMessage }: { retryAfterMs?: number; errorMessage?: string }): number {\n\t\tif (retryAfterMs !== undefined && Number.isFinite(retryAfterMs) && retryAfterMs > 0) {\n\t\t\treturn retryAfterMs;\n\t\t}\n\n\t\tconst message = errorMessage?.toLowerCase() ?? \"\";\n\t\tif (/usage[- ]limit|quota|insufficient_quota|billing/.test(message)) return 30 * 60_000;\n\t\tif (/rate[ -]?limit|429|too many requests/.test(message)) return 30_000;\n\t\tif (/overloaded|capacity/.test(message)) return 45_000 + this.capacityJitterMs();\n\t\tif (/5xx|\\b5\\d\\d\\b|server|internal error/.test(message)) return 20_000;\n\t\treturn 5 * 60_000;\n\t}\n\n\tprivate capacityJitterMs(): number {\n\t\treturn Math.round(Math.min(1, Math.max(0, this.random())) * 30_000);\n\t}\n}\n"]}

package/dist/core/retry-fallback/log.d.ts

@@ -1,10 +0,0 @@
-export interface FallbackLogger {
-    debug(event: string, data?: Record<string, unknown>): void;
-    info(event: string, data?: Record<string, unknown>): void;
-    warn(event: string, data?: Record<string, unknown>): void;
-}
-export interface FallbackLoggerOptions {
-    maxBytes?: number;
-}
-export declare function createFallbackLogger(agentDir: string, options?: FallbackLoggerOptions): FallbackLogger;
-//# sourceMappingURL=log.d.ts.map

package/dist/core/retry-fallback/log.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../src/core/retry-fallback/log.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,cAAc;IAC9B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC3D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,cAAc,CAsB1G"}

package/dist/core/retry-fallback/log.js

@@ -1,128 +0,0 @@
-import { chmodSync, closeSync, mkdirSync, openSync, renameSync, rmSync, statSync, writeSync } from "node:fs";
-import { dirname, join } from "node:path";
-const DEFAULT_MAX_BYTES = 5 * 1024 * 1024;
-const MAX_STRING_LENGTH = 200;
-const BLOCKED_KEY = /^(?:__proto__|constructor|prototype|headers?|env(?:ironment)?|authorization|credential(?:s)?|password|secret|token|api_?key|client_?secret)$/i;
-const ALLOWED_DATA_KEY = /^(?:selector|candidate|currentSelector|originalSelector|from|to|model|chainKey|reason|skipReason|classification|thinkingLevel|durationMs|retryAfterMs|error|errorMessage|warning)$/;
-const SENSITIVE_TEXT = /((?:authorization\s*[:=]\s*(?:bearer|basic)\s+)|(?:bearer\s+)|(?:[?&](?:api[_-]?key|token|secret|password|auth(?:orization)?)=))[^\s&,"'}\]]+/gi;
-export function createFallbackLogger(agentDir, options = {}) {
-    const filePath = join(agentDir, "logs", "fallback.log");
-    const maxBytes = validMaxBytes(options.maxBytes);
-    let reportedWriteFailure = false;
-    function log(level, event, data) {
-        try {
-            const line = formatLine(level, event, data);
-            writeLine(filePath, line, maxBytes);
-        }
-        catch (error) {
-            if (!reportedWriteFailure) {
-                reportedWriteFailure = true;
-                console.error("Unable to write retry fallback debug log", error);
-            }
-        }
-    }
-    return {
-        debug: (event, data) => log("debug", event, data),
-        info: (event, data) => log("info", event, data),
-        warn: (event, data) => log("warn", event, data),
-    };
-}
-function validMaxBytes(value) {
-    return typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.floor(value) : DEFAULT_MAX_BYTES;
-}
-function formatLine(level, event, data) {
-    const entry = {
-        ts: new Date().toISOString(),
-        level,
-        event: safeText(event),
-    };
-    if (data !== undefined) {
-        for (const [key, value] of safeEntries(data)) {
-            if (ALLOWED_DATA_KEY.test(key) && !BLOCKED_KEY.test(key)) {
-                const safeValue = serializeValue(value, new WeakSet());
-                if (safeValue !== undefined)
-                    entry[key] = safeValue;
-            }
-        }
-    }
-    return JSON.stringify(entry);
-}
-function writeLine(filePath, line, maxBytes) {
-    mkdirSync(dirname(filePath), { recursive: true, mode: 0o700 });
-    const text = `${line}\n`;
-    if (fileExceedsCap(filePath, Buffer.byteLength(text), maxBytes)) {
-        rmSync(`${filePath}.1`, { force: true });
-        renameSync(filePath, `${filePath}.1`);
-        chmodSync(`${filePath}.1`, 0o600);
-    }
-    const descriptor = openSync(filePath, "a", 0o600);
-    try {
-        writeSync(descriptor, text);
-    }
-    finally {
-        closeSync(descriptor);
-    }
-    chmodSync(filePath, 0o600);
-}
-function fileExceedsCap(filePath, incomingBytes, maxBytes) {
-    try {
-        return statSync(filePath).size + incomingBytes > maxBytes;
-    }
-    catch (error) {
-        if (isMissingFileError(error))
-            return false;
-        throw error;
-    }
-}
-function isMissingFileError(error) {
-    return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
-}
-function serializeValue(value, seen) {
-    if (typeof value === "string")
-        return safeText(value);
-    if (typeof value === "bigint")
-        return value.toString();
-    if (typeof value === "number" || typeof value === "boolean" || value === null)
-        return value;
-    if (typeof value === "undefined")
-        return undefined;
-    if (typeof value === "function" || typeof value === "symbol")
-        return String(value);
-    if (seen.has(value))
-        return "[Circular]";
-    seen.add(value);
-    if (Array.isArray(value))
-        return value.map((item) => serializeValue(item, seen) ?? null);
-    const result = {};
-    for (const [key, item] of safeEntries(value)) {
-        if (!BLOCKED_KEY.test(key)) {
-            const safeValue = serializeValue(item, seen);
-            if (safeValue !== undefined)
-                result[key] = safeValue;
-        }
-    }
-    return result;
-}
-function safeEntries(value) {
-    try {
-        const entries = [];
-        for (const key of Object.keys(value)) {
-            try {
-                const item = Reflect.get(value, key);
-                entries.push([key, item]);
-            }
-            catch {
-                entries.push([key, "[Unreadable]"]);
-            }
-        }
-        return entries;
-    }
-    catch {
-        return [["unserializable", "[Unreadable]"]];
-    }
-}
-function safeText(value) {
-    const redacted = value.replace(SENSITIVE_TEXT, "$1[redacted]");
-    return redacted.length <= MAX_STRING_LENGTH ? redacted : `${redacted.slice(0, MAX_STRING_LENGTH - 3)}...`;
-}
-//# sourceMappingURL=log.js.map

package/dist/core/retry-fallback/log.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"log.js","sourceRoot":"","sources":["../../../src/core/retry-fallback/log.ts"],"names":[],"mappings":"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","sourcesContent":["import { chmodSync, closeSync, mkdirSync, openSync, renameSync, rmSync, statSync, writeSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\n\nconst DEFAULT_MAX_BYTES = 5 * 1024 * 1024;\nconst MAX_STRING_LENGTH = 200;\nconst BLOCKED_KEY =\n\t/^(?:__proto__|constructor|prototype|headers?|env(?:ironment)?|authorization|credential(?:s)?|password|secret|token|api_?key|client_?secret)$/i;\nconst ALLOWED_DATA_KEY =\n\t/^(?:selector|candidate|currentSelector|originalSelector|from|to|model|chainKey|reason|skipReason|classification|thinkingLevel|durationMs|retryAfterMs|error|errorMessage|warning)$/;\nconst SENSITIVE_TEXT =\n\t/((?:authorization\\s*[:=]\\s*(?:bearer|basic)\\s+)|(?:bearer\\s+)|(?:[?&](?:api[_-]?key|token|secret|password|auth(?:orization)?)=))[^\\s&,\"'}\\]]+/gi;\n\nexport interface FallbackLogger {\n\tdebug(event: string, data?: Record<string, unknown>): void;\n\tinfo(event: string, data?: Record<string, unknown>): void;\n\twarn(event: string, data?: Record<string, unknown>): void;\n}\n\nexport interface FallbackLoggerOptions {\n\tmaxBytes?: number;\n}\n\nexport function createFallbackLogger(agentDir: string, options: FallbackLoggerOptions = {}): FallbackLogger {\n\tconst filePath = join(agentDir, \"logs\", \"fallback.log\");\n\tconst maxBytes = validMaxBytes(options.maxBytes);\n\tlet reportedWriteFailure = false;\n\n\tfunction log(level: \"debug\" | \"info\" | \"warn\", event: string, data?: Record<string, unknown>): void {\n\t\ttry {\n\t\t\tconst line = formatLine(level, event, data);\n\t\t\twriteLine(filePath, line, maxBytes);\n\t\t} catch (error) {\n\t\t\tif (!reportedWriteFailure) {\n\t\t\t\treportedWriteFailure = true;\n\t\t\t\tconsole.error(\"Unable to write retry fallback debug log\", error);\n\t\t\t}\n\t\t}\n\t}\n\n\treturn {\n\t\tdebug: (event, data) => log(\"debug\", event, data),\n\t\tinfo: (event, data) => log(\"info\", event, data),\n\t\twarn: (event, data) => log(\"warn\", event, data),\n\t};\n}\n\nfunction validMaxBytes(value: number | undefined): number {\n\treturn typeof value === \"number\" && Number.isFinite(value) && value > 0 ? Math.floor(value) : DEFAULT_MAX_BYTES;\n}\n\nfunction formatLine(\n\tlevel: \"debug\" | \"info\" | \"warn\",\n\tevent: string,\n\tdata: Record<string, unknown> | undefined,\n): string {\n\tconst entry: Record<string, unknown> = {\n\t\tts: new Date().toISOString(),\n\t\tlevel,\n\t\tevent: safeText(event),\n\t};\n\tif (data !== undefined) {\n\t\tfor (const [key, value] of safeEntries(data)) {\n\t\t\tif (ALLOWED_DATA_KEY.test(key) && !BLOCKED_KEY.test(key)) {\n\t\t\t\tconst safeValue = serializeValue(value, new WeakSet<object>());\n\t\t\t\tif (safeValue !== undefined) entry[key] = safeValue;\n\t\t\t}\n\t\t}\n\t}\n\treturn JSON.stringify(entry);\n}\n\nfunction writeLine(filePath: string, line: string, maxBytes: number): void {\n\tmkdirSync(dirname(filePath), { recursive: true, mode: 0o700 });\n\tconst text = `${line}\\n`;\n\tif (fileExceedsCap(filePath, Buffer.byteLength(text), maxBytes)) {\n\t\trmSync(`${filePath}.1`, { force: true });\n\t\trenameSync(filePath, `${filePath}.1`);\n\t\tchmodSync(`${filePath}.1`, 0o600);\n\t}\n\tconst descriptor = openSync(filePath, \"a\", 0o600);\n\ttry {\n\t\twriteSync(descriptor, text);\n\t} finally {\n\t\tcloseSync(descriptor);\n\t}\n\tchmodSync(filePath, 0o600);\n}\n\nfunction fileExceedsCap(filePath: string, incomingBytes: number, maxBytes: number): boolean {\n\ttry {\n\t\treturn statSync(filePath).size + incomingBytes > maxBytes;\n\t} catch (error) {\n\t\tif (isMissingFileError(error)) return false;\n\t\tthrow error;\n\t}\n}\n\nfunction isMissingFileError(error: unknown): boolean {\n\treturn typeof error === \"object\" && error !== null && \"code\" in error && error.code === \"ENOENT\";\n}\n\nfunction serializeValue(value: unknown, seen: WeakSet<object>): unknown {\n\tif (typeof value === \"string\") return safeText(value);\n\tif (typeof value === \"bigint\") return value.toString();\n\tif (typeof value === \"number\" || typeof value === \"boolean\" || value === null) return value;\n\tif (typeof value === \"undefined\") return undefined;\n\tif (typeof value === \"function\" || typeof value === \"symbol\") return String(value);\n\tif (seen.has(value)) return \"[Circular]\";\n\tseen.add(value);\n\tif (Array.isArray(value)) return value.map((item) => serializeValue(item, seen) ?? null);\n\tconst result: Record<string, unknown> = {};\n\tfor (const [key, item] of safeEntries(value)) {\n\t\tif (!BLOCKED_KEY.test(key)) {\n\t\t\tconst safeValue = serializeValue(item, seen);\n\t\t\tif (safeValue !== undefined) result[key] = safeValue;\n\t\t}\n\t}\n\treturn result;\n}\n\nfunction safeEntries(value: object): Array<[string, unknown]> {\n\ttry {\n\t\tconst entries: Array<[string, unknown]> = [];\n\t\tfor (const key of Object.keys(value)) {\n\t\t\ttry {\n\t\t\t\tconst item: unknown = Reflect.get(value, key);\n\t\t\t\tentries.push([key, item]);\n\t\t\t} catch {\n\t\t\t\tentries.push([key, \"[Unreadable]\"]);\n\t\t\t}\n\t\t}\n\t\treturn entries;\n\t} catch {\n\t\treturn [[\"unserializable\", \"[Unreadable]\"]];\n\t}\n}\n\nfunction safeText(value: string): string {\n\tconst redacted = value.replace(SENSITIVE_TEXT, \"$1[redacted]\");\n\treturn redacted.length <= MAX_STRING_LENGTH ? redacted : `${redacted.slice(0, MAX_STRING_LENGTH - 3)}...`;\n}\n"]}

package/dist/core/retry-fallback/validate.d.ts

@@ -1,8 +0,0 @@
-import type { Api, Model } from "@earendil-works/pi-ai";
-export interface FallbackModelRegistry {
-    find(provider: string, id: string): Model<Api> | undefined;
-    getAll(): Model<Api>[];
-}
-/** Returns configuration warnings without changing malformed fallback-chain settings. */
-export declare function validateFallbackChains(chains: unknown, registry: FallbackModelRegistry): string[];
-//# sourceMappingURL=validate.d.ts.map

package/dist/core/retry-fallback/validate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/core/retry-fallback/validate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAIxD,MAAM,WAAW,qBAAqB;IACrC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAC3D,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;CACvB;AA2BD,yFAAyF;AACzF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,qBAAqB,GAAG,MAAM,EAAE,CA+CjG"}

package/dist/core/retry-fallback/validate.js

@@ -1,63 +0,0 @@
-import { getSupportedThinkingLevels } from "../thinking-levels.js";
-import { baseSelector, parseFallbackSelector } from "./chains.js";
-function isPlainObject(value) {
-    if (value === null || typeof value !== "object" || Array.isArray(value))
-        return false;
-    const prototype = Object.getPrototypeOf(value);
-    return prototype === Object.prototype || prototype === null;
-}
-function invalidSelectorWarning(kind, selector, key) {
-    const subject = kind === "key" ? `Fallback chain key "${selector}"` : `Fallback chain entry "${selector}" for "${key}"`;
-    return `${subject} is not a valid or known model selector.`;
-}
-function validateThinkingLevel(selector, model, subject, warnings) {
-    if (selector.thinkingLevel && !getSupportedThinkingLevels(model).includes(selector.thinkingLevel)) {
-        warnings.push(`${subject} uses thinking level "${selector.thinkingLevel}", which is unsupported by ${selector.provider}/${selector.id}.`);
-    }
-}
-/** Returns configuration warnings without changing malformed fallback-chain settings. */
-export function validateFallbackChains(chains, registry) {
-    if (!isPlainObject(chains))
-        return ["Fallback chains must be a plain object."];
-    const warnings = [];
-    const models = registry.getAll();
-    for (const [key, entries] of Object.entries(chains)) {
-        const hasProvider = key.includes("/");
-        const hasWildcard = key.includes("*");
-        if (!hasProvider) {
-            warnings.push(`Fallback chain key "${key}" must use a provider/model selector; roles are unsupported.`);
-        }
-        if (hasWildcard)
-            warnings.push(`Fallback chain key "${key}" cannot contain wildcards.`);
-        const parsedKey = hasProvider && !hasWildcard ? parseFallbackSelector(key, models) : undefined;
-        const keyModel = parsedKey ? registry.find(parsedKey.provider, parsedKey.id) : undefined;
-        if (hasProvider && !hasWildcard && (!parsedKey || !keyModel)) {
-            warnings.push(invalidSelectorWarning("key", key));
-        }
-        if (parsedKey && keyModel) {
-            validateThinkingLevel(parsedKey, keyModel, `Fallback chain key "${key}"`, warnings);
-        }
-        if (!Array.isArray(entries) || entries.some((entry) => typeof entry !== "string")) {
-            warnings.push(`Fallback chain "${key}" entries must be an array of strings.`);
-            continue;
-        }
-        if (entries.length === 0) {
-            warnings.push(`Fallback chain "${key}" must contain at least one entry.`);
-            continue;
-        }
-        for (const entry of entries) {
-            const parsedEntry = parseFallbackSelector(entry, models);
-            const entryModel = parsedEntry ? registry.find(parsedEntry.provider, parsedEntry.id) : undefined;
-            if (!parsedEntry || !entryModel) {
-                warnings.push(invalidSelectorWarning("entry", entry, key));
-                continue;
-            }
-            if (parsedKey && baseSelector(parsedEntry) === baseSelector(parsedKey)) {
-                warnings.push(`Fallback chain entry "${entry}" for "${key}" cannot reference the same model.`);
-            }
-            validateThinkingLevel(parsedEntry, entryModel, `Fallback chain entry "${entry}"`, warnings);
-        }
-    }
-    return warnings;
-}
-//# sourceMappingURL=validate.js.map

package/dist/core/retry-fallback/validate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/core/retry-fallback/validate.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type { Api, Model } from \"@earendil-works/pi-ai\";\nimport { getSupportedThinkingLevels } from \"../thinking-levels.ts\";\nimport { baseSelector, parseFallbackSelector } from \"./chains.ts\";\n\nexport interface FallbackModelRegistry {\n\tfind(provider: string, id: string): Model<Api> | undefined;\n\tgetAll(): Model<Api>[];\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n\tif (value === null || typeof value !== \"object\" || Array.isArray(value)) return false;\n\tconst prototype = Object.getPrototypeOf(value);\n\treturn prototype === Object.prototype || prototype === null;\n}\n\nfunction invalidSelectorWarning(kind: \"key\" | \"entry\", selector: string, key?: string): string {\n\tconst subject =\n\t\tkind === \"key\" ? `Fallback chain key \"${selector}\"` : `Fallback chain entry \"${selector}\" for \"${key}\"`;\n\treturn `${subject} is not a valid or known model selector.`;\n}\n\nfunction validateThinkingLevel(\n\tselector: { thinkingLevel?: ThinkingLevel; provider: string; id: string },\n\tmodel: Model<Api>,\n\tsubject: string,\n\twarnings: string[],\n): void {\n\tif (selector.thinkingLevel && !getSupportedThinkingLevels(model).includes(selector.thinkingLevel)) {\n\t\twarnings.push(\n\t\t\t`${subject} uses thinking level \"${selector.thinkingLevel}\", which is unsupported by ${selector.provider}/${selector.id}.`,\n\t\t);\n\t}\n}\n\n/** Returns configuration warnings without changing malformed fallback-chain settings. */\nexport function validateFallbackChains(chains: unknown, registry: FallbackModelRegistry): string[] {\n\tif (!isPlainObject(chains)) return [\"Fallback chains must be a plain object.\"];\n\n\tconst warnings: string[] = [];\n\tconst models = registry.getAll();\n\n\tfor (const [key, entries] of Object.entries(chains)) {\n\t\tconst hasProvider = key.includes(\"/\");\n\t\tconst hasWildcard = key.includes(\"*\");\n\t\tif (!hasProvider) {\n\t\t\twarnings.push(`Fallback chain key \"${key}\" must use a provider/model selector; roles are unsupported.`);\n\t\t}\n\t\tif (hasWildcard) warnings.push(`Fallback chain key \"${key}\" cannot contain wildcards.`);\n\n\t\tconst parsedKey = hasProvider && !hasWildcard ? parseFallbackSelector(key, models) : undefined;\n\t\tconst keyModel = parsedKey ? registry.find(parsedKey.provider, parsedKey.id) : undefined;\n\t\tif (hasProvider && !hasWildcard && (!parsedKey || !keyModel)) {\n\t\t\twarnings.push(invalidSelectorWarning(\"key\", key));\n\t\t}\n\t\tif (parsedKey && keyModel) {\n\t\t\tvalidateThinkingLevel(parsedKey, keyModel, `Fallback chain key \"${key}\"`, warnings);\n\t\t}\n\n\t\tif (!Array.isArray(entries) || entries.some((entry) => typeof entry !== \"string\")) {\n\t\t\twarnings.push(`Fallback chain \"${key}\" entries must be an array of strings.`);\n\t\t\tcontinue;\n\t\t}\n\t\tif (entries.length === 0) {\n\t\t\twarnings.push(`Fallback chain \"${key}\" must contain at least one entry.`);\n\t\t\tcontinue;\n\t\t}\n\n\t\tfor (const entry of entries) {\n\t\t\tconst parsedEntry = parseFallbackSelector(entry, models);\n\t\t\tconst entryModel = parsedEntry ? registry.find(parsedEntry.provider, parsedEntry.id) : undefined;\n\t\t\tif (!parsedEntry || !entryModel) {\n\t\t\t\twarnings.push(invalidSelectorWarning(\"entry\", entry, key));\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (parsedKey && baseSelector(parsedEntry) === baseSelector(parsedKey)) {\n\t\t\t\twarnings.push(`Fallback chain entry \"${entry}\" for \"${key}\" cannot reference the same model.`);\n\t\t\t}\n\t\t\tvalidateThinkingLevel(parsedEntry, entryModel, `Fallback chain entry \"${entry}\"`, warnings);\n\t\t}\n\t}\n\n\treturn warnings;\n}\n"]}

package/node_modules/@earendil-works/pi-ai/dist/utils/stop-details.d.ts

@@ -1,4 +0,0 @@
-import type { AssistantMessage } from "../types.ts";
-/** Returns true when an assistant error was classified as a refusal or sensitive stop. */
-export declare function isClassifierRefusal(message: AssistantMessage): boolean;
-//# sourceMappingURL=stop-details.d.ts.map

package/node_modules/@earendil-works/pi-ai/dist/utils/stop-details.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stop-details.d.ts","sourceRoot":"","sources":["../../src/utils/stop-details.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,0FAA0F;AAC1F,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAKtE"}

package/node_modules/@earendil-works/pi-ai/dist/utils/stop-details.js

@@ -1,6 +0,0 @@
-/** Returns true when an assistant error was classified as a refusal or sensitive stop. */
-export function isClassifierRefusal(message) {
-    return (message.stopReason === "error" &&
-        (message.stopDetails?.type === "refusal" || message.stopDetails?.type === "sensitive"));
-}
-//# sourceMappingURL=stop-details.js.map

package/node_modules/@earendil-works/pi-ai/dist/utils/stop-details.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stop-details.js","sourceRoot":"","sources":["../../src/utils/stop-details.ts"],"names":[],"mappings":"AAEA,0FAA0F;AAC1F,MAAM,UAAU,mBAAmB,CAAC,OAAyB;IAC5D,OAAO,CACN,OAAO,CAAC,UAAU,KAAK,OAAO;QAC9B,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,IAAI,KAAK,WAAW,CAAC,CACtF,CAAC;AACH,CAAC","sourcesContent":["import type { AssistantMessage } from \"../types.ts\";\n\n/** Returns true when an assistant error was classified as a refusal or sensitive stop. */\nexport function isClassifierRefusal(message: AssistantMessage): boolean {\n\treturn (\n\t\tmessage.stopReason === \"error\" &&\n\t\t(message.stopDetails?.type === \"refusal\" || message.stopDetails?.type === \"sensitive\")\n\t);\n}\n"]}