opencode-models-manager 0.1.0 → 0.2.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Felipe Gutiérrez
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+MIT License
+
+Copyright (c) 2026 Felipe Gutiérrez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.

package/README.md

@@ -19,13 +19,13 @@ This repo was created to provide a simple solution for managing AI models for ev
 
 ## Installation
 
-This branch is the OpenCode v1 line and requires OpenCode 1.18.0 or later. Pin 0.1.0 explicitly so a future v2 release on the latest dist-tag is never installed into a v1 host:
+The `main` branch is the OpenCode v1 line and requires OpenCode 1.18.0 or later. It is not compatible with OpenCode v2.
 
 ```
-opencode plugin opencode-model-manager@0.1.0
+opencode plugin opencode-models-manager@0.1.1
 ```
 
-Once the opencode-v1 dist-tag is published, `opencode-model-manager@opencode-v1` resolves to this line and can replace the pinned version above.
+For OpenCode v2, use the `v2` branch until the 2.x package release is published.
 
 Restart OpenCode after installation.
 
@@ -35,7 +35,7 @@ Add to `~/.config/opencode/opencode.json` (global) or `opencode.json` (project):
 
 ```json
 {
-  "plugin": ["opencode-model-manager@0.1.0"]
+  "plugin": ["opencode-models-manager@0.1.1"]
 }
 ```
 
@@ -55,13 +55,32 @@ Create `.opencode/models.json` in the project root:
 
 ```json
 {
-  "chat": "opencode-go/deepseek-v4.1-flash",
-  "chat2": "opencode-go/mimo-v2.6-flash"
+  "agent": {
+    "chat": "opencode-go/deepseek-v4.1-flash",
+    "chat2": "opencode-go/mimo-v2.6-flash"
+  },
+  "commands": {
+    "document": "opencode-go/deepseek-v4.1-flash",
+    "document2": "opencode-go/mimo-v2.6-flash"
+  }
 }
 ```
 
-Each key is an agent name and each value is a `provider/model` reference. The plugin merges the model into that agent's existing configuration, so prompts, permissions, and other settings are preserved.
+The `agent` section targets agents in `.opencode/agent` and the `commands` section targets commands in `.opencode/commands`. The plugin merges the model into each existing configuration, so prompts, permissions, frontmatter, and other settings are preserved. A flat map such as `{ "chat": "provider/model" }` is still supported and applies to agents.
 
 Invalid entries are logged and skipped. Restart OpenCode after changing `models.json` so the config hook runs again.
 
