oh-my-opencode-slim 0.8.3 → 0.8.4

package/README.md

@@ -15,7 +15,7 @@
 bunx oh-my-opencode-slim@latest install
 ```
 
-The installer generates an OpenAI configuration by default (using `gpt-5.4` and `gpt-5-codex`). No provider questions asked.
+The installer generates an OpenAI configuration by default (using `gpt-5.4` and `gpt-5.4-mini`). No provider questions asked.
 
 For non-interactive mode:
 
@@ -23,6 +23,11 @@ For non-interactive mode:
 bunx oh-my-opencode-slim@latest install --no-tui --tmux=no --skills=yes
 ```
 
+To force overwrite of an existing configuration:
+```bash
+bunx oh-my-opencode-slim@latest install --reset
+```
+
 ### For Alternative Providers
 
 The default configuration uses OpenAI. To use Kimi, GitHub Copilot, or ZAI Coding Plan, see **[Provider Configurations](docs/provider-configurations.md)** for step-by-step instructions and config examples.
@@ -55,6 +60,27 @@ https://raw.githubusercontent.com/alvinunreal/oh-my-opencode-slim/refs/heads/mas
 - **[Provider Configurations](docs/provider-configurations.md)** - Config examples for all supported providers
 - **[Tmux Integration](docs/tmux-integration.md)** - Real-time agent monitoring with tmux
 
+### ✅ Verify Your Setup
+
+After installation and authentication, verify all agents are configured and responding:
+
+```bash
+opencode
+```
+
+Then run:
+
+```
+ping all agents
+```
+
+<div align="center">
+  <img src="img/ping.png" alt="Ping all agents" width="600">
+  <p><i>Confirmation that all six agents are online and ready.</i></p>
+</div>
+
+If any agent fails to respond, check your provider authentication and config file.
+
 ---
 
 ## 🏛️ Meet the Pantheon
@@ -119,12 +145,12 @@ https://raw.githubusercontent.com/alvinunreal/oh-my-opencode-slim/refs/heads/mas
   </tr>
   <tr>
     <td colspan="2">
-      <b>Default Model:</b> <code>openai/gpt-5-codex</code>
+      <b>Default Model:</b> <code>openai/gpt-5.4-mini</code>
     </td>
   </tr>
   <tr>
     <td colspan="2">
-      <b>Recommended Models:</b> <code>cerebras/zai-glm-4.7</code> <code>google/gemini-3.1-pro-preview</code> <code>openai/gpt-5-codex</code>
+      <b>Recommended Models:</b> <code>cerebras/zai-glm-4.7</code> <code>google/gemini-3.1-pro-preview</code> <code>openai/gpt-5.4-mini</code>
     </td>
   </tr>
 </table>
@@ -191,12 +217,12 @@ https://raw.githubusercontent.com/alvinunreal/oh-my-opencode-slim/refs/heads/mas
   </tr>
   <tr>
     <td colspan="2">
-      <b>Default Model:</b> <code>openai/gpt-5-codex</code>
+      <b>Default Model:</b> <code>openai/gpt-5.4-mini</code>
     </td>
   </tr>
   <tr>
     <td colspan="2">
-      <b>Recommended Models:</b> <code>google/gemini-3.1-pro-preview</code> <code>openai/gpt-5-codex</code>
+      <b>Recommended Models:</b> <code>google/gemini-3.1-pro-preview</code> <code>openai/gpt-5.4-mini</code>
     </td>
   </tr>
 </table>
@@ -263,12 +289,12 @@ https://raw.githubusercontent.com/alvinunreal/oh-my-opencode-slim/refs/heads/mas
   </tr>
   <tr>
     <td colspan="2">
-      <b>Default Model:</b> <code>openai/gpt-5-codex</code>
+      <b>Default Model:</b> <code>openai/gpt-5.4-mini</code>
     </td>
   </tr>
   <tr>
     <td colspan="2">
