fix(opencode): Detect managed v2 installation

src/drivers/opencode/driver.ts

@@ -1,12 +1,25 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
 import { detectBinary, runCommandWithTimeout } from "../helpers.js";
 import type { AgentInstallation, StartOptions } from "../../core/driver.js";
 import type { AgentCapabilities } from "../../core/capabilities.js";
 import type { ListModelsOptions, ModelInfo, ProviderModels } from "../../core/models.js";
 import { createRuntimeHooks, SessionDriver } from "../session-driver.js";
 import { parseOpencodeLine } from "./parser.js";
 
+function opencodeV2BinaryPath(homeDir: string = os.homedir()): string {
+  return path.join(homeDir, ".opencode", "bin", "opencode");
+}
+
+function resolveOpencodeCommand(homeDir: string = os.homedir()): string {
+  const localBin = opencodeV2BinaryPath(homeDir);
+  return fs.existsSync(localBin) ? localBin : "opencode";
+}
+
 export class OpencodeDriver extends SessionDriver {
   readonly id = "opencode" as const;
+  private detectedPath?: string;
 
   protected readonly hooks = createRuntimeHooks({
     parse: parseOpencodeLine,
@@ -16,6 +29,10 @@ export class OpencodeDriver extends SessionDriver {
 
   protected readonly resumeError = "No native session id for Opencode resume";
 
+  protected override getCommand(): string {
+    return this.detectedPath ?? resolveOpencodeCommand();
+  }
+
   protected buildArgs(options: StartOptions): string[] {
     const args: string[] = ["run", "--format", "json"];
     if (options.model) args.push("--model", options.model);
@@ -40,8 +57,16 @@ export class OpencodeDriver extends SessionDriver {
   }
 
   async detect(): Promise<AgentInstallation> {
-    const res = await detectBinary("opencode");
-    if (!res.installed) return { installed: false, error: "opencode binary not found" };
+    let res = await detectBinary("opencode");
+    if (!res.installed) {
+      const localBin = opencodeV2BinaryPath();
+      if (fs.existsSync(localBin)) res = await detectBinary(localBin);
+    }
+    if (!res.installed || !res.path) {
+      this.detectedPath = undefined;
+      return { installed: false, error: "opencode binary not found" };
+    }
+    this.detectedPath = res.path;
     return { installed: true, path: res.path, version: res.version, details: "opencode run --format json" };
   }
 
@@ -92,4 +117,3 @@ export class OpencodeDriver extends SessionDriver {
     }
   }
 }
-

tests/opencode-driver.test.ts

@@ -0,0 +1,49 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+
+vi.mock("../src/drivers/helpers.js", async (importOriginal) => {
+  const mod = await importOriginal<typeof import("../src/drivers/helpers.js")>();
+  return { ...mod, detectBinary: vi.fn() };
+});
+
+import { OpencodeDriver } from "../src/drivers/opencode/driver.js";
+import { detectBinary } from "../src/drivers/helpers.js";
+
+const mockedDetect = vi.mocked(detectBinary);
+
+afterEach(() => {
+  vi.clearAllMocks();
+  vi.unstubAllEnvs();
+});
+
+describe("OpencodeDriver", () => {
+  it("detects and launches the managed OpenCode v2 binary when PATH is stale", async () => {
+    const home = fs.mkdtempSync(path.join(os.tmpdir(), "codedeck-opencode-"));
+    const binary = path.join(home, ".opencode", "bin", "opencode");
+    fs.mkdirSync(path.dirname(binary), { recursive: true });
+    fs.writeFileSync(binary, "");
+    vi.stubEnv("HOME", home);
+
+    mockedDetect
+      .mockResolvedValueOnce({ installed: false })
+      .mockResolvedValueOnce({ installed: true, path: binary, version: "opencode v2.0.12" });
+
+    try {
+      const driver = new OpencodeDriver();
+
+      expect((driver as any).getCommand()).toBe(binary);
+      await expect(driver.detect()).resolves.toMatchObject({
+        installed: true,
+        path: binary,
+        version: "opencode v2.0.12",
+      });
+      expect(mockedDetect).toHaveBeenNthCalledWith(1, "opencode");
+      expect(mockedDetect).toHaveBeenNthCalledWith(2, binary);
+      expect((driver as any).getCommand()).toBe(binary);
+    } finally {
+      fs.rmSync(home, { recursive: true, force: true });
+    }
+  });
+});