@next-open-ai/openbot 0.6.8 → 0.6.66

package/dist/core/agent/proxy/adapters/opencode-adapter.js

@@ -0,0 +1,786 @@
+/**
+ * OpenCode AgentProxy 适配器：使用 [@opencode-ai/sdk](https://opencode.ai/docs/zh-cn/sdk/) 对接官方 Server。
+ * 支持在消息中使用 //init、//undo、//redo、//share、//help 等 TUI 常见指令。
+ *
+ * 认证：SDK 文档未要求 Basic Auth。仅当用户在配置中填写了密码（对应 opencode serve 的 OPENCODE_SERVER_PASSWORD）
+ * 时，才通过自定义 fetch 注入 HTTP Basic；未填密码时直接使用 SDK 默认 fetch，无需处理 Request/duplex。
+ *
+ * 服务端默认模型：在启动 opencode serve 之前，在 OpenCode 配置里设置 model 即可。
+ * - 全局：编辑 ~/.config/opencode/opencode.json，添加 "model": "providerID/modelID"。
+ * - 当前项目：在项目根目录创建 opencode.json，添加 "model": "providerID/modelID"。
+ * - 环境变量：OPENCODE_CONFIG_CONTENT='{"model":"opencode/minimax-m2.5-free"}' opencode serve
+ * 并确保该 provider 已通过 /connect 或环境变量配置好 API Key。详见 https://opencode.ai/docs/config
+ *
+ * OpenCode Zen 免费模型（截图中的 Select model → OpenCode Zen）：
+ * - 在 TUI 中 /connect → 选择 OpenCode Zen → 到 opencode.ai/auth 登录并粘贴 API Key。
+ * - 在配置中设置 model 为以下之一即可作为默认模型（格式 opencode/<model-id>）：
+ *   - opencode/minimax-m2.5-free  — MiniMax M2.5 Free
+ *   - opencode/glm-5-free          — GLM 5 Free
+ *   - opencode/kimi-k2.5-free     — Kimi K2.5 Free
+ *   - opencode/big-pickle          — Big Pickle
+ * 本适配器请求不传 model 时由 OpenCode 服务端使用上述配置的默认模型。详见 https://opencode.ai/docs/zen
+ */
+import { join, resolve } from "path";
+import { createOpencodeClient } from "@opencode-ai/sdk";
+import { getOpenbotWorkspaceDir } from "../../agent-dir.js";
+import { ensureLocalOpencodeRunning } from "./opencode-local-runner.js";
+/** 单次请求与事件流超时。长任务（如 init 分析大项目、多轮工具调用）可能较久，故设 15 分钟 */
+const REQUEST_TIMEOUT_MS = 15 * 60 * 1000; // 15 min
+/** 仅在使用自定义 fetch（带密码）时用作 Basic 认证用户名 */
+const DEFAULT_SERVER_USERNAME = "opencode";
+/** /help 的说明文案 */
+const OPENCODE_HELP_TEXT = `**OpenCode 指令**（在消息开头输入，如 \`/init\`）
+
+- **/init** — 分析当前项目并创建 AGENTS.md，便于 OpenCode 理解项目结构
+- **/undo** — 撤销上一步修改
+- **/redo** — 重做已撤销的修改
+- **/share** — 分享当前会话，获取分享链接
+- **/help** — 显示本说明
+
+直接输入普通内容将作为对话发送给 OpenCode。`;
+function getSelfGatewayPort() {
+    const p = process.env.PORT?.trim();
+    if (!p)
+        return null;
+    const n = parseInt(p, 10);
+    return Number.isFinite(n) && n > 0 ? n : null;
+}
+function isLoopback(address) {
+    const a = address.toLowerCase();
+    return a === "127.0.0.1" || a === "localhost" || a === "::1" || a === "::ffff:127.0.0.1";
+}
+function getOpenCodeConfig(config) {
+    const oc = config.opencode;
+    if (oc?.port == null)
+        return null;
+    const port = Number(oc.port);
+    if (Number.isNaN(port) || port <= 0)
+        return null;
+    const mode = oc.mode === "local" || oc.mode === "remote" ? oc.mode : "remote";
+    const address = mode === "local"
+        ? "127.0.0.1"
+        : (oc.address != null && String(oc.address).trim()) || "";
+    if (mode === "remote" && !address)
+        return null;
+    const normalizedAddress = address.replace(/^https?:\/\//, "");
+    const selfPort = getSelfGatewayPort();
+    if (selfPort != null && port === selfPort && isLoopback(normalizedAddress)) {
+        throw new Error("OpenCode 地址不能指向本机当前 Gateway 端口（" +
+            normalizedAddress +
+            ":" +
+            port +
+            "），否则会造成请求死锁。");
+    }
+    const baseUrl = `http://${normalizedAddress}:${port}`.replace(/\/$/, "");
+    const username = (oc.username != null && String(oc.username).trim())
+        ? String(oc.username).trim()
+        : DEFAULT_SERVER_USERNAME;
+    const modelStr = (oc.model != null && String(oc.model).trim())
+        ? String(oc.model).trim()
+        : (config.model || "opencode/default");
+    const providerID = (config.provider && String(config.provider).trim()) || (modelStr.includes("/") ? modelStr.split("/")[0].trim() : modelStr.includes("-") ? modelStr.split("-")[0].trim() : "opencode");
+    const modelID = modelStr.includes("/") ? modelStr.slice(modelStr.indexOf("/") + 1).trim() : modelStr;
+    return {
+        baseUrl,
+        username,
+        password: oc.password != null ? String(oc.password).trim() : undefined,
+        model: { providerID, modelID: modelID || "default" },
+    };
+}
+/** 与 Claude Code 一致：未显式配置时使用智能体工作区路径 ~/.openbot/workspace/<workspace>/ */
+function getOpencodeWorkingDirectory(config) {
+    const custom = config.opencode?.workingDirectory;
+    if (typeof custom === "string" && custom.trim()) {
+        return resolve(custom.trim());
+    }
+    const w = config.workspace;
+    if (typeof w !== "string" || !w.trim())
+        return undefined;
+    return join(getOpenbotWorkspaceDir(), w.trim());
+}
+function buildAuthHeaders(oc) {
+    const user = oc.username || DEFAULT_SERVER_USERNAME;
+    const pass = oc.password ?? "";
+    return {
+        "Content-Type": "application/json",
+        Authorization: "Basic " + Buffer.from(`${user}:${pass}`).toString("base64"),
+    };
+}
+/**
+ * 在 Node/undici 下带 body 的请求需要 duplex，SDK 默认 fetch 未设置。无密码时用此 fetch 仅补 duplex。
+ * @param externalSignal 用户中止时传入，与超时合并
+ */
+function createDuplexFetch(timeoutMs, externalSignal) {
+    return (input, init) => {
+        let signal = init?.signal ?? AbortSignal.timeout(timeoutMs);
+        if (externalSignal) {
+            if (externalSignal.aborted)
+                signal = externalSignal;
+            else {
+                const c = new AbortController();
+                const tid = setTimeout(() => c.abort(), timeoutMs);
+                externalSignal.addEventListener("abort", () => {
+                    clearTimeout(tid);
+                    c.abort();
+                }, { once: true });
+                signal = c.signal;
+            }
+        }
+        if (input instanceof Request) {
+            const method = input.method.toUpperCase();
+            const hasBody = input.body != null || ["POST", "PUT", "PATCH"].includes(method);
+            const req = new Request(input.url, {
+                method: input.method,
+                headers: input.headers,
+                body: input.body,
+                mode: input.mode,
+                credentials: input.credentials,
+                cache: input.cache,
+                redirect: input.redirect,
+                referrer: input.referrer,
+                integrity: input.integrity,
+                signal,
+                ...(hasBody && { duplex: "half" }),
+            });
+            return fetch(req);
+        }
+        const method = (init?.method ?? "GET").toString().toUpperCase();
+        const hasBody = init?.body != null || ["POST", "PUT", "PATCH"].includes(method);
+        return fetch(input, { ...init, signal, ...(hasBody && { duplex: "half" }) });
+    };
+}
+/**
+ * 仅当用户配置了密码时使用：创建带 HTTP Basic 的 fetch，并满足 Node/undici 对带 body 请求的 duplex 要求。
+ * @param externalSignal 用户中止时传入，与超时合并
+ */
+function createAuthFetch(authHeaders, timeoutMs, externalSignal) {
+    return (input, init) => {
+        let signal = init?.signal ?? AbortSignal.timeout(timeoutMs);
+        if (externalSignal) {
+            if (externalSignal.aborted)
+                signal = externalSignal;
+            else {
+                const c = new AbortController();
+                const tid = setTimeout(() => c.abort(), timeoutMs);
+                externalSignal.addEventListener("abort", () => {
+                    clearTimeout(tid);
+                    c.abort();
+                }, { once: true });
+                signal = c.signal;
+            }
+        }
+        if (input instanceof Request) {
+            const cloned = input.clone();
+            const headers = new Headers(cloned.headers);
+            for (const [k, v] of Object.entries(authHeaders))
+                headers.set(k, v);
+            const method = cloned.method.toUpperCase();
+            const hasBody = cloned.body != null || ["POST", "PUT", "PATCH"].includes(method);
+            const req = new Request(cloned.url, {
+                method: cloned.method,
+                headers,
+                body: cloned.body,
+                mode: cloned.mode,
+                credentials: cloned.credentials,
+                cache: cloned.cache,
+                redirect: cloned.redirect,
+                referrer: cloned.referrer,
+                integrity: cloned.integrity,
+                signal,
+                ...(hasBody && { duplex: "half" }),
+            });
+            return fetch(req);
+        }
+        const headers = new Headers(init?.headers);
+        for (const [k, v] of Object.entries(authHeaders))
+            headers.set(k, v);
+        const method = (init?.method ?? "GET").toString().toUpperCase();
+        const hasBody = init?.body != null || ["POST", "PUT", "PATCH"].includes(method);
+        return fetch(input, { ...init, headers, signal, ...(hasBody && { duplex: "half" }) });
+    };
+}
+/** 按 channel 的 sessionId 复用 OpenCode session，便于 //undo、//redo 等生效 */
+const opencodeSessionCache = new Map();
+function getCachedSessionId(channelSessionId) {
+    return opencodeSessionCache.get(channelSessionId);
+}
+function setCachedSessionId(channelSessionId, opencodeSessionId) {
+    opencodeSessionCache.set(channelSessionId, opencodeSessionId);
+}
+/** 解析消息：若以 / 或 // 开头则返回 { command, args }，否则返回 null。支持常用 /command 形式。 */
+function parseSlashCommand(message) {
+    const trimmed = message.trim();
+    const isSlash = trimmed.startsWith("/");
+    if (!isSlash)
+        return null;
+    const rest = trimmed.startsWith("//") ? trimmed.slice(2).trim() : trimmed.slice(1).trim();
+    if (!rest)
+        return null;
+    const space = rest.indexOf(" ");
+    const command = space >= 0 ? rest.slice(0, space).toLowerCase() : rest.toLowerCase();
+    const args = space >= 0 ? rest.slice(space + 1).trim() : "";
+    return command ? { command, args } : null;
+}
+/** 从 session.prompt / session.command 返回的 parts 提取文本（含所有 type，用于兼容旧逻辑） */
+function partsToText(parts) {
+    if (!Array.isArray(parts))
+        return "";
+    return parts
+        .map((p) => (typeof p?.text === "string" ? p.text : typeof p?.content === "string" ? p.content : ""))
+        .filter(Boolean)
+        .join("");
+}
+/** 仅取 type=text 的 part 拼接为助手正文，与流式时只推 text 保持一致，不包含 reasoning/step-start/step-finish */
+function partsToReplyText(parts) {
+    if (!Array.isArray(parts))
+        return "";
+    return parts
+        .filter((p) => p?.type === "text")
+        .map((p) => (typeof p.text === "string" ? p.text : typeof p.content === "string" ? p.content : ""))
+        .filter(Boolean)
+        .join("")
+        .trim();
+}
+/** 日志用：可序列化对象，避免循环引用、过长字符串和不可序列化字段 */
+function safeForLog(obj, maxStrLen = 2000) {
+    if (obj === null || obj === undefined)
+        return obj;
+    if (typeof obj !== "object") {
+        const s = String(obj);
+        return s.length > maxStrLen ? s.slice(0, maxStrLen) + "…" : s;
+    }
+    if (Array.isArray(obj))
+        return obj.map((v) => safeForLog(v, maxStrLen));
+    const seen = new WeakSet();
+    function toPlain(o) {
+        if (o === null || o === undefined)
+            return o;
+        if (typeof o !== "object")
+            return typeof o === "string" && o.length > maxStrLen ? o.slice(0, maxStrLen) + "…" : o;
+        if (seen.has(o))
+            return "[Circular]";
+        seen.add(o);
+        if (typeof o.toJSON === "function")
+            return toPlain(o.toJSON());
+        if (Array.isArray(o))
+            return o.map(toPlain);
+        const out = {};
+        for (const k of Object.keys(o)) {
+            try {
+                out[k] = toPlain(o[k]);
+            }
+            catch {
+                out[k] = "[?]";
+            }
+        }
+        return out;
+    }
+    return toPlain(obj);
+}
+/** 打印 SDK 接口的完整返回，便于排查 */
+function logSdkResponse(api, res) {
+    console.log(`[OpenCode] SDK ${api} 返回:`, JSON.stringify(safeForLog(res), null, 2));
+}
+/** 将 SDK/API 抛出的错误转为可读字符串，避免 [object Object] */
+function formatErrorMessage(err) {
+    if (err instanceof Error)
+        return err.message;
+    const o = err;
+    if (Array.isArray(o?.error) && o.error.length > 0 && typeof o.error[0]?.message === "string") {
+        return o.error[0].message;
+    }
+    if (typeof o?.data?.message === "string")
+        return o.data.message;
+    if (typeof o?.message === "string")
+        return o.message;
+    if (typeof err === "string")
+        return err;
+    try {
+        return JSON.stringify(err);
+    }
+    catch {
+        return "未知错误";
+    }
+}
+/** 从多种可能的 API 响应结构中取出 parts 或纯文本 */
+function extractPartsOrText(res) {
+    const data = res?.data ?? res;
+    if (!data)
+        return "";
+    const parts = data?.info?.parts ?? data?.parts;
+    if (Array.isArray(parts))
+        return partsToText(parts);
+    if (typeof data?.content === "string")
+        return data.content;
+    if (typeof data?.text === "string")
+        return data.text;
+    if (typeof data?.message === "string")
+        return data.message;
+    return "";
+}
+/** 从 command 类接口返回中优先取 type=text 的 part 作为主回复，避免被 reasoning 等淹没；无则退回 partsToText */
+function extractCommandReplyText(res) {
+    const data = res?.data ?? res;
+    if (!data)
+        return "";
+    const parts = data?.info?.parts ?? data?.parts;
+    if (!Array.isArray(parts)) {
+        if (typeof data?.content === "string")
+            return data.content;
+        if (typeof data?.text === "string")
+            return data.text;
+        return "";
+    }
+    const textPart = parts.find((p) => p?.type === "text");
+    if (textPart && (typeof textPart.text === "string"))
+        return textPart.text.trim();
+    return partsToText(parts);
+}
+const POLL_INTERVAL_MS = 1500;
+/** 流式回退轮询超时。长任务若事件流提前断开，需给服务端足够时间生成完整回复 */
+const POLL_TIMEOUT_MS = 10 * 60 * 1000; // 10 min
+/**
+ * 服务端 POST /session/{id}/message 返回 204，助手回复异步生成。轮询 session.messages() 取最新 assistant 消息的文本。
+ */
+async function pollForAssistantMessage(session, sessionId) {
+    const deadline = Date.now() + POLL_TIMEOUT_MS;
+    let lastListRes;
+    let pollCount = 0;
+    while (Date.now() < deadline) {
+        pollCount++;
+        const listRes = await session.messages({ path: { id: sessionId } });
+        lastListRes = listRes;
+        if (pollCount === 1)
+            logSdkResponse("session.messages(poll, first)", listRes);
+        const list = listRes?.data ?? listRes;
+        if (!Array.isArray(list) || list.length === 0) {
+            await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+            continue;
+        }
+        // 找最后一条 user 的位置，只认「在它之后出现的 assistant」为本轮回复（避免并发多轮时拿错）
+        let lastUserIndex = -1;
+        for (let i = list.length - 1; i >= 0; i--) {
+            if (list[i]?.info?.role === "user") {
+                lastUserIndex = i;
+                break;
+            }
+        }
+        for (let i = lastUserIndex + 1; i < list.length; i++) {
+            const item = list[i];
+            if (item?.info?.role !== "assistant")
+                continue;
+            const parts = item?.info?.parts ?? item?.parts;
+            if (!Array.isArray(parts))
+                continue;
+            const text = partsToReplyText(parts);
+            if (text)
+                return text;
+            // 已有 assistant 但 parts 为空，可能仍在生成，继续轮询
+            break;
+        }
+        await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+    }
+    console.log("[OpenCode] session.messages(poll) 超时，最后一次返回:", JSON.stringify(safeForLog(lastListRes)));
+    return "";
+}
+export const opencodeAdapter = {
+    type: "opencode",
+    async runStream(options, config, callbacks) {
+        const oc = getOpenCodeConfig(config);
+        if (!oc) {
+            throw new Error("OpenCode adapter: missing opencode.port or (remote 模式下缺少 address) in agent config");
+        }
+        if (config.opencode?.mode === "local" && config.opencode.port != null) {
+            await ensureLocalOpencodeRunning(Number(config.opencode.port), config.opencode.model?.trim() || undefined, getOpencodeWorkingDirectory(config));
+        }
+        const hasPassword = Boolean(oc.password?.trim());
+        const userSignal = options.signal;
+        const fetchImpl = hasPassword
+            ? createAuthFetch(buildAuthHeaders(oc), REQUEST_TIMEOUT_MS, userSignal)
+            : createDuplexFetch(REQUEST_TIMEOUT_MS, userSignal);
+        const client = createOpencodeClient({
+            baseUrl: oc.baseUrl,
+            fetch: fetchImpl,
+            throwOnError: true,
+        });
+        const channelSessionId = options.sessionId;
+        let sessionId = getCachedSessionId(channelSessionId);
+        const ensureSession = async () => {
+            if (sessionId)
+                return sessionId;
+            const createRes = await client.session.create({ body: {} });
+            logSdkResponse("session.create", createRes);
+            const id = createRes.data?.id ?? createRes.id;
+            if (typeof id !== "string" || !id)
+                throw new Error("OpenCode 创建 Session 失败：返回缺少 id");
+            sessionId = id;
+            setCachedSessionId(channelSessionId, sessionId);
+            return sessionId;
+        };
+        const slash = parseSlashCommand(options.message);
+        try {
+            if (slash) {
+                const { command, args } = slash;
+                await ensureSession();
+                if (command === "help") {
+                    if (OPENCODE_HELP_TEXT)
+                        callbacks.onChunk(OPENCODE_HELP_TEXT);
+                    callbacks.onDone();
+                    return;
+                }
+                if (command === "init") {
+                    try {
+                        const initRes = await client.session.command({
+                            path: { id: sessionId },
+                            body: { command: "init", arguments: args || "" },
+                        });
+                        logSdkResponse("session.command(init)", initRes);
+                        const text = extractCommandReplyText(initRes) || "执行成功：已初始化项目并生成 AGENTS.md。";
+                        callbacks.onChunk(text);
+                    }
+                    catch (initErr) {
+                        console.warn("[OpenCode] init failed:", initErr);
+                        const msg = formatErrorMessage(initErr);
+                        const isAbort = msg.includes("aborted") || msg.includes("AbortError");
+                        callbacks.onChunk(isAbort ? "执行失败：请求已取消或超时。" : `执行失败：${msg}`);
+                    }
+                    callbacks.onDone();
+                    return;
+                }
+                if (command === "undo" || command === "redo") {
+                    try {
+                        if (command === "redo") {
+                            const unrevertRes = await client.session.unrevert({
+                                path: { id: sessionId },
+                            });
+                            logSdkResponse("session.unrevert(redo)", unrevertRes);
+                            callbacks.onChunk("已重做。");
+                        }
+                        else {
+                            const listRes = await client.session.messages({
+                                path: { id: sessionId },
+                            });
+                            const list = listRes?.data ?? listRes;
+                            const items = Array.isArray(list) ? list : [];
+                            const lastAssistant = [...items].reverse().find((m) => m?.info?.role === "assistant");
+                            const messageID = lastAssistant?.info?.id;
+                            if (!messageID) {
+                                callbacks.onChunk("没有可撤销的助手消息。");
+                                callbacks.onDone();
+                                return;
+                            }
+                            await client.session.revert({
+                                path: { id: sessionId },
+                                body: { messageID },
+                            });
+                            logSdkResponse("session.revert(undo)", { messageID });
+                            callbacks.onChunk("已撤销。");
+                        }
+                    }
+                    catch (undoRedoErr) {
+                        console.warn("[OpenCode] undo/redo failed:", undoRedoErr);
+                        callbacks.onChunk(`执行失败：${formatErrorMessage(undoRedoErr)}`);
+                    }
+                    callbacks.onDone();
+                    return;
+                }
+                if (command === "share") {
+                    const shareRes = await client.session.share({ path: { id: sessionId } });
+                    logSdkResponse("session.share", shareRes);
+                    const data = shareRes.data ?? shareRes;
+                    const url = data?.share?.url ?? data?.shareURL ?? data?.shareUrl ?? data?.url ?? "";
+                    callbacks.onChunk(url ? `分享链接：${url}` : "分享完成（请查看 OpenCode 返回的链接）。");
+                    callbacks.onDone();
+                    return;
+                }
+                // 其他未单独处理的 /xxx 当作普通指令发给 OpenCode command
+                try {
+                    const cmdRes = await client.session.command({
+                        path: { id: sessionId },
+                        body: { command, arguments: args || "", agent: "build" },
+                    });
+                    logSdkResponse("session.command(/xxx)", cmdRes);
+                    const text = extractCommandReplyText(cmdRes) || "已执行。";
+                    callbacks.onChunk(text);
+                }
+                catch (cmdErr) {
+                    console.warn("[OpenCode] command failed:", cmdErr);
+                    callbacks.onChunk(`执行失败：${formatErrorMessage(cmdErr)}`);
+                }
+                callbacks.onDone();
+                return;
+            }
+            // 普通对话：使用 promptAsync + event 流式接收 message.part.updated（delta）与 session.idle 结束
+            sessionId = await ensureSession();
+            const opencodeSessionId = sessionId;
+            const subscribeResult = await client.event.subscribe({
+                signal: userSignal,
+            });
+            const eventStream = subscribeResult?.stream;
+            if (!eventStream || typeof eventStream[Symbol.asyncIterator] !== "function") {
+                throw new Error("OpenCode event.subscribe() 未返回可迭代 stream");
+            }
+            try {
+                await client.session.promptAsync({
+                    path: { id: opencodeSessionId },
+                    body: { parts: [{ type: "text", text: options.message }] },
+                });
+            }
+            catch (promptErr) {
+                callbacks.onChunk(`请求失败：${formatErrorMessage(promptErr)}`);
+                callbacks.onDone();
+                return;
+            }
+            // 取刚发送的用户消息 ID，流式时只转发助手消息的 part，避免把用户问题当助手内容回显
+            let userMessageID = null;
+            try {
+                const listRes = await client.session.messages({ path: { id: opencodeSessionId } });
+                const list = listRes?.data ?? listRes;
+                if (Array.isArray(list) && list.length > 0) {
+                    // 列表可能是新→旧或旧→新，取「最后一条 user」为刚发的
+                    for (let i = list.length - 1; i >= 0; i--) {
+                        const item = list[i];
+                        if (item?.info?.role === "user" && item?.info?.id) {
+                            userMessageID = item.info.id;
+                            break;
+                        }
+                    }
+                    if (userMessageID == null) {
+                        for (let i = 0; i < list.length; i++) {
+                            const item = list[i];
+                            if (item?.info?.role === "user" && item?.info?.id) {
+                                userMessageID = item.info.id;
+                                break;
+                            }
+                        }
+                    }
+                }
+            }
+            catch (_) {
+                // 忽略，仅用于过滤用户 part
+            }
+            let hadAnyChunk = false;
+            let lastTextLength = 0;
+            let eventCount = 0;
+            // reasoning 只缓存在见到 text 或 session.idle 时再整体输出一次，避免「先部分后完整」重复显示
+            const reasoningBuffer = new Map();
+            // 正文累积后去掉 [step-start]/[step-finish] 再推送，避免服务端把这类标签混在 text 里
+            let textAccumulated = "";
+            let lastEmittedCleanLen = 0;
+            const stepMarkerRe = /\n?\[step-(?:start|finish)\]\n?/g;
+            const emitStrippedText = () => {
+                const cleaned = textAccumulated.replace(stepMarkerRe, "");
+                const toEmit = cleaned.slice(lastEmittedCleanLen);
+                if (toEmit) {
+                    hadAnyChunk = true;
+                    callbacks.onChunk(toEmit);
+                    lastEmittedCleanLen = cleaned.length;
+                }
+            };
+            const flushReasoningForMessage = (messageID) => {
+                const raw = reasoningBuffer.get(messageID);
+                if (!raw?.trim())
+                    return;
+                reasoningBuffer.delete(messageID);
+                const formatted = `\n\n---\nreasoning: ${raw.slice(0, 2000)}${raw.length > 2000 ? "…" : ""}\n---\n\n`;
+                hadAnyChunk = true;
+                callbacks.onChunk(formatted);
+            };
+            try {
+                for await (const event of eventStream) {
+                    if (userSignal?.aborted)
+                        break;
+                    eventCount++;
+                    const ev = event;
+                    if (ev.type !== "message.part.updated" || (ev.properties?.part?.type !== "text")) {
+                        const partType = ev.properties?.part?.type ?? "(no part)";
+                        console.log(`[OpenCode] event #${eventCount} type=${ev.type} part.type=${partType}`);
+                    }
+                    const info = ev.properties?.info;
+                    if (ev.type === "message.updated" && info?.sessionID === opencodeSessionId && info?.role === "user" && info?.id) {
+                        userMessageID = info.id;
+                    }
+                    if (ev.type === "message.part.updated" && ev.properties?.part?.sessionID === opencodeSessionId) {
+                        const part = ev.properties.part;
+                        if (userMessageID != null && part.messageID === userMessageID)
+                            continue;
+                        const partType = part.type ?? "";
+                        const delta = ev.properties.delta;
+                        const fullText = typeof part?.text === "string" ? part.text : "";
+                        if (partType === "text") {
+                            const msgId = part.messageID ?? "";
+                            flushReasoningForMessage(msgId);
+                            if (typeof delta === "string" && delta) {
+                                textAccumulated += delta;
+                                emitStrippedText();
+                            }
+                            else if (fullText.length > lastTextLength) {
+                                textAccumulated = fullText;
+                                lastTextLength = fullText.length;
+                                emitStrippedText();
+                            }
+                        }
+                        else if (partType === "reasoning" && fullText.trim()) {
+                            const msgId = part.messageID ?? "";
+                            reasoningBuffer.set(msgId, fullText);
+                        }
+                        // step-start、step-finish、tool_call 等不推给前端
+                    }
+                    if (ev.type === "session.idle" && ev.properties?.sessionID === opencodeSessionId) {
+                        for (const msgId of reasoningBuffer.keys())
+                            flushReasoningForMessage(msgId);
+                        console.log(`[OpenCode] session.idle after ${eventCount} events, hadAnyChunk=${hadAnyChunk}`);
+                        break;
+                    }
+                }
+            }
+            catch (streamErr) {
+                const errMsg = streamErr instanceof Error ? streamErr.message : String(streamErr);
+                if (streamErr?.name !== "AbortError") {
+                    console.warn(`[OpenCode] event stream error after ${eventCount} events, hadAnyChunk=${hadAnyChunk}:`, errMsg);
+                }
+                // 流提前断开（如超时、网络）：若已有部分内容已下发，前端能看到；若 hadAnyChunk 为 false 则下面轮询补全
+            }
+            if (!hadAnyChunk) {
+                console.log("[OpenCode] no chunks from stream, falling back to pollForAssistantMessage");
+                const fallback = await pollForAssistantMessage(client.session, opencodeSessionId);
+                if (fallback)
+                    callbacks.onChunk(fallback);
+            }
+            callbacks.onDone();
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            console.error(`[OpenCode] error: ${msg}`);
+            throw e;
+        }
+    },
+    async runCollect(options, config) {
+        const oc = getOpenCodeConfig(config);
+        if (!oc) {
+            throw new Error("OpenCode adapter: missing opencode.port or (remote 模式下缺少 address) in agent config");
+        }
+        if (config.opencode?.mode === "local" && config.opencode.port != null) {
+            await ensureLocalOpencodeRunning(Number(config.opencode.port), config.opencode.model?.trim() || undefined, getOpencodeWorkingDirectory(config));
+        }
+        const hasPassword = oc.password != null && String(oc.password).trim() !== "";
+        const client = createOpencodeClient({
+            baseUrl: oc.baseUrl,
+            ...(hasPassword
+                ? { fetch: createAuthFetch(buildAuthHeaders(oc), REQUEST_TIMEOUT_MS) }
+                : {}),
+            throwOnError: true,
+        });
+        const channelSessionId = options.sessionId;
+        let sessionId = getCachedSessionId(channelSessionId);
+        const ensureSession = async () => {
+            if (sessionId)
+                return sessionId;
+            const createRes = await client.session.create({ body: {} });
+            logSdkResponse("session.create", createRes);
+            const id = createRes.data?.id ?? createRes.id;
+            if (typeof id !== "string" || !id)
+                throw new Error("OpenCode 创建 Session 失败：返回缺少 id");
+            sessionId = id;
+            setCachedSessionId(channelSessionId, sessionId);
+            return sessionId;
+        };
+        const slash = parseSlashCommand(options.message);
+        if (slash) {
+            const { command, args } = slash;
+            await ensureSession();
+            if (command === "help")
+                return OPENCODE_HELP_TEXT.trim();
+            if (command === "init") {
+                try {
+                    const initRes = await client.session.command({
+                        path: { id: sessionId },
+                        body: { command: "init", arguments: args || "" },
+                    });
+                    logSdkResponse("session.command(init) runCollect", initRes);
+                    return extractCommandReplyText(initRes) || "执行成功：已初始化项目并生成 AGENTS.md。";
+                }
+                catch (e) {
+                    console.warn("[OpenCode] init failed (runCollect):", e);
+                    const msg = formatErrorMessage(e);
+                    const isAbort = msg.includes("aborted") || msg.includes("AbortError");
+                    return isAbort ? "执行失败：请求已取消或超时。" : `执行失败：${msg}`;
+                }
+            }
+            if (command === "undo" || command === "redo") {
+                try {
+                    if (command === "redo") {
+                        await client.session.unrevert({ path: { id: sessionId } });
+                        logSdkResponse("session.unrevert(redo) runCollect", {});
+                        return "已重做。";
+                    }
+                    const listRes = await client.session.messages({
+                        path: { id: sessionId },
+                    });
+                    const list = listRes?.data ?? listRes;
+                    const items = Array.isArray(list) ? list : [];
+                    const lastAssistant = [...items].reverse().find((m) => m?.info?.role === "assistant");
+                    const messageID = lastAssistant?.info?.id;
+                    if (!messageID)
+                        return "没有可撤销的助手消息。";
+                    await client.session.revert({
+                        path: { id: sessionId },
+                        body: { messageID },
+                    });
+                    logSdkResponse("session.revert(undo) runCollect", { messageID });
+                    return "已撤销。";
+                }
+                catch (e) {
+                    return `执行失败：${formatErrorMessage(e)}`;
+                }
+            }
+            if (command === "share") {
+                const shareRes = await client.session.share({ path: { id: sessionId } });
+                logSdkResponse("session.share (runCollect)", shareRes);
+                const data = shareRes.data ?? shareRes;
+                const url = data?.share?.url ?? data?.shareURL ?? data?.shareUrl ?? data?.url ?? "";
+                return url ? `分享链接：${url}` : "分享完成。";
+            }
+            try {
+                const cmdRes = await client.session.command({
+                    path: { id: sessionId },
+                    body: { command, arguments: args || "", agent: "build" },
+                });
+                logSdkResponse("session.command(/xxx) runCollect", cmdRes);
+                return extractCommandReplyText(cmdRes) || "已执行。";
+            }
+            catch (e) {
+                return `执行失败：${formatErrorMessage(e)}`;
+            }
+        }
+        sessionId = await ensureSession();
+        let text = "";
+        try {
+            const promptRes = await client.session.prompt({
+                path: { id: sessionId },
+                body: { parts: [{ type: "text", text: options.message }] }, // 不传 model，用 OpenCode 服务端默认
+            });
+            logSdkResponse("session.prompt (runCollect)", promptRes);
+            text = extractPartsOrText(promptRes);
+        }
+        catch (promptErr) {
+            const msg = promptErr instanceof Error ? promptErr.message : String(promptErr);
+            const cause = promptErr instanceof Error ? promptErr?.cause : undefined;
+            const isClosedOrTimeout = msg.includes("fetch failed") ||
+                msg.includes("other side closed") ||
+                msg.includes("aborted due to timeout") ||
+                msg.includes("TimeoutError") ||
+                cause?.code === "UND_ERR_SOCKET";
+            if (isClosedOrTimeout) {
+                console.warn("[OpenCode] session.prompt (runCollect) 被关闭或超时，改为轮询:", msg);
+                text = await pollForAssistantMessage(client.session, sessionId);
+            }
+            else {
+                throw promptErr;
+            }
+        }
+        if (!text)
+            text = await pollForAssistantMessage(client.session, sessionId);
+        return text.trim() || "(无文本回复或请求超时)";
+    },
+};