-      <b>Recommended Models:</b> <code>cerebras/zai-glm-4.7</code> <code>google/gemini-3.1-pro-preview</code> <code>openai/gpt-5-codex</code>
+      <b>Recommended Models:</b> <code>cerebras/zai-glm-4.7</code> <code>google/gemini-3.1-pro-preview</code> <code>openai/gpt-5.4-mini</code>
     </td>
   </tr>
 </table>

package/dist/cli/config-io.d.ts

@@ -16,7 +16,7 @@ export declare function parseConfig(path: string): {
  */
 export declare function writeConfig(configPath: string, config: OpenCodeConfig): void;
 export declare function addPluginToOpenCodeConfig(): Promise<ConfigMergeResult>;
-export declare function writeLiteConfig(installConfig: InstallConfig): ConfigMergeResult;
+export declare function writeLiteConfig(installConfig: InstallConfig, targetPath?: string): ConfigMergeResult;
 export declare function disableDefaultAgents(): ConfigMergeResult;
 export declare function canModifyOpenCodeConfig(): boolean;
 export declare function detectCurrentConfig(): DetectedConfig;

package/dist/cli/custom-skills.d.ts

@@ -1,6 +1,6 @@
 /**
  * A custom skill bundled in this repository.
- * Unlike npx-installed skills, these are copied from src/skills/ to ~/.config/opencode/skills/
+ * Unlike npx-installed skills, these are copied from src/skills/ to the OpenCode skills directory
  */
 export interface CustomSkill {
     /** Skill name (folder name) */
@@ -21,7 +21,7 @@ export declare const CUSTOM_SKILLS: CustomSkill[];
  */
 export declare function getCustomSkillsDir(): string;
 /**
- * Install a custom skill by copying from src/skills/ to ~/.config/opencode/skills/
+ * Install a custom skill by copying from src/skills/ to the OpenCode skills directory
  * @param skill - The custom skill to install
  * @param projectRoot - Root directory of oh-my-opencode-slim project
  * @returns True if installation succeeded, false otherwise

package/dist/cli/index.js

@@ -11,6 +11,9 @@ var __export = (target, all) => {
     });
 };
 
+// src/cli/install.ts
+import { existsSync as existsSync4 } from "fs";
+
 // src/cli/config-io.ts
 import {
   copyFileSync as copyFileSync2,
@@ -24,20 +27,47 @@ import {
 // src/cli/paths.ts
 import { existsSync, mkdirSync } from "fs";
 import { homedir } from "os";
-import { join } from "path";
-function getConfigDir() {
+import { dirname, join } from "path";
+function getDefaultOpenCodeConfigDir() {
   const userConfigDir = process.env.XDG_CONFIG_HOME ? process.env.XDG_CONFIG_HOME : join(homedir(), ".config");
   return join(userConfigDir, "opencode");
 }
+function getCustomOpenCodeConfigDir() {
+  const configDir = process.env.OPENCODE_CONFIG_DIR?.trim();
+  return configDir || undefined;
+}
+function getConfigDir() {
+  const customConfigDir = getCustomOpenCodeConfigDir();
+  if (customConfigDir) {
+    return customConfigDir;
+  }
+  return getDefaultOpenCodeConfigDir();
+}
+function getOpenCodeConfigPaths() {
+  const configDir = getDefaultOpenCodeConfigDir();
+  return [join(configDir, "opencode.json"), join(configDir, "opencode.jsonc")];
+}
 function getConfigJson() {
-  return join(getConfigDir(), "opencode.json");
+  return getOpenCodeConfigPaths()[0];
 }
 function getConfigJsonc() {
-  return join(getConfigDir(), "opencode.jsonc");
+  return getOpenCodeConfigPaths()[1];
 }
 function getLiteConfig() {
   return join(getConfigDir(), "oh-my-opencode-slim.json");
 }
+function getLiteConfigJsonc() {
+  return join(getConfigDir(), "oh-my-opencode-slim.jsonc");
+}
+function getExistingLiteConfigPath() {
+  const jsonPath = getLiteConfig();
+  if (existsSync(jsonPath))
+    return jsonPath;
+  const jsoncPath = getLiteConfigJsonc();
+  if (existsSync(jsoncPath))
+    return jsoncPath;
+  return jsonPath;
+}
 function getExistingConfigPath() {
   const jsonPath = getConfigJson();
   if (existsSync(jsonPath))
@@ -53,6 +83,12 @@ function ensureConfigDir() {
     mkdirSync(configDir, { recursive: true });
   }
 }
+function ensureOpenCodeConfigDir() {
+  const configDir = dirname(getConfigJson());
+  if (!existsSync(configDir)) {
+    mkdirSync(configDir, { recursive: true });
+  }
+}
 
 // src/config/constants.ts
 var SUBAGENT_NAMES = [
@@ -2305,7 +2341,7 @@ class Doc {
 var version = {
   major: 4,
   minor: 3,
-  patch: 5
+  patch: 6
 };
 
 // node_modules/zod/v4/core/schemas.js
@@ -3591,7 +3627,7 @@ var $ZodRecord = /* @__PURE__ */ $constructor("$ZodRecord", (inst, def) => {
         if (keyResult instanceof Promise) {
           throw new Error("Async schemas not supported in object keys currently");
         }
-        const checkNumericKey = typeof key === "string" && number.test(key) && keyResult.issues.length && keyResult.issues.some((iss) => iss.code === "invalid_type" && iss.expected === "number");
+        const checkNumericKey = typeof key === "string" && number.test(key) && keyResult.issues.length;
         if (checkNumericKey) {
           const retryResult = def.keyType._zod.run({ value: Number(key), issues: [] }, ctx);
           if (retryResult instanceof Promise) {
@@ -10962,7 +10998,7 @@ function finalize(ctx, schema) {
           }
         }
       }
-      if (refSchema.$ref) {
+      if (refSchema.$ref && refSeen.def) {
         for (const key in schema2) {
           if (key === "$ref" || key === "allOf")
             continue;
@@ -13672,10 +13708,12 @@ var BackgroundTaskConfigSchema = exports_external.object({
 var FailoverConfigSchema = exports_external.object({
   enabled: exports_external.boolean().default(true),
   timeoutMs: exports_external.number().min(0).default(15000),
+  retryDelayMs: exports_external.number().min(0).default(500),
   chains: FallbackChainsSchema.default({})
 });
 var PluginConfigSchema = exports_external.object({
   preset: exports_external.string().optional(),
+  setDefaultAgent: exports_external.boolean().optional(),
   scoringEngineVersion: exports_external.enum(["v1", "v2-shadow", "v2"]).optional(),
   balanceProviderUsage: exports_external.boolean().optional(),
   manualPlan: ManualPlanSchema.optional(),
@@ -13707,8 +13745,7 @@ import {
   readdirSync,
   statSync
 } from "fs";
-import { homedir as homedir2 } from "os";
-import { dirname, join as join2 } from "path";
+import { dirname as dirname2, join as join2 } from "path";
 import { fileURLToPath } from "url";
 var CUSTOM_SKILLS = [
   {
@@ -13719,7 +13756,7 @@ var CUSTOM_SKILLS = [
   }
 ];
 function getCustomSkillsDir() {
-  return join2(homedir2(), ".config", "opencode", "skills");
+  return join2(getConfigDir(), "skills");
 }
 function copyDirRecursive(src, dest) {
   if (!existsSync2(dest)) {
@@ -13733,7 +13770,7 @@ function copyDirRecursive(src, dest) {
     if (stat.isDirectory()) {
       copyDirRecursive(srcPath, destPath);
     } else {
-      const destDir = dirname(destPath);
+      const destDir = dirname2(destPath);
       if (!existsSync2(destDir)) {
         mkdirSync2(destDir, { recursive: true });
       }
@@ -13819,10 +13856,10 @@ var MODEL_MAPPINGS = {
   openai: {
     orchestrator: { model: "openai/gpt-5.4" },
     oracle: { model: "openai/gpt-5.4", variant: "high" },
-    librarian: { model: "openai/gpt-5-codex", variant: "low" },
-    explorer: { model: "openai/gpt-5-codex", variant: "low" },
-    designer: { model: "openai/gpt-5-codex", variant: "medium" },
-    fixer: { model: "openai/gpt-5-codex", variant: "low" }
+    librarian: { model: "openai/gpt-5.4-mini", variant: "low" },
+    explorer: { model: "openai/gpt-5.4-mini", variant: "low" },
+    designer: { model: "openai/gpt-5.4-mini", variant: "medium" },
+    fixer: { model: "openai/gpt-5.4-mini", variant: "low" }
   },
   kimi: {
     orchestrator: { model: "kimi-for-coding/k2p5" },
@@ -13837,7 +13874,10 @@ var MODEL_MAPPINGS = {
     oracle: { model: "github-copilot/claude-opus-4.6", variant: "high" },
     librarian: { model: "github-copilot/grok-code-fast-1", variant: "low" },
     explorer: { model: "github-copilot/grok-code-fast-1", variant: "low" },
-    designer: { model: "github-copilot/gemini-3.1-pro-preview", variant: "medium" },
+    designer: {
+      model: "github-copilot/gemini-3.1-pro-preview",
+      variant: "medium"
+    },
     fixer: { model: "github-copilot/claude-sonnet-4.6", variant: "low" }
   },
   "zai-plan": {
@@ -13932,16 +13972,16 @@ function writeConfig(configPath, config2) {
   renameSync(tmpPath, configPath);
 }
 async function addPluginToOpenCodeConfig() {
+  const configPath = getExistingConfigPath();
   try {
-    ensureConfigDir();
+    ensureOpenCodeConfigDir();
   } catch (err) {
     return {
       success: false,
-      configPath: getConfigDir(),
+      configPath,
       error: `Failed to create config directory: ${err}`
     };
   }
-  const configPath = getExistingConfigPath();
   try {
     const { config: parsedConfig, error: error48 } = parseConfig(configPath);
     if (error48) {
@@ -13966,8 +14006,8 @@ async function addPluginToOpenCodeConfig() {
     };
   }
 }
-function writeLiteConfig(installConfig) {
-  const configPath = getLiteConfig();
+function writeLiteConfig(installConfig, targetPath) {
+  const configPath = targetPath ?? getLiteConfig();
   try {
     ensureConfigDir();
     const config2 = generateLiteConfig(installConfig);
@@ -13992,7 +14032,7 @@ function writeLiteConfig(installConfig) {
 function disableDefaultAgents() {
   const configPath = getExistingConfigPath();
   try {
-    ensureConfigDir();
+    ensureOpenCodeConfigDir();
     const { config: parsedConfig, error: error48 } = parseConfig(configPath);
     if (error48) {
       return {
@@ -14207,7 +14247,9 @@ async function checkOpenCodeInstalled() {
   }
   const version2 = await getOpenCodeVersion();
   const path = getOpenCodePath();
-  printSuccess(`OpenCode ${version2 ?? ""} detected${path ? ` (${DIM}${path}${RESET})` : ""}`);
+  const detectedVersion = version2 ?? "";
+  const pathInfo = path ? ` (${DIM}${path}${RESET})` : "";
+  printSuccess(`OpenCode ${detectedVersion} detected${pathInfo}`);
   return { ok: true, version: version2 ?? undefined, path: path ?? undefined };
 }
 function handleStepResult(result, successMsg) {
@@ -14224,9 +14266,10 @@ function formatConfigSummary() {
   lines.push("");
   lines.push(`  ${BOLD}Preset:${RESET} ${BLUE}openai${RESET}`);
   lines.push(`  ${SYMBOLS.check} OpenAI (default)`);
-  lines.push(`  ${DIM}\u25CB Kimi \u2014 see docs/provider-configurations.md${RESET}`);
-  lines.push(`  ${DIM}\u25CB GitHub Copilot \u2014 see docs/provider-configurations.md${RESET}`);
-  lines.push(`  ${DIM}\u25CB ZAI Coding Plan \u2014 see docs/provider-configurations.md${RESET}`);
+  const seeDocs = "see docs/provider-configurations.md";
+  lines.push(`  ${DIM}\u25CB Kimi \u2014 ${seeDocs}${RESET}`);
+  lines.push(`  ${DIM}\u25CB GitHub Copilot \u2014 ${seeDocs}${RESET}`);
+  lines.push(`  ${DIM}\u25CB ZAI Coding Plan \u2014 ${seeDocs}${RESET}`);
   return lines.join(`
 `);
 }
@@ -14248,25 +14291,21 @@ async function runInstall(config2) {
     if (!ok)
       return 1;
   }
-  {
-    printStep(step++, totalSteps, "Adding oh-my-opencode-slim plugin...");
-    if (config2.dryRun) {
-      printInfo("Dry run mode - skipping plugin installation");
-    } else {
-      const pluginResult = await addPluginToOpenCodeConfig();
-      if (!handleStepResult(pluginResult, "Plugin added"))
-        return 1;
-    }
+  printStep(step++, totalSteps, "Adding oh-my-opencode-slim plugin...");
+  if (config2.dryRun) {
+    printInfo("Dry run mode - skipping plugin installation");
+  } else {
+    const pluginResult = await addPluginToOpenCodeConfig();
+    if (!handleStepResult(pluginResult, "Plugin added"))
+      return 1;
   }
-  {
-    printStep(step++, totalSteps, "Disabling OpenCode default agents...");
-    if (config2.dryRun) {
-      printInfo("Dry run mode - skipping agent disabling");
-    } else {
-      const agentResult = disableDefaultAgents();
-      if (!handleStepResult(agentResult, "Default agents disabled"))
-        return 1;
-    }
+  printStep(step++, totalSteps, "Disabling OpenCode default agents...");
+  if (config2.dryRun) {
+    printInfo("Dry run mode - skipping agent disabling");
+  } else {
+    const agentResult = disableDefaultAgents();
+    if (!handleStepResult(agentResult, "Default agents disabled"))
+      return 1;
   }
   printStep(step++, totalSteps, "Writing oh-my-opencode-slim configuration...");
   if (config2.dryRun) {
@@ -14276,9 +14315,15 @@ async function runInstall(config2) {
 ${JSON.stringify(liteConfig, null, 2)}
 `);
   } else {
-    const liteResult = writeLiteConfig(config2);
-    if (!handleStepResult(liteResult, "Config written"))
-      return 1;
+    const configPath = getExistingLiteConfigPath();
+    const configExists = existsSync4(configPath);
+    if (configExists && !config2.reset) {
+      printInfo(`Configuration already exists at ${configPath}. ` + "Use --reset to overwrite.");
+    } else {
+      const liteResult = writeLiteConfig(config2, configExists ? configPath : undefined);
+      if (!handleStepResult(liteResult, configExists ? "Config reset" : "Config written"))
+        return 1;
+    }
   }
   if (config2.installSkills) {
     printStep(step++, totalSteps, "Installing recommended skills...");
@@ -14319,22 +14364,27 @@ ${JSON.stringify(liteConfig, null, 2)}
           printInfo(`Skipped: ${skill.name} (already installed)`);
         }
       }
-      printSuccess(`${customSkillsInstalled}/${CUSTOM_SKILLS.length} custom skills processed`);
+      const totalCustom = CUSTOM_SKILLS.length;
+      printSuccess(`${customSkillsInstalled}/${totalCustom} custom skills processed`);
     }
   }
   console.log();
   console.log(formatConfigSummary());
   console.log();
-  console.log(`${SYMBOLS.star} ${BOLD}${GREEN}${isUpdate ? "Configuration updated!" : "Installation complete!"}${RESET}`);
+  const statusMsg = isUpdate ? "Configuration updated!" : "Installation complete!";
+  console.log(`${SYMBOLS.star} ${BOLD}${GREEN}${statusMsg}${RESET}`);
   console.log();
   console.log(`${BOLD}Next steps:${RESET}`);
   console.log();
   console.log(`  1. Start OpenCode:`);
   console.log(`     ${BLUE}$ opencode${RESET}`);
   console.log();
-  console.log(`${BOLD}Default configuration uses OpenAI models (gpt-5.4 / gpt-5-codex).${RESET}`);
-  console.log(`${BOLD}For alternative providers (Kimi, GitHub Copilot, ZAI Coding Plan), see:${RESET}`);
-  console.log(`  ${BLUE}https://github.com/alvinunreal/oh-my-opencode-slim/blob/main/docs/provider-configurations.md${RESET}`);
+  const modelsInfo = "Default configuration uses OpenAI models (gpt-5.4 / gpt-5.4-mini).";
+  console.log(`${BOLD}${modelsInfo}${RESET}`);
+  const altProviders = "For alternative providers (Kimi, GitHub Copilot, ZAI Coding Plan)";
+  console.log(`${BOLD}${altProviders}, see:${RESET}`);
+  const docsUrl = "https://github.com/alvinunreal/oh-my-opencode-slim/" + "blob/master/docs/provider-configurations.md";
+  console.log(`  ${BLUE}${docsUrl}${RESET}`);
   console.log();
   return 0;
 }
@@ -14343,7 +14393,8 @@ async function install(args) {
     hasTmux: args.tmux === "yes",
     installSkills: args.skills === "yes",
     installCustomSkills: args.skills === "yes",
-    dryRun: args.dryRun
+    dryRun: args.dryRun,
+    reset: args.reset ?? false
   };
   return runInstall(config2);
 }
@@ -14362,6 +14413,8 @@ function parseArgs(args) {
       result.skills = arg.split("=")[1];
     } else if (arg === "--dry-run") {
       result.dryRun = true;
+    } else if (arg === "--reset") {
+      result.reset = true;
     } else if (arg === "-h" || arg === "--help") {
       printHelp();
       process.exit(0);
@@ -14380,6 +14433,7 @@ Options:
   --skills=yes|no        Install recommended skills (yes/no)
   --no-tui               Non-interactive mode
   --dry-run              Simulate install without writing files
+  --reset                Force overwrite of existing configuration
   -h, --help             Show this help message
 
 The installer generates an OpenAI configuration by default.
@@ -14388,6 +14442,7 @@ For alternative providers, see docs/provider-configurations.md.
 Examples:
   bunx oh-my-opencode-slim install
   bunx oh-my-opencode-slim install --no-tui --tmux=no --skills=yes
+  bunx oh-my-opencode-slim install --reset
 `);
 }
 async function main() {

package/dist/cli/paths.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Get the OpenCode plugin config directory.
+ *
+ * Resolution order:
+ * 1. OPENCODE_CONFIG_DIR (custom OpenCode directory)
+ * 2. XDG_CONFIG_HOME/opencode
+ * 3. ~/.config/opencode
+ */
 export declare function getConfigDir(): string;
 export declare function getOpenCodeConfigPaths(): string[];
 export declare function getConfigJson(): string;
@@ -7,3 +15,7 @@ export declare function getLiteConfigJsonc(): string;
 export declare function getExistingLiteConfigPath(): string;
 export declare function getExistingConfigPath(): string;
 export declare function ensureConfigDir(): void;
+/**
+ * Ensure the directory for OpenCode's main config file exists.
+ */
+export declare function ensureOpenCodeConfigDir(): void;

package/dist/cli/providers.d.ts

@@ -9,19 +9,19 @@ export declare const MODEL_MAPPINGS: {
             readonly variant: "high";
         };
         readonly librarian: {
-            readonly model: "openai/gpt-5-codex";
+            readonly model: "openai/gpt-5.4-mini";
             readonly variant: "low";
         };
         readonly explorer: {
-            readonly model: "openai/gpt-5-codex";
+            readonly model: "openai/gpt-5.4-mini";
             readonly variant: "low";
         };
         readonly designer: {
-            readonly model: "openai/gpt-5-codex";
+            readonly model: "openai/gpt-5.4-mini";
             readonly variant: "medium";
         };
         readonly fixer: {
-            readonly model: "openai/gpt-5-codex";
+            readonly model: "openai/gpt-5.4-mini";
             readonly variant: "low";
         };
     };

package/dist/cli/types.d.ts

@@ -4,6 +4,7 @@ export interface InstallArgs {
     tmux?: BooleanArg;
     skills?: BooleanArg;
     dryRun?: boolean;
+    reset?: boolean;
 }
 export interface OpenCodeConfig {
     plugin?: string[];
@@ -16,6 +17,7 @@ export interface InstallConfig {
     installSkills: boolean;
     installCustomSkills: boolean;
     dryRun?: boolean;
+    reset: boolean;
 }
 export interface ConfigMergeResult {
     success: boolean;

package/dist/config/loader.d.ts

@@ -3,7 +3,8 @@ import { type PluginConfig } from './schema';
  * Load plugin configuration from user and project config files, merging them appropriately.
  *
  * Configuration is loaded from two locations:
- * 1. User config: ~/.config/opencode/oh-my-opencode-slim.jsonc or .json (or $XDG_CONFIG_HOME)
+ * 1. User config: $OPENCODE_CONFIG_DIR/oh-my-opencode-slim.jsonc or .json,
+ *    or ~/.config/opencode/oh-my-opencode-slim.jsonc or .json (or $XDG_CONFIG_HOME)
  * 2. Project config: <directory>/.opencode/oh-my-opencode-slim.jsonc or .json
  *
  * JSONC format is preferred over JSON (allows comments and trailing commas).

package/dist/config/schema.d.ts

@@ -109,6 +109,7 @@ export type BackgroundTaskConfig = z.infer<typeof BackgroundTaskConfigSchema>;
 export declare const FailoverConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     timeoutMs: z.ZodDefault<z.ZodNumber>;
+    retryDelayMs: z.ZodDefault<z.ZodNumber>;
     chains: z.ZodDefault<z.ZodObject<{
         orchestrator: z.ZodOptional<z.ZodArray<z.ZodString>>;
         oracle: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -121,6 +122,7 @@ export declare const FailoverConfigSchema: z.ZodObject<{
 export type FailoverConfig = z.infer<typeof FailoverConfigSchema>;
 export declare const PluginConfigSchema: z.ZodObject<{
     preset: z.ZodOptional<z.ZodString>;
+    setDefaultAgent: z.ZodOptional<z.ZodBoolean>;
     scoringEngineVersion: z.ZodOptional<z.ZodEnum<{
         v1: "v1";
         "v2-shadow": "v2-shadow";
@@ -203,6 +205,7 @@ export declare const PluginConfigSchema: z.ZodObject<{
     fallback: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         timeoutMs: z.ZodDefault<z.ZodNumber>;
+        retryDelayMs: z.ZodDefault<z.ZodNumber>;
         chains: z.ZodDefault<z.ZodObject<{
             orchestrator: z.ZodOptional<z.ZodArray<z.ZodString>>;
             oracle: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/dist/hooks/foreground-fallback/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Runtime model fallback for foreground (interactive) agent sessions.
+ *
+ * When OpenCode fires a session.error, message.updated, or session.status
+ * event containing a rate-limit signal, this manager:
+ *   1. Looks up the next untried model in the agent's configured chain
+ *   2. Aborts the rate-limited prompt via client.session.abort()
+ *   3. Re-queues the last user message via client.session.promptAsync()
+ *      with the new model — promptAsync returns immediately so we never
+ *      block the event handler waiting for a full LLM response.
+ *
+ * This mirrors the BackgroundTaskManager's fallback loop but operates
+ * reactively through the event system instead of wrapping prompt() in a
+ * try/catch, which is not possible for interactive (foreground) sessions.
+ */
+import type { PluginInput } from '@opencode-ai/plugin';
+type OpencodeClient = PluginInput['client'];
+export declare function isRateLimitError(error: unknown): boolean;
+/**
+ * Manages runtime model fallback for foreground agent sessions.
+ *
+ * Constructed at plugin init with the ordered fallback chains for each agent
+ * (built from _modelArray entries merged with fallback.chains config).
+ */
+export declare class ForegroundFallbackManager {
+    private readonly client;
+    /**
+     * Ordered fallback chains per agent.
+     * e.g. { orchestrator: ['anthropic/claude-opus-4-5', 'openai/gpt-4o'] }
+     * The first model that hasn't been tried yet is selected on each fallback.
+     */
+    private readonly chains;
+    private readonly enabled;
+    /** sessionID → last observed model string ("providerID/modelID") */
+    private readonly sessionModel;
+    /** sessionID → agent name (populated from message.updated info.agent field) */
+    private readonly sessionAgent;
+    /** sessionID → set of models already attempted this session */
+    private readonly sessionTried;
+    /** Sessions with an active fallback switch in flight */
+    private readonly inProgress;
+    /** sessionID → timestamp of last trigger (for deduplication) */
+    private readonly lastTrigger;
+    constructor(client: OpencodeClient, 
+    /**
+     * Ordered fallback chains per agent.
+     * e.g. { orchestrator: ['anthropic/claude-opus-4-5', 'openai/gpt-4o'] }
+     * The first model that hasn't been tried yet is selected on each fallback.
+     */
+    chains: Record<string, string[]>, enabled: boolean);
+    /**
+     * Process an OpenCode plugin event.
+     * Call this from the plugin's `event` hook for every event received.
+     */
+    handleEvent(rawEvent: unknown): Promise<void>;
+    private tryFallback;
+    /**
+     * Determine the fallback chain to use for a session.
+     *
+     * Priority:
+     * 1. Agent name known AND has a configured chain → return it directly
+     * 2. Agent name known but NO chain configured → return [] (no fallback;
+     *    do NOT bleed into other agents' chains which would re-prompt the
+     *    session with a model belonging to a completely different agent)
+     * 3. Agent name unknown, current model known → search all chains for
+     *    the model to infer which chain to use
+     * 4. Nothing matches → flatten all chains as a last resort (only
+     *    reached when both agent name and current model are unavailable)
+     */
+    private resolveChain;
+}
+export {};

package/dist/hooks/index.d.ts

@@ -2,6 +2,7 @@ export type { AutoUpdateCheckerOptions } from './auto-update-checker';
 export { createAutoUpdateCheckerHook } from './auto-update-checker';
 export { createChatHeadersHook } from './chat-headers';
 export { createDelegateTaskRetryHook } from './delegate-task-retry';
+export { ForegroundFallbackManager, isRateLimitError } from './foreground-fallback';
 export { createJsonErrorRecoveryHook } from './json-error-recovery';
 export { createPhaseReminderHook } from './phase-reminder';
 export { createPostReadNudgeHook } from './post-read-nudge';