-Actually Opencode v1 is supported.
+## OpenCode v2
+
+OpenCode v2 requires a default plugin definition object. The v2 implementation lives on the [`v2`](https://github.com/RainingDaemons/opencode-models-manager/tree/v2) branch and is versioned as `0.2.0`.
+
+Use the v2 configuration key (`plugins`, plural):
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugins": ["opencode-models-manager@0.2.0"]
+}
+```
+
+Agent models in `.opencode/models.json` are supported. OpenCode v2 currently exposes an add-only command transform API, so it cannot update models on commands that were loaded from `.opencode/commands`; command entries are logged and skipped.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-models-manager",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "description": "OpenCode plugin — manage agent models from a single JSON file",
   "author": "RainingDaemons",
@@ -22,7 +22,7 @@
     "model-manager"
   ],
   "engines": {
-    "opencode": ">=1.18.0"
+    "opencode": ">=2.0.0"
   },
   "main": "./src/models.ts",
   "exports": {
@@ -34,11 +34,13 @@
     "!test",
     "!test/**"
   ],
-  "dependencies": {
-    "@opencode-ai/plugin": "^1.18.1"
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^6.0.0"
   },
   "scripts": {
     "test": "node --test test/models.test.ts",
+    "typecheck": "tsc --noEmit",
     "logo": "node script/logo.mjs"
   }
 }

package/src/models.ts

@@ -1,9 +1,18 @@
 import { readFileSync } from "node:fs"
 import path from "node:path"
-import type { Plugin } from "@opencode-ai/plugin"
 
 const CONFIG_FILE = path.join(".opencode", "models.json")
 
+type Section = "agent" | "command"
+type Models = Record<Section, Record<string, string>>
+
+const SECTIONS: Record<string, Section> = {
+  agent: "agent",
+  agents: "agent",
+  command: "command",
+  commands: "command",
+}
+
 function isRecord(value: unknown): value is Record<string, unknown> {
   return typeof value === "object" && value !== null && !Array.isArray(value)
 }
@@ -13,7 +22,41 @@ function isModelRef(value: string): boolean {
   return slash > 0 && slash < value.length - 1
 }
 
-function loadModels(file: string): Record<string, string> | null {
+function isEntryName(name: string): boolean {
+  return name.trim() !== ""
+}
+
+function parseModelRef(value: string): { providerID: string; id: string } {
+  const separator = value.indexOf("/")
+  return {
+    providerID: value.slice(0, separator),
+    id: value.slice(separator + 1),
+  }
+}
+
+function loadSection(
+  file: string,
+  section: Section,
+  value: Record<string, unknown>
+): Record<string, string> {
+  const models: Record<string, string> = {}
+  for (const [name, model] of Object.entries(value)) {
+    if (!isEntryName(name)) {
+      console.error(`[model-manager] ${file} ${section}s contains an empty name`)
+      continue
+    }
+    if (typeof model !== "string" || !isModelRef(model)) {
+      console.error(
+        `[model-manager] ${file} "${section}.${name}" must be "provider/model", got ${JSON.stringify(model)}`
+      )
+      continue
+    }
+    models[name] = model
+  }
+  return models
+}
+
+export function loadModels(file: string): Models | null {
   let raw: string
   try {
     raw = readFileSync(file, "utf8")
@@ -34,34 +77,66 @@ function loadModels(file: string): Record<string, string> | null {
     return null
   }
 
-  const models: Record<string, string> = {}
-  for (const [name, value] of Object.entries(parsed)) {
-    if (name.trim() === "") {
-      console.error(`[model-manager] ${file} contains an empty agent name`)
+  const models: Models = { agent: {}, command: {} }
+  for (const [key, value] of Object.entries(parsed)) {
+    if (typeof value === "string") {
+      if (!isEntryName(key)) {
+        console.error(`[model-manager] ${file} contains an empty agent name`)
+        continue
+      }
+      if (!isModelRef(value)) {
+        console.error(
+          `[model-manager] ${file} "${key}" must be "provider/model", got ${JSON.stringify(value)}`
+        )
+        continue
+      }
+      models.agent[key] = value
       continue
     }
-    if (typeof value !== "string" || !isModelRef(value)) {
-      console.error(
-        `[model-manager] "${name}" must be "provider/model", got ${JSON.stringify(value)}`
-      )
+
+    const section = Object.hasOwn(SECTIONS, key) ? SECTIONS[key] : undefined
+    if (!section) {
+      console.error(`[model-manager] ${file} has unknown key "${key}"`)
       continue
     }
-    models[name] = value
+    if (!isRecord(value)) {
+      console.error(`[model-manager] ${file} "${key}" must be a JSON object`)
+      continue
+    }
+    Object.assign(models[section], loadSection(file, section, value))
   }
 
   return models
 }
 
-export default (async ({ directory, worktree }) => ({
-  config: async (cfg) => {
-    const root = worktree || directory
-    const models = loadModels(path.join(root, CONFIG_FILE)) ??
-      (root === directory ? null : loadModels(path.join(directory, CONFIG_FILE)))
+/**
+ * OpenCode v2 setup plugin.
+ *
+ * This intentionally has no package imports beyond Node built-ins: OpenCode
+ * 2.0 resolves local and package plugins independently of its own SDK modules.
+ */
+export default {
+  id: "opencode-models-manager",
+  async setup(ctx: any) {
+    const file = path.join(process.cwd(), CONFIG_FILE)
+    const models = loadModels(file)
     if (!models) return
 
-    cfg.agent ??= {}
-    for (const [name, model] of Object.entries(models)) {
-      cfg.agent[name] = { ...cfg.agent[name], model }
+    if (Object.keys(models.agent).length > 0) {
+      await ctx.agent.transform((editor: any) => {
+        for (const [name, model] of Object.entries(models.agent)) {
+          editor.update(name, (agent: any) => {
+            agent.model = parseModelRef(model)
+          })
+        }
+      })
+      await ctx.agent.reload()
+    }
+
+    if (Object.keys(models.command).length > 0) {
+      console.error(
+        `[model-manager] ${file} contains command models, but OpenCode v2 does not support updating existing command definitions; those entries were skipped`
+      )
     }
   },
-})) satisfies Plugin
+}