@hiai-gg/hiai-opencode 0.1.4 → 0.1.5

package/AGENTS.md

@@ -213,6 +213,8 @@ The runtime loader is:
 
 - [src/config/defaults.ts](src/config/defaults.ts)
 
+Users configure only the 10 primary agent model slots under `models`: `bob`, `coder`, `strategist`, `guard`, `critic`, `designer`, `researcher`, `manager`, `brainstormer`, and `vision`.
+Hidden agents and task categories are derived internally in `src/config/defaults.ts`.
 Use fully qualified model IDs. Do not introduce local aliases like `hiai-fast`, `sonnet`, `fast`, or `high`.
 
 ## Change Map
@@ -221,9 +223,9 @@ Use this table when you need to change something and want the right file immedia
 
 | Goal | Edit this first | Why |
 |---|---|---|
-| Change which default model an agent uses | [hiai-opencode.json](hiai-opencode.json) | This is the canonical model source |
-| Change which default model a category uses | [hiai-opencode.json](hiai-opencode.json) | Categories are assigned there |
-| Change MCP/LSP/user-facing defaults | [hiai-opencode.json](hiai-opencode.json) | The runtime loader reads this file |
+| Change a user-facing default model slot | [hiai-opencode.json](hiai-opencode.json) | This is the canonical model source |
+| Change how categories inherit the 10 model slots | [src/config/defaults.ts](src/config/defaults.ts) | Category routing is internal |
+| Change MCP/LSP user-facing switches | [hiai-opencode.json](hiai-opencode.json) | Users only toggle enabled state there |
 | Change Bob behavior or prompt text | [src/agents/bob.ts](src/agents/bob.ts), `src/agents/bob/*` | Bob prompt authoring lives there |
 | Change Coder behavior or prompt text | `src/agents/coder/*` | Coder prompt authoring lives there |
 | Change Strategist behavior or prompt text | `src/agents/strategist/*` | Strategist prompt authoring lives there |

package/ARCHITECTURE.md

@@ -62,20 +62,20 @@ Runtime naming, visibility, and compatibility are normalized through:
 
 ### Presets
 
-Agent and category model IDs live in one place:
+User-facing model IDs live in one place:
 
 - [hiai-opencode.json](hiai-opencode.json)
 
 ### Runtime Defaults
 
-The TypeScript defaults loader only reads the bundled canonical config:
+The TypeScript defaults loader derives hidden agents and categories from the 10 user-facing model slots:
 
 - [src/config/defaults.ts](src/config/defaults.ts)
 
-This is the runtime source of truth for:
+This is the internal routing source for:
 
-- agent models
-- category models
+- hidden agent model inheritance
+- category model inheritance
 - MCP defaults
 - LSP defaults
 - permissions
@@ -158,7 +158,8 @@ If a prompt change looks correct in source but does not show up correctly in Ope
 
 Use these rules when editing the prompt layer:
 
-- change `hiai-opencode.json` when any default model assignment should change
+- change `hiai-opencode.json` when any primary agent model slot should change
+- change `src/config/defaults.ts` when internal category-to-agent-slot routing should change
 - change `src/agents/*` when the prompt content or behavior should change
 - change shared prompt/injection files when the prompt is being appended or normalized after agent construction
 - change `src/plugin-handlers/agent-config-handler.ts` when runtime name, visibility, mode, or final description should change

package/README.md

