@hiai-gg/hiai-opencode 0.1.4 → 0.1.5

package/dist/internals/plugins/websearch-cited/index.d.ts

@@ -3,9 +3,15 @@ import type { GetAuth } from "./types";
 export declare const GOOGLE_PROVIDER_ID = "google";
 export declare const OPENAI_PROVIDER_ID = "openai";
 export declare const OPENROUTER_PROVIDER_ID = "openrouter";
+type SelectedProviderID = typeof GOOGLE_PROVIDER_ID | typeof OPENAI_PROVIDER_ID | typeof OPENROUTER_PROVIDER_ID;
 export declare function registerGetAuth(providerID: string, getAuth: GetAuth): void;
 export declare function resolveGetAuth(providerID: string): GetAuth | undefined;
-declare const WebsearchCitedPlugin: Plugin;
+type SelectedWebsearchConfig = {
+    providerID: SelectedProviderID;
+    model: string;
+};
+export type WebsearchCitedFallback = SelectedWebsearchConfig;
+declare const WebsearchCitedPlugin: (_ctx?: unknown, fallback?: WebsearchCitedFallback) => Promise<any>;
 export declare const WebsearchCitedGooglePlugin: Plugin;
 export declare const WebsearchCitedOpenAIPlugin: Plugin;
 export default WebsearchCitedPlugin;

package/dist/mcp/types.d.ts

@@ -3,10 +3,10 @@ export declare const McpNameSchema: z.ZodEnum<{
     websearch: "websearch";
     stitch: "stitch";
     firecrawl: "firecrawl";
+    context7: "context7";
     playwright: "playwright";
     "sequential-thinking": "sequential-thinking";
     rag: "rag";
-    context7: "context7";
     mempalace: "mempalace";
     grep_app: "grep_app";
 }>;

package/dist/plugin/tool-registry.d.ts

@@ -1,5 +1,6 @@
 import type { AvailableCategory } from "../agents/dynamic-agent-prompt-builder";
 import type { HiaiOpenCodeConfig } from "../config";
+import type { McpServerConfig } from "../config/types";
 import type { PluginContext, ToolsRecord } from "./types";
 import { builtinTools, createBackgroundTools, createCallOmoAgent, createLookAt, createSkillMcpTool, createSkillTool, createGrepTools, createGlobTools, createAstGrepTools, createSessionManagerTools, createDelegateTask, discoverCommandsSync, interactive_bash, createTaskCreateTool, createTaskGetTool, createTaskList, createTaskUpdateTool, createHashlineEditTool } from "../tools";
 import type { Managers } from "../create-managers";
@@ -35,6 +36,7 @@ export declare function createToolRegistry(args: {
     managers: Pick<Managers, "backgroundManager" | "tmuxSessionManager" | "skillMcpManager">;
     skillContext: SkillContext;
     availableCategories: AvailableCategory[];
+    builtinMcp?: Record<string, McpServerConfig>;
     interactiveBashEnabled?: boolean;
     toolFactories?: Partial<ToolRegistryFactories>;
 }): ToolRegistryResult;

package/dist/tools/skill-mcp/tools.d.ts

@@ -1,10 +1,12 @@
 import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { McpServerConfig } from "../../config/types";
 import type { SkillMcpManager } from "../../features/skill-mcp-manager";
 import type { LoadedSkill } from "../../features/opencode-skill-loader/types";
 interface SkillMcpToolOptions {
     manager: SkillMcpManager;
     getLoadedSkills: () => LoadedSkill[];
     getSessionID?: () => string | undefined;
+    builtinMcp?: Record<string, McpServerConfig>;
 }
 export declare function applyGrepFilter(output: string, pattern: string | undefined): string;
 export declare function createSkillMcpTool(options: SkillMcpToolOptions): ToolDefinition;

package/hiai-opencode.json

