@smart-coders-hq/opencode-model-fallback 1.1.1 → 1.3.0

package/README.md

@@ -5,7 +5,7 @@ OpenCode plugin that adds automatic model fallback when your primary model hits
 ## How it works
 
 1. **Preemptive redirect** — intercepts outgoing messages via `chat.message` hook; if the target model is known to be rate-limited, redirects the message to a healthy fallback _before_ it hits the provider (no 429 round-trip)
-2. **Reactive fallback** — if a 429 still occurs (first hit, or preemptive not available), listens for `session.status: retry` events, aborts the retry loop, reverts the failed message, and replays it with the next healthy fallback model
+2. **Reactive fallback** — if a fallback-triggering error still occurs (first hit, or preemptive not available), listens for both `session.status: retry` and `session.error` (`APIError`) events, aborts the retry loop, reverts the failed message, and replays it with the next healthy fallback model
 3. Shows an inline toast notification and logs the event
 4. Tracks model health globally (rate limits are account-wide) — automatically recovers after configurable cooldown periods
 5. **Depth reset** — when the TUI reverts to the original model between messages, `fallbackDepth` resets so `maxFallbackDepth` only guards true cascading failures within a single message
@@ -176,6 +176,8 @@ With the `verbose` flag:
 
 Includes token/cost breakdown per model period.
 
+When enabled, the plugin auto-creates `~/.config/opencode/commands/fallback-status.md` at startup so the slash command is available without manual setup.
+
 ## Health state machine
 
 ```
@@ -187,7 +189,7 @@ cooldown ──[retryOriginalAfterMs elapsed]──→ healthy
 - **healthy** — model is usable; preferred for fallback selection
 - **rate_limited** — recently hit a limit; skipped when walking fallback chain
 - **cooldown** — cooling off; used as last resort if no healthy model is available
-- State transitions are checked every 30 seconds via a background timer
+- State transitions are checked every 30 seconds via a background timer (the timer is unref'ed so it does not keep the process alive)
 - When the original model recovers to healthy, a toast appears on the next `session.idle`
 
 ## Troubleshooting
@@ -195,6 +197,9 @@ cooldown ──[retryOriginalAfterMs elapsed]──→ healthy
 **Toast doesn't appear**
 The TUI notification requires an active OpenCode TUI session. Headless/API usage won't show toasts but logs are always written.
 
+**`/fallback-status` command is missing**
+The plugin writes `~/.config/opencode/commands/fallback-status.md` on startup. If the command does not appear, verify the directory is writable and check for `fallback-status.command.write.failed` in OpenCode logs.
+
 **"no fallback chain configured"**
 Your `model-fallback.json` has no `agents["*"].fallbackModels` (or no entry for the active agent). Add at least a wildcard entry with one model.
 
@@ -214,11 +219,14 @@ Key log events: `plugin.init`, `retry.detected`, `fallback.success`, `fallback.e
 
 To see the full event stream (including `event.received` and `retry.nomatch`), set `"logLevel": "debug"` in your config and restart OpenCode.
 
+For safety, free-form provider error text is redacted in plugin logs; use category/model/session fields for diagnosis.
+
 ## Release automation
 
 - Uses **Conventional Commits** + `semantic-release` for automated versioning/changelog/release notes
 - CI runs lint, tests, type check, and build on every push/PR via `.github/workflows/ci.yml`
-- Release workflow runs on `main` after successful CI via `.github/workflows/release.yml`
+- Trusted release gate runs on pushes to `main` via `.github/workflows/release-gate.yml`
+- Release workflow (`.github/workflows/release.yml`) runs on successful `Release Gate` completion (`workflow_run`), only for `push` events on `main`, and only when `head_sha` matches `github.sha`
 - Published as `@smart-coders-hq/opencode-model-fallback`
 - To publish to npm, set repository secret `NPM_TOKEN`
 
@@ -227,7 +235,7 @@ To see the full event stream (including `event.received` and `retry.nomatch`), s
 ```bash
 bun install
 bun run lint          # lint checks
-bun test              # 145 tests across 11 files
+bun test              # 163 tests across 16 files
 bunx tsc --noEmit     # type check
 bun run build         # build to dist/
 ```

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/plugin.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
+import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
 import { homedir as homedir5 } from "os";
 import { dirname as dirname2, join as join4 } from "path";
 
