@skj1724/oh-my-opencode 3.19.6 → 3.19.8

package/dist/cli/index.js

@@ -6117,6 +6117,12 @@ var init_model_resolver = __esm(() => {
   init_model_availability();
 });
 
+// src/shared/runtime-fallback.ts
+var init_runtime_fallback = __esm(() => {
+  init_model_availability();
+  init_model_requirements();
+});
+
 // src/shared/perf-timer.ts
 class PerfTimer {
   marks = new Map;
@@ -6226,6 +6232,7 @@ var init_shared = __esm(() => {
   init_model_requirements();
   init_model_resolver();
   init_model_availability();
+  init_runtime_fallback();
   init_perf_tracer();
   init_fileio_monitor();
   init_windows_reserved_names();
@@ -8460,7 +8467,7 @@ var import_picocolors2 = __toESM(require_picocolors(), 1);
 // package.json
 var package_default = {
   name: "@skj1724/oh-my-opencode",
-  version: "3.19.6",
+  version: "3.19.8",
   description: "The Best AI Agent Harness - Batteries-Included OpenCode Plugin with Multi-Model Orchestration, Parallel Background Agents, and Crafted LSP/AST Tools",
   main: "dist/index.js",
   types: "dist/index.d.ts",
@@ -24997,6 +25004,7 @@ var HookNameSchema = exports_external.enum([
   "auto-slash-command",
   "edit-error-recovery",
   "delegate-task-retry",
+  "runtime-fallback",
   "prometheus-md-only",
   "perf-profiler",
   "start-work",
@@ -25006,6 +25014,23 @@ var BuiltinCommandNameSchema = exports_external.enum([
   "init-deep",
   "start-work"
 ]);
+var ProviderModelStringSchema = exports_external.string().refine((value) => {
+  const separatorIndex = value.indexOf("/");
+  return separatorIndex > 0 && separatorIndex < value.length - 1;
+}, "Expected provider/model format");
+var NonEmptyStringSchema = exports_external.string().min(1);
+var FallbackModelEntrySchema = exports_external.union([
+  exports_external.object({
+    model: ProviderModelStringSchema,
+    variant: exports_external.string().optional()
+  }).strict(),
+  exports_external.object({
+    providerID: NonEmptyStringSchema,
+    modelID: NonEmptyStringSchema,
+    variant: exports_external.string().optional()
+  }).strict()
+]);
+var FallbackModelsSchema = exports_external.array(FallbackModelEntrySchema);
 var AgentOverrideConfigSchema = exports_external.object({
   model: exports_external.string().optional(),
   variant: exports_external.string().optional(),
@@ -25020,7 +25045,8 @@ var AgentOverrideConfigSchema = exports_external.object({
   description: exports_external.string().optional(),
   mode: exports_external.enum(["subagent", "primary", "all"]).optional(),
   color: exports_external.string().regex(/^#[0-9A-Fa-f]{6}$/).optional(),
-  permission: AgentPermissionSchema.optional()
+  permission: AgentPermissionSchema.optional(),
+  fallback_models: FallbackModelsSchema.optional()
 });
 var AgentOverridesSchema = exports_external.object({
   build: AgentOverrideConfigSchema.optional(),
@@ -25056,6 +25082,7 @@ var CategoryConfigSchema = exports_external.object({
   description: exports_external.string().optional(),
   model: exports_external.string().optional(),
   variant: exports_external.string().optional(),
+  fallback_models: FallbackModelsSchema.optional(),
   temperature: exports_external.number().min(0).max(2).optional(),
   top_p: exports_external.number().min(0).max(1).optional(),
   maxTokens: exports_external.number().optional(),
@@ -25183,6 +25210,15 @@ var GitMasterConfigSchema = exports_external.object({
   commit_footer: exports_external.boolean().default(true),
   include_co_authored_by: exports_external.boolean().default(true)
 });
+var RuntimeFallbackConfigSchema = exports_external.object({
+  enabled: exports_external.boolean().default(true),
+  max_attempts: exports_external.number().min(0).default(3),
+  initial_delay_ms: exports_external.number().min(0).default(2000),
+  backoff_factor: exports_external.number().min(1).default(2),
+  max_delay_ms: exports_external.number().min(0).default(30000),
+  respect_retry_after: exports_external.boolean().default(true),
+  jitter: exports_external.boolean().default(true)
+});
 var OhMyOpenCodeConfigSchema = exports_external.object({
   $schema: exports_external.string().optional(),
   disabled_mcps: exports_external.array(AnyMcpNameSchema).optional(),
@@ -25201,7 +25237,8 @@ var OhMyOpenCodeConfigSchema = exports_external.object({
   ralph_loop: RalphLoopConfigSchema.optional(),
   background_task: BackgroundTaskConfigSchema.optional(),
   notification: NotificationConfigSchema.optional(),
-  git_master: GitMasterConfigSchema.optional()
+  git_master: GitMasterConfigSchema.optional(),
+  runtime_fallback: RuntimeFallbackConfigSchema.optional()
 });
 // src/cli/doctor/checks/config.ts
 var USER_CONFIG_DIR2 = getOpenCodeConfigDir({ binary: "opencode" });

package/dist/config/index.d.ts

@@ -1,2 +1,2 @@
-export { OhMyOpenCodeConfigSchema, AgentOverrideConfigSchema, AgentOverridesSchema, McpNameSchema, AgentNameSchema, HookNameSchema, BuiltinCommandNameSchema, SisyphusAgentConfigSchema, ExperimentalConfigSchema, RalphLoopConfigSchema, } from "./schema";
-export type { OhMyOpenCodeConfig, AgentOverrideConfig, AgentOverrides, McpName, AgentName, HookName, BuiltinCommandName, SisyphusAgentConfig, ExperimentalConfig, DynamicContextPruningConfig, RalphLoopConfig, } from "./schema";
+export { OhMyOpenCodeConfigSchema, AgentOverrideConfigSchema, AgentOverridesSchema, McpNameSchema, AgentNameSchema, HookNameSchema, BuiltinCommandNameSchema, SisyphusAgentConfigSchema, ExperimentalConfigSchema, RalphLoopConfigSchema, FallbackModelEntrySchema, } from "./schema";
+export type { OhMyOpenCodeConfig, AgentOverrideConfig, AgentOverrides, McpName, AgentName, HookName, BuiltinCommandName, SisyphusAgentConfig, ExperimentalConfig, DynamicContextPruningConfig, RalphLoopConfig, RuntimeFallbackConfig, FallbackModelEntry, } from "./schema";

package/dist/config/schema.d.ts

@@ -70,6 +70,7 @@ export declare const HookNameSchema: z.ZodEnum<{
     "auto-slash-command": "auto-slash-command";
     "edit-error-recovery": "edit-error-recovery";
     "delegate-task-retry": "delegate-task-retry";
+    "runtime-fallback": "runtime-fallback";
     "prometheus-md-only": "prometheus-md-only";
     "perf-profiler": "perf-profiler";
     "start-work": "start-work";
@@ -78,6 +79,14 @@ export declare const BuiltinCommandNameSchema: z.ZodEnum<{
     "start-work": "start-work";
     "init-deep": "init-deep";
 }>;
+export declare const FallbackModelEntrySchema: z.ZodUnion<readonly [z.ZodObject<{
+    model: z.ZodString;
+    variant: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    providerID: z.ZodString;
+    modelID: z.ZodString;
+    variant: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>]>;
 export declare const AgentOverrideConfigSchema: z.ZodObject<{
     model: z.ZodOptional<z.ZodString>;
     variant: z.ZodOptional<z.ZodString>;
@@ -127,6 +136,14 @@ export declare const AgentOverrideConfigSchema: z.ZodObject<{
             ask: "ask";
         }>>;
     }, z.core.$strip>>;
+    fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        model: z.ZodString;
+        variant: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        providerID: z.ZodString;
+        modelID: z.ZodString;
+        variant: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>>>;
 }, z.core.$strip>;
 export declare const AgentOverridesSchema: z.ZodObject<{
     build: z.ZodOptional<z.ZodObject<{
@@ -178,6 +195,14 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 ask: "ask";
             }>>;
         }, z.core.$strip>>;
+        fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            model: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            providerID: z.ZodString;
+            modelID: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>>;
     }, z.core.$strip>>;
     plan: z.ZodOptional<z.ZodObject<{
         model: z.ZodOptional<z.ZodString>;
@@ -228,6 +253,14 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 ask: "ask";
             }>>;
         }, z.core.$strip>>;
+        fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            model: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            providerID: z.ZodString;
+            modelID: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>>;
     }, z.core.$strip>>;
     sisyphus: z.ZodOptional<z.ZodObject<{
         model: z.ZodOptional<z.ZodString>;
@@ -278,6 +311,14 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 ask: "ask";
             }>>;
         }, z.core.$strip>>;
+        fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            model: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            providerID: z.ZodString;
+            modelID: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>>;
     }, z.core.$strip>>;
     "sisyphus-junior": z.ZodOptional<z.ZodObject<{
         model: z.ZodOptional<z.ZodString>;
@@ -328,6 +369,14 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 ask: "ask";
             }>>;
         }, z.core.$strip>>;
+        fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            model: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            providerID: z.ZodString;
+            modelID: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>>;
     }, z.core.$strip>>;
     "OpenCode-Builder": z.ZodOptional<z.ZodObject<{
         model: z.ZodOptional<z.ZodString>;
@@ -378,6 +427,14 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 ask: "ask";
             }>>;
         }, z.core.$strip>>;
+        fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            model: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            providerID: z.ZodString;
+            modelID: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>>;
     }, z.core.$strip>>;
     prometheus: z.ZodOptional<z.ZodObject<{
         model: z.ZodOptional<z.ZodString>;
@@ -428,6 +485,14 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 ask: "ask";
             }>>;
         }, z.core.$strip>>;
+        fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            model: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            providerID: z.ZodString;
+            modelID: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>>;
     }, z.core.$strip>>;
     metis: z.ZodOptional<z.ZodObject<{
         model: z.ZodOptional<z.ZodString>;
@@ -478,6 +543,14 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 ask: "ask";
             }>>;
         }, z.core.$strip>>;
+        fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            model: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            providerID: z.ZodString;
+            modelID: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>>;
     }, z.core.$strip>>;
     momus: z.ZodOptional<z.ZodObject<{
         model: z.ZodOptional<z.ZodString>;
@@ -528,6 +601,14 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 ask: "ask";
             }>>;
         }, z.core.$strip>>;
+        fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            model: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            providerID: z.ZodString;
+            modelID: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>>;
     }, z.core.$strip>>;
     oracle: z.ZodOptional<z.ZodObject<{
         model: z.ZodOptional<z.ZodString>;
@@ -578,6 +659,14 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 ask: "ask";
             }>>;
         }, z.core.$strip>>;