@@ -1,170 +1,69 @@
 {
-  "_description": "Canonical hiai-opencode runtime config. Copy this file to .opencode/hiai-opencode.json and edit it there. This file is the user-facing source of truth for agent models, category models, MCP switches, LSP defaults, skill discovery, service auth placeholders, and local helper defaults. Model provider credentials are configured in OpenCode Connect; this file stores model IDs only.",
+  "_description": "hiai-opencode user config. Edit only this file in your project as .opencode/hiai-opencode.json. Model provider credentials are configured in OpenCode Connect; this file stores model IDs only.",
   "$schema": "./config/hiai-opencode.schema.json",
-  "agents": {
+  "models": {
     "bob": {
-      "model": "openrouter/anthropic/claude-3.5-opus",
-      "description": "Primary orchestrator for end-to-end task execution, delegation, and high-level workflow control."
+      "model": "openrouter/moonshotai/kimi-k2.6",
+      "recommended": "xhigh"
     },
     "coder": {
-      "model": "openrouter/anthropic/claude-3.5-sonnet",
-      "description": "High-depth executor for multi-file implementation, substantial refactors, and technical delivery."
+      "model": "openrouter/minimax/minimax-m2.7",
+      "recommended": "high"
     },
     "strategist": {
-      "model": "openrouter/z-ai/glm-5.1",
-      "description": "Planning and architecture agent for decomposition, sequencing, and decision framing before execution."
+      "model": "openrouter/anthropic/claude-opus-latest",
+      "recommended": "high"
     },
     "guard": {
-      "model": "openrouter/openai/gpt-4o",
-      "description": "Execution supervisor that routes work, enforces discipline, and keeps delegated flows on track."
+      "model": "openrouter/qwen/qwen3.6-plus",
+      "recommended": "middle"
     },
     "critic": {
-      "model": "openrouter/qwen/qwen2.5-72b-instruct",
-      "description": "High-accuracy review gate for implementation quality, correctness, and plan validation."
+      "model": "openrouter/xiaomi/mimo-v2.5-pro",
+      "recommended": "high"
     },
     "designer": {
-      "model": "openrouter/google/gemini-3.1-pro",
-      "description": "Creative visual problem-solver for high-touch UI, interaction, and brand-level interface direction."
+      "model": "openrouter/google/gemini-3.1-pro-preview",
+      "recommended": "design"
     },
     "researcher": {
-      "model": "openrouter/google/gemini-2.0-flash",
-      "description": "Codebase exploration and external documentation research."
+      "model": "openrouter/deepseek/deepseek-v4-flash",
+      "recommended": "fast"
     },
-    "platform-manager": {
-      "model": "openrouter/google/gemini-2.0-flash",
-      "description": "Manager. Unified platform management agent for session continuity, project initialization, and orchestration."
+    "manager": {
+      "model": "openrouter/qwen/qwen3.5-9b",
+      "recommended": "fast"
     },
     "brainstormer": {
-      "model": "openrouter/google/gemini-2.0-flash",
-      "description": "Idea exploration agent for divergent thinking, option generation, and concept shaping before execution."
+      "model": "openrouter/mistralai/mistral-small-2603",
+      "recommended": "writing"
     },
-    "multimodal": {
-      "model": "openrouter/google/gemini-3.1-pro",
-      "description": "Vision. Multimodal analysis agent for images, PDFs, diagrams, and other non-text inputs."
-    },
-    "sub": {
-      "model": "openrouter/google/gemini-2.0-flash",
-      "description": "Hidden compatibility executor. Primary subtask execution is handled by Coder."
-    },
-    "quality-guardian": {
-      "model": "openrouter/anthropic/claude-3.5-sonnet",
-      "description": "Hidden compatibility review agent. Primary review work is handled by Critic."
-    },
-    "agent-skills": {
-      "model": "openrouter/google/gemini-2.0-flash",
-      "description": "Hidden system agent for skill registry, discovery, and capability orchestration."
+    "vision": {
+      "model": "openrouter/google/gemma-4-26b-a4b-it",
+      "recommended": "vision"
     }
   },
-  "agentRequirements": {},
-  "categories": {
-    "visual-engineering": {
-      "model": "openrouter/google/gemini-2.0-pro-exp-02-05",
-      "variant": "high",
-      "description": "Frontend and UI systems work with design-system discipline. Uses Coder deep execution contour."
-    },
-    "artistry": {
-      "model": "openrouter/google/gemini-2.0-pro-exp-02-05",
-      "variant": "high",
-      "description": "High-effort creative problem solving beyond standard patterns. Uses Coder deep execution contour."
-    },
-    "ultrabrain": {
-      "model": "openrouter/openai/gpt-4o",
-      "variant": "xhigh",
-      "description": "Hard logic and architecture tasks. Uses Coder deep execution contour."
-    },
-    "deep": {
-      "model": "openrouter/openai/o1",
-      "variant": "medium",
-      "description": "Deep autonomous implementation with full context buildup. Uses Coder deep execution contour."
-    },
-    "quick": {
-      "model": "openrouter/google/gemini-2.0-flash",
-      "description": "Fast bounded execution: single-file fixes, typos, and simple modifications. Uses Coder fast execution contour."
-    },
-    "writing": {
-      "model": "openrouter/kimi/kimi-latest",
-      "description": "Documentation and prose tasks with bounded scope. Uses Coder fast execution contour."
-    },
-    "git": {
-      "model": "openrouter/google/gemini-2.0-flash",
-      "description": "Git, commit, diff, and repository hygiene tasks."
-    },
-    "unspecified-low": {
-      "model": "openrouter/anthropic/claude-3.5-sonnet",
-      "description": "Unclassifiable moderate tasks with bounded scope. Uses Coder fast execution contour."
-    },
-    "unspecified-high": {
-      "model": "openrouter/anthropic/claude-3.5-opus",
-      "variant": "max",
-      "description": "Unclassifiable substantial tasks across modules. Uses Coder deep execution contour."
-    }
-  },
-  "categoryRequirements": {},
-  "modelFamilies": [],
   "auth": {
     "googleSearch": "{env:GOOGLE_SEARCH_API_KEY}",
     "stitch": "{env:STITCH_AI_API_KEY}",
     "firecrawl": "{env:FIRECRAWL_API_KEY}",
     "context7": "{env:CONTEXT7_API_KEY}"
   },
-  "ollama": {
-    "enabled": false,
-    "model": "{env:OLLAMA_MODEL:-qwen3.5:4b}",
-    "baseUrl": "{env:OLLAMA_BASE_URL:-http://localhost:11434}",
-    "purpose": "helper"
-  },
-  "fast_apply": {
-    "enabled": false,
-    "ollama_url": "{env:OLLAMA_BASE_URL:-http://localhost:11434}",
-    "model": "{env:OLLAMA_MODEL:-qwen3.5:4b}",
-    "timeout": 30000
-  },
   "mcp": {
-    "playwright": {
-      "enabled": true,
-      "command": ["node", "{pluginRoot}/assets/mcp/playwright.mjs"],
-      "timeout": 600000
-    },
-    "stitch": {
-      "enabled": true,
-      "type": "remote",
-      "url": "https://stitch.googleapis.com/mcp",
-      "headers": { "X-Goog-Api-Key": "{env:STITCH_AI_API_KEY}" },
-      "timeout": 600000
-    },
-    "sequential-thinking": {
-      "enabled": true,
-      "command": ["node", "{pluginRoot}/assets/runtime/npm-package-runner.mjs", "@modelcontextprotocol/server-sequential-thinking"],
-      "timeout": 600000
-    },
-    "firecrawl": {
-      "enabled": true,
-      "command": ["node", "{pluginRoot}/assets/runtime/npm-package-runner.mjs", "firecrawl-mcp"],
-      "environment": { "FIRECRAWL_API_KEY": "{env:FIRECRAWL_API_KEY}" },
-      "timeout": 600000
-    },
-    "rag": {
-      "enabled": true,
-      "type": "local",
-      "command": ["node", "{pluginRoot}/assets/mcp/rag.mjs"],
-      "environment": {
-        "OPENCODE_RAG_URL": "{env:OPENCODE_RAG_URL:-http://localhost:9002/tools/search}"
-      },
-      "timeout": 600000
-    },
-    "mempalace": {
-      "enabled": true,
-      "type": "local",
-      "command": ["node", "{pluginRoot}/assets/mcp/mempalace.mjs", "--palace", "./.opencode/palace"],
-      "timeout": 600000
-    },
-    "context7": {
-      "enabled": true,
-      "type": "remote",
-      "url": "https://mcp.context7.com/mcp",
-      "headers": { "X-API-KEY": "{env:CONTEXT7_API_KEY}" },
-      "timeout": 600000
-    }
+    "playwright": { "enabled": true },
+    "stitch": { "enabled": true },
+    "sequential-thinking": { "enabled": true },
+    "firecrawl": { "enabled": true },
+    "rag": { "enabled": true },
+    "mempalace": { "enabled": true },
+    "context7": { "enabled": true }
+  },
+  "lsp": {
+    "typescript": { "enabled": true },
+    "svelte": { "enabled": true },
+    "eslint": { "enabled": true },
+    "bash": { "enabled": true },
+    "pyright": { "enabled": true }
   },
   "skill_discovery": {
     "config_sources": true,
@@ -175,40 +74,7 @@
     "project_agents": false,
     "global_agents": false
   },
-  "skills": {
-    "enabled": true,
-    "disabled": []
-  },
-  "lsp": {
-    "typescript": {
-      "command": ["typescript-language-server", "--stdio"],
-      "extensions": [".ts", ".tsx", ".mts", ".cts"]
-    },
-    "svelte": {
-      "command": ["svelteserver", "--stdio"],
-      "extensions": [".svelte"]
-    },
-    "eslint": {
-      "command": ["node", "{pluginRoot}/assets/runtime/npm-package-runner.mjs", "eslint-lsp", "--stdio"],
-      "extensions": [".js", ".jsx", ".ts", ".tsx", ".mjs", ".cjs", ".svelte"]
-    },
-    "bash": {
-      "command": ["node", "{pluginRoot}/assets/runtime/npm-package-runner.mjs", "bash-language-server", "start"],
-      "extensions": [".sh", ".bash"]
-    },
-    "pyright": {
-      "command": ["pyright-langserver", "--stdio"],
-      "extensions": [".py"]
-    }
-  },
   "subtask2": {
-    "replace_generic": true,
-    "generic_return": null
-  },
-  "permissions": {
-    "read": { "*": "allow", "*.env": "deny", "*.env.*": "deny", "*.env.example": "allow" },
-    "edit": { "*": "allow" },
-    "bash": { "*": "allow" },
-    "deny_paths": ["**/backup/**", "**/secrets.*", "**/.env", "**/.env.*"]
+    "replace_generic": true
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hiai-gg/hiai-opencode",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Unified OpenCode plugin — canonical 12-agent model with bundled skills, MCP integrations, LSP, and permissions in one install.",
   "type": "module",
   "main": "dist/index.js",

package/src/config/defaults.ts

@@ -1,23 +1,61 @@
 /**
  * Runtime defaults for hiai-opencode.
  *
- * Model defaults are intentionally not defined in TypeScript.
- * The bundled hiai-opencode.json file is the single source of truth for:
- * - agent models
- * - category models
- * - user-editable runtime defaults
+ * The user-facing config owns model choice through 10 primary agent slots.
+ * Internal routing derives hidden agents and task categories from those slots.
  */
 import { existsSync, readFileSync } from "node:fs"
 import { dirname, join, normalize } from "node:path"
-import type { HiaiOpencodeConfig } from "./types.js"
+import { createDefaultMcpConfig } from "../mcp/registry.js"
+import type { HiaiOpencodeConfig, LspServerConfig } from "./types.js"
+
+const REQUIRED_MODEL_SLOTS = [
+  "bob",
+  "coder",
+  "strategist",
+  "guard",
+  "critic",
+  "designer",
+  "researcher",
+  "manager",
+  "brainstormer",
+  "vision",
+] as const
+
+type ModelSlot = (typeof REQUIRED_MODEL_SLOTS)[number]
+
+const DEFAULT_LSP: Record<string, LspServerConfig> = {
+  typescript: {
+    enabled: true,
+    command: ["typescript-language-server", "--stdio"],
+    extensions: [".ts", ".tsx", ".mts", ".cts"],
+  },
+  svelte: {
+    enabled: true,
+    command: ["svelteserver", "--stdio"],
+    extensions: [".svelte"],
+  },
+  eslint: {
+    enabled: true,
+    command: ["node", "{pluginRoot}/assets/runtime/npm-package-runner.mjs", "eslint-lsp", "--stdio"],
+    extensions: [".js", ".jsx", ".ts", ".tsx", ".mjs", ".cjs", ".svelte"],
+  },
+  bash: {
+    enabled: true,
+    command: ["node", "{pluginRoot}/assets/runtime/npm-package-runner.mjs", "bash-language-server", "start"],
+    extensions: [".sh", ".bash"],
+  },
+  pyright: {
+    enabled: true,
+    command: ["pyright-langserver", "--stdio"],
+    extensions: [".py"],
+  },
+}
 
 function findPluginRoot(): string {
   const candidates = [
-    // Source tree: src/config/defaults.ts -> repo root
     join(import.meta.dirname, "..", ".."),
-    // Built package: dist/index.js bundle -> package root
     join(import.meta.dirname, ".."),
-    // Non-bundled compiled output: dist/config/defaults.js -> package root
     join(import.meta.dirname, "..", ".."),
     dirname(process.argv[1] ?? ""),
     process.cwd(),
@@ -25,35 +63,122 @@ function findPluginRoot(): string {
 
   for (const candidate of candidates) {
     const root = normalize(candidate)
-    if (existsSync(join(root, "hiai-opencode.json"))) {
-      return root
-    }
+    if (existsSync(join(root, "hiai-opencode.json"))) return root
   }
 
-  throw new Error(
-    "[hiai-opencode] Cannot find bundled hiai-opencode.json. The package is incomplete.",
-  )
+  throw new Error("[hiai-opencode] Cannot find bundled hiai-opencode.json. The package is incomplete.")
 }
 
 function expandPluginRootPlaceholders(value: unknown, pluginRoot: string): unknown {
-  if (typeof value === "string") {
-    return value.replaceAll("{pluginRoot}", pluginRoot)
+  if (typeof value === "string") return value.replaceAll("{pluginRoot}", pluginRoot)
+  if (Array.isArray(value)) return value.map((item) => expandPluginRootPlaceholders(item, pluginRoot))
+  if (value && typeof value === "object") {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, entry]) => [key, expandPluginRootPlaceholders(entry, pluginRoot)]),
+    )
   }
+  return value
+}
 
-  if (Array.isArray(value)) {
-    return value.map((item) => expandPluginRootPlaceholders(item, pluginRoot))
+function requireModelSlots(config: HiaiOpencodeConfig): Record<ModelSlot, string> {
+  const models = config.models ?? {}
+  const resolved = Object.fromEntries(
+    REQUIRED_MODEL_SLOTS.map((slot) => {
+      const value = models[slot]
+      const model = typeof value === "string" ? value : value?.model
+      return [slot, model?.trim() ?? ""]
+    }),
+  ) as Record<ModelSlot, string>
+
+  const missing = REQUIRED_MODEL_SLOTS.filter((slot) => !resolved[slot])
+  if (missing.length > 0) {
+    throw new Error(`[hiai-opencode] Missing required model slot(s) in hiai-opencode.json: ${missing.join(", ")}`)
   }
+  return resolved
+}
 
-  if (value && typeof value === "object") {
-    return Object.fromEntries(
-      Object.entries(value).map(([key, entry]) => [
-        key,
-        expandPluginRootPlaceholders(entry, pluginRoot),
-      ]),
-    )
+function deriveAgents(models: Record<ModelSlot, string>): HiaiOpencodeConfig["agents"] {
+  return {
+    bob: { model: models.bob },
+    coder: { model: models.coder },
+    strategist: { model: models.strategist },
+    guard: { model: models.guard },
+    critic: { model: models.critic },
+    designer: { model: models.designer },
+    researcher: { model: models.researcher },
+    "platform-manager": { model: models.manager },
+    brainstormer: { model: models.brainstormer },
+    multimodal: { model: models.vision },
+    sub: { model: models.coder },
+    "quality-guardian": { model: models.critic },
+    "agent-skills": { model: models.manager },
   }
+}
 
-  return value
+function deriveCategories(models: Record<ModelSlot, string>): HiaiOpencodeConfig["categories"] {
+  return {
+    "visual-engineering": { model: models.designer, variant: "high" },
+    artistry: { model: models.designer, variant: "high" },
+    ultrabrain: { model: models.strategist, variant: "xhigh" },
+    deep: { model: models.coder, variant: "medium" },
+    quick: { model: models.researcher },
+    writing: { model: models.brainstormer },
+    git: { model: models.manager },
+    "unspecified-low": { model: models.coder },
+    "unspecified-high": { model: models.bob, variant: "max" },
+  }
+}
+
+function deriveMcp(config: HiaiOpencodeConfig): HiaiOpencodeConfig["mcp"] {
+  const defaults = createDefaultMcpConfig()
+  const userMcp = config.mcp ?? {}
+  return Object.fromEntries(
+    Object.entries(defaults).map(([name, entry]) => {
+      const override = userMcp[name] ?? {}
+      return [name, { ...entry, ...override }]
+    }),
+  )
+}
+
+function deriveLsp(config: HiaiOpencodeConfig): HiaiOpencodeConfig["lsp"] {
+  const userLsp = config.lsp ?? {}
+  return Object.fromEntries(
+    Object.entries(DEFAULT_LSP).map(([name, entry]) => {
+      const override = userLsp[name] ?? {}
+      return [name, { ...entry, ...override }]
+    }),
+  )
+}
+
+function materializeConfig(rawConfig: HiaiOpencodeConfig): HiaiOpencodeConfig {
+  const models = requireModelSlots(rawConfig)
+  return {
+    ...rawConfig,
+    agents: deriveAgents(models),
+    agentRequirements: {},
+    categories: deriveCategories(models),
+    categoryRequirements: {},
+    modelFamilies: [],
+    mcp: deriveMcp(rawConfig),
+    lsp: deriveLsp(rawConfig),
+    subtask2: {
+      replace_generic: true,
+      generic_return: null,
+      ...(rawConfig.subtask2 ?? {}),
+    },
+    skills: {
+      enabled: true,
+      disabled: [],
+      ...(rawConfig.skills ?? {}),
+    },
+    permissions: {
+      read: { "*": "allow", "*.env": "deny", "*.env.*": "deny", "*.env.example": "allow" },
+      edit: { "*": "allow" },
+      bash: { "*": "allow" },
+      deny_paths: ["**/backup/**", "**/secrets.*", "**/.env", "**/.env.*"],
+      ...(rawConfig.permissions ?? {}),
+    },
+  }
 }
 
 function loadBundledDefaultConfig(): HiaiOpencodeConfig {
@@ -61,8 +186,13 @@ function loadBundledDefaultConfig(): HiaiOpencodeConfig {
   const configPath = join(pluginRoot, "hiai-opencode.json")
   const raw = readFileSync(configPath, "utf-8")
   const parsed = JSON.parse(raw) as HiaiOpencodeConfig
+  const materialized = materializeConfig(parsed)
+
+  return expandPluginRootPlaceholders(materialized, pluginRoot) as HiaiOpencodeConfig
+}
 
-  return expandPluginRootPlaceholders(parsed, pluginRoot) as HiaiOpencodeConfig
+export function applyModelSlots(config: HiaiOpencodeConfig): HiaiOpencodeConfig {
+  return materializeConfig(config)
 }
 
 export const defaultConfig: HiaiOpencodeConfig = loadBundledDefaultConfig()

package/src/config/loader.test.ts

@@ -28,9 +28,23 @@ function withTempProject(
   }
 }
 
+const requiredModels = {
+  bob: { model: "openrouter/test/bob", recommended: "xhigh" },
+  coder: { model: "openrouter/test/coder", recommended: "high" },
+  strategist: { model: "openrouter/test/strategist", recommended: "high" },
+  guard: "openrouter/test/guard",
+  critic: "openrouter/test/critic",
+  designer: "openrouter/test/designer",
+  researcher: "openrouter/test/researcher",
+  manager: "openrouter/test/manager",
+  brainstormer: "openrouter/test/brainstormer",
+  vision: "openrouter/test/vision",
+};
+
 test("loadConfig accepts compact enabled-only LSP entries for builtin servers", () => {
   withTempProject(
     {
+      models: requiredModels,
       lsp: {
         typescript: {
           enabled: true,
@@ -42,7 +56,7 @@ test("loadConfig accepts compact enabled-only LSP entries for builtin servers",
       const tsServer = loaded.lsp?.typescript;
 
       expect(tsServer).toBeDefined();
-      expect(tsServer?.command.length).toBeGreaterThan(0);
+      expect(tsServer?.command?.length).toBeGreaterThan(0);
       expect(tsServer?.extensions).toContain(".ts");
     },
   );
@@ -51,6 +65,7 @@ test("loadConfig accepts compact enabled-only LSP entries for builtin servers",
 test("loadConfig ignores unknown compact enabled-only LSP entries", () => {
   withTempProject(
     {
+      models: requiredModels,
       lsp: {
         "custom-server": {
           enabled: true,

package/src/config/loader.ts

@@ -2,7 +2,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { parse } from "jsonc-parser";
 import { HiaiOpencodeConfigSchema } from "./platform-schema.js";
-import { defaultConfig } from "./defaults.js";
+import { applyModelSlots, defaultConfig } from "./defaults.js";
 import {
   LEGACY_AGENT_ALIAS_TO_CANONICAL,
   type CanonicalAgentName,
@@ -157,10 +157,12 @@ export function loadConfig(projectDir: string): HiaiOpencodeConfig {
   const validated = HiaiOpencodeConfigSchema.parse(normalizedParsed);
   const normalized = normalizeAgentAliases(validated);
 
-  return deepMerge(
+  const merged = deepMerge(
     BASE_CONFIG as unknown as Record<string, unknown>,
     normalized as unknown as Record<string, unknown>,
   ) as HiaiOpencodeConfig;
+
+  return applyModelSlots(merged);
 }
 
 export function resolveEnvVars(value: string): string {