claude-opencode-mcp 1.0.0

package/dist/errors.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Structured error model for the bridge.
+ *
+ * Every failure surfaced to Claude Code uses one of these codes so that the
+ * orchestrator can react deterministically instead of parsing prose.
+ */
+export declare const BRIDGE_ERROR_CODES: readonly ["WORKSPACE_NOT_FOUND", "WORKSPACE_NOT_ALLOWED", "WORKSPACE_NOT_READABLE", "WORKSPACE_MISMATCH", "OPENCODE_NOT_AVAILABLE", "OPENCODE_START_TIMEOUT", "OPENCODE_UNAVAILABLE", "OPENCODE_SESSION_NOT_FOUND", "OPENCODE_ERROR", "AGENT_NOT_FOUND", "AGENT_TIMEOUT", "AGENT_ABORTED", "AGENT_EXECUTION_FAILED", "INVALID_PATH", "INVALID_ARGUMENT", "PERMISSION_DENIED", "MODEL_NOT_AVAILABLE", "DIFF_UNAVAILABLE", "NOT_GIT_REPOSITORY", "CONFIG_INVALID", "INTERNAL_ERROR"];
+export type BridgeErrorCode = (typeof BRIDGE_ERROR_CODES)[number];
+export interface SerializedBridgeError {
+    code: BridgeErrorCode;
+    message: string;
+    details?: Record<string, unknown>;
+    retryable: boolean;
+    request_id?: string;
+}
+export interface BridgeErrorOptions {
+    details?: Record<string, unknown>;
+    retryable?: boolean;
+    cause?: unknown;
+}
+export declare class BridgeError extends Error {
+    readonly code: BridgeErrorCode;
+    readonly details?: Record<string, unknown>;
+    readonly retryable: boolean;
+    constructor(code: BridgeErrorCode, message: string, options?: BridgeErrorOptions);
+    toJSON(): SerializedBridgeError;
+}
+export declare function isBridgeError(error: unknown): error is BridgeError;
+export declare function serializeError(error: unknown, requestId?: string): SerializedBridgeError;

package/dist/errors.js