+        fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            model: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            providerID: z.ZodString;
+            modelID: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>>;
     }, z.core.$strip>>;
     librarian: z.ZodOptional<z.ZodObject<{
         model: z.ZodOptional<z.ZodString>;
@@ -628,6 +717,14 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 ask: "ask";
             }>>;
         }, z.core.$strip>>;
+        fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            model: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            providerID: z.ZodString;
+            modelID: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>>;
     }, z.core.$strip>>;
     explore: z.ZodOptional<z.ZodObject<{
         model: z.ZodOptional<z.ZodString>;
@@ -678,6 +775,14 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 ask: "ask";
             }>>;
         }, z.core.$strip>>;
+        fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            model: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            providerID: z.ZodString;
+            modelID: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>>;
     }, z.core.$strip>>;
     "multimodal-looker": z.ZodOptional<z.ZodObject<{
         model: z.ZodOptional<z.ZodString>;
@@ -728,6 +833,14 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 ask: "ask";
             }>>;
         }, z.core.$strip>>;
+        fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            model: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            providerID: z.ZodString;
+            modelID: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>>;
     }, z.core.$strip>>;
     atlas: z.ZodOptional<z.ZodObject<{
         model: z.ZodOptional<z.ZodString>;
@@ -778,6 +891,14 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 ask: "ask";
             }>>;
         }, z.core.$strip>>;
