oh-my-agent-web 0.3.0 → 0.4.0

package/dist/server/engine/codex-map.js

@@ -0,0 +1,298 @@
+/**
+ * codex app-server 的**纯映射**（不碰网络/子进程，单测直接覆盖）。
+ *
+ * 三件事：
+ *   1. thread items → 工作台的 `UiMessage`（对话区与历史都靠它）；
+ *   2. model catalog → 模型下拉的条目 + 思考档位；
+ *   3. 审批请求 → 工作台的 ApprovalRequest（审批弹窗的文字与作用域）。
+ *
+ * 为什么单独一个文件：这些规则又多又碎（item 有 18 种），混进引擎里会很快破 400 行，
+ * 也没法测。引擎只负责「收通知 → 按 threadId 分发」。
+ */
+import { TOOL_EXCERPT_CHARS } from "../protocol.js";
+const EXCERPT = TOOL_EXCERPT_CHARS;
+function clip(text) {
+    if (text.length <= EXCERPT)
+        return { outputExcerpt: text, truncated: false };
+    return { outputExcerpt: text.slice(0, EXCERPT), truncated: true };
+}
+function textOf(content) {
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .map((part) => (typeof part === "string" ? part : typeof part.text === "string" ? part.text : ""))
+        .join("");
+}
+/** codex 的工具状态 → 工作台的三态 */
+function toolStatus(status) {
+    if (status === undefined || status === "inProgress" || status === "running")
+        return "running";
+    if (status === "completed" || status === "ok")
+        return "ok";
+    return "failed";
+}
+/**
+ * 一轮 turn 的 items → 界面消息。
+ *
+ * 规则：
+ *   - `userMessage` 开一条用户消息；`agentMessage` 开一条助手消息；
+ *   - `reasoning` / `plan` 接到当前助手消息上（折叠块）；
+ *   - 工具类（commandExecution / fileChange / mcpToolCall）也接在当前助手消息上，
+ *     没有助手消息就先开一条（否则工具卡会丢）。
+ */
+export function itemsToUiMessages(items, ts) {
+    const messages = [];
+    let assistant = null;
+    const ensureAssistant = () => {
+        if (assistant)
+            return assistant;
+        assistant = { id: `codex-asst-${ts}-${messages.length}`, role: "assistant", ts, blocks: [] };
+        messages.push(assistant);
+        return assistant;
+    };
+    for (const item of items) {
+        const type = item.type;
+        if (type === "userMessage") {
+            const text = textOf(item.content);
+            if (text.trim() === "")
+                continue;
+            messages.push({ id: item.id ?? `codex-user-${ts}-${messages.length}`, role: "user", ts, blocks: [{ kind: "text", text }] });
+            assistant = null;
+            continue;
+        }
+        if (type === "agentMessage") {
+            const text = item.text ?? "";
+            if (text === "")
+                continue;
+            // 连续的 agentMessage（分段回复）接到同一条助手消息上
+            const target = ensureAssistant();
+            target.blocks = [...target.blocks, { kind: "text", text }];
+            continue;
+        }
+        if (type === "reasoning" || type === "plan") {
+            const text = type === "plan" ? (item.text ?? "") : [...(item.summary ?? []), ...(Array.isArray(item.content) ? item.content.filter((c) => typeof c === "string") : [])].join("\n");
+            if (text.trim() === "")
+                continue;
+            const target = ensureAssistant();
+            target.blocks = [...target.blocks, { kind: "thinking", text }];
+            continue;
+        }
+        if (type === "commandExecution") {
+            const target = ensureAssistant();
+            const output = clip(item.aggregatedOutput ?? "");
+            target.blocks = [
+                ...target.blocks,
+                {
+                    kind: "tool",
+                    toolCallId: item.id ?? `codex-exec-${ts}`,
+                    name: "shell",
+                    argsSummary: item.command ?? "",
+                    argsFull: item.command ?? "",
+                    status: toolStatus(item.status),
+                    outputExcerpt: output.outputExcerpt,
+                    truncated: output.truncated,
+                    ...(typeof item.exitCode === "number" ? { exitCode: item.exitCode } : {}),
+                    startedAt: ts,
+                },
+            ];
+            continue;
+        }
+        if (type === "fileChange") {
+            const target = ensureAssistant();
+            const paths = (item.changes ?? []).map((change) => change.path ?? "").filter(Boolean);
+            target.blocks = [
+                ...target.blocks,
+                {
+                    kind: "tool",
+                    toolCallId: item.id ?? `codex-patch-${ts}`,
+                    name: "apply_patch",
+                    argsSummary: paths.length > 0 ? paths.join(", ") : "改动文件",
+                    status: toolStatus(item.status),
+                    outputExcerpt: "",
+                    truncated: false,
+                    startedAt: ts,
+                },
+            ];
+            continue;
+        }
+        if (type === "mcpToolCall" || type === "dynamicToolCall") {
+            const target = ensureAssistant();
+            const name = item.server ? `${item.server}.${item.tool ?? "tool"}` : (item.tool ?? "tool");
+            const outputText = item.error?.message ?? (item.result === undefined ? "" : JSON.stringify(item.result));
+            const output = clip(outputText);
+            target.blocks = [
+                ...target.blocks,
+                {
+                    kind: "tool",
+                    toolCallId: item.id ?? `codex-tool-${ts}`,
+                    name,
+                    argsSummary: item.arguments === undefined ? "" : JSON.stringify(item.arguments).slice(0, 200),
+                    argsFull: item.arguments === undefined ? "" : JSON.stringify(item.arguments),
+                    status: toolStatus(item.status),
+                    outputExcerpt: output.outputExcerpt,
+                    truncated: output.truncated,
+                    startedAt: ts,
+                },
+            ];
+            continue;
+        }
+        if (type === "imageView" || type === "imageGeneration" || type === "webSearch") {
+            const target = ensureAssistant();
+            const text = type === "webSearch" ? "（联网搜索）" : type === "imageView" ? `（查看图片：${item.path ?? ""}）` : "（生成图片）";
+            target.blocks = [...target.blocks, { kind: "text", text }];
+        }
+    }
+    return messages;
+}
+/** 一轮 turn 的 items 拍平成转录（`readTranscript` 用） */
+export function itemsToTranscript(items, ts) {
+    return itemsToUiMessages(items, ts)
+        .filter((message) => message.blocks.some((block) => block.kind === "text"))
+        .map((message) => ({
+        role: message.role,
+        text: message.blocks
+            .map((block) => (block.kind === "text" ? block.text : ""))
+            .join("")
+            .trim(),
+        ts,
+    }))
+        .filter((message) => message.text !== "");
+}
+/** turn 的起始时间（秒 → 毫秒）；没有就用兜底值 */
+export function turnTs(turn, fallback) {
+    return typeof turn.startedAt === "number" ? turn.startedAt * 1000 : fallback;
+}
+/** 模型目录 → 模型下拉（隐藏模型不显示；id 用 model slug，切模型直接回传它） */
+export function mapModels(models) {
+    return models
+        .filter((model) => model.hidden !== true)
+        .map((model) => ({
+        id: model.model || model.id,
+        label: model.displayName && model.displayName !== model.model ? `${model.displayName}` : model.model || model.id,
+        ...(model.isDefault ? { current: true } : {}),
+    }));
+}
+/** 某个模型支持的思考档位（codex 的 reasoning efforts） */
+export function thinkingLevelsOf(models, modelId) {
+    const model = models.find((item) => (item.model || item.id) === modelId) ?? models.find((item) => item.id === modelId);
+    if (!model?.supportedReasoningEfforts)
+        return [];
+    return model.supportedReasoningEfforts
+        .map((effort) => effort.reasoningEffort)
+        .filter((effort) => typeof effort === "string" && effort !== "");
+}
+/** 命令行 → 「这类」的作用域键（与 pi 侧的 bash 规则同构，`总是允许这类` 才有意义） */
+export function commandScope(command) {
+    const first = command.trim().split(/\s+/)[0] ?? "";
+    const clean = first.replace(/^.*\//, "");
+    return { scopeKey: `bash|${clean}`, scopeHint: clean === "" ? command.trim().slice(0, 60) : clean };
+}
+/** 命令执行审批 → 工作台的审批请求 */
+export function commandApprovalRequest(params) {
+    const command = typeof params.command === "string" ? params.command : "";
+    const scope = commandScope(command);
+    const reason = typeof params.reason === "string" && params.reason !== "" ? params.reason : null;
+    return {
+        toolName: "shell",
+        argsSummary: command === "" ? "（未提供命令）" : command.slice(0, 300),
+        scopeKey: scope.scopeKey,
+        scopeHint: scope.scopeHint,
+        riskNote: reason ?? "codex 请求执行命令；是否放行由你决定",
+    };
+}
+/** 文件改动审批 → 工作台的审批请求 */
+export function fileChangeApprovalRequest(params) {
+    const root = typeof params.grantRoot === "string" ? params.grantRoot : "";
+    const reason = typeof params.reason === "string" && params.reason !== "" ? params.reason : null;
+    return {
+        toolName: "apply_patch",
+        argsSummary: root === "" ? "改动工作区文件" : `允许写入 ${root}`,
+        scopeKey: `write|${root}`,
+        scopeHint: root === "" ? "工作区文件" : root,
+        riskNote: reason ?? "codex 想改动工作区文件，确认后才继续",
+    };
+}
+/** 审批决定 → codex 的 decision 字符串 */
+export function approvalDecision(decision, kind) {
+    if (decision === "deny")
+        return "decline";
+    if (decision === "always")
+        return "acceptForSession";
+    return kind === "command" ? "accept" : "accept";
+}
+/** 模型下拉里显示的当前模型（codex 的 provider 只有一个，给个稳定标签） */
+export function modelDisplay(provider, model) {
+    if (!model)
+        return null;
+    return `${provider ?? "codex"}/${model}`;
+}
+/** 给 `ModelOption` 用：把引擎模型表转成快照里的形状（保留顺序，去重） */
+export function toModelOptions(models) {
+    const seen = new Set();
+    const options = [];
+    for (const model of models) {
+        if (seen.has(model.id))
+            continue;
+        seen.add(model.id);
+        options.push({ id: model.id, label: model.label });
+    }
+    return options;
+}
+export function toolStartOf(item) {
+    const id = item.id ?? `codex-tool-${item.type}`;
+    if (item.type === "commandExecution") {
+        return {
+            type: "tool_start",
+            toolCallId: id,
+            name: "shell",
+            argsSummary: item.command ?? "",
+            argsFull: item.command ?? "",
+        };
+    }
+    if (item.type === "fileChange") {
+        return { type: "tool_start", toolCallId: id, name: "apply_patch", argsSummary: "改动工作区文件" };
+    }
+    if (item.type === "mcpToolCall" || item.type === "dynamicToolCall") {
+        const name = item.server ? `${item.server}.${item.tool ?? "tool"}` : (item.tool ?? "tool");
+        return { type: "tool_start", toolCallId: id, name, argsSummary: "" };
+    }
+    return null;
+}
+export function toolEndOf(item) {
+    const id = item.id ?? `codex-tool-${item.type}`;
+    const ok = item.status === "completed" || item.status === "ok";
+    if (item.type === "commandExecution") {
+        return {
+            type: "tool_end",
+            toolCallId: id,
+            status: ok ? "ok" : "failed",
+            output: item.aggregatedOutput ?? "",
+            ...(typeof item.exitCode === "number" ? { exitCode: item.exitCode } : {}),
+        };
+    }
+    if (item.type === "fileChange") {
+        return { type: "tool_end", toolCallId: id, status: ok ? "ok" : "failed", output: "" };
+    }
+    if (item.type === "mcpToolCall" || item.type === "dynamicToolCall") {
+        const output = item.error?.message ?? (item.result === undefined ? "" : JSON.stringify(item.result));
+        return { type: "tool_end", toolCallId: id, status: ok ? "ok" : "failed", output };
+    }
+    return null;
+}
+/**
+ * codex 的错误 → 人话。
+ * 最常见的一条是**写入锁**：同一个 thread 同时被 Codex 桌面端/TUI 打开时，app-server 会拒绝
+ * resume（`thread-store conflict` / `active writer`）—— 这不是 bug，是原生行为，
+ * 必须让用户知道该关哪一边，而不是只看到「切换模型失败」。
+ */
+export function friendlyCodexError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (/active writer|thread-store conflict/i.test(message)) {
+        return "这个会话正被 Codex（桌面端/终端）打开着，写入锁被占用：先在那里关掉它，或新建一条会话";
+    }
+    if (/no rollout found/i.test(message))
+        return "这个会话还没有落盘（先发一条消息，或换一条有历史的会话）";
+    if (/not found/i.test(message))
+        return "Codex 里找不到这个会话（可能已被删除或归档）";
+    return message;
+}

