oc-blackbytes 0.4.0 → 0.5.0

package/README.md

@@ -97,11 +97,11 @@ Create `oc-blackbytes.jsonc` in the OpenCode config directory. For the full conf
 | `disabled_tools` | `string[]` | `[]` | Prevents bundled tools from being registered. |
 | `mcp_env_alllowlist` | `string[]` | `[]` | Recognized by the schema for MCP environment filtering workflows. |
 | `hashline_edit` | `boolean` | `true` | Enables the `hashline_edit` tool and `tool.execute.after` hashline post-processing for `read`/`write`. |
-| `model_fallback` | `boolean` | `false` | Enables model fallback resolution: discovers connected providers at init and resolves fallback chains when a preferred model's provider is unavailable. |
+| `model_fallback` | `boolean` | `true` | Enables model fallback resolution: discovers connected providers at init and resolves fallback chains when a preferred model's provider is unavailable. Set to `false` to disable. |
 | `auto_update` | `boolean` | `false` | Recognized by the schema for maintenance workflows. |
 | `websearch.provider` | `"exa" \| "tavily"` | `"exa"` | Selects the built-in `websearch` MCP backend. |
 | `agents` | `Record<string, AgentModelConfig>` | `{}` | Per-agent model configuration overrides. See [Per-agent model configuration](#per-agent-model-configuration). |
-| `fallback_models` | `string \| (string \| FallbackModelObject)[]` | — | Global fallback model chain. When `model_fallback: true` and an agent's primary model is unavailable, the plugin walks this chain and uses the first model whose provider is connected. |
+| `fallback_models` | `string \| (string \| FallbackModelObject)[]` | — | Global fallback model chain. When an agent's primary model is unavailable, the plugin walks this chain and uses the first model whose provider is connected. |
 | `_migrations` | `string[]` | `[]` | Internal migration bookkeeping. |
 
 ## Built-in agents
@@ -150,7 +150,7 @@ Each agent model config supports:
 | `model` | `string` | Model identifier (e.g., `"openai/gpt-5.4"`). Drives prompt variant selection and, for subagents, sets the model hint. |
 | `reasoningEffort` | `string` | Override reasoning effort level for OpenAI reasoning models (`"low"`, `"medium"`, `"high"`). |
 | `temperature` | `number` | Override temperature for the agent. |
-| `fallback_models` | `string \| (string \| object)[]` | Per-agent fallback chain — tried before the global `fallback_models` when the primary model's provider is unavailable. Requires `model_fallback: true`. |
+| `fallback_models` | `string \| (string \| object)[]` | Per-agent fallback chain — tried before the global `fallback_models` when the primary model's provider is unavailable. |
 
 When a `model` is specified for a subagent, the factory selects the appropriate prompt variant for that model family (Claude, GPT, or Gemini). The primary agent (`bytes`) uses the model hint for prompt selection only — the actual model is determined by the OpenCode UI selection. For recommended models per agent, see [docs/configuration.md](docs/configuration.md).
 

package/dist/index.js

@@ -2339,14 +2339,19 @@ async function discoverAvailableModels(client) {
     return new Map;
   }
 }
-function isModelAvailable(modelRef, availableModels) {
+function resolveModelRef(modelRef, availableModels) {
   if (availableModels.size === 0)
-    return true;
+    return modelRef;
   const slashIdx = modelRef.indexOf("/");
   if (slashIdx === -1)
-    return true;
+    return modelRef;
   const providerId = modelRef.substring(0, slashIdx);
-  return availableModels.has(providerId);
+  const modelId = modelRef.substring(slashIdx + 1);
+  const providerModels = availableModels.get(providerId);
+  if (!providerModels)
+    return;
+  const matchedModel = prefixMatchModel(modelId, providerModels);
+  return matchedModel ? `${providerId}/${matchedModel}` : undefined;
 }
 function prefixMatchModel(modelPrefix, providerModels) {
   if (providerModels.has(modelPrefix))
@@ -2387,9 +2392,10 @@ function walkFallbackChain(fallbacks, availableModels) {
   const chain = typeof fallbacks === "string" ? [fallbacks] : fallbacks;
   for (const entry of chain) {
     const modelRef = typeof entry === "string" ? entry : entry.model;
-    if (isModelAvailable(modelRef, availableModels)) {
-      return typeof entry === "string" ? { model: entry, fromFallback: true } : {
-        model: entry.model,
+    const resolvedModel = resolveModelRef(modelRef, availableModels);
+    if (resolvedModel) {
+      return typeof entry === "string" ? { model: resolvedModel, fromFallback: true } : {
+        model: resolvedModel,
         fromFallback: true,
         reasoningEffort: entry.reasoningEffort,
         temperature: entry.temperature
@@ -2429,9 +2435,10 @@ function resolveAgentModel(agentName, agentConfig, globalFallbacks, availableMod
     }
     return { model: "", fromFallback: false };
   }
-  if (isModelAvailable(primaryModel, availableModels)) {
-    log(`  [model-resolver] ${agentName}: using primary model ${primaryModel}`);
-    return { model: primaryModel, fromFallback: false };
+  const resolvedPrimaryModel = resolveModelRef(primaryModel, availableModels);
+  if (resolvedPrimaryModel) {
+    log(`  [model-resolver] ${agentName}: using primary model ${resolvedPrimaryModel}`);
+    return { model: resolvedPrimaryModel, fromFallback: false };
   }
   log(`  [model-resolver] ${agentName}: primary model ${primaryModel} not available, trying fallbacks...`);
   const perAgentResolved = walkFallbackChain(agentConfig?.fallback_models, availableModels);
@@ -31440,7 +31447,7 @@ function loadPluginConfig(_input) {
 // src/index.ts
 var BlackbytesPlugin = async (ctx) => {
   const pluginConfig = loadPluginConfig(ctx);
-  const availableModels = pluginConfig.model_fallback ? await discoverAvailableModels(ctx.client) : new Map;
+  const availableModels = pluginConfig.model_fallback !== false ? await discoverAvailableModels(ctx.client) : new Map;
   return createOpenCodePlugin({ input: ctx, pluginConfig, availableModels });
 };
 var src_default = BlackbytesPlugin;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oc-blackbytes",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "An OpenCode plugin tailored to streamline my everyday workflow.",
   "type": "module",
   "main": "./dist/index.js",