@season179/pi-model-fallback 26.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Season Saw
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,53 @@
+# @season179/pi-model-fallback
+
+Automatic model failover for Pi. When the selected model fails with a persistent provider error (rate limit, overload, 5xx, network), Pi switches to the next model in a user-defined fallback chain and resumes work automatically.
+
+Main model settings (`settings.json`) are configured nowhere in this extension — the fallback chain lives in its own config file.
+
+## What It Does
+
+- Triggers only after Pi's built-in same-model retries are exhausted.
+- Classifies errors by HTTP status first, error-message patterns as backstop.
+- Falls back on rate limit (429), overload (529), 5xx, and network errors.
+- Never falls back on user aborts, context-overflow, or 4xx request errors (those fail identically on every model).
+- Auth errors (401/403) do not trigger fallback unless explicitly enabled.
+- Resumes the interrupted run automatically via a "continue" message.
+- Restores your original model on the next interactive message after a cooldown (default 10 minutes), so an ongoing outage doesn't cause churn.
+- A manual model switch (`/model`, Ctrl+P) cancels the pending restore — your choice wins.
+- Persists fallback state in the session: resuming a session left on a fallback model restores the original immediately.
+
+## Installation
+
+```bash
+pi install npm:@season179/pi-model-fallback
+```
+
+## Configuration
+
+Create `~/.pi/agent/fallback-models.json` (global) or `.pi/fallback-models.json` (project-local, wins if present). It contains **only** the fallback chain:
+
+```json
+{
+  "fallbacks": [
+    { "provider": "openai-codex", "model": "gpt-5.6-sol" },
+    { "provider": "google", "model": "gemini-3-pro" }
+  ],
+  "restoreCooldownMinutes": 10,
+  "fallbackOnAuthErrors": false
+}
+```
+
+- `fallbacks` — ordered chain; entries without a configured API key are skipped.
+- `restoreCooldownMinutes` — how long after the last failure before the original model is restored on your next message (default `10`).
+- `fallbackOnAuthErrors` — set `true` to also fall back on 401/403. Off by default because it can silently shift spend to a metered key and mask an expired credential.
+
+The config is re-read on every trigger, so edits apply without reloading Pi.
+
+## Usage
+
+- `/fallback` — show the chain, current model, and whether a fallback is active.
+- `/fallback restore` — force-switch back to the original model before the cooldown expires.
+
+## Known Pi-Core Limitation
+
+Pi persists *every* model switch (including this extension's) as the new global default in `~/.pi/agent/settings.json`; there is no session-only `setModel` in the extension API. The restore path writes the original defaults back, and resumed sessions repair them at startup. But while a fallback is active — or after a crash mid-fallback, until that session is resumed — new Pi sessions elsewhere will start on the fallback model.

package/dist/extensions/model-fallback.d.ts

@@ -0,0 +1,43 @@
+/**
+ * model-fallback — automatic model failover for pi.
+ *
+ * When an agent run fails with a persistent provider error (rate limit,
+ * overload, 5xx, network), this extension switches to the next model in a
+ * user-defined fallback chain and resumes work automatically. The main model
+ * settings (settings.json) are never touched.
+ *
+ * Config (fallback models ONLY), first found wins:
+ *   - <project>/.pi/fallback-models.json   (project-local)
+ *   - ~/.pi/agent/fallback-models.json     (global)
+ *
+ * {
+ *   "fallbacks": [
+ *     { "provider": "openai", "model": "gpt-5.2" },
+ *     { "provider": "google", "model": "gemini-3-pro" }
+ *   ],
+ *   "restoreCooldownMinutes": 10,
+ *   "fallbackOnAuthErrors": false
+ * }
+ *
+ * Behavior:
+ *   - Triggers only after pi's built-in same-model retries are exhausted.
+ *   - Never triggers on user aborts, context-overflow, or 4xx request errors.
+ *   - Auth errors (401/403) trigger only when fallbackOnAuthErrors is true.
+ *   - Restores the original model on the next interactive message, once the
+ *     last failure is older than restoreCooldownMinutes (avoids churn during
+ *     an ongoing outage). `/fallback restore` forces it immediately.
+ *   - A manual model switch (/model, Ctrl+P) cancels the pending restore.
+ *   - The original model is persisted in the session, so resuming a session
+ *     that was left on a fallback model triggers an immediate restore attempt.
+ *
+ * KNOWN PI-CORE LIMITATION: pi persists *every* model switch (including this
+ * extension's) as the new global default in ~/.pi/agent/settings.json — there
+ * is no session-only setModel in the extension API. The restore path writes
+ * the original defaults back, and resumed sessions repair them at startup,
+ * but while a fallback is active (or after a crash mid-fallback until the
+ * session is resumed), new pi sessions elsewhere will start on the fallback
+ * model.
+ */
+import { type ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export default function (pi: ExtensionAPI): void;
+//# sourceMappingURL=model-fallback.d.ts.map

package/dist/extensions/model-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-fallback.d.ts","sourceRoot":"","sources":["../../src/extensions/model-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,EAAmB,KAAK,YAAY,EAAyB,MAAM,iCAAiC,CAAC;AAqB5G,MAAM,CAAC,OAAO,WAAW,EAAE,EAAE,YAAY,QAwTxC"}

package/dist/extensions/model-fallback.js

@@ -0,0 +1,333 @@
+/**
+ * model-fallback — automatic model failover for pi.
+ *
+ * When an agent run fails with a persistent provider error (rate limit,
+ * overload, 5xx, network), this extension switches to the next model in a
+ * user-defined fallback chain and resumes work automatically. The main model
+ * settings (settings.json) are never touched.
+ *
+ * Config (fallback models ONLY), first found wins:
+ *   - <project>/.pi/fallback-models.json   (project-local)
+ *   - ~/.pi/agent/fallback-models.json     (global)
+ *
+ * {
+ *   "fallbacks": [
+ *     { "provider": "openai", "model": "gpt-5.2" },
+ *     { "provider": "google", "model": "gemini-3-pro" }
+ *   ],
+ *   "restoreCooldownMinutes": 10,
+ *   "fallbackOnAuthErrors": false
+ * }
+ *
+ * Behavior:
+ *   - Triggers only after pi's built-in same-model retries are exhausted.
+ *   - Never triggers on user aborts, context-overflow, or 4xx request errors.
+ *   - Auth errors (401/403) trigger only when fallbackOnAuthErrors is true.
+ *   - Restores the original model on the next interactive message, once the
+ *     last failure is older than restoreCooldownMinutes (avoids churn during
+ *     an ongoing outage). `/fallback restore` forces it immediately.
+ *   - A manual model switch (/model, Ctrl+P) cancels the pending restore.
+ *   - The original model is persisted in the session, so resuming a session
+ *     that was left on a fallback model triggers an immediate restore attempt.
+ *
+ * KNOWN PI-CORE LIMITATION: pi persists *every* model switch (including this
+ * extension's) as the new global default in ~/.pi/agent/settings.json — there
+ * is no session-only setModel in the extension API. The restore path writes
+ * the original defaults back, and resumed sessions repair them at startup,
+ * but while a fallback is active (or after a crash mid-fallback until the
+ * session is resumed), new pi sessions elsewhere will start on the fallback
+ * model.
+ */
+import { CONFIG_DIR_NAME } from "@earendil-works/pi-coding-agent";
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const STATE_ENTRY = "model-fallback-state";
+const DEFAULT_COOLDOWN_MINUTES = 10;
+export default function (pi) {
+    // ---- state -------------------------------------------------------------
+    let originalModel; // set on first incident
+    let chainIndex = 0; // next fallback to try
+    let lastFailureAt = 0; // epoch ms of last classified failure
+    let internalSwitch = false; // guards our own setModel calls
+    let restoreFailureWarned = false; // warn only once when auto-restore can't switch back
+    let lastHttpStatus; // from after_provider_response
+    let stashedStopReason; // from agent_end
+    let stashedErrorMessage;
+    // ---- config ------------------------------------------------------------
+    function loadConfig(cwd) {
+        const candidates = [
+            join(cwd, CONFIG_DIR_NAME, "fallback-models.json"),
+            join(homedir(), ".pi", "agent", "fallback-models.json"),
+        ];
+        for (const path of candidates) {
+            if (!existsSync(path))
+                continue;
+            try {
+                const raw = JSON.parse(readFileSync(path, "utf8"));
+                const fallbacks = Array.isArray(raw.fallbacks)
+                    ? raw.fallbacks.filter((f) => !!f &&
+                        typeof f.provider === "string" &&
+                        typeof f.model === "string")
+                    : [];
+                return {
+                    fallbacks,
+                    restoreCooldownMinutes: typeof raw.restoreCooldownMinutes === "number"
+                        ? raw.restoreCooldownMinutes
+                        : DEFAULT_COOLDOWN_MINUTES,
+                    fallbackOnAuthErrors: raw.fallbackOnAuthErrors === true,
+                };
+            }
+            catch (err) {
+                notifySafe(`model-fallback: invalid config at ${path}: ${String(err)}`, "error");
+                return undefined;
+            }
+        }
+        return undefined;
+    }
+    // ---- helpers -----------------------------------------------------------
+    let notifySafe = () => { };
+    function modelKey(m) {
+        return `${m.provider}/${m.model}`;
+    }
+    function persistState(active) {
+        pi.appendEntry(STATE_ENTRY, { active, originalModel: originalModel ?? null });
+    }
+    function classify(errorMessage, status, cfg) {
+        const msg = (errorMessage ?? "").toLowerCase();
+        // Context overflow: never fall back — that's compaction's job, and a
+        // smaller-context fallback would only make it worse.
+        const overflowPatterns = [
+            "context length",
+            "context_length",
+            "maximum context",
+            "prompt is too long",
+            "too many tokens",
+            "exceeds the context",
+            "input is too long",
+        ];
+        if (overflowPatterns.some((p) => msg.includes(p)))
+            return "skip";
+        // Prefer numeric status; errorMessage often embeds it as a prefix ("529 {...}").
+        let code = status;
+        if (code === undefined) {
+            const m = /^\s*(\d{3})\b/.exec(errorMessage ?? "");
+            if (m)
+                code = Number(m[1]);
+        }
+        if (code !== undefined) {
+            if (code === 401 || code === 403)
+                return cfg.fallbackOnAuthErrors ? "fallback" : "auth";
+            if (code === 429 || code >= 500)
+                return "fallback";
+            if (code >= 400 && code < 500)
+                return "skip"; // bad request: same failure on every model
+        }
+        // No status: check for network-level failures.
+        const networkPatterns = [
+            "econnreset",
+            "econnrefused",
+            "etimedout",
+            "enotfound",
+            "eai_again",
+            "fetch failed",
+            "network",
+            "socket hang up",
+            "terminated",
+            "overloaded",
+            "rate limit",
+            "rate_limit",
+        ];
+        if (networkPatterns.some((p) => msg.includes(p)))
+            return "fallback";
+        return "unknown";
+    }
+    async function switchTo(ref, ctx) {
+        const model = ctx.modelRegistry.find(ref.provider, ref.model);
+        if (!model)
+            return false;
+        internalSwitch = true;
+        try {
+            return await pi.setModel(model);
+        }
+        finally {
+            internalSwitch = false;
+        }
+    }
+    // ---- wiring ------------------------------------------------------------
+    pi.on("session_start", async (_event, ctx) => {
+        notifySafe = (msg, level = "info") => {
+            if (ctx.hasUI)
+                ctx.ui.notify(msg, level);
+            else
+                console.error(`[model-fallback] ${msg}`);
+        };
+        // Re-arm restore if this session was left on a fallback model.
+        let persisted;
+        for (const entry of ctx.sessionManager.getEntries()) {
+            if (entry.type === "custom" && entry.customType === STATE_ENTRY) {
+                persisted = entry.data;
+            }
+        }
+        if (persisted?.active && persisted.originalModel) {
+            originalModel = persisted.originalModel;
+            lastFailureAt = 0; // outage was in a previous session
+            // Restore immediately: this also repairs the global default model that
+            // pi persisted when the fallback switch happened.
+            const target = originalModel;
+            if (await switchTo(target, ctx)) {
+                notifySafe(`model-fallback: restored original model ${modelKey(target)} from previous session.`, "info");
+                originalModel = undefined;
+                chainIndex = 0;
+                persistState(false);
+            }
+            else {
+                notifySafe(`model-fallback: session was left on a fallback model and ${modelKey(target)} is unavailable; will retry on your next message (or /fallback restore).`, "warning");
+            }
+        }
+    });
+    // Primary classification signal: HTTP status of the most recent provider response.
+    pi.on("after_provider_response", (event, _ctx) => {
+        lastHttpStatus = event.status;
+    });
+    pi.on("agent_start", async () => {
+        lastHttpStatus = undefined;
+    });
+    // Stash error details here; pi may still auto-retry/compact after agent_end.
+    pi.on("agent_end", async (event) => {
+        stashedStopReason = undefined;
+        stashedErrorMessage = undefined;
+        for (let i = event.messages.length - 1; i >= 0; i--) {
+            const m = event.messages[i];
+            if (m.role === "assistant") {
+                stashedStopReason = m.stopReason;
+                stashedErrorMessage = m.errorMessage;
+                break;
+            }
+        }
+    });
+    // Act only when pi has truly given up (retries and compaction exhausted).
+    pi.on("agent_settled", async (_event, ctx) => {
+        if (stashedStopReason !== "error") {
+            chainIndex = 0; // healthy (or aborted) run: reset chain position
+            return;
+        }
+        const cfg = loadConfig(ctx.cwd);
+        if (!cfg || cfg.fallbacks.length === 0)
+            return;
+        const cls = classify(stashedErrorMessage, lastHttpStatus, cfg);
+        if (cls === "skip")
+            return;
+        if (cls === "auth") {
+            notifySafe("model-fallback: auth error (401/403) — not falling back. Fix credentials, or set \"fallbackOnAuthErrors\": true in fallback-models.json.", "error");
+            return;
+        }
+        if (cls === "unknown") {
+            notifySafe(`model-fallback: unrecognized error, not falling back: ${stashedErrorMessage ?? "(no message)"}`, "warning");
+            return;
+        }
+        lastFailureAt = Date.now();
+        // Remember the model we're abandoning (first incident only).
+        if (!originalModel && ctx.model) {
+            originalModel = { provider: ctx.model.provider, model: ctx.model.id };
+        }
+        // Walk the chain from the current position. If a previous incident
+        // exhausted the chain, start over — the user may have fixed a key or the
+        // outage may have ended for an earlier entry.
+        if (chainIndex >= cfg.fallbacks.length)
+            chainIndex = 0;
+        while (chainIndex < cfg.fallbacks.length) {
+            const candidate = cfg.fallbacks[chainIndex];
+            chainIndex++;
+            if (originalModel && modelKey(candidate) === modelKey(originalModel))
+                continue;
+            if (ctx.model && modelKey(candidate) === `${ctx.model.provider}/${ctx.model.id}`)
+                continue;
+            if (await switchTo(candidate, ctx)) {
+                persistState(true);
+                notifySafe(`model-fallback: ${stashedErrorMessage?.slice(0, 120) ?? "provider error"} — switched to ${modelKey(candidate)}, resuming.`, "warning");
+                pi.sendUserMessage("continue");
+                return;
+            }
+            notifySafe(`model-fallback: ${modelKey(candidate)} unavailable (not found or no API key), skipping.`, "warning");
+        }
+        notifySafe("model-fallback: all fallback models exhausted. Stopping.", "error");
+    });
+    // Restore the original model on the next interactive input, after cooldown.
+    pi.on("input", async (event, ctx) => {
+        if (event.source !== "interactive")
+            return;
+        if (!originalModel)
+            return;
+        const cfg = loadConfig(ctx.cwd);
+        const cooldownMs = (cfg?.restoreCooldownMinutes ?? DEFAULT_COOLDOWN_MINUTES) * 60_000;
+        if (Date.now() - lastFailureAt < cooldownMs)
+            return; // likely still in the outage window
+        const target = originalModel;
+        if (await switchTo({ provider: target.provider, model: target.model }, ctx)) {
+            notifySafe(`model-fallback: restored original model ${modelKey(target)}.`, "info");
+            originalModel = undefined;
+            chainIndex = 0;
+            restoreFailureWarned = false;
+            persistState(false);
+        }
+        else if (!restoreFailureWarned) {
+            restoreFailureWarned = true;
+            notifySafe(`model-fallback: cannot restore ${modelKey(target)} (not found or no API key). Staying on fallback; fix credentials and use /fallback restore.`, "warning");
+        }
+    });
+    // A genuine manual model switch cancels the pending restore.
+    pi.on("model_select", async (event, _ctx) => {
+        if (internalSwitch)
+            return;
+        if (event.source === "restore")
+            return; // session restore, not a user decision
+        if (originalModel) {
+            notifySafe("model-fallback: manual model change — pending restore cancelled.", "info");
+            originalModel = undefined;
+            chainIndex = 0;
+            persistState(false);
+        }
+    });
+    // ---- command -----------------------------------------------------------
+    pi.registerCommand("fallback", {
+        description: "Show model-fallback status; '/fallback restore' switches back to the original model now",
+        handler: async (args, ctx) => {
+            const cfg = loadConfig(ctx.cwd);
+            if (args?.trim() === "restore") {
+                if (!originalModel) {
+                    notifySafe("model-fallback: nothing to restore.", "info");
+                    return;
+                }
+                const target = originalModel;
+                if (await switchTo(target, ctx)) {
+                    notifySafe(`model-fallback: restored original model ${modelKey(target)}.`, "info");
+                    originalModel = undefined;
+                    chainIndex = 0;
+                    restoreFailureWarned = false;
+                    persistState(false);
+                }
+                else {
+                    notifySafe(`model-fallback: could not restore ${modelKey(target)} (not found or no API key).`, "error");
+                }
+                return;
+            }
+            const lines = [];
+            if (!cfg) {
+                lines.push("No config found. Create ~/.pi/agent/fallback-models.json:");
+                lines.push('{ "fallbacks": [ { "provider": "openai", "model": "gpt-5.2" } ] }');
+            }
+            else {
+                lines.push(`Chain: ${cfg.fallbacks.map(modelKey).join(" -> ") || "(empty)"}`);
+                lines.push(`Cooldown: ${cfg.restoreCooldownMinutes}m | Auth-error fallback: ${cfg.fallbackOnAuthErrors ? "on" : "off"}`);
+            }
+            lines.push(originalModel
+                ? `ACTIVE: on fallback, original ${modelKey(originalModel)} pending restore (/fallback restore to force).`
+                : "Idle: running on your selected model.");
+            const current = ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : "unknown";
+            lines.push(`Current model: ${current}`);
+            notifySafe(lines.join("\n"), "info");
+        },
+    });
+}
+//# sourceMappingURL=model-fallback.js.map

package/dist/extensions/model-fallback.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@season179/pi-model-fallback",
+  "version": "26.7.0",
+  "description": "Automatic model failover for Pi, driven by a standalone fallback-models.json config.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Season Saw",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/season179/pi-ecosystem.git",
+    "directory": "packages/pi-model-fallback"
+  },
+  "keywords": [
+    "pi",
+    "pi-package",
+    "pi-extension",
+    "fallback",
+    "failover",
+    "model",
+    "agent"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "pi": {
+    "extensions": [
+      "./dist/extensions/model-fallback.js"
+    ]
+  },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "tsc -p tsconfig.json",
+    "prepack": "npm run clean && npm run build",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}