@smart-coders-hq/opencode-model-fallback 1.2.0 → 1.3.1

package/README.md

@@ -1,29 +1,27 @@
 # opencode-model-fallback
 
-OpenCode plugin that adds automatic model fallback when your primary model hits a rate limit or quota. Instead of waiting in a retry loop, it immediately switches to the next healthy model in a configured chain — per-agent, with a health state machine that tracks recovery.
+OpenCode plugin that automatically switches to the next model in a configured fallback chain when the current one hits a rate limit, quota error, timeout, overload, or configured 5xx path.
 
-## How it works
+## Features
 
-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
-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
+- Preemptive redirect via `chat.message` when a model is already known to be rate-limited
+- Reactive fallback from both `session.status` retry events and `session.error` API errors
+- Per-agent ordered fallback chains with `"*"` wildcard support
+- Global model health tracking with automatic recovery windows
+- `/fallback-status` slash command for session depth, history, and model health
+- Structured logs with provider free-form error text redacted
 
 ## Installation
 
-Add to the `plugin` array in your `~/.config/opencode/opencode.jsonc`:
+Add the plugin to `~/.config/opencode/opencode.jsonc`:
 
 ```jsonc
 {
-  "plugin": [
-    // ... existing plugins
-    "@smart-coders-hq/opencode-model-fallback",
-  ],
+  "plugin": ["@smart-coders-hq/opencode-model-fallback"],
 }
 ```
 
-Or load locally during development:
+For local development:
 
 ```jsonc
 {
@@ -31,14 +29,14 @@ Or load locally during development:
 }
 ```
 
