claude-opencode-mcp 1.0.0

package/dist/opencode/agents.js

@@ -0,0 +1,239 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { parse as parseYaml } from "yaml";
+import { BridgeError } from "../errors.js";
+import { buildPermissions, PROFILE_CAPABILITIES, profileForAgent, } from "../security/policy.js";
+export const BUILTIN_AGENT_NAMES = [
+    "deepseek-researcher",
+    "deepseek-reviewer",
+    "deepseek-coder",
+    "deepseek-tester",
+];
+const PROFILE_BY_NAME = {
+    "deepseek-researcher": "read",
+    "deepseek-reviewer": "review",
+    "deepseek-coder": "code",
+    "deepseek-tester": "test",
+};
+export function packageRoot() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    // src/opencode/ -> package root; dist/opencode/ -> package root
+    return path.resolve(here, "..", "..");
+}
+export function builtinAgentsDir() {
+    return path.join(packageRoot(), "agents");
+}
+export function parseAgentMarkdown(contents, file) {
+    const normalized = contents.replace(/\r\n/g, "\n");
+    if (!normalized.startsWith("---\n")) {
+        return { frontmatter: {}, body: normalized.trim(), file };
+    }
+    const end = normalized.indexOf("\n---", 4);
+    if (end === -1) {
+        return { frontmatter: {}, body: normalized.trim(), file };
+    }
+    const header = normalized.slice(4, end);
+    const body = normalized
+        .slice(end + 4)
+        .replace(/^\n+/, "")
+        .trim();
+    let frontmatter = {};
+    try {
+        const parsed = parseYaml(header);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            frontmatter = parsed;
+        }
+    }
+    catch (error) {
+        throw new BridgeError("CONFIG_INVALID", `Invalid agent frontmatter in ${file}`, {
+            details: { file, reason: error instanceof Error ? error.message : String(error) },
+            cause: error,
+        });
+    }
+    return { frontmatter, body, file };
+}
+function normalizeMode(value) {
+    return value === "primary" || value === "subagent" || value === "all" ? value : "all";
+}
+const VALID_PROFILES = new Set(["read", "review", "code", "test"]);
+function frontmatterProfile(frontmatter) {
+    return typeof frontmatter.profile === "string" && VALID_PROFILES.has(frontmatter.profile)
+        ? frontmatter.profile
+        : undefined;
+}
+async function readAgentFile(file, name) {
+    const contents = await fs.promises.readFile(file, "utf8");
+    const { frontmatter, body } = parseAgentMarkdown(contents, file);
+    return {
+        name,
+        description: typeof frontmatter.description === "string" && frontmatter.description.trim()
+            ? frontmatter.description.trim()
+            : `Delegated agent ${name}`,
+        mode: normalizeMode(frontmatter.mode),
+        prompt: body,
+        permission: {},
+        model: typeof frontmatter.model === "string" ? frontmatter.model : null,
+        ...(typeof frontmatter.temperature === "number"
+            ? { temperature: frontmatter.temperature }
+            : {}),
+        source: "builtin",
+    };
+}
+export async function loadBuiltinAgentDefinitions() {
+    const dir = builtinAgentsDir();
+    const definitions = [];
+    for (const name of BUILTIN_AGENT_NAMES) {
+        const file = path.join(dir, `${name}.md`);
+        try {
+            const definition = await readAgentFile(file, name);
+            definitions.push(definition);
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                throw new BridgeError("CONFIG_INVALID", `Built-in agent definition is missing: ${file}. Reinstall claude-opencode-mcp.`, { details: { file }, cause: error });
+            }
+            throw error;
+        }
+    }
+    return definitions;
+}
+export async function loadProjectAgentDefinitions(cwd) {
+    const dir = path.join(cwd, ".claude-opencode", "agents");
+    let entries;
+    try {
+        entries = await fs.promises.readdir(dir);
+    }
+    catch {
+        return [];
+    }
+    const definitions = [];
+    for (const entry of entries) {
+        if (!entry.endsWith(".md"))
+            continue;
+        const name = entry.slice(0, -3);
+        const file = path.join(dir, entry);
+        const contents = await fs.promises.readFile(file, "utf8");
+        const { frontmatter, body } = parseAgentMarkdown(contents, file);
+        definitions.push({
+            name,
+            description: typeof frontmatter.description === "string" && frontmatter.description.trim()
+                ? frontmatter.description.trim()
+                : `Project agent ${name}`,
+            mode: normalizeMode(frontmatter.mode),
+            prompt: body,
+            permission: {},
+            model: typeof frontmatter.model === "string" ? frontmatter.model : null,
+            ...(typeof frontmatter.temperature === "number"
+                ? { temperature: frontmatter.temperature }
+                : {}),
+            ...(frontmatterProfile(frontmatter) ? { profile: frontmatterProfile(frontmatter) } : {}),
+            source: "project",
+        });
+    }
+    return definitions;
+}
+function profileForDefinition(definition) {
+    const byName = PROFILE_BY_NAME[definition.name];
+    if (byName)
+        return byName;
+    if (definition.profile)
+        return definition.profile;
+    if (/coder|editor|implement/i.test(definition.name))
+        return "code";
+    if (/test/i.test(definition.name))
+        return "test";
+    if (/review|audit/i.test(definition.name))
+        return "review";
+    return "read";
+}
+export function buildAgentDefinitions(input) {
+    const { builtin, project, config } = input;
+    const byName = new Map();
+    for (const definition of builtin)
+        byName.set(definition.name, { ...definition });
+    for (const definition of project) {
+        const existing = byName.get(definition.name);
+        if (existing) {
+            byName.set(definition.name, {
+                ...existing,
+                description: definition.description,
+                prompt: definition.prompt,
+                mode: definition.mode,
+                model: definition.model ?? existing.model,
+                ...(definition.temperature !== undefined ? { temperature: definition.temperature } : {}),
+                source: "project",
+            });
+        }
+        else {
+            byName.set(definition.name, { ...definition });
+        }
+    }
+    for (const [name, override] of Object.entries(config.agents)) {
+        if (override.enabled === false) {
+            byName.delete(name);
+            continue;
+        }
+        const existing = byName.get(name);
+        const base = existing ?? {
+            name,
+            description: override.description ?? `Delegated agent ${name}`,
+            mode: "all",
+            prompt: override.prompt ?? "You are a delegated software engineering agent.",
+            permission: {},
+            model: null,
+            source: "project",
+        };
+        byName.set(name, {
+            ...base,
+            ...(override.description !== undefined ? { description: override.description } : {}),
+            ...(override.prompt !== undefined ? { prompt: override.prompt } : {}),
+            ...(override.model !== undefined ? { model: override.model } : {}),
+            ...(override.temperature !== undefined ? { temperature: override.temperature } : {}),
+            ...(override.profile !== undefined ? { profile: override.profile } : {}),
+        });
+    }
+    return [...byName.values()];
+}
+export function agentProfile(definition) {
+    return definition.profile ?? profileForDefinition(definition);
+}
+export function agentCapabilities(definition) {
+    return PROFILE_CAPABILITIES[agentProfile(definition)];
+}
+export function agentPermissions(definition, config) {
+    return buildPermissions(agentProfile(definition), config.security);
+}
+export function toOpenCodeAgentConfig(definitions, config) {
+    const result = {};
+    for (const definition of definitions) {
+        const model = definition.model ?? config.defaults.model ?? null;
+        result[definition.name] = {
+            description: definition.description,
+            mode: definition.mode,
+            prompt: definition.prompt,
+            permission: agentPermissions(definition, config),
+            ...(model ? { model: normalizeModel(model, config) } : {}),
+            ...(definition.temperature !== undefined ? { temperature: definition.temperature } : {}),
+        };
+    }
+    return result;
+}
+export function normalizeModel(model, config) {
+    const trimmed = model.trim();
+    if (!trimmed)
+        return trimmed;
+    if (trimmed.includes("/"))
+        return trimmed;
+    return `${config.defaults.provider}/${trimmed}`;
+}
+export function findAgentDefinition(definitions, name) {
+    return definitions.find((definition) => definition.name === name) ?? null;
+}
+export function isBuiltinAgent(name) {
+    return BUILTIN_AGENT_NAMES.includes(name);
+}
+export function fallbackProfileForUnknownAgent(name) {
+    return profileForAgent(name) ?? PROFILE_BY_NAME[name] ?? null;
+}
+//# sourceMappingURL=agents.js.map