+        fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            model: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            providerID: z.ZodString;
+            modelID: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const ClaudeCodeConfigSchema: z.ZodObject<{
@@ -799,6 +920,14 @@ export declare const CategoryConfigSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     model: z.ZodOptional<z.ZodString>;
     variant: z.ZodOptional<z.ZodString>;
+    fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        model: z.ZodString;
+        variant: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        providerID: z.ZodString;
+        modelID: z.ZodString;
+        variant: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>>>;
     temperature: z.ZodOptional<z.ZodNumber>;
     top_p: z.ZodOptional<z.ZodNumber>;
     maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -837,6 +966,14 @@ export declare const CategoriesConfigSchema: z.ZodRecord<z.ZodString, z.ZodObjec
     description: z.ZodOptional<z.ZodString>;
     model: z.ZodOptional<z.ZodString>;
     variant: z.ZodOptional<z.ZodString>;
+    fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        model: z.ZodString;
+        variant: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        providerID: z.ZodString;
+        modelID: z.ZodString;
+        variant: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>>>;
     temperature: z.ZodOptional<z.ZodNumber>;
     top_p: z.ZodOptional<z.ZodNumber>;
     maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -1016,6 +1153,15 @@ export declare const GitMasterConfigSchema: z.ZodObject<{
     commit_footer: z.ZodDefault<z.ZodBoolean>;
     include_co_authored_by: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
+export declare const RuntimeFallbackConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    max_attempts: z.ZodDefault<z.ZodNumber>;
+    initial_delay_ms: z.ZodDefault<z.ZodNumber>;
+    backoff_factor: z.ZodDefault<z.ZodNumber>;
+    max_delay_ms: z.ZodDefault<z.ZodNumber>;
+    respect_retry_after: z.ZodDefault<z.ZodBoolean>;
+    jitter: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
 export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
     $schema: z.ZodOptional<z.ZodString>;
     disabled_mcps: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -1064,6 +1210,7 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
         "auto-slash-command": "auto-slash-command";
         "edit-error-recovery": "edit-error-recovery";
         "delegate-task-retry": "delegate-task-retry";
+        "runtime-fallback": "runtime-fallback";
         "prometheus-md-only": "prometheus-md-only";
         "perf-profiler": "perf-profiler";
         "start-work": "start-work";
@@ -1122,6 +1269,14 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     ask: "ask";
                 }>>;
             }, z.core.$strip>>;