@@ -0,0 +1,68 @@
+/**
+ * Structured error model for the bridge.
+ *
+ * Every failure surfaced to Claude Code uses one of these codes so that the
+ * orchestrator can react deterministically instead of parsing prose.
+ */
+export const BRIDGE_ERROR_CODES = [
+    "WORKSPACE_NOT_FOUND",
+    "WORKSPACE_NOT_ALLOWED",
+    "WORKSPACE_NOT_READABLE",
+    "WORKSPACE_MISMATCH",
+    "OPENCODE_NOT_AVAILABLE",
+    "OPENCODE_START_TIMEOUT",
+    "OPENCODE_UNAVAILABLE",
+    "OPENCODE_SESSION_NOT_FOUND",
+    "OPENCODE_ERROR",
+    "AGENT_NOT_FOUND",
+    "AGENT_TIMEOUT",
+    "AGENT_ABORTED",
+    "AGENT_EXECUTION_FAILED",
+    "INVALID_PATH",
+    "INVALID_ARGUMENT",
+    "PERMISSION_DENIED",
+    "MODEL_NOT_AVAILABLE",
+    "DIFF_UNAVAILABLE",
+    "NOT_GIT_REPOSITORY",
+    "CONFIG_INVALID",
+    "INTERNAL_ERROR",
+];
+export class BridgeError extends Error {
+    code;
+    details;
+    retryable;
+    constructor(code, message, options = {}) {
+        super(message, options.cause !== undefined ? { cause: options.cause } : undefined);
+        this.name = "BridgeError";
+        this.code = code;
+        this.details = options.details;
+        this.retryable = options.retryable ?? false;
+    }
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            ...(this.details ? { details: this.details } : {}),
+            retryable: this.retryable,
+        };
+    }
+}
+export function isBridgeError(error) {
+    return error instanceof BridgeError;
+}
+export function serializeError(error, requestId) {
+    if (isBridgeError(error)) {
+        const serialized = error.toJSON();
+        return requestId ? { ...serialized, request_id: requestId } : serialized;
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    const serialized = {
+        code: "INTERNAL_ERROR",
+        message,
+        retryable: false,
+    };
+    if (requestId)
+        serialized.request_id = requestId;
+    return serialized;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,qBAAqB;IACrB,uBAAuB;IACvB,wBAAwB;IACxB,oBAAoB;IACpB,wBAAwB;IACxB,wBAAwB;IACxB,sBAAsB;IACtB,4BAA4B;IAC5B,gBAAgB;IAChB,iBAAiB;IACjB,eAAe;IACf,eAAe;IACf,wBAAwB;IACxB,cAAc;IACd,kBAAkB;IAClB,mBAAmB;IACnB,qBAAqB;IACrB,kBAAkB;IAClB,oBAAoB;IACpB,gBAAgB;IAChB,gBAAgB;CACR,CAAC;AAkBX,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAkB;IACtB,OAAO,CAA2B;IAClC,SAAS,CAAU;IAE5B,YAAY,IAAqB,EAAE,OAAe,EAAE,UAA8B,EAAE;QAClF,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACnF,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;IAC9C,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClD,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,KAAK,YAAY,WAAW,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,SAAkB;IAC/D,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QAClC,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;IAC3E,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,UAAU,GAA0B;QACxC,IAAI,EAAE,gBAAgB;QACtB,OAAO;QACP,SAAS,EAAE,KAAK;KACjB,CAAC;IACF,IAAI,SAAS;QAAE,UAAU,CAAC,UAAU,GAAG,SAAS,CAAC;IACjD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+import path from "node:path";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { Command } from "commander";
+import { runInit } from "./cli/init.js";
+import { loadConfig } from "./config/config.js";
+import { createMcpServer, SERVER_VERSION } from "./mcp/server.js";
+import { OpenCodeManager } from "./opencode/manager.js";
+import { SessionRegistry } from "./opencode/sessions.js";
+import { prepareRun } from "./opencode/setup.js";
+import { createLogger, defaultLogFile, stateDirectory } from "./util/logger.js";
+async function runServer() {
+    const logger = createLogger({ file: defaultLogFile() });
+    const env = process.env;
+    const stateDir = stateDirectory();
+    let globalConfig;
+    try {
+        globalConfig = (await loadConfig({ env })).config;
+    }
+    catch (error) {
+        logger.error("failed to load configuration", {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        process.exitCode = 1;
+        return;
+    }
+    const registry = new SessionRegistry(path.join(stateDir, "sessions.json"), logger);
+    const manager = new OpenCodeManager({ logger, env });
+    const server = createMcpServer({ logger, manager, registry, globalConfig, env, stateDir });
+    let shuttingDown = false;
+    const shutdown = async (reason) => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        logger.info("shutting down", { reason });
+        try {
+            await server.close();
+        }
+        catch {
+            // ignore
+        }
+        try {
+            await manager.stopAll();
+        }
+        catch {
+            // ignore
+        }
+        logger.info("shutdown complete");
+        setImmediate(() => process.exit(0));
+    };
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info("claude-opencode-mcp started", {
+        pid: process.pid,
+        cwd: process.cwd(),
+        state_dir: stateDir,
+    });
+    server.server.onclose = () => {
+        void shutdown("transport closed");
+    };
+    process.on("SIGINT", () => void shutdown("SIGINT"));
+    process.on("SIGTERM", () => void shutdown("SIGTERM"));
+    // Never orphan an OpenCode child, even if we exit through an unexpected path.
+    process.on("exit", () => manager.killAllSync());
+    if (globalConfig.opencode.autoStart && !globalConfig.opencode.url) {
+        setImmediate(() => {
+            void (async () => {
+                try {
+                    await prepareRun({ manager, logger, env, globalConfig }, {});
+                    logger.info("warmed up OpenCode for the default workspace");
+                }
+                catch (error) {
+                    logger.debug("OpenCode warmup skipped", {
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                }
+            })();
+        });
+    }
+}
+async function main() {
+    const program = new Command();
+    program
+        .name("claude-opencode-mcp")
+        .description("MCP bridge that lets Claude Code delegate tasks to OpenCode agents (DeepSeek by default) in the same workspace.")
+        .version(SERVER_VERSION, "-v, --version", "print the bridge version")
+        .action(async () => {
+        await runServer();
+    });
+    program
+        .command("init")
+        .description("initialize optional project-local configuration and validate the environment")
+        .option("--dir <path>", "project directory (defaults to the current directory)")
+        .option("--force", "overwrite existing generated files")
+        .option("--write-mcp", "create or update .mcp.json in the project")
+        .action(async (options) => {
+        const code = await runInit({
+            ...(options.dir ? { dir: options.dir } : {}),
+            ...(options.force ? { force: true } : {}),
+            ...(options.writeMcp ? { writeMcp: true } : {}),
+        });
+        process.exitCode = code;
+    });
+    program
+        .command("serve")
+        .description("run the MCP stdio server (default command)")
+        .action(async () => {
+        await runServer();
+    });
+    await program.parseAsync(process.argv);
+}
+main().catch((error) => {
+    process.stderr.write(`claude-opencode-mcp fatal error: ${error instanceof Error ? (error.stack ?? error.message) : String(error)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/mcp/execute.d.ts

@@ -0,0 +1,30 @@
+import type { LoadedConfig, ResolvedConfig } from "../config/config.js";
+import type { OpenCodeManager } from "../opencode/manager.js";
+import type { SessionRegistry } from "../opencode/sessions.js";
+import type { PreparedRun } from "../opencode/setup.js";
+import type { AgentSession, DelegateResult } from "../types/index.js";
+import type { Logger } from "../util/logger.js";
+import { type ToolExtra } from "./tool-utils.js";
+export interface AppContext {
+    logger: Logger;
+    manager: OpenCodeManager;
+    registry: SessionRegistry;
+    globalConfig: ResolvedConfig;
+    env: NodeJS.ProcessEnv;
+    stateDir: string;
+    /** Override per-workspace config loading (tests/embedding). */
+    loadProjectConfig?: (cwd: string) => Promise<LoadedConfig>;
+}
+export declare function loadWorkspaceConfig(ctx: AppContext, cwd: string): Promise<ResolvedConfig>;
+export interface ExecuteRunInput {
+    prepared: PreparedRun;
+    session: AgentSession;
+    text: string;
+    timeoutMs: number;
+    disableEdits: boolean;
+    extra: ToolExtra;
+    requestId: string;
+}
+export declare function executeRun(ctx: AppContext, input: ExecuteRunInput): Promise<DelegateResult>;
+export declare function countChangedFiles(session: AgentSession): Promise<number>;
+export declare function assertSession(session: AgentSession | null, sessionId: string): AgentSession;

package/dist/mcp/execute.js

@@ -0,0 +1,128 @@
+import { loadConfig } from "../config/config.js";
+import { BridgeError, isBridgeError } from "../errors.js";
+import { runPrompt } from "../opencode/run.js";
+import { diffSinceBaseline } from "../util/git.js";
+import { truncate } from "../util/text.js";
+import { createProgressReporter } from "./tool-utils.js";
+export async function loadWorkspaceConfig(ctx, cwd) {
+    if (ctx.loadProjectConfig) {
+        return (await ctx.loadProjectConfig(cwd)).config;
+    }
+    return (await loadConfig({ cwd, env: ctx.env })).config;
+}
+export async function executeRun(ctx, input) {
+    const { prepared, session } = input;
+    const progress = createProgressReporter(input.extra, ctx.logger, input.requestId);
+    const runLogger = ctx.logger.child({
+        request_id: input.requestId,
+        session_id: session.id,
+        agent: session.agent,
+        cwd: session.cwd,
+    });
+    ctx.registry.update(session.id, { status: "running", lastError: undefined });
+    ctx.manager.beginRun(prepared.serverKey, session.id);
+    try {
+        const result = await runPrompt({
+            client: prepared.client,
+            sessionId: session.id,
+            agent: session.agent,
+            model: prepared.model,
+            text: input.text,
+            timeoutMs: input.timeoutMs,
+            disableEdits: input.disableEdits,
+            ...(progress ? { onProgress: progress } : {}),
+            ...(input.extra.signal ? { signal: input.extra.signal } : {}),
+            logger: runLogger,
+        });
+        const truncatedSummary = truncate(result.summary, prepared.config.limits.summaryChars);
+        const filesChanged = await countChangedFiles(session);
+        const status = result.status === "completed"
+            ? "completed"
+            : result.status === "timeout"
+                ? "timeout"
+                : "failed";
+        ctx.registry.update(session.id, {
+            status,
+            ...(truncatedSummary.text ? { lastSummary: truncatedSummary.text } : {}),
+            ...(result.error
+                ? { lastError: { code: result.error.code, message: result.error.message } }
+                : { lastError: undefined }),
+            durationMs: result.durationMs,
+            ...(result.messageID ? { lastMessageID: result.messageID } : {}),
+        });
+        runLogger.info("delegated run finished", {
+            status: result.status,
+            duration_ms: result.durationMs,
+            files_changed: filesChanged,
+            findings: result.findings.length,
+        });
+        return {
+            status: result.status,
+            session_id: session.id,
+            agent: session.agent,
+            cwd: session.cwd,
+            model: prepared.modelString,
+            summary: truncatedSummary.text,
+            findings: result.findings,
+            files_changed: filesChanged,
+            duration_ms: result.durationMs,
+            truncated: truncatedSummary.truncated,
+            ...(result.error
+                ? {
+                    error: {
+                        code: result.error.code,
+                        message: result.error.message,
+                        ...(result.error.details ? { details: result.error.details } : {}),
+                    },
+                }
+                : {}),
+        };
+    }
+    catch (error) {
+        const code = isBridgeError(error) ? error.code : "INTERNAL_ERROR";
+        const message = error instanceof Error ? error.message : String(error);
+        ctx.registry.update(session.id, {
+            status: code === "AGENT_ABORTED" ? "aborted" : "failed",
+            lastError: { code, message },
+        });
+        throw error;
+    }
+    finally {
+        ctx.manager.endRun(prepared.serverKey, session.id);
+    }
+}
+export async function countChangedFiles(session) {
+    const baseline = session.baseline
+        ? {
+            head: session.baseline.head,
+            stashRef: session.baseline.stashRef,
+            untracked: session.baseline.untracked,
+            unborn: session.baseline.unborn,
+            dirty: session.baseline.stashRef !== null,
+        }
+        : null;
+    if (!baseline)
+        return 0;
+    try {
+        const diff = await diffSinceBaseline(session.cwd, baseline, {
+            maxPatchChars: 20_000,
+            maxNewFiles: 50,
+        });
+        return diff.files.length;
+    }
+    catch {
+        return 0;
+    }
+}
+export function assertSession(session, sessionId) {
+    if (!session) {
+        throw new BridgeError("OPENCODE_SESSION_NOT_FOUND", `Unknown session: ${sessionId}`, {
+            details: {
+                session_id: sessionId,
+                hint: "Create a session with create_session or delegate_task first.",
+            },
+        });
+    }
+    return session;
+}
+//# sourceMappingURL=execute.js.map

package/dist/mcp/execute.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,19 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { LoadedConfig, ResolvedConfig } from "../config/config.js";
+import type { OpenCodeManager } from "../opencode/manager.js";
+import type { SessionRegistry } from "../opencode/sessions.js";
+import type { Logger } from "../util/logger.js";
+export declare const SERVER_NAME = "claude-opencode-mcp";
+export declare const SERVER_VERSION = "1.0.0";
+export declare const SERVER_INSTRUCTIONS: string;
+export interface CreateMcpServerOptions {
+    logger: Logger;
+    manager: OpenCodeManager;
+    registry: SessionRegistry;
+    globalConfig: ResolvedConfig;
+    env?: NodeJS.ProcessEnv;
+    stateDir: string;
+    /** Override per-workspace config loading (tests/embedding). */
+    loadProjectConfig?: (cwd: string) => Promise<LoadedConfig>;
+}
+export declare function createMcpServer(options: CreateMcpServerOptions): McpServer;

package/dist/mcp/server.js

@@ -0,0 +1,38 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerAbortSession } from "./tools/abort-session.js";
+import { registerCreateSession } from "./tools/create-session.js";
+import { registerDelegateTask } from "./tools/delegate-task.js";
+import { registerGetDiff } from "./tools/get-diff.js";
+import { registerGetSession } from "./tools/get-session.js";
+import { registerListAgents } from "./tools/list-agents.js";
+import { registerSendMessage } from "./tools/send-message.js";
+export const SERVER_NAME = "claude-opencode-mcp";
+export const SERVER_VERSION = "1.0.0";
+export const SERVER_INSTRUCTIONS = [
+    "Claude Code is the orchestrator; this server delegates focused tasks to OpenCode agents that run in the same workspace.",
+    "Use delegate_task for one-shot work, or create_session + send_message for multi-step work that must keep context.",
+    "Read-only agents: deepseek-researcher, deepseek-reviewer. Editing agent: deepseek-coder. Test-running agent: deepseek-tester.",
+    "After a coder session, call get_diff to inspect exactly what changed before reporting back to the user.",
+    "Paths supplied to delegate_task are exploration hints, not boundaries.",
+].join(" ");
+export function createMcpServer(options) {
+    const ctx = {
+        logger: options.logger,
+        manager: options.manager,
+        registry: options.registry,
+        globalConfig: options.globalConfig,
+        env: options.env ?? process.env,
+        stateDir: options.stateDir,
+        ...(options.loadProjectConfig ? { loadProjectConfig: options.loadProjectConfig } : {}),
+    };
+    const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION }, { instructions: SERVER_INSTRUCTIONS });
+    registerDelegateTask(server, ctx);
+    registerCreateSession(server, ctx);
+    registerSendMessage(server, ctx);
+    registerGetSession(server, ctx);
+    registerGetDiff(server, ctx);
+    registerAbortSession(server, ctx);
+    registerListAgents(server, ctx);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,CAAC,MAAM,WAAW,GAAG,qBAAqB,CAAC;AACjD,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,yHAAyH;IACzH,mHAAmH;IACnH,+HAA+H;IAC/H,yGAAyG;IACzG,wEAAwE;CACzE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAaZ,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC7D,MAAM,GAAG,GAAe;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG;QAC/B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvF,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,EAC9C,EAAE,YAAY,EAAE,mBAAmB,EAAE,CACtC,CAAC;IAEF,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEhC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/mcp/session-utils.d.ts

@@ -0,0 +1,5 @@
+import type { PreparedRun } from "../opencode/setup.js";
+import type { AgentSession } from "../types/index.js";
+import type { AppContext } from "./execute.js";
+export declare function defaultSessionTitle(agent: string, task: string): string;
+export declare function createDelegatedSession(ctx: AppContext, prepared: PreparedRun, title?: string | null): Promise<AgentSession>;

package/dist/mcp/session-utils.js

@@ -0,0 +1,55 @@
+import { BridgeError } from "../errors.js";
+import { createSessionRecord } from "../opencode/sessions.js";
+import { captureGitBaseline } from "../util/git.js";
+export function defaultSessionTitle(agent, task) {
+    const cleaned = task.replace(/\s+/g, " ").trim();
+    const short = cleaned.length > 60 ? `${cleaned.slice(0, 57)}…` : cleaned;
+    return `${agent}: ${short || "delegated task"}`;
+}
+export async function createDelegatedSession(ctx, prepared, title) {
+    const baseline = await captureGitBaseline(prepared.workspace.cwd);
+    let opencodeId;
+    try {
+        const result = await prepared.client.session.create({
+            body: { title: title?.trim() ? title.trim() : undefined },
+        });
+        if (result.error || !result.data) {
+            throw new BridgeError("OPENCODE_ERROR", "OpenCode did not return a session id.", {
+                details: { error: result.error },
+            });
+        }
+        opencodeId = result.data.id;
+    }
+    catch (error) {
+        if (error instanceof BridgeError)
+            throw error;
+        throw new BridgeError("OPENCODE_UNAVAILABLE", `Could not create an OpenCode session: ${error instanceof Error ? error.message : String(error)}`, { cause: error, retryable: true });
+    }
+    const session = createSessionRecord({
+        id: opencodeId,
+        cwd: prepared.workspace.cwd,
+        agent: prepared.definition.name,
+        provider: prepared.model?.providerID ?? null,
+        model: prepared.modelString,
+        title: title?.trim() ? title.trim() : null,
+        ...(baseline
+            ? {
+                baseline: {
+                    head: baseline.head,
+                    stashRef: baseline.stashRef,
+                    untracked: baseline.untracked,
+                    unborn: baseline.unborn,
+                },
+            }
+            : {}),
+    });
+    ctx.registry.upsert(session);
+    ctx.logger.info("created delegated session", {
+        session_id: session.id,
+        cwd: session.cwd,
+        agent: session.agent,
+        model: session.model,
+    });
+    return session;
+}
+//# sourceMappingURL=session-utils.js.map

package/dist/mcp/session-utils.js.map

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

package/dist/mcp/tool-utils.d.ts

@@ -0,0 +1,11 @@
+import type { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
+import type { CallToolResult, ServerNotification, ServerRequest } from "@modelcontextprotocol/sdk/types.js";
+import type { RunProgress } from "../types/index.js";
+import type { Logger } from "../util/logger.js";
+export type ToolExtra = RequestHandlerExtra<ServerRequest, ServerNotification>;
+export declare function jsonResult(value: unknown, options?: {
+    isError?: boolean;
+}): CallToolResult;
+export declare function errorResult(error: unknown, requestId?: string): CallToolResult;
+export type ProgressReporter = (progress: RunProgress) => Promise<void>;
+export declare function createProgressReporter(extra: ToolExtra, logger: Logger, requestId: string): ProgressReporter | undefined;

package/dist/mcp/tool-utils.js

@@ -0,0 +1,44 @@
+import { serializeError } from "../errors.js";
+export function jsonResult(value, options = {}) {
+    const text = JSON.stringify(value, null, 2) ?? String(value);
+    const result = { content: [{ type: "text", text }] };
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+        result.structuredContent = value;
+    }
+    if (options.isError)
+        result.isError = true;
+    return result;
+}
+export function errorResult(error, requestId) {
+    return jsonResult({ error: serializeError(error, requestId) }, { isError: true });
+}
+export function createProgressReporter(extra, logger, requestId) {
+    const token = extra._meta?.progressToken;
+    if (token === undefined || token === null)
+        return undefined;
+    let lastSentAt = 0;
+    return async (progress) => {
+        const now = Date.now();
+        if (progress.progress < 100 && now - lastSentAt < 400)
+            return;
+        lastSentAt = now;
+        try {
+            await extra.sendNotification({
+                method: "notifications/progress",
+                params: {
+                    progressToken: token,
+                    progress: progress.progress,
+                    ...(progress.total !== undefined ? { total: progress.total } : {}),
+                    ...(progress.message ? { message: progress.message } : {}),
+                },
+            });
+        }
+        catch (error) {
+            logger.debug("failed to send progress notification", {
+                request_id: requestId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    };
+}
+//# sourceMappingURL=tool-utils.js.map

package/dist/mcp/tool-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-utils.js","sourceRoot":"","sources":["../../src/mcp/tool-utils.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAM9C,MAAM,UAAU,UAAU,CAAC,KAAc,EAAE,UAAiC,EAAE;IAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAmB,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACrE,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,CAAC,iBAAiB,GAAG,KAAgC,CAAC;IAC9D,CAAC;IACD,IAAI,OAAO,CAAC,OAAO;QAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC3C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,SAAkB;IAC5D,OAAO,UAAU,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AACpF,CAAC;AAID,MAAM,UAAU,sBAAsB,CACpC,KAAgB,EAChB,MAAc,EACd,SAAiB;IAEjB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC;IACzC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5D,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,OAAO,KAAK,EAAE,QAAqB,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,QAAQ,CAAC,QAAQ,GAAG,GAAG,IAAI,GAAG,GAAG,UAAU,GAAG,GAAG;YAAE,OAAO;QAC9D,UAAU,GAAG,GAAG,CAAC;QACjB,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,gBAAgB,CAAC;gBAC3B,MAAM,EAAE,wBAAwB;gBAChC,MAAM,EAAE;oBACN,aAAa,EAAE,KAAK;oBACpB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;oBAC3B,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAClE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC3D;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE;gBACnD,UAAU,EAAE,SAAS;gBACrB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/abort-session.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AppContext } from "../execute.js";
+export declare function registerAbortSession(server: McpServer, ctx: AppContext): void;