package/dist/server/engine/codex-sessions.js

@@ -0,0 +1,159 @@
+/**
+ * codex 的「项目 / 会话清单」提供者（对齐 codex 原生：项目就是 codex 的 project，会话就是 thread）。
+ *
+ * 数据全部来自 app-server：
+ *   - `project/list`（原生项目：名字 + 多个 root + 原生排序 position）；
+ *   - `thread/list`（原生会话：名字、cwd、projectId、模型、更新时间）。
+ *
+ * 分组规则（**只读，不改 codex 的任何东西**）：
+ *   1. thread.projectId 有值 → 归到那个项目；
+ *   2. 没有 projectId 但有 cwd → 归到「root 是 cwd 前缀」的项目（最长前缀胜出）；
+ *   3. 都没匹配上 → 按 cwd 单独成组（不丢会话，也不硬塞进别人的项目）。
+ *
+ * 这条兜底很重要：本机实测 codex 的 threads.project_id 大量为 NULL（Desktop 只在某些路径下写入），
+ * 只按 projectId 归类会让侧栏空掉。
+ */
+import { basename } from "node:path";
+import { isScratchCwd } from "./scratch.js";
+/**
+ * 拉会话时必须显式声明这两项，否则会「看不见大部分历史」（实测 0.162/0.163）：
+ *   - `modelProviders: []` → 缺省时服务端只返回**当前配置的 provider** 的会话
+ *     （本机 35 条非归档会话里，缺省只回了 13 条）；
+ *   - `sourceKinds` 全给 → 缺省只回「交互式来源」，`exec` 起的会话会被吞掉。
+ */
+const ALL_SOURCES = ["cli", "vscode", "exec", "appServer", "subAgent", "unknown"];
+const cwdOf = (thread) => thread.cwd ?? "";
+/** cwd 是否落在某个 root 里（等于或在其下；避免 `/a/bc` 冒充 `/a/b`） */
+function underRoot(cwd, root) {
+    if (cwd === "" || root === "")
+        return false;
+    if (cwd === root)
+        return true;
+    return cwd.startsWith(root.endsWith("/") ? root : `${root}/`);
+}
+/**
+ * 纯分组：projects + threads → 侧栏形状（单测直接覆盖）。
+ * 会话按 updatedAt 倒序；项目之间保持 codex 的 position 顺序。
+ */
+export function groupThreads(projects, threads) {
+    const byProjectId = new Map(projects.map((project) => [project.id, project]));
+    const roots = projects.flatMap((project) => project.roots.map((root) => ({ projectId: project.id, path: root.path ?? "" })));
+    const groups = new Map();
+    const ensureGroup = (key, project, cwd) => {
+        const known = groups.get(key);
+        if (known)
+            return known;
+        const created = { project, cwd, sessions: [] };
+        groups.set(key, created);
+        return created;
+    };
+    // 先把所有项目建出来（没有会话的项目也要显示：原生侧栏就是这样的）
+    for (const project of projects) {
+        ensureGroup(`project:${project.id}`, project, project.roots[0]?.path ?? "");
+    }
+    for (const thread of threads) {
+        if (thread.archived === true)
+            continue;
+        const cwd = cwdOf(thread);
+        const explicit = thread.projectId ? byProjectId.get(thread.projectId) : undefined;
+        let project = explicit ?? null;
+        if (!project && cwd !== "") {
+            // 最长前缀胜出：嵌套 root（monorepo）时归到最具体的那个项目
+            const match = roots
+                .filter((root) => underRoot(cwd, root.path))
+                .sort((left, right) => right.path.length - left.path.length)[0];
+            if (match)
+                project = byProjectId.get(match.projectId) ?? null;
+        }
+        // 临时目录里的随手会话（`codex exec` 的一次性跑）不进侧栏；当前正在聊的那条
+        // 仍然看得到 —— 侧栏会把 state.conversations 合进来（见 Sidebar）。
+        if (!project && isScratchCwd(cwd))
+            continue;
+        const key = project ? `project:${project.id}` : `cwd:${cwd || "unknown"}`;
+        const group = ensureGroup(key, project, project?.roots[0]?.path ?? cwd);
+        group.sessions.push({
+            id: thread.id,
+            engineSessionId: thread.id,
+            title: (thread.name ?? "").trim() || (thread.preview ?? "").trim() || "(未命名会话)",
+            startedAt: typeof thread.createdAt === "number" ? thread.createdAt * 1000 : 0,
+            updatedAt: typeof thread.updatedAt === "number" ? thread.updatedAt * 1000 : 0,
+            cwd: cwd || group.cwd,
+            model: thread.model ?? null,
+        });
+    }
+    return [...groups.values()]
+        .map((group) => ({
+        cwd: group.cwd,
+        name: group.project?.name?.trim() || basename(group.cwd) || "未分项目",
+        sessions: [...group.sessions].sort((left, right) => right.updatedAt - left.updatedAt),
+    }))
+        // 有会话的排前面；同组内按最近更新时间
+        .sort((left, right) => {
+        const leftAt = left.sessions[0]?.updatedAt ?? 0;
+        const rightAt = right.sessions[0]?.updatedAt ?? 0;
+        return rightAt - leftAt;
+    });
+}
+/** 分页拉全部会话（跟随 nextCursor；上限 5 页，避免超大库把首屏拖死） */
+export async function listAllThreads(client, pageSize = 200) {
+    const rows = [];
+    let cursor = null;
+    for (let page = 0; page < 5; page += 1) {
+        const result = await client.request("thread/list", {
+            limit: pageSize,
+            modelProviders: [],
+            sourceKinds: [...ALL_SOURCES],
+            ...(cursor ? { cursor } : {}),
+        });
+        rows.push(...(result?.data ?? []));
+        cursor = result?.nextCursor ?? null;
+        if (!cursor)
+            break;
+    }
+    return rows;
+}
+/**
+ * 保证某个目录在 codex 里有一个原生 project（新建会话时用）。
+ *
+ * - 已有覆盖它的项目（root 相同或是其前缀）→ 直接用（取最长前缀，嵌套目录不会归错）；
+ * - 没有 → `project/create`，`idempotencyKey` 按目录固定，重复点不会建出两个；
+ * - 老版本 codex 没有 `project/*` → 返回 null，退回「只有 cwd」的老行为（不阻塞建会话）。
+ */
+export async function ensureCodexProject(client, workspace) {
+    if (!workspace)
+        return null;
+    try {
+        const list = await client.request("project/list", {});
+        const match = (list?.data ?? [])
+            .flatMap((project) => (project.roots ?? []).map((root) => ({ id: project.id, path: root.path ?? "" })))
+            .filter((root) => root.path !== "" && (workspace === root.path || workspace.startsWith(`${root.path}/`)))
+            .sort((left, right) => right.path.length - left.path.length)[0];
+        if (match)
+            return match.id;
+        const created = await client.request("project/create", {
+            name: workspace.split("/").filter(Boolean).pop() ?? workspace,
+            roots: [{ path: workspace }],
+            idempotencyKey: `agent-web:${workspace}`,
+        });
+        return created?.project?.id ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export function createCodexSessionsProvider(options) {
+    return async () => {
+        const [projects, threads] = await Promise.all([
+            options.client
+                .request("project/list", { sortKey: "position" })
+                .then((result) => result?.data ?? [])
+                .catch((error) => {
+                // 老版本 codex 没有 project/*：退化成「只按 cwd 分组」，不要让侧栏整体失败
+                options.log?.(`codex project/list 不可用：${error instanceof Error ? error.message : String(error)}`);
+                return [];
+            }),
+            listAllThreads(options.client, options.limit ?? 200),
+        ]);
+        return groupThreads(projects, threads);
+    };
+}

package/dist/server/engine/codex-transport.js

@@ -0,0 +1,49 @@
+/**
+ * codex app-server 客户端（JSONL over stdio）。
+ *
+ * 为什么是「子进程 + stdio」而不是自建协议：codex 自己就有本地服务（`codex app-server`），
+ * 项目 / 会话 / 回合 / 审批全走它的 JSON-RPC。我们只当客户端，**不碰它的存储格式**
+ * （`state_5.sqlite`、rollout jsonl 都不直写），这样 Codex Desktop / CLI 与工作台看到的是
+ * 同一份会话。
+ *
+ * 生命周期：懒启动（第一次 request 才 spawn）+ 按需重建（进程挂了下次请求再拉起）。
+ * 这样「机器上没装 codex」不会让工作台起不来 —— 只有在真正用这个引擎时才报错。
+ *
+ * 帧格式（实测 0.162/0.163 一致）：
+ *   请求 → `{"id":1,"method":"thread/list","params":{...}}\n`
+ *   响应 → `{"id":1,"result":{...}}` / `{"id":1,"error":{"code":-32602,"message":"..."}}`
+ *   通知 → `{"method":"item/agentMessage/delta","params":{...},"emittedAtMs":...}`
+ *   服务端请求（审批）→ `{"id":9,"method":"item/commandExecution/requestApproval","params":{...}}`
+ *     客户端必须回 `{"id":9,"result":{...}}`，否则那一轮会一直等。
+ */
+import { createJsonRpcStdioClient } from "./jsonrpc-stdio.js";
+/**
+ * codex app-server 客户端 = 通用 JSON-RPC stdio 客户端 + codex 的握手。
+ * 握手结果里的 userAgent 形如 `agent-web/0.163.0 (Mac OS …)`，取中间的版本号。
+ */
+export function createCodexClient(options = {}) {
+    const log = options.log ?? (() => { });
+    return createJsonRpcStdioClient({
+        bin: options.bin ?? "codex",
+        args: ["app-server"],
+        env: options.home ? { CODEX_HOME: options.home } : undefined,
+        name: "codex",
+        log,
+        timeoutMs: options.timeoutMs,
+        // codex 不带 jsonrpc 信封（实测 0.162/0.163 都接受裸 {id,method,params}）
+        jsonrpc: false,
+        async handshake(call) {
+            const result = (await call("initialize", {
+                clientInfo: {
+                    name: options.clientName ?? "agent-web",
+                    title: "agent-web",
+                    version: options.clientVersion ?? "0.1.0",
+                },
+                // experimentalApi 打开隐藏方法（project/* 等）；实测 0.162/0.163 都支持
+                capabilities: { experimentalApi: true, requestAttestation: false },
+            }));
+            const match = /^[^/]+\/([0-9][^\s]*)/.exec(result?.userAgent ?? "");
+            return { version: match?.[1] ?? null };
+        },
+    });
+}