@botlearn-course/daemon 0.0.1

package/dist/runtimes/codex.js

@@ -0,0 +1,332 @@
+import { execFileSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { NdjsonStreamAdapter } from "./ndjson-stream.js";
+import { wrapEngineAdapter, } from "./engine.js";
+import { firstExistingPath, readCommandVersion, resolveCommandOnPath, } from "./probe.js";
+// 权限姿态：daemon 驱动的 Codex run 非交互、无审批中继，且每个 run 的工作区已隔离，
+// 因此默认 danger-full-access + approval_policy=never；需要收紧可用 extraArgs 覆盖。
+const CODEX_DESKTOP_BUNDLE_PATH = "/Applications/Codex.app/Contents/Resources/codex";
+/** Codex 会话 id 是 36 位带连字符的 UUID；拒绝其他形状以保证 argv 安全。 */
+const CODEX_SESSION_ID_RE = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;
+const CODEX_FOREIGN_EXTRA_FLAGS_WITH_VALUE = new Set([
+    "--append-system-prompt",
+    "--permission-mode",
+]);
+const CODEX_SANDBOX_MODES = new Set(["read-only", "workspace-write", "danger-full-access"]);
+function extraFlagName(arg) {
+    if (!arg.startsWith("-"))
+        return arg;
+    const eq = arg.indexOf("=");
+    return eq === -1 ? arg : arg.slice(0, eq);
+}
+/** 把不可信 JSON 值收敛为有限非负数，否则 undefined。 */
+function numOrUndefined(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : undefined;
+}
+function nextExtraValue(args, index) {
+    const next = args[index + 1];
+    if (typeof next !== "string")
+        return undefined;
+    if (!next.startsWith("-"))
+        return next;
+    return /^-\d/.test(next) ? next : undefined;
+}
+export function sanitizeCodexExtraArgs(extraArgs) {
+    if (!extraArgs?.length)
+        return [];
+    const out = [];
+    for (let i = 0; i < extraArgs.length; i += 1) {
+        const arg = extraArgs[i];
+        const name = extraFlagName(arg);
+        if (CODEX_FOREIGN_EXTRA_FLAGS_WITH_VALUE.has(name)) {
+            if (!arg.includes("=") && nextExtraValue(extraArgs, i) !== undefined)
+                i += 1;
+            continue;
+        }
+        // `codex exec resume` 不接受 -s/--sandbox；改写成两个子命令都接受的 -c 覆盖。
+        if (name === "-s" || name === "--sandbox") {
+            const value = arg.includes("=")
+                ? arg.slice(arg.indexOf("=") + 1)
+                : nextExtraValue(extraArgs, i);
+            if (!arg.includes("=") && value !== undefined)
+                i += 1;
+            if (value && CODEX_SANDBOX_MODES.has(value)) {
+                out.push("-c", `sandbox_mode="${value}"`);
+            }
+            continue;
+        }
+        if (arg === "--full-auto") {
+            out.push("--dangerously-bypass-approvals-and-sandbox");
+            continue;
+        }
+        out.push(arg);
+    }
+    return out;
+}
+function hasCodexSandboxOverride(args) {
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        if (arg === "--dangerously-bypass-approvals-and-sandbox" ||
+            arg.startsWith("-c sandbox_mode=") ||
+            arg.startsWith("-csandbox_mode=") ||
+            arg.startsWith("--config=sandbox_mode=")) {
+            return true;
+        }
+        if ((arg === "-c" || arg === "--config") && args[i + 1]?.startsWith("sandbox_mode=")) {
+            return true;
+        }
+    }
+    return false;
+}
+/** 通过 PATH 或 macOS 桌面 bundle 解析 Codex CLI 可执行文件。 */
+export function resolveCodexCommand(deps = {}) {
+    const onPath = resolveCommandOnPath("codex", deps);
+    if (onPath)
+        return onPath;
+    return firstExistingPath([CODEX_DESKTOP_BUNDLE_PATH], deps);
+}
+function resolveCodexGlobalNpmEntry() {
+    try {
+        const globalRoot = execFileSync("npm", ["root", "-g"], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+            timeout: 5000,
+        }).trim();
+        if (!globalRoot)
+            return null;
+        const candidate = path.join(globalRoot, "@openai", "codex", "bin", "codex.js");
+        return existsSync(candidate) ? candidate : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 探测 Codex CLI 是否安装并读取版本。 */
+export function probeCodex(deps = {}) {
+    const command = resolveCodexCommand(deps);
+    if (command) {
+        return {
+            available: true,
+            path: command,
+            version: readCommandVersion(command, [], deps) ?? undefined,
+        };
+    }
+    // npm 全局安装但 bin 不在 PATH 上：报告 .js 入口，但 resolveBinary 不用它
+    // （.js 无法直接 spawn）。
+    const npmEntry = resolveCodexGlobalNpmEntry();
+    if (npmEntry) {
+        return {
+            available: true,
+            path: npmEntry,
+            version: readCommandVersion(process.execPath, [npmEntry], deps) ?? undefined,
+        };
+    }
+    return { available: false };
+}
+/**
+ * Codex adapter — spawn `codex exec [resume <sid>] --json ...` 并解析 JSONL 事件流。
+ *
+ * 事件形状（节选）：
+ *   {"type":"thread.started","thread_id":"<uuid>"}
+ *   {"type":"turn.started"}
+ *   {"type":"item.started","item":{"type":"command_execution", ...}}
+ *   {"type":"item.completed","item":{"type":"agent_message","text":"..."}}
+ *   {"type":"turn.completed","usage":{...}}
+ *
+ * `codex exec` 不报告 USD 成本，只报 token 用量，所以 costUsd 恒空。
+ * systemContext 走 prompt 前缀（Codex 没有 --append-system-prompt；本包单轮
+ * 执行、不复用 transcript，前缀不会跨轮累积）。
+ */
+export class CodexAdapter extends NdjsonStreamAdapter {
+    id = "codex";
+    explicitBinary;
+    resolvedBinary = null;
+    constructor(opts) {
+        super(opts?.logger);
+        this.explicitBinary = opts?.binary ?? process.env.BOTLEARN_CODEX_BIN;
+    }
+    async run(opts) {
+        if (opts.sessionId && !CODEX_SESSION_ID_RE.test(opts.sessionId)) {
+            throw new Error(`codex: invalid sessionId "${opts.sessionId}" (expected UUID)`);
+        }
+        return super.run(opts);
+    }
+    resolveBinary() {
+        if (this.explicitBinary)
+            return this.explicitBinary;
+        if (this.resolvedBinary)
+            return this.resolvedBinary;
+        this.resolvedBinary = resolveCodexCommand() ?? "codex";
+        return this.resolvedBinary;
+    }
+    /**
+     * 新会话：`exec <tail> -- <prompt>`；resume：`exec resume <sid> <tail> -- <prompt>`。
+     * 两条路径共享同一个 tail（sandbox/approval 用 -c 表达以兼容 resume）。
+     * `--` 隔开 flags 与 positionals，防止以 `-` 开头的 prompt 被解析成选项。
+     */
+    buildArgs(opts) {
+        const tail = [];
+        const extraArgs = sanitizeCodexExtraArgs(opts.extraArgs);
+        const hasSandboxOverride = hasCodexSandboxOverride(extraArgs);
+        if (!hasSandboxOverride) {
+            tail.push("-c", 'sandbox_mode="danger-full-access"', "-c", 'approval_policy="never"');
+        }
+        tail.push("--skip-git-repo-check", "--json");
+        if (extraArgs.length)
+            tail.push(...extraArgs);
+        const prompt = composeCodexPrompt(opts.text, opts.systemContext);
+        if (opts.sessionId) {
+            return ["exec", "resume", opts.sessionId, ...tail, "--", prompt];
+        }
+        return ["exec", ...tail, "--", prompt];
+    }
+    spawnEnv(_opts) {
+        return {
+            ...process.env,
+            // 保证 JSONL 输出不混入 ANSI 转义。
+            FORCE_COLOR: "0",
+            NO_COLOR: "1",
+        };
+    }
+    handleEvent(raw, ctx) {
+        const obj = raw;
+        const status = codexStatusEvent(obj);
+        if (status)
+            ctx.emitStatus(status);
+        ctx.emitBlock(normalizeBlock(obj, ctx.seq));
+        if (obj.type === "thread.started") {
+            if (typeof obj.thread_id === "string") {
+                ctx.state.newSessionId = obj.thread_id;
+            }
+            return;
+        }
+        if (obj.type === "item.completed" && obj.item?.type === "agent_message") {
+            if (typeof obj.item.text === "string") {
+                ctx.appendAssistantText(obj.item.text);
+                // 最后一条 agent_message 即最终回复。
+                ctx.state.finalText = obj.item.text;
+            }
+            return;
+        }
+        if (obj.type === "turn.completed") {
+            // usage 成功与失败的 turn 都会报。input_tokens 含缓存部分，
+            // miss = input_tokens - cached_input_tokens。仅本地诊断用。
+            const usage = obj.usage;
+            if (usage && typeof usage === "object") {
+                const input = numOrUndefined(usage.input_tokens);
+                const cached = numOrUndefined(usage.cached_input_tokens);
+                const output = numOrUndefined(usage.output_tokens);
+                const hit = cached;
+                const miss = input !== undefined ? Math.max(0, input - (cached ?? 0)) : undefined;
+                if (hit !== undefined || miss !== undefined || output !== undefined) {
+                    ctx.state.usage = {
+                        ...(hit !== undefined ? { inputCacheHitTokens: hit } : {}),
+                        ...(miss !== undefined ? { inputCacheMissTokens: miss } : {}),
+                        ...(output !== undefined ? { outputTokens: output } : {}),
+                    };
+                }
+            }
+            if (obj.turn?.status === "failed") {
+                ctx.state.errorText =
+                    obj.turn.error?.message?.trim() || summarizeCodexErrorEvent(raw) || "codex turn failed";
+            }
+            return;
+        }
+        if (obj.type === "error") {
+            const err = obj.error;
+            const fromMessage = typeof err === "string" ? err.trim() : (err?.message?.trim() ?? "");
+            ctx.state.errorText = fromMessage || summarizeCodexErrorEvent(raw) || "codex error";
+        }
+    }
+}
+/** systemContext 前缀 + 分隔线；空/纯空白时原样返回 text。 */
+function composeCodexPrompt(text, systemContext) {
+    const sc = systemContext?.trim();
+    if (!sc)
+        return text;
+    return `${sc}\n\n---\n\n${text}`;
+}
+/**
+ * codex `error` / 失败 `turn.completed` 事件的兜底摘要：error.message 缺失时
+ * 用紧凑 JSON 代替不可诊断的 "codex error"，截断防失控。
+ */
+function summarizeCodexErrorEvent(raw) {
+    try {
+        const json = JSON.stringify(raw);
+        if (!json || json === "{}" || json === "null")
+            return "";
+        return json.length > 800 ? `${json.slice(0, 800)}…` : json;
+    }
+    catch {
+        return "";
+    }
+}
+function codexStatusEvent(obj) {
+    if (obj.type === "thread.started") {
+        return { kind: "thinking", phase: "started", label: "Starting session" };
+    }
+    if (obj.type === "turn.started") {
+        return { kind: "thinking", phase: "started", label: "Thinking" };
+    }
+    if (obj.type === "item.started" && typeof obj.item?.type === "string") {
+        const tool = obj.item.type;
+        if (tool === "command_execution" ||
+            tool === "file_change" ||
+            tool === "mcp_tool_call" ||
+            tool === "web_search") {
+            return { kind: "thinking", phase: "updated", label: codexToolLabel(tool) };
+        }
+    }
+    if (obj.type === "item.completed" && obj.item?.type === "agent_message") {
+        return { kind: "thinking", phase: "stopped" };
+    }
+    if (obj.type === "turn.completed") {
+        return { kind: "thinking", phase: "stopped" };
+    }
+    return undefined;
+}
+function codexToolLabel(tool) {
+    switch (tool) {
+        case "command_execution":
+            return "Running command";
+        case "file_change":
+            return "Editing files";
+        case "mcp_tool_call":
+            return "Calling tool";
+        case "web_search":
+            return "Searching web";
+        default:
+            return tool;
+    }
+}
+function normalizeBlock(obj, seq) {
+    let kind = "other";
+    const type = obj?.type;
+    const itemType = obj?.item?.type;
+    if (type === "thread.started" || type === "turn.started" || type === "turn.completed") {
+        kind = "system";
+    }
+    else if (type === "item.completed" && itemType === "agent_message") {
+        kind = "assistant_text";
+    }
+    else if (type === "item.started" || type === "item.completed") {
+        if (itemType === "command_execution" ||
+            itemType === "file_change" ||
+            itemType === "mcp_tool_call" ||
+            itemType === "web_search") {
+            kind = type === "item.completed" ? "tool_result" : "tool_use";
+        }
+    }
+    return { raw: obj, kind, seq };
+}
+export const codexModule = {
+    id: "codex",
+    displayName: "Codex CLI",
+    binary: "codex",
+    probe: async () => probeCodex(),
+    create: () => wrapEngineAdapter("codex", new CodexAdapter(), {
+        // codex 没有一等 --model flag；模型走 -c 覆盖（值带引号，与 sandbox_mode 一致）。
+        modelArgs: (m) => ["-c", `model="${m}"`],
+    }),
+};

package/dist/runtimes/deepseek-tui.d.ts

@@ -0,0 +1,50 @@
+import { spawn } from "node:child_process";
+import { type ProbeDeps } from "./probe.js";
+import { type EngineAdapter, type EngineRunOptions, type EngineRunResult } from "./engine.js";
+import type { RuntimeModule, RuntimeProbe } from "../types.js";
+interface DeepseekAdapterDeps {
+    binary?: string;
+    /** 测试注入：使用现成的兼容 server，不 spawn `deepseek`。 */
+    serverUrl?: string;
+    authToken?: string;
+    fetchFn?: typeof fetch;
+    spawnFn?: typeof spawn;
+}
+/** 解析 PATH 上的 `deepseek` dispatcher CLI。 */
+export declare function resolveDeepseekCommand(deps?: ProbeDeps): string | null;
+export declare function probeDeepseekTui(deps?: ProbeDeps): RuntimeProbe;
+/**
+ * DeepSeek TUI 引擎。驱动 `deepseek serve --http` 暴露的 headless runtime
+ * API（HTTP/SSE），不是交互式 TUI 也不是 ACP —— HTTP/SSE 是其文档化的完整
+ * runtime 面；ACP 目前只是保守的编辑器基线。
+ *
+ * 权限姿态：course run 在 owner 本机的隔离工作区执行，线程一律
+ * `allow_shell/trust_mode/auto_approve = true`（owner 信任，无审批人可交互）。
+ */
+export declare class DeepseekTuiAdapter implements EngineAdapter {
+    readonly id: "deepseek-tui";
+    private readonly explicitBinary;
+    private readonly explicitServerUrl;
+    private readonly explicitAuthToken;
+    private readonly fetchFn;
+    private readonly spawnFn;
+    private resolvedBinary;
+    constructor(deps?: DeepseekAdapterDeps);
+    run(opts: EngineRunOptions): Promise<EngineRunResult>;
+    private resolveBinary;
+    private acquireHandle;
+    /**
+     * 不设置 DEEPSEEK_RUNTIME_DIR：server 跨 run 池化共享，per-run 目录不成立；
+     * BYOA 直接用用户本机 deepseek 自身的默认状态目录（含已登录凭据）。
+     */
+    private spawnEnv;
+    private createThread;
+    private patchThreadSystemContext;
+    private startTurnAndReadEvents;
+    private readEvents;
+    private requestJson;
+}
+/** 仅测试用：清空进程池。 */
+export declare function __resetDeepseekTuiPoolForTests(): void;
+export declare const deepseekTuiModule: RuntimeModule;
+export {};