+            fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                model: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                providerID: z.ZodString;
+                modelID: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>>;
         }, z.core.$strip>>;
         plan: z.ZodOptional<z.ZodObject<{
             model: z.ZodOptional<z.ZodString>;
@@ -1172,6 +1327,14 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     ask: "ask";
                 }>>;
             }, z.core.$strip>>;
+            fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                model: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                providerID: z.ZodString;
+                modelID: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>>;
         }, z.core.$strip>>;
         sisyphus: z.ZodOptional<z.ZodObject<{
             model: z.ZodOptional<z.ZodString>;
@@ -1222,6 +1385,14 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     ask: "ask";
                 }>>;
             }, z.core.$strip>>;
+            fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                model: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                providerID: z.ZodString;
+                modelID: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>>;
         }, z.core.$strip>>;
         "sisyphus-junior": z.ZodOptional<z.ZodObject<{
             model: z.ZodOptional<z.ZodString>;
@@ -1272,6 +1443,14 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     ask: "ask";
                 }>>;
             }, z.core.$strip>>;
+            fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                model: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                providerID: z.ZodString;
+                modelID: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>>;
         }, z.core.$strip>>;
         "OpenCode-Builder": z.ZodOptional<z.ZodObject<{
             model: z.ZodOptional<z.ZodString>;
@@ -1322,6 +1501,14 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     ask: "ask";
                 }>>;
             }, z.core.$strip>>;
