feat(agent): unify models and validate OpenCode providers

Generate chat, task and learning models from agent-models.json.
Use WaterNetwork fast/expert models with 272k context and validate
upstream names before readiness. Add an isolated model check command
with signal-safe cleanup and plugin, Skill and MCP management docs.

Verified in isolation: type checks, 26 focused tests and both model
catalog checks; no model inference requests.

tests/runtime/opencode.test.ts

@@ -6,6 +6,7 @@ import { tmpdir } from "node:os";
 import { join } from "node:path";
 
 import { config } from "../../src/config.js";
+import { modelCheckTargets } from "../../src/runtime/model-check.js";
 import {
   OpencodeRuntimeAdapter,
   resolveEmbeddedOpencodePort,
@@ -141,7 +142,7 @@ describe("resolveEmbeddedOpencodePort", () => {
 
 describe("OpencodeRuntimeAdapter.warmup", () => {
   const toolIds = ["shell", "web_search", "geocode", "query_project_data", "final_answer", "locate_features", "zoom_to_map", "show_chart", "view_history", "session_search", "memory_manager", "skill_manager", "render_scada_analysis", "clear_scada_analysis", "get_operational_task_context", "query_operational_task_data", "publish_execution_plan", "publish_task_report", "propose_task_action", "add_task_human_evidence", "request_task_data_access", "todoread", "todowrite"];
-  async function createWarmupRuntime(missing: string[] = []) {
+  async function createWarmupRuntime(missing: string[] = [], invalidModel?: string) {
     const root = await mkdtemp(join(tmpdir(), "warmup-workspace-test-"));
     const previousRoot = config.CONVERSATION_WORKSPACE_ROOT;
     config.CONVERSATION_WORKSPACE_ROOT = root;
@@ -155,6 +156,14 @@ describe("OpencodeRuntimeAdapter.warmup", () => {
       },
       model: { list: async () => { calls.push("model.list"); return { data: [{ providerID, id, enabled: true, capabilities: { tools: true } }] }; } },
       rpc: { call: async (input: { method: string }) => {
+        if (input.method === "check_models") {
+          calls.push("model.check");
+          const targets = modelCheckTargets(config.MODEL_CONFIG).models;
+          return { output: {
+            models: targets.map((model) => ({ id: model.id, model_id: model.wire_id, status: model.id === invalidModel ? "not_advertised" : "valid" })),
+            providers: [...new Set(targets.map((model) => model.provider_id))].map((id) => ({ id, status: "checked" })),
+          } };
+        }
         if (input.method === "mcp") { calls.push("mcp.list"); return { output: { servers: [], configuration_errors: [] } }; }
         calls.push("tool.list");
         return { output: toolIds.filter((id) => !missing.includes(id)).map((id) => ({ id, direct: true, sandboxed: id === "shell", workspaceRoot: root })) };
@@ -166,13 +175,21 @@ describe("OpencodeRuntimeAdapter.warmup", () => {
   it("verifies business tools and model before reporting ready and removes the warmup session", async () => {
     const { runtime, calls, cleanup } = await createWarmupRuntime();
     try { await runtime.warmup();
-    expect(calls).toEqual(["health", "session.create", "tool.list", "mcp.list", "model.list", "session.remove"]); } finally { await cleanup(); }
+    expect(calls).toEqual(["health", "session.create", "tool.list", "mcp.list", "model.check", "model.list", "session.remove"]); } finally { await cleanup(); }
   });
   it("fails readiness if a business tool was lost and still cleans up", async () => {
     const { runtime, calls, cleanup } = await createWarmupRuntime(["render_scada_analysis"]);
     try { await expect(runtime.warmup()).rejects.toThrow("business tools missing: render_scada_analysis");
     expect(calls.at(-1)).toBe("session.remove"); } finally { await cleanup(); }
   });
+  it("rejects an invalid non-default model before readiness and cleans up the session", async () => {
+    const { runtime, calls, cleanup } = await createWarmupRuntime([], "waternetwork/gpt-6.1-sol");
+    try {
+      await expect(runtime.warmup()).rejects.toThrow("waternetwork/gpt-6.1-sol: not_advertised");
+      expect(calls).not.toContain("model.list");
+      expect(calls.at(-1)).toBe("session.remove");
+    } finally { await cleanup(); }
+  });
 });
 
 describe("conversation workspace binding", () => {