-Then create a config file (see [Configuration](#configuration)).
-
 ## Configuration
 
-Place `model-fallback.json` at either:
+Create `model-fallback.json` in either:
+
+- `.opencode/model-fallback.json`
+- `~/.config/opencode/model-fallback.json`
 
-- `.opencode/model-fallback.json` — project-local
-- `~/.config/opencode/model-fallback.json` — global
+Minimal example:
 
 ```json
 {
@@ -63,49 +61,22 @@ Place `model-fallback.json` at either:
       ]
     }
   },
-  "patterns": [
-    "rate limit",
-    "usage limit",
-    "too many requests",
-    "quota exceeded",
-    "overloaded",
-    "capacity exceeded",
-    "credits exhausted",
-    "billing limit",
-    "429"
-  ],
   "logging": true,
   "logLevel": "info",
   "logPath": "~/.local/share/opencode/logs/model-fallback.log"
 }
 ```
 
-### All config fields
-
-| Field                           | Type     | Default                                           | Description                                                                                                                        |
-| ------------------------------- | -------- | ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
-| `enabled`                       | boolean  | `true`                                            | Enable/disable the plugin                                                                                                          |
-| `defaults.fallbackOn`           | string[] | all categories                                    | Error categories that trigger fallback                                                                                             |
-| `defaults.cooldownMs`           | number   | `300000` (5 min)                                  | How long before a rate-limited model enters cooldown. Min: 10000                                                                   |
-| `defaults.retryOriginalAfterMs` | number   | `900000` (15 min)                                 | How long before a cooldown model is considered healthy again. Min: 10000                                                           |
-| `defaults.maxFallbackDepth`     | number   | `3`                                               | Maximum number of fallbacks per session. Max: 10                                                                                   |
-| `agents`                        | object   | `{"*": {}}`                                       | Per-agent fallback chains (see below)                                                                                              |
-| `patterns`                      | string[] | see defaults                                      | Case-insensitive substrings to match in retry messages                                                                             |
-| `logging`                       | boolean  | `true`                                            | Write structured logs to `logPath`                                                                                                 |
-| `logLevel`                      | string   | `"info"`                                          | Minimum log level written to file: `"info"` suppresses debug noise, `"debug"` logs every event (useful for incident investigation) |
-| `logPath`                       | string   | `~/.local/share/opencode/logs/model-fallback.log` | Log file path (must be within `$HOME`)                                                                                             |
-
-### Error categories
+Most important knobs:
 
-- `rate_limit` — 429, "rate limit", "too many requests", "usage limit"
-- `quota_exceeded` — "quota exceeded", "credits exhausted", "billing limit"
-- `overloaded` — "overloaded", "capacity exceeded"
-- `timeout` — "timeout", "timed out"
-- `5xx` — 500/502/503/504, "internal server error", "bad gateway"
+- `defaults.fallbackOn` - which error categories trigger fallback
+- `defaults.cooldownMs` - how long a rate-limited model stays unavailable
+- `defaults.retryOriginalAfterMs` - when a cooled-down model becomes healthy again
+- `defaults.maxFallbackDepth` - max cascading fallbacks within one message
+- `agents` - ordered fallback chains per agent
+- `logging`, `logLevel`, `logPath` - structured file logging controls
 
-## Per-agent chains
-
-Configure different fallback chains for different agents using the agent name as the key. The `"*"` wildcard is used for any agent without a specific entry.
+Per-agent example:
 
 ```json
 {
@@ -130,112 +101,54 @@ Configure different fallback chains for different agents using the agent name as
 }
 ```
 
-Models are tried in order. Rate-limited models are skipped; cooldown models are used as a last resort.
-
-## Migrating from opencode-rate-limit-fallback
-
-If you have an existing `rate-limit-fallback.json` config, the plugin auto-migrates it on load — no manual steps needed.
-
-**Old format:**
-
-```json
-{
-  "fallbackModel": "anthropic/claude-opus-4-5",
-  "cooldownMs": 300000,
-  "patterns": ["rate limit"],
-  "logging": true
-}
-```
-
-**Automatically converted to:**
-
-```json
-{
-  "agents": { "*": { "fallbackModels": ["anthropic/claude-opus-4-5"] } },
-  "defaults": { "cooldownMs": 300000 },
-  "patterns": ["rate limit"],
-  "logging": true
-}
-```
-
-The plugin checks both `rate-limit-fallback.json` and `model-fallback.json` — old configs are found and migrated automatically.
+If you still have `rate-limit-fallback.json`, it is discovered and auto-migrated on load.
 
-## `/fallback-status` command
+## `/fallback-status`
 
 Run `/fallback-status` in any OpenCode session to see:
 
-- Current session's fallback depth and history
-- Health state of all tracked models (healthy / cooldown / rate_limited) with time remaining
-- Which agent is active
+- current session fallback depth and history
+- tracked model health and time remaining
+- active agent name
 
-With the `verbose` flag:
+Verbose mode adds token and cost breakdown by fallback period:
 
-```
+```text
 /fallback-status verbose:true
 ```
 
-Includes token/cost breakdown per model period.
-
-## Health state machine
-
-```
-healthy ──[rate limit detected]──→ rate_limited
-rate_limited ──[cooldownMs elapsed]──→ cooldown
-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
-- When the original model recovers to healthy, a toast appears on the next `session.idle`
+When enabled, the plugin auto-creates `~/.config/opencode/commands/fallback-status.md` at startup.
 
 ## Troubleshooting
 
-**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.
-
-**"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.
-
-**"all fallback models exhausted"**
-All configured fallback models are currently rate-limited. Wait for `cooldownMs` to elapse or add more models to the chain.
+- **No toast appears** - toasts require an active OpenCode TUI session; headless/API runs still log events
+- **`/fallback-status` is missing** - verify `~/.config/opencode/commands/` is writable and check logs for `fallback-status.command.write.failed`
+- **"no fallback chain configured"** - add `agents["*"]` or an entry for the active agent with at least one `fallbackModels` value
+- **"all fallback models exhausted"** - every configured fallback is currently rate-limited; wait for recovery or add more models
+- **"max fallback depth reached"** - all models in the chain failed within one message; start a new session or raise `maxFallbackDepth`
 
-**"max fallback depth reached"**
-The session has hit `maxFallbackDepth` cascading fallbacks within a single message (all models failing in sequence). Depth resets automatically when the TUI reverts to the original model between messages, so this typically indicates all configured models are rate-limited simultaneously. Start a new session or increase `maxFallbackDepth` in config.
-
-**Check the logs:**
+Check logs with:
 
 ```bash
 tail -f ~/.local/share/opencode/logs/model-fallback.log | jq .
 ```
 
-Key log events: `plugin.init`, `retry.detected`, `fallback.success`, `fallback.exhausted`, `health.transition`, `recovery.available`
-
-To see the full event stream (including `event.received` and `retry.nomatch`), set `"logLevel": "debug"` in your config and restart OpenCode.
-
-## 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`
-- Published as `@smart-coders-hq/opencode-model-fallback`
-- To publish to npm, set repository secret `NPM_TOKEN`
+For more event detail, set `"logLevel": "debug"` and restart OpenCode.
 
 ## Development
 
 ```bash
 bun install
-bun run lint          # lint checks
-bun test              # 145 tests across 11 files
-bunx tsc --noEmit     # type check
-bun run build         # build to dist/
+bun run lint
+bun test
+bunx tsc --noEmit
+bun run build
 ```
 
-Load locally in OpenCode:
+Local plugin config:
 
 ```jsonc
 { "plugin": ["file:///absolute/path/to/dist/index.js"] }
 ```
 
-Config for testing: place `model-fallback.json` in `.opencode/` in your project directory.
+For local testing, place `model-fallback.json` in `.opencode/` in your project directory.

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";
 
@@ -3305,7 +3305,7 @@ function labelModel(key) {
 }
 
 // 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 {
@@ -3314,6 +3314,7 @@ class Logger {
   enabled;
   minLevel;
   dirCreated = false;
+  fileErrorNotified = false;
   constructor(client, logPath, enabled, minLevel = "info") {
     this.client = client;
     this.logPath = logPath;
@@ -3321,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(() => {});
@@ -3356,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
@@ -3505,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;
@@ -3575,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();
@@ -3583,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 {
@@ -3596,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);
@@ -3619,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" };
     }
@@ -3634,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 [];
@@ -3652,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);
@@ -3782,6 +3839,7 @@ class SessionStateStore {
       agentName
     };
     state.currentModel = toModel;
+    state.fallbackDepth++;
     state.recoveryNotifiedForModel = null;
     state.fallbackHistory.push(event);
     if (agentName)
@@ -4026,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,
@@ -4049,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 }) {
@@ -4124,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);
         }
       }
     }
@@ -4145,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);
@@ -4178,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) {
@@ -4206,7 +4271,8 @@ async function handleIdle(sessionId, client, store, _config, logger) {
     return;
   logger.info("recovery.available", {
     sessionId,
-    originalModel: state.originalModel
+    originalModel: state.originalModel,
+    currentModel: state.currentModel
   });
   await notifyRecovery(client, state.originalModel);
   state.recoveryNotifiedForModel = state.originalModel;

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,CAwBf"}

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.2.0",
+  "version": "1.3.1",
   "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.2.0",
+  "version": "1.3.1",
   "entry": "dist/index.js",
   "links": [
     {