+            fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                model: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                providerID: z.ZodString;
+                modelID: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>>;
         }, z.core.$strip>>;
         prometheus: z.ZodOptional<z.ZodObject<{
             model: z.ZodOptional<z.ZodString>;
@@ -1372,6 +1559,14 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     ask: "ask";
                 }>>;
             }, z.core.$strip>>;
+            fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                model: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                providerID: z.ZodString;
+                modelID: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>>;
         }, z.core.$strip>>;
         metis: z.ZodOptional<z.ZodObject<{
             model: z.ZodOptional<z.ZodString>;
@@ -1422,6 +1617,14 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     ask: "ask";
                 }>>;
             }, z.core.$strip>>;
+            fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                model: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                providerID: z.ZodString;
+                modelID: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>>;
         }, z.core.$strip>>;
         momus: z.ZodOptional<z.ZodObject<{
             model: z.ZodOptional<z.ZodString>;
@@ -1472,6 +1675,14 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     ask: "ask";
                 }>>;
             }, z.core.$strip>>;
+            fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                model: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                providerID: z.ZodString;
+                modelID: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>>;
         }, z.core.$strip>>;
         oracle: z.ZodOptional<z.ZodObject<{
             model: z.ZodOptional<z.ZodString>;
@@ -1522,6 +1733,14 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     ask: "ask";
                 }>>;
             }, z.core.$strip>>;
+            fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                model: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                providerID: z.ZodString;
+                modelID: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>>;
         }, z.core.$strip>>;
         librarian: z.ZodOptional<z.ZodObject<{
             model: z.ZodOptional<z.ZodString>;
@@ -1572,6 +1791,14 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     ask: "ask";
                 }>>;
             }, z.core.$strip>>;
+            fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                model: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                providerID: z.ZodString;
+                modelID: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>>;
         }, z.core.$strip>>;
         explore: z.ZodOptional<z.ZodObject<{
             model: z.ZodOptional<z.ZodString>;
@@ -1622,6 +1849,14 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     ask: "ask";
                 }>>;
             }, z.core.$strip>>;
+            fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                model: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                providerID: z.ZodString;
+                modelID: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>>;
         }, z.core.$strip>>;
         "multimodal-looker": z.ZodOptional<z.ZodObject<{
             model: z.ZodOptional<z.ZodString>;
@@ -1672,6 +1907,14 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     ask: "ask";
                 }>>;
             }, z.core.$strip>>;
+            fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                model: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                providerID: z.ZodString;
+                modelID: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>>;
         }, z.core.$strip>>;
         atlas: z.ZodOptional<z.ZodObject<{
             model: z.ZodOptional<z.ZodString>;
@@ -1722,12 +1965,28 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     ask: "ask";
                 }>>;
             }, z.core.$strip>>;
+            fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                model: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                providerID: z.ZodString;
+                modelID: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     categories: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
         variant: z.ZodOptional<z.ZodString>;
+        fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            model: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            providerID: z.ZodString;
+            modelID: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>>;
         temperature: z.ZodOptional<z.ZodNumber>;
         top_p: z.ZodOptional<z.ZodNumber>;
         maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -1855,6 +2114,15 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
         commit_footer: z.ZodDefault<z.ZodBoolean>;
         include_co_authored_by: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