@@ -116,10 +116,22 @@ New-Item -ItemType Directory -Force .opencode
 Copy-Item .\hiai-opencode.json .\.opencode\hiai-opencode.json
 ```
 
-If you installed only from npm/OpenCode and do not have this repository checked out, create `.opencode/hiai-opencode.json` with the service block below and adjust it later.
+If you installed only from npm/OpenCode and do not have this repository checked out, create `.opencode/hiai-opencode.json` with the shape below and adjust it later.
 
 ```json
 {
+  "models": {
+    "bob": { "model": "openrouter/anthropic/claude-3.5-opus", "recommended": "xhigh" },
+    "coder": { "model": "openrouter/anthropic/claude-3.5-sonnet", "recommended": "high" },
+    "strategist": { "model": "openrouter/z-ai/glm-5.1", "recommended": "high" },
+    "guard": { "model": "openrouter/openai/gpt-4o", "recommended": "middle" },
+    "critic": { "model": "openrouter/qwen/qwen2.5-72b-instruct", "recommended": "high" },
+    "designer": { "model": "openrouter/google/gemini-3.1-pro", "recommended": "design" },
+    "researcher": { "model": "openrouter/google/gemini-2.0-flash", "recommended": "fast" },
+    "manager": { "model": "openrouter/google/gemini-2.0-flash", "recommended": "fast" },
+    "brainstormer": { "model": "openrouter/kimi/kimi-latest", "recommended": "writing" },
+    "vision": { "model": "openrouter/google/gemini-3.1-pro", "recommended": "vision" }
+  },
   "mcp": {
     "playwright": { "enabled": true },
     "sequential-thinking": { "enabled": true },
@@ -137,7 +149,7 @@ By default, skill discovery is deterministic: `hiai-opencode` skills plus projec
 ### 3. Connect models and add service keys
 
 Model provider credentials belong to OpenCode Connect, not to `hiai-opencode`.
-This plugin only writes model IDs such as `openrouter/anthropic/claude-3.5-sonnet` into agent and category config.
+This plugin only reads the 10 model IDs in `models`. Internal routing derives hidden agents and task categories from those 10 choices.
 
 Use OpenCode Connect to authorize the providers behind your configured model IDs. Then add only the service keys for MCP or search integrations you actually use:
 
@@ -216,7 +228,7 @@ If a dependency is missing, install only user-level or project-local dependencie
 
 ### Models
 
-Canonical runtime defaults for agents, categories, MCP, LSP, and model IDs:
+Canonical user-facing config for 10 primary agent models, MCP/LSP switches, service auth placeholders, and skill discovery:
 
 - [hiai-opencode.json](hiai-opencode.json)
 
@@ -224,7 +236,7 @@ Runtime loader for the bundled canonical config:
 
 - [src/config/defaults.ts](src/config/defaults.ts)
 
-If you want to change which model a specific agent or category uses by default, edit `hiai-opencode.json`.
+If you want to change model selection, edit the 10 entries in `models`. Do not add category-specific model choices unless you are intentionally developing the plugin internals.
 
 Use fully qualified model IDs. Do not introduce local aliases like `hiai-fast`, `sonnet`, `fast`, or `high`.
 

package/config/hiai-opencode.schema.json

@@ -1,131 +1,75 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "hiai-opencode Configuration",
-  "description": "Unified configuration for hiai-opencode plugin",
+  "description": "User-facing hiai-opencode config. Users choose 10 primary agent models, service auth placeholders, and enable/disable MCP/LSP integrations. Internal routing derives hidden agents and task categories from these model slots.",
   "type": "object",
   "properties": {
     "$schema": { "type": "string" },
-    "agents": {
+    "models": {
       "type": "object",
-      "additionalProperties": {
-        "type": "object",
-        "properties": {
-          "model": { "type": "string" },
-          "description": { "type": "string" }
-        },
-        "required": ["model"]
-      }
-    },
-    "agentRequirements": {
-      "type": "object",
-      "additionalProperties": {
-        "type": "object",
-        "properties": {
-          "fallbackChain": {
-            "type": "array",
-            "items": { "$ref": "#/definitions/fallbackEntry" }
-          },
-          "variant": { "type": "string" },
-          "requiresModel": { "type": "string" },
-          "requiresAnyModel": { "type": "boolean" },
-          "requiresProvider": { "type": "array", "items": { "type": "string" } }
-        },
-        "required": ["fallbackChain"]
-      }
-    },
-    "categories": {
-      "type": "object",
-      "additionalProperties": {
-        "type": "object",
-        "properties": {
-          "model": { "type": "string" },
-          "variant": { "type": "string" },
-          "description": { "type": "string" },
-          "fallbackChain": {
-            "type": "array",
-            "items": { "$ref": "#/definitions/fallbackEntry" }
-          }
-        },
-        "required": ["model"]
-      }
+      "description": "The only user-facing model source of truth. Use fully qualified OpenCode model IDs.",
+      "properties": {
+        "bob": { "$ref": "#/definitions/modelSlot" },
+        "coder": { "$ref": "#/definitions/modelSlot" },
+        "strategist": { "$ref": "#/definitions/modelSlot" },
+        "guard": { "$ref": "#/definitions/modelSlot" },
+        "critic": { "$ref": "#/definitions/modelSlot" },
+        "designer": { "$ref": "#/definitions/modelSlot" },
+        "researcher": { "$ref": "#/definitions/modelSlot" },
+        "manager": { "$ref": "#/definitions/modelSlot" },
+        "brainstormer": { "$ref": "#/definitions/modelSlot" },
+        "vision": { "$ref": "#/definitions/modelSlot" }
+      },
+      "required": [
+        "bob",
+        "coder",
+        "strategist",
+        "guard",
+        "critic",
+        "designer",
+        "researcher",
+        "manager",
+        "brainstormer",
+        "vision"
+      ]
     },
-    "categoryRequirements": {
+    "auth": {
       "type": "object",
-      "additionalProperties": {
-        "type": "object",
-        "properties": {
-          "fallbackChain": {
-            "type": "array",
-            "items": { "$ref": "#/definitions/fallbackEntry" }
-          },
-          "variant": { "type": "string" },
-          "requiresModel": { "type": "string" },
-          "requiresAnyModel": { "type": "boolean" },
-          "requiresProvider": { "type": "array", "items": { "type": "string" } }
-        },
-        "required": ["fallbackChain"]
-      }
-    },
-    "modelFamilies": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "family": { "type": "string" },
-          "includes": { "type": "array", "items": { "type": "string" } },
-          "pattern": { "type": "string" },
-          "variants": { "type": "array", "items": { "type": "string" } },
-          "reasoningEfforts": { "type": "array", "items": { "type": "string" } },
-          "supportsThinking": { "type": "boolean" }
-        },
-        "required": ["family"]
+      "additionalProperties": { "type": "string" },
+      "properties": {
+        "googleSearch": { "type": "string" },
+        "stitch": { "type": "string" },
+        "firecrawl": { "type": "string" },
+        "context7": { "type": "string" }
       }
     },
     "mcp": {
       "type": "object",
-      "additionalProperties": {
-        "type": "object",
-        "properties": {
-          "enabled": { "type": "boolean", "default": true },
-          "type": { "enum": ["remote", "local"] },
-          "url": { "type": "string" },
-          "headers": { "type": "object", "additionalProperties": { "type": "string" } },
-          "command": { "type": "array", "items": { "type": "string" } },
-          "timeout": { "type": "number" },
-          "environment": { "type": "object", "additionalProperties": { "type": "string" } }
-        },
-        "required": ["enabled"]
-      }
-    },
-    "lsp": {
-      "type": "object",
-      "additionalProperties": {
-        "type": "object",
-        "properties": {
-          "command": { "type": "array", "items": { "type": "string" } },
-          "extensions": { "type": "array", "items": { "type": "string" } },
-          "initialization": { "type": "object" }
-        },
-        "required": ["command", "extensions"]
-      }
-    },
-    "subtask2": {
-      "type": "object",
+      "additionalProperties": false,
       "properties": {
-        "replace_generic": { "type": "boolean" },
-        "generic_return": { "type": ["string", "null"] }
+        "playwright": { "$ref": "#/definitions/toggle" },
+        "stitch": { "$ref": "#/definitions/toggle" },
+        "sequential-thinking": { "$ref": "#/definitions/toggle" },
+        "firecrawl": { "$ref": "#/definitions/toggle" },
+        "rag": { "$ref": "#/definitions/toggle" },
+        "mempalace": { "$ref": "#/definitions/toggle" },
+        "context7": { "$ref": "#/definitions/toggle" }
       }
     },
-    "skills": {
+    "lsp": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
-        "enabled": { "type": "boolean", "default": true },
-        "disabled": { "type": "array", "items": { "type": "string" } }
+        "typescript": { "$ref": "#/definitions/toggle" },
+        "svelte": { "$ref": "#/definitions/toggle" },
+        "eslint": { "$ref": "#/definitions/toggle" },
+        "bash": { "$ref": "#/definitions/toggle" },
+        "pyright": { "$ref": "#/definitions/toggle" }
       }
     },
     "skill_discovery": {
       "type": "object",
-      "description": "Controls which external skill directories are scanned. Defaults keep installs deterministic: hiai-opencode skills plus project .opencode/skills only.",
+      "description": "Controls external skill folder scanning. Defaults keep installs deterministic.",
       "properties": {
         "config_sources": { "type": "boolean", "default": true },
         "project_opencode": { "type": "boolean", "default": true },
@@ -136,59 +80,38 @@
         "global_agents": { "type": "boolean", "default": false }
       }
     },
-    "permissions": {
-      "type": "object",
-      "properties": {
-        "read": { "type": "object", "additionalProperties": { "type": "string" } },
-        "edit": { "type": "object", "additionalProperties": { "type": "string" } },
-        "bash": { "type": "object", "additionalProperties": { "type": "string" } },
-        "deny_paths": { "type": "array", "items": { "type": "string" } }
-      }
-    },
-    "auth": {
-      "type": "object",
-      "additionalProperties": { "type": "string" }
-    },
-    "ollama": {
-      "type": "object",
-      "properties": {
-        "enabled": { "type": "boolean", "default": false },
-        "model": { "type": "string" },
-        "baseUrl": { "type": "string" },
-        "purpose": { "enum": ["verification", "helper", "fallback"] }
-      }
-    },
-    "fast_apply": {
+    "subtask2": {
       "type": "object",
       "properties": {
-        "enabled": { "type": "boolean", "default": false },
-        "ollama_url": { "type": "string" },
-        "model": { "type": "string" },
-        "timeout": { "type": "number" }
+        "replace_generic": { "type": "boolean" }
       }
     }
   },
+  "required": ["models"],
   "definitions": {
-    "fallbackEntry": {
-      "type": "object",
-      "properties": {
-        "providers": { "type": "array", "items": { "type": "string" } },
-        "model": { "type": "string" },
-        "variant": { "type": "string" },
-        "reasoningEffort": { "type": "string" },
-        "temperature": { "type": "number" },
-        "top_p": { "type": "number" },
-        "maxTokens": { "type": "number" },
-        "thinking": {
+    "modelSlot": {
+      "oneOf": [
+        { "type": "string" },
+        {
           "type": "object",
           "properties": {
-            "type": { "enum": ["enabled", "disabled"] },
-            "budgetTokens": { "type": "number" }
+            "model": { "type": "string" },
+            "recommended": {
+              "enum": ["xhigh", "high", "middle", "fast", "vision", "writing", "design"]
+            }
           },
-          "required": ["type"]
+          "required": ["model"],
+          "additionalProperties": false
         }
+      ]
+    },
+    "toggle": {
+      "type": "object",
+      "properties": {
+        "enabled": { "type": "boolean", "default": true }
       },
-      "required": ["providers", "model"]
+      "required": ["enabled"],
+      "additionalProperties": false
     }
   }
 }

package/dist/config/defaults.d.ts

@@ -1,2 +1,3 @@
 import type { HiaiOpencodeConfig } from "./types.js";
+export declare function applyModelSlots(config: HiaiOpencodeConfig): HiaiOpencodeConfig;
 export declare const defaultConfig: HiaiOpencodeConfig;