package/dist/opencode/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/opencode/agents.ts"],"names":[],"mappings":"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"}

package/dist/opencode/binary.d.ts

@@ -0,0 +1,19 @@
+export interface ResolvedBinary {
+    command: string;
+    version: string;
+    source: string;
+}
+export interface ResolveBinaryOptions {
+    configured?: string | null;
+    env?: NodeJS.ProcessEnv;
+}
+export declare function resolveOpenCodeBinary(options?: ResolveBinaryOptions): Promise<ResolvedBinary>;
+/** Cached binary resolution so we only probe the filesystem once per process. */
+export declare class BinaryResolver {
+    private readonly options;
+    private cached;
+    private cachedKey;
+    constructor(options?: ResolveBinaryOptions);
+    resolve(configured?: string | null, force?: boolean): Promise<ResolvedBinary>;
+    invalidate(): void;
+}

package/dist/opencode/binary.js

@@ -0,0 +1,129 @@
+import { execFile } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { BridgeError } from "../errors.js";
+import { packageRoot } from "./agents.js";
+function executableNames() {
+    return process.platform === "win32" ? ["opencode.cmd", "opencode.exe", "opencode"] : ["opencode"];
+}
+function candidatePaths(configured, env) {
+    const candidates = [];
+    const explicit = configured ?? env.OPENCODE_BIN ?? null;
+    if (explicit?.trim()) {
+        candidates.push({
+            command: explicit.trim(),
+            source: "config/env OPENCODE_BIN",
+            mustExist: true,
+        });
+    }
+    for (const name of executableNames()) {
+        candidates.push({ command: name, source: "PATH", mustExist: false });
+    }
+    // Walk up from the package root so hoisted installs are found too: npm often
+    // places `opencode-ai` in a parent node_modules/.bin when this package is a
+    // dependency rather than the root project.
+    let dir = packageRoot();
+    const seen = new Set();
+    while (dir && !seen.has(dir)) {
+        seen.add(dir);
+        for (const name of executableNames()) {
+            candidates.push({
+                command: path.join(dir, "node_modules", ".bin", name),
+                source: `node_modules/.bin (${dir})`,
+                mustExist: true,
+            });
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    for (const name of executableNames()) {
+        candidates.push({
+            command: path.join(process.cwd(), "node_modules", ".bin", name),
+            source: "project node_modules/.bin",
+            mustExist: true,
+        });
+    }
+    for (const name of executableNames()) {
+        candidates.push({
+            command: path.join(os.homedir(), ".opencode", "bin", name),
+            source: "~/.opencode/bin",
+            mustExist: true,
+        });
+        candidates.push({
+            command: path.join(os.homedir(), ".local", "bin", name),
+            source: "~/.local/bin",
+            mustExist: true,
+        });
+        candidates.push({ command: `/opt/homebrew/bin/${name}`, source: "homebrew", mustExist: true });
+        candidates.push({ command: `/usr/local/bin/${name}`, source: "usr-local", mustExist: true });
+    }
+    return candidates;
+}
+function probeVersion(command) {
+    return new Promise((resolve) => {
+        execFile(command, ["--version"], { timeout: 20_000, windowsHide: true }, (error, stdout, stderr) => {
+            if (error) {
+                resolve(null);
+                return;
+            }
+            const output = `${stdout}\n${stderr}`.trim();
+            const firstLine = output
+                .split("\n")
+                .map((line) => line.trim())
+                .filter(Boolean)[0];
+            resolve(firstLine ?? "unknown");
+        });
+    });
+}
+export async function resolveOpenCodeBinary(options = {}) {
+    const env = options.env ?? process.env;
+    const candidates = candidatePaths(options.configured, env);
+    const failures = [];
+    for (const candidate of candidates) {
+        if (candidate.mustExist) {
+            try {
+                await fs.promises.access(candidate.command, fs.constants.X_OK);
+            }
+            catch {
+                failures.push(`${candidate.command} (${candidate.source}): not found`);
+                continue;
+            }
+        }
+        const version = await probeVersion(candidate.command);
+        if (version) {
+            return { command: candidate.command, version, source: candidate.source };
+        }
+        failures.push(`${candidate.command} (${candidate.source}): not executable`);
+    }
+    throw new BridgeError("OPENCODE_NOT_AVAILABLE", [
+        "OpenCode executable was not found.",
+        "Install it with `npm install -g opencode-ai` (or `brew install sst/tap/opencode`),",
+        "or point the bridge at it with the OPENCODE_BIN environment variable",
+        "or the opencode.binary configuration option.",
+    ].join(" "), { details: { candidates: failures }, retryable: false });
+}
+/** Cached binary resolution so we only probe the filesystem once per process. */
+export class BinaryResolver {
+    options;
+    cached = null;
+    cachedKey = null;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async resolve(configured, force = false) {
+        const key = configured ?? this.options.configured ?? null;
+        if (this.cached && !force && this.cachedKey === key)
+            return this.cached;
+        this.cached = await resolveOpenCodeBinary({ ...this.options, configured: key });
+        this.cachedKey = key;
+        return this.cached;
+    }
+    invalidate() {
+        this.cached = null;
+        this.cachedKey = null;
+    }
+}
+//# sourceMappingURL=binary.js.map

package/dist/opencode/binary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.js","sourceRoot":"","sources":["../../src/opencode/binary.ts"],"names":[],"mappings":"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"}

package/dist/opencode/client.d.ts

@@ -0,0 +1,32 @@
+import { type OpencodeClient } from "@opencode-ai/sdk";
+export interface AuthCredentials {
+    username: string;
+    password: string;
+}
+export declare function basicAuthHeader(credentials: AuthCredentials): string;
+export interface WorkspaceClientOptions {
+    baseUrl: string;
+    directory?: string;
+    auth?: AuthCredentials | null;
+}
+/**
+ * Build an OpenCode SDK client bound to a workspace directory.
+ *
+ * `directory` is sent as the `x-opencode-directory` header on every request
+ * (and as a query parameter on GET/HEAD) so the server routes the request to
+ * the correct project instance.
+ */
+export declare function createWorkspaceClient(options: WorkspaceClientOptions): OpencodeClient;
+export declare function normalizeBaseUrl(url: string): string;
+export interface HealthResult {
+    healthy: boolean;
+    version: string;
+}
+/**
+ * Check `/global/health` directly.
+ *
+ * The v1 client bundled with @opencode-ai/sdk 1.x does not expose a health
+ * method (only the v2 namespace does), but the endpoint exists on every
+ * 1.x server, so the bridge talks to it over plain HTTP.
+ */
+export declare function fetchHealth(baseUrl: string, auth?: AuthCredentials | null): Promise<HealthResult | null>;

package/dist/opencode/client.js

@@ -0,0 +1,55 @@
+import { createOpencodeClient } from "@opencode-ai/sdk";
+export function basicAuthHeader(credentials) {
+    const raw = `${credentials.username}:${credentials.password}`;
+    return `Basic ${Buffer.from(raw, "utf8").toString("base64")}`;
+}
+/**
+ * Build an OpenCode SDK client bound to a workspace directory.
+ *
+ * `directory` is sent as the `x-opencode-directory` header on every request
+ * (and as a query parameter on GET/HEAD) so the server routes the request to
+ * the correct project instance.
+ */
+export function createWorkspaceClient(options) {
+    const headers = {};
+    if (options.auth)
+        headers.Authorization = basicAuthHeader(options.auth);
+    const config = {
+        baseUrl: options.baseUrl,
+        headers,
+    };
+    if (options.directory)
+        config.directory = options.directory;
+    return createOpencodeClient(config);
+}
+export function normalizeBaseUrl(url) {
+    return url.endsWith("/") ? url.slice(0, -1) : url;
+}
+/**
+ * Check `/global/health` directly.
+ *
+ * The v1 client bundled with @opencode-ai/sdk 1.x does not expose a health
+ * method (only the v2 namespace does), but the endpoint exists on every
+ * 1.x server, so the bridge talks to it over plain HTTP.
+ */
+export async function fetchHealth(baseUrl, auth) {
+    const headers = { accept: "application/json" };
+    if (auth)
+        headers.Authorization = basicAuthHeader(auth);
+    try {
+        const response = await fetch(`${normalizeBaseUrl(baseUrl)}/global/health`, {
+            headers,
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!response.ok)
+            return null;
+        const body = (await response.json());
+        if (body?.healthy !== true)
+            return null;
+        return { healthy: true, version: body.version ?? "unknown" };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/opencode/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/opencode/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAuB,MAAM,kBAAkB,CAAC;AAO7E,MAAM,UAAU,eAAe,CAAC,WAA4B;IAC1D,MAAM,GAAG,GAAG,GAAG,WAAW,CAAC,QAAQ,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;IAC9D,OAAO,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;AAChE,CAAC;AAQD;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA+B;IACnE,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,IAAI,OAAO,CAAC,IAAI;QAAE,OAAO,CAAC,aAAa,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAExE,MAAM,MAAM,GAA+C;QACzD,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO;KACR,CAAC;IACF,IAAI,OAAO,CAAC,SAAS;QAAE,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAC5D,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACpD,CAAC;AAOD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAe,EACf,IAA6B;IAE7B,MAAM,OAAO,GAA2B,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IACvE,IAAI,IAAI;QAAE,OAAO,CAAC,aAAa,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,gBAAgB,EAAE;YACzE,OAAO;YACP,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;SACpC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAC9B,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA4C,CAAC;QAChF,IAAI,IAAI,EAAE,OAAO,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,SAAS,EAAE,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/opencode/manager.d.ts

@@ -0,0 +1,66 @@
+import type { OpencodeClient } from "@opencode-ai/sdk";
+import { type ResolvedConfig } from "../config/config.js";
+import type { Logger } from "../util/logger.js";
+import { type ResolveBinaryOptions } from "./binary.js";
+import { type AuthCredentials } from "./client.js";
+export interface ServerStatus {
+    key: string;
+    url: string;
+    cwd: string;
+    external: boolean;
+    version: string | null;
+    activeRuns: number;
+    lastUsedAt: number;
+}
+export interface EnsureServerInput {
+    cwd: string;
+    config: ResolvedConfig;
+    agentConfig: Record<string, unknown>;
+}
+export interface OpenCodeManagerOptions {
+    logger: Logger;
+    env?: NodeJS.ProcessEnv;
+    binaryOptions?: ResolveBinaryOptions;
+}
+export declare class OpenCodeManager {
+    private readonly servers;
+    /** Every spawned child, tracked from creation so shutdown can always kill it. */
+    private readonly children;
+    private readonly logger;
+    private readonly env;
+    private readonly resolver;
+    private stopping;
+    constructor(options: OpenCodeManagerOptions);
+    resolveAuth(config: ResolvedConfig): AuthCredentials | null;
+    /** Ensure an OpenCode server exists for the workspace and return its record key. */
+    ensure(input: EnsureServerInput): Promise<string>;
+    clientFor(input: EnsureServerInput): Promise<OpencodeClient>;
+    /**
+     * Return a client for a workspace only when a live server already serves it.
+     * Used by read-only tools (get_session, get_diff, abort_session) that must
+     * not start an OpenCode process as a side effect.
+     */
+    existingClient(cwd: string): OpencodeClient | null;
+    getExistingServerVersion(cwd: string): string | null;
+    private externalKey;
+    private ensureExternal;
+    private assertAgentsAvailable;
+    private ensureLocal;
+    private spawnServer;
+    private tryHealth;
+    private waitForHealth;
+    beginRun(key: string, sessionId?: string): void;
+    endRun(key: string, sessionId?: string): void;
+    isDead(key: string): boolean;
+    getStatus(): ServerStatus[];
+    getRunningServerKeys(): string[];
+    private evictIfNeeded;
+    stop(key: string): Promise<void>;
+    stopAll(): Promise<void>;
+    /**
+     * Synchronous last-resort cleanup for `process.on("exit")`: kills any child
+     * that was spawned but not yet registered (shutdown races) so no OpenCode
+     * process is orphaned when the bridge exits.
+     */
+    killAllSync(): void;
+}