+    runtime_fallback: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        max_attempts: z.ZodDefault<z.ZodNumber>;
+        initial_delay_ms: z.ZodDefault<z.ZodNumber>;
+        backoff_factor: z.ZodDefault<z.ZodNumber>;
+        max_delay_ms: z.ZodDefault<z.ZodNumber>;
+        respect_retry_after: z.ZodDefault<z.ZodBoolean>;
+        jitter: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type OhMyOpenCodeConfig = z.infer<typeof OhMyOpenCodeConfigSchema>;
 export type AgentOverrideConfig = z.infer<typeof AgentOverrideConfigSchema>;
@@ -1877,4 +2145,6 @@ export type CategoryConfig = z.infer<typeof CategoryConfigSchema>;
 export type CategoriesConfig = z.infer<typeof CategoriesConfigSchema>;
 export type BuiltinCategoryName = z.infer<typeof BuiltinCategoryNameSchema>;
 export type GitMasterConfig = z.infer<typeof GitMasterConfigSchema>;
+export type RuntimeFallbackConfig = z.infer<typeof RuntimeFallbackConfigSchema>;
+export type FallbackModelEntry = z.infer<typeof FallbackModelEntrySchema>;
 export { AnyMcpNameSchema, type AnyMcpName, McpNameSchema, type McpName } from "../mcp/types";

package/dist/features/background-agent/manager.d.ts

@@ -1,7 +1,7 @@
 import type { PluginInput } from "@opencode-ai/plugin";
 import type { BackgroundTask, LaunchInput, ResumeInput } from "./types";
 import type { PerfTracer } from "../../shared/perf-tracer";
-import type { BackgroundTaskConfig } from "../../config/schema";
+import type { BackgroundTaskConfig, RuntimeFallbackConfig } from "../../config/schema";
 interface EventProperties {
     sessionID?: string;
     info?: {
@@ -13,6 +13,9 @@ interface Event {
     type: string;
     properties?: EventProperties;
 }
+type BackgroundManagerConfig = BackgroundTaskConfig & {
+    runtimeFallback?: RuntimeFallbackConfig;
+};
 export declare class BackgroundManager {
     private static cleanupManagers;
     private static cleanupRegistered;
@@ -30,11 +33,12 @@ export declare class BackgroundManager {
     private perfTracer?;
     private queuesByKey;
     private processingKeys;
-    constructor(ctx: PluginInput, config?: BackgroundTaskConfig);
+    constructor(ctx: PluginInput, config?: BackgroundManagerConfig);
     setPerfTracer(tracer: PerfTracer): void;
     launch(input: LaunchInput): Promise<BackgroundTask>;
     private processKey;
     private startTask;
+    private handlePromptFailure;
     getTask(id: string): BackgroundTask | undefined;
     getTasksByParentSession(sessionID: string): BackgroundTask[];
     getAllDescendantTasks(sessionID: string): BackgroundTask[];

package/dist/features/background-agent/types.d.ts

@@ -1,3 +1,5 @@
+import type { FallbackAttempt } from "../../shared/runtime-fallback";
+export type { FallbackAttempt };
 export type BackgroundTaskStatus = "pending" | "running" | "completed" | "error" | "cancelled";
 export interface PhaseTiming {
     /** queuedAt -> startedAt in ms */
@@ -53,6 +55,7 @@ export interface BackgroundTask {
     concurrencyGroup?: string;
     /** Parent session's agent name for notification */
     parentAgent?: string;
+    category?: string;
     /** Last message count for stability detection */
     lastMsgCount?: number;
     /** Number of consecutive polls with stable message count */
@@ -65,6 +68,8 @@ export interface BackgroundTask {
     maxRuntimeMs?: number;
     /** Max duration of a single step in ms (0 / undefined = unlimited) */
     stepTimeoutMs?: number;
+    /** Fallback attempts history */
+    attempts?: FallbackAttempt[];
 }
 export interface LaunchInput {
     description: string;
@@ -77,6 +82,7 @@ export interface LaunchInput {
         modelID: string;
     };
     parentAgent?: string;
+    category?: string;
     model?: {
         providerID: string;
         modelID: string;