@@ -3262,8 +3262,8 @@ function classifyError(message, statusCode) {
 
 // src/display/notifier.ts
 async function notifyFallback(client, from, to, reason) {
-  const fromLabel = from ? shortModelName(from) : "current model";
-  const message = `Model fallback: switched from ${fromLabel} to ${shortModelName(to)} (${reason})`;
+  const fromLabel = from ? labelModel(from) : "current model";
+  const message = `Model fallback: switched from ${fromLabel} to ${labelModel(to)} (${reason})`;
   await client.tui.showToast({
     body: {
       title: "Model Fallback",
@@ -3274,7 +3274,7 @@ async function notifyFallback(client, from, to, reason) {
   }).catch(() => {});
 }
 async function notifyFallbackActive(client, originalModel, currentModel) {
-  const message = `Using ${shortModelName(currentModel)} (fallback from ${shortModelName(originalModel)})`;
+  const message = `Using ${labelModel(currentModel)} (fallback from ${labelModel(originalModel)})`;
   await client.tui.showToast({
     body: {
       title: "Fallback Active",
@@ -3285,7 +3285,7 @@ async function notifyFallbackActive(client, originalModel, currentModel) {
   }).catch(() => {});
 }
 async function notifyRecovery(client, originalModel) {
-  const message = `Original model ${shortModelName(originalModel)} is available again`;
+  const message = `Original model ${labelModel(originalModel)} is available again`;
   await client.tui.showToast({
     body: {
       title: "Model Recovered",
@@ -3295,13 +3295,17 @@ async function notifyRecovery(client, originalModel) {
     }
   }).catch(() => {});
 }
-function shortModelName(key) {
-  const parts = key.split("/");
-  return parts.length > 1 ? parts.slice(1).join("/") : key;
+function labelModel(key) {
+  const slash = key.indexOf("/");
+  if (slash === -1)
+    return key;
+  const provider = key.slice(0, slash);
+  const model = key.slice(slash + 1);
+  return `${model} [${provider}]`;
 }
 
 // src/logging/logger.ts
-import { appendFileSync, existsSync as existsSync3, mkdirSync, writeFileSync } from "fs";
+import { appendFileSync, mkdirSync, writeFileSync } from "fs";
 import { dirname } from "path";
 
 class Logger {
@@ -3310,6 +3314,7 @@ class Logger {
   enabled;
   minLevel;
   dirCreated = false;
+  fileErrorNotified = false;
   constructor(client, logPath, enabled, minLevel = "info") {
     this.client = client;
     this.logPath = logPath;
@@ -3317,18 +3322,19 @@ class Logger {
     this.minLevel = minLevel;
   }
   log(level, event, fields = {}) {
+    const sanitizedFields = sanitizeFields(fields);
     const entry = {
       ts: new Date().toISOString(),
       level,
       event,
-      ...fields
+      ...sanitizedFields
     };
     const shouldWrite = this.enabled && (this.minLevel === "debug" || level !== "debug");
     if (shouldWrite) {
       this.writeToFile(entry);
     }
     if (level !== "debug") {
-      const message = `[model-fallback] ${event}${Object.keys(fields).length ? " " + JSON.stringify(fields) : ""}`;
+      const message = `[model-fallback] ${event}${Object.keys(sanitizedFields).length ? " " + JSON.stringify(sanitizedFields) : ""}`;
       this.client.app.log({
         body: { service: "model-fallback", level, message }
       }).catch(() => {});
@@ -3352,13 +3358,65 @@ class Logger {
         mkdirSync(dirname(this.logPath), { recursive: true, mode: 448 });
         this.dirCreated = true;
       }
-      if (!existsSync3(this.logPath)) {
-        writeFileSync(this.logPath, "", { mode: 384 });
-      }
+      try {
+        writeFileSync(this.logPath, "", { mode: 384, flag: "ax" });
+      } catch {}
       appendFileSync(this.logPath, JSON.stringify(entry) + `
 `, "utf-8");
-    } catch {}
+    } catch (err) {
+      if (!this.fileErrorNotified) {
+        this.fileErrorNotified = true;
+        const message = `[model-fallback] logging.file.write.failed ${JSON.stringify({
+          logPath: this.logPath,
+          error: summarizeError(err)
+        })}`;
+        this.client.app.log({
+          body: { service: "model-fallback", level: "warn", message }
+        }).catch(() => {});
+      }
+    }
+  }
+}
+function sanitizeFields(fields) {
+  const out = {};
+  for (const [key, value] of Object.entries(fields)) {
+    out[key] = sanitizeValue(key, value);
+  }
+  return out;
+}
+function sanitizeValue(key, value) {
+  if (value === null || value === undefined)
+    return value;
+  if (isSensitiveKey(key)) {
+    if (typeof value === "string") {
+      return { redacted: true, length: value.length };
+    }
+    if (value instanceof Error) {
+      return { redacted: true, type: value.name, code: getErrorCode(value) };
+    }
+    return { redacted: true, type: typeof value };
+  }
+  if (value instanceof Error) {
+    return { name: value.name, message: value.message };
+  }
+  return value;
+}
+function isSensitiveKey(key) {
+  return /(?:^|_)(message|prompt|content|parts|error|err|stack|body)(?:$|_)/i.test(key);
+}
+function getErrorCode(err) {
+  const code = err.code;
+  return typeof code === "string" ? code : undefined;
+}
+function summarizeError(err) {
+  if (err && typeof err === "object") {
+    const e = err;
+    return {
+      type: typeof e.name === "string" ? e.name : "Error",
+      code: typeof e.code === "string" ? e.code : undefined
+    };
   }
+  return { type: typeof err };
 }
 
 // src/resolution/agent-resolver.ts
@@ -3501,7 +3559,7 @@ async function attemptFallback(sessionId, reason, client, store, config, logger,
       const result = await client.session.messages({ path: { id: sessionId } });
       messageEntries = Array.isArray(result.data) ? result.data : [];
     } catch (err) {
-      logger.error("replay.messages.failed", { sessionId, err: String(err) });
+      logger.error("replay.messages.failed", { sessionId, err });
       return { success: false, error: "messages fetch failed" };
     }
     let lastUserEntry = null;
@@ -3571,7 +3629,7 @@ async function attemptFallback(sessionId, reason, client, store, config, logger,
       return { success: false, error: "all fallback models exhausted" };
     }
     const currentModel = sessionState.currentModel;
-    if (currentModel) {
+    if (currentModel && shouldMarkRateLimited(reason)) {
       store.health.markRateLimited(currentModel, config.defaults.cooldownMs, config.defaults.retryOriginalAfterMs);
     }
     sessionState.lastFallbackAt = Date.now();
@@ -3579,7 +3637,7 @@ async function attemptFallback(sessionId, reason, client, store, config, logger,
       await client.session.abort({ path: { id: sessionId } });
       logger.debug("replay.abort.ok", { sessionId });
     } catch (err) {
-      logger.error("replay.abort.failed", { sessionId, err: String(err) });
+      logger.error("replay.abort.failed", { sessionId, err });
       return { success: false, error: "abort failed" };
     }
     try {
@@ -3592,7 +3650,7 @@ async function attemptFallback(sessionId, reason, client, store, config, logger,
         messageID: lastUserEntry.id
       });
     } catch (err) {
-      logger.error("replay.revert.failed", { sessionId, err: String(err) });
+      logger.error("replay.revert.failed", { sessionId, err });
       return { success: false, error: "revert failed" };
     }
     const promptParts = convertPartsForPrompt(lastUserEntry.parts);
@@ -3615,7 +3673,7 @@ async function attemptFallback(sessionId, reason, client, store, config, logger,
       logger.error("replay.prompt.failed", {
         sessionId,
         fallbackModel,
-        err: String(err)
+        err
       });
       return { success: false, error: "prompt failed" };
     }
@@ -3630,11 +3688,14 @@ async function attemptFallback(sessionId, reason, client, store, config, logger,
       reason,
       depth: newDepth
     });
-    return { success: true, fallbackModel };
+    return { success: true, fallbackModel, fromModel: currentModel };
   } finally {
     store.sessions.releaseLock(sessionId);
   }
 }
+function shouldMarkRateLimited(reason) {
+  return reason === "rate_limit" || reason === "quota_exceeded";
+}
 function sanitizeParts(parts) {
   if (!Array.isArray(parts))
     return [];
@@ -3648,7 +3709,7 @@ class ModelHealthStore {
   onTransition;
   constructor(opts) {
     this.onTransition = opts?.onTransition;
-    this.timer = setInterval(() => this.tick(), 30000);
+    this.timer = setInterval(() => this.tick(), 30000).unref();
   }
   get(modelKey2) {
     return this.store.get(modelKey2) ?? this.newHealth(modelKey2);
@@ -3778,6 +3839,7 @@ class SessionStateStore {
       agentName
     };
     state.currentModel = toModel;
+    state.fallbackDepth++;
     state.recoveryNotifiedForModel = null;
     state.fallbackHistory.push(event);
     if (agentName)
@@ -4022,22 +4084,25 @@ function getLastUserModelAndAgent(data) {
 }
 
 // src/plugin.ts
-var createPlugin = async ({ client, directory }) => {
-  const { config, path: configPath, warnings, migrated } = loadConfig(directory);
-  const logger = new Logger(client, config.logPath, config.logging, config.logLevel);
-  const cmdPath = join4(homedir5(), ".config/opencode/commands/fallback-status.md");
+function resolveFallbackStatusCommandPath() {
+  return join4(homedir5(), ".config", "opencode", "commands", "fallback-status.md");
+}
+function ensureFallbackStatusCommand(logger, cmdPath) {
   try {
-    if (!existsSync4(cmdPath)) {
-      mkdirSync2(dirname2(cmdPath), { recursive: true });
-      writeFileSync2(cmdPath, `Call the fallback-status tool and display the full output.
-`);
-    }
-  } catch (err) {
-    logger.warn("fallback-status.command.write.failed", {
-      cmdPath,
-      err: String(err)
+    mkdirSync2(dirname2(cmdPath), { recursive: true, mode: 448 });
+    writeFileSync2(cmdPath, `Call the fallback-status tool and display the full output.
+`, {
+      flag: "wx"
     });
+  } catch (err) {
+    if (err.code !== "EEXIST") {
+      logger.warn("fallback-status.command.write.failed", { cmdPath, err });
+    }
   }
+}
+var createPlugin = async ({ client, directory }) => {
+  const { config, path: configPath, warnings, migrated } = loadConfig(directory);
+  const logger = new Logger(client, config.logPath, config.logging, config.logLevel);
   logger.info("plugin.init", {
     configPath,
     enabled: config.enabled,
@@ -4045,17 +4110,19 @@ var createPlugin = async ({ client, directory }) => {
     agentCount: Object.keys(config.agents).length
   });
   for (const w of warnings) {
-    logger.warn("config.warning", { message: w });
+    logger.warn("config.warning", { warning: w });
   }
   if (migrated) {
     logger.info("config.migrated", {
-      message: "Auto-migrated from old rate-limit-fallback.json format"
+      note: "Auto-migrated from old rate-limit-fallback.json format"
     });
   }
   if (!config.enabled) {
     logger.info("plugin.disabled");
     return {};
   }
+  const cmdPath = resolveFallbackStatusCommandPath();
+  ensureFallbackStatusCommand(logger, cmdPath);
   const store = new FallbackStore(config, logger);
   const hooks = {
     async event({ event }) {
@@ -4120,8 +4187,7 @@ async function handleEvent(event, client, store, config, logger, directory) {
       if (config.defaults.fallbackOn.includes(category)) {
         const result = await attemptFallback(sessionID, category, client, store, config, logger, directory);
         if (result.success && result.fallbackModel) {
-          const state = store.sessions.get(sessionID);
-          await notifyFallback(client, state.originalModel, result.fallbackModel, category);
+          await notifyFallback(client, result.fromModel ?? null, result.fallbackModel, category);
         }
       }
     }
@@ -4141,12 +4207,16 @@ async function handleEvent(event, client, store, config, logger, directory) {
 }
 async function handleRetry(sessionId, message, client, store, config, logger, directory) {
   if (!matchesAnyPattern(message, config.patterns)) {
-    logger.debug("retry.nomatch", { sessionId, message });
+    logger.debug("retry.nomatch", { sessionId, messageLength: message.length });
     return;
   }
   const category = classifyError(message);
   if (!config.defaults.fallbackOn.includes(category)) {
-    logger.debug("retry.ignored", { sessionId, message, category });
+    logger.debug("retry.ignored", {
+      sessionId,
+      category,
+      messageLength: message.length
+    });
     return;
   }
   const sessionState = store.sessions.get(sessionId);
@@ -4174,15 +4244,14 @@ async function handleRetry(sessionId, message, client, store, config, logger, di
   }
   logger.info("retry.detected", {
     sessionId,
-    message,
+    messageLength: message.length,
     category,
     agentName: sessionState.agentName,
     agentFile: sessionState.agentFile
   });
   const result = await attemptFallback(sessionId, category, client, store, config, logger, directory);
   if (result.success && result.fallbackModel) {
-    const state = store.sessions.get(sessionId);
-    await notifyFallback(client, state.originalModel, result.fallbackModel, category);
+    await notifyFallback(client, result.fromModel ?? null, result.fallbackModel, category);
   }
 }
 async function handleIdle(sessionId, client, store, _config, logger) {

package/dist/src/display/notifier.d.ts

@@ -4,5 +4,6 @@ type Client = PluginInput["client"];
 export declare function notifyFallback(client: Client, from: ModelKey | null, to: ModelKey, reason: ErrorCategory): Promise<void>;
 export declare function notifyFallbackActive(client: Client, originalModel: ModelKey, currentModel: ModelKey): Promise<void>;
 export declare function notifyRecovery(client: Client, originalModel: ModelKey): Promise<void>;
+export declare function labelModel(key: ModelKey): string;
 export {};
 //# sourceMappingURL=notifier.d.ts.map

package/dist/src/display/notifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notifier.d.ts","sourceRoot":"","sources":["../../../src/display/notifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE3D,KAAK,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;AAEpC,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,QAAQ,GAAG,IAAI,EACrB,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,QAAQ,EACvB,YAAY,EAAE,QAAQ,GACrB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAY3F"}
+{"version":3,"file":"notifier.d.ts","sourceRoot":"","sources":["../../../src/display/notifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE3D,KAAK,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;AAEpC,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,QAAQ,GAAG,IAAI,EACrB,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,QAAQ,EACvB,YAAY,EAAE,QAAQ,GACrB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAY3F;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAMhD"}

package/dist/src/logging/logger.d.ts

@@ -13,6 +13,7 @@ export declare class Logger {
     private enabled;
     private minLevel;
     private dirCreated;
+    private fileErrorNotified;
     constructor(client: Client, logPath: string, enabled: boolean, minLevel?: "debug" | "info");
     log(level: LogLevel, event: string, fields?: Record<string, unknown>): void;
     info(event: string, fields?: Record<string, unknown>): void;

package/dist/src/logging/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/logging/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,KAAK,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;AAEpC,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,UAAU,CAAS;gBAGzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,QAAQ,GAAE,OAAO,GAAG,MAAe;IAQrC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IA0B/E,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,OAAO,CAAC,WAAW;CAepB"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/logging/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,KAAK,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;AAEpC,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,iBAAiB,CAAS;gBAGhC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,QAAQ,GAAE,OAAO,GAAG,MAAe;IAQrC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IA2B/E,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,OAAO,CAAC,WAAW;CA8BpB"}

package/dist/src/plugin.d.ts

@@ -3,6 +3,7 @@ import type { Event } from "@opencode-ai/sdk";
 import { loadConfig } from "./config/loader.js";
 import { Logger } from "./logging/logger.js";
 import { FallbackStore } from "./state/store.js";
+export declare function ensureFallbackStatusCommand(logger: Logger, cmdPath: string): void;
 export declare const createPlugin: Plugin;
 export declare function handleEvent(event: Event, client: Parameters<Plugin>[0]["client"], store: FallbackStore, config: ReturnType<typeof loadConfig>["config"], logger: Logger, directory: string): Promise<void>;
 export declare function handleIdle(sessionId: string, client: Parameters<Plugin>[0]["client"], store: FallbackStore, _config: ReturnType<typeof loadConfig>["config"], logger: Logger): Promise<void>;

package/dist/src/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,MAAM,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAK9C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIhD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG7C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAIjD,eAAO,MAAM,YAAY,EAAE,MAqG1B,CAAC;AAEF,wBAAsB,WAAW,CAC/B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EACvC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,QAAQ,CAAC,EAC/C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAyDf;AAqFD,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EACvC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,QAAQ,CAAC,EAChD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAuBf"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,MAAM,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAK9C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIhD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG7C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAQjD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAWjF;AAED,eAAO,MAAM,YAAY,EAAE,MA2F1B,CAAC;AAEF,wBAAsB,WAAW,CAC/B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EACvC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,QAAQ,CAAC,EAC/C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAwDf;AAwFD,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EACvC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,QAAQ,CAAC,EAChD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAuBf"}

package/dist/src/replay/orchestrator.d.ts

@@ -6,6 +6,7 @@ type Client = PluginInput["client"];
 export interface ReplayResult {
     success: boolean;
     fallbackModel?: ModelKey;
+    fromModel?: ModelKey | null;
     error?: string;
 }
 export declare function attemptFallback(sessionId: string, reason: ErrorCategory, client: Client, store: FallbackStore, config: PluginConfig, logger: Logger, directory: string): Promise<ReplayResult>;

package/dist/src/replay/orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/replay/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGzE,KAAK,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;AAEpC,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC,CAwOvB"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/replay/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGzE,KAAK,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;AAEpC,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB,SAAS,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC,CAwOvB"}

package/dist/src/state/model-health.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-health.d.ts","sourceRoot":"","sources":["../../../src/state/model-health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,YAAY,CAAC,CAAmE;gBAE5E,IAAI,CAAC,EAAE;QACjB,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,KAAK,IAAI,CAAC;KACjF;IAMD,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,WAAW;IAIpC,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,GAAG,IAAI;IAc3F,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAKrC,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM;IAQvC,MAAM,IAAI,WAAW,EAAE;IAIvB,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,IAAI;IA4BZ,OAAO,CAAC,SAAS;CAUlB"}
+{"version":3,"file":"model-health.d.ts","sourceRoot":"","sources":["../../../src/state/model-health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,YAAY,CAAC,CAAmE;gBAE5E,IAAI,CAAC,EAAE;QACjB,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,KAAK,IAAI,CAAC;KACjF;IAOD,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,WAAW;IAIpC,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,GAAG,IAAI;IAc3F,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAKrC,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM;IAQvC,MAAM,IAAI,WAAW,EAAE;IAIvB,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,IAAI;IA4BZ,OAAO,CAAC,SAAS;CAUlB"}

package/dist/src/state/session-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-state.d.ts","sourceRoot":"","sources":["../../../src/state/session-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAiB,QAAQ,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEhG,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAA2C;IAExD,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB;IAS5C,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IASvC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKpC,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,SAAQ,GAAG,OAAO;IAM7D,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,IAAI;IAmBP,wBAAwB,CACtB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,QAAQ,EACjB,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,IAAI;IAkBP,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI;IAQ1D,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKxD,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKxD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IASrC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI/B,MAAM,IAAI,oBAAoB,EAAE;IAIhC,OAAO,CAAC,QAAQ;CAcjB"}
+{"version":3,"file":"session-state.d.ts","sourceRoot":"","sources":["../../../src/state/session-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAiB,QAAQ,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEhG,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAA2C;IAExD,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB;IAS5C,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IASvC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKpC,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,SAAQ,GAAG,OAAO;IAM7D,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,IAAI;IAmBP,wBAAwB,CACtB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,QAAQ,EACjB,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,IAAI;IAmBP,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI;IAQ1D,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKxD,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKxD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IASrC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI/B,MAAM,IAAI,oBAAoB,EAAE;IAIhC,OAAO,CAAC,QAAQ;CAcjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smart-coders-hq/opencode-model-fallback",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "description": "Ordered model fallback chains with health tracking for OpenCode",
   "type": "module",
   "main": "dist/index.js",

package/plugin.json

@@ -3,7 +3,7 @@
   "id": "opencode-model-fallback",
   "name": "Model Fallback",
   "description": "Ordered model fallback chains with health tracking and preemptive redirects for OpenCode",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "entry": "dist/index.js",
   "links": [
     {