@botlearn-course/daemon 0.0.1

package/dist/runtimes/claude-code.js

@@ -0,0 +1,353 @@
+import { execFileSync } from "node:child_process";
+import path from "node:path";
+import { NdjsonStreamAdapter } from "./ndjson-stream.js";
+import { wrapEngineAdapter, } from "./engine.js";
+import { looksLikeRuntimeAuthFailure } from "./runtime-errors.js";
+import { firstExistingPath, readCommandVersion, resolveCommandOnPath, resolveHomePath, } from "./probe.js";
+// 权限姿态：daemon 驱动的 Claude Code run 非交互、无审批中继，且工作区已按 run 隔离，
+// 因此默认 --permission-mode bypassPermissions；需要收紧可用 extraArgs 覆盖。
+const CLAUDE_DESKTOP_CLI_RELATIVE_PATH = path.join("Applications", "Claude Code URL Handler.app", "Contents", "MacOS", "claude");
+const CLAUDE_DESKTOP_CLI_SYSTEM_PATH = "/Applications/Claude Code URL Handler.app/Contents/MacOS/claude";
+/** 这些 env 会覆盖 ~/.claude 的存量登录凭据；spawn 前必须剔除。 */
+const CLAUDE_CODE_AUTH_ENV_DENYLIST = [
+    "ANTHROPIC_API_KEY",
+    "ANTHROPIC_AUTH_TOKEN",
+    "ANTHROPIC_BASE_URL",
+    "ANTHROPIC_CUSTOM_HEADERS",
+    "CLAUDE_CODE_OAUTH_TOKEN",
+];
+export function scrubClaudeCodeAuthEnv(env) {
+    const out = { ...env };
+    for (const key of CLAUDE_CODE_AUTH_ENV_DENYLIST) {
+        delete out[key];
+    }
+    return out;
+}
+function isValidClaudeSessionId(sessionId) {
+    if (sessionId.length === 0 || sessionId.length > 512)
+        return false;
+    if (sessionId.startsWith("-"))
+        return false;
+    for (const ch of sessionId) {
+        const code = ch.codePointAt(0);
+        if (code === undefined || code < 0x20 || code === 0x7f)
+            return false;
+    }
+    return true;
+}
+function invalidClaudeSessionIdError() {
+    return "claude-code: invalid sessionId (expected non-control text not starting with '-')";
+}
+const CLAUDE_FOREIGN_FLAGS_WITH_VALUE = new Set([
+    "--color",
+    "--config",
+    "--disable",
+    "--enable",
+    "--image",
+    "--local-provider",
+    "--output-last-message",
+    "--output-schema",
+    "--profile",
+    "--sandbox",
+    "-i",
+    "-o",
+    "-p",
+    "-s",
+]);
+const CLAUDE_FOREIGN_BOOLEAN_FLAGS = new Set([
+    "--all",
+    "--dangerously-bypass-approvals-and-sandbox",
+    "--ephemeral",
+    "--full-auto",
+    "--ignore-rules",
+    "--ignore-user-config",
+    "--json",
+    "--last",
+    "--oss",
+    "--print",
+    "--skip-git-repo-check",
+]);
+function extraFlagName(arg) {
+    if (!arg.startsWith("-"))
+        return arg;
+    const eq = arg.indexOf("=");
+    return eq === -1 ? arg : arg.slice(0, eq);
+}
+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 sanitizeClaudeExtraArgs(extraArgs) {
+    if (!extraArgs?.length)
+        return [];
+    const out = [];
+    for (let i = 0; i < extraArgs.length; i += 1) {
+        const arg = extraArgs[i];
+        const name = extraFlagName(arg);
+        // codex 的裸 -c（TOML 覆盖）总带一个值。
+        if (arg === "-c") {
+            const value = nextExtraValue(extraArgs, i);
+            if (value !== undefined)
+                i += 1;
+            continue;
+        }
+        if (name === "--config" || name === "--sandbox") {
+            if (!arg.includes("=") && nextExtraValue(extraArgs, i) !== undefined)
+                i += 1;
+            continue;
+        }
+        if (CLAUDE_FOREIGN_FLAGS_WITH_VALUE.has(name)) {
+            if (!arg.includes("=") && nextExtraValue(extraArgs, i) !== undefined)
+                i += 1;
+            continue;
+        }
+        if (CLAUDE_FOREIGN_BOOLEAN_FLAGS.has(name)) {
+            continue;
+        }
+        out.push(arg);
+    }
+    return out;
+}
+/** 通过 PATH 或 macOS 桌面 bundle 兜底解析 Claude Code CLI。 */
+export function resolveClaudeCommand(deps = {}) {
+    const onPath = resolveCommandOnPath("claude", deps);
+    if (onPath)
+        return onPath;
+    if ((deps.platform ?? process.platform) !== "darwin")
+        return null;
+    return firstExistingPath([resolveHomePath(CLAUDE_DESKTOP_CLI_RELATIVE_PATH, deps), CLAUDE_DESKTOP_CLI_SYSTEM_PATH], deps);
+}
+/** 探测 Claude Code CLI 是否安装并读取版本。 */
+export function probeClaude(deps = {}) {
+    const command = resolveClaudeCommand(deps);
+    if (!command)
+        return { available: false };
+    return {
+        available: true,
+        path: command,
+        version: readCommandVersion(command, [], deps) ?? undefined,
+    };
+}
+/** 用 `claude -p ping` 探测登录态；Claude Code 会把认证失败伪装成 success result。 */
+export function probeClaudeAuth(deps = {}) {
+    const command = resolveClaudeCommand(deps);
+    if (!command)
+        return { checked: false, ok: false, message: "claude command not found" };
+    return runClaudeAuthProbe(command, deps);
+}
+function runClaudeAuthProbe(command, deps = {}) {
+    const execFn = deps.execFileSyncFn ?? execFileSync;
+    const env = scrubClaudeCodeAuthEnv(deps.env ?? process.env);
+    try {
+        // 新版 claude 要求 --print + stream-json 必须带 --verbose，否则探测恒失败。
+        const raw = execFn(command, ["-p", "ping", "--output-format", "stream-json", "--verbose"], {
+            stdio: ["ignore", "pipe", "pipe"],
+            env,
+            timeout: 20_000,
+        });
+        const output = Buffer.isBuffer(raw) ? raw.toString("utf8") : String(raw ?? "");
+        const authFailure = claudeAuthFailureFromOutput(output);
+        if (authFailure)
+            return { checked: true, ok: false, message: authFailure };
+        return { checked: true, ok: true, message: "claude-code auth ok" };
+    }
+    catch (err) {
+        const e = err;
+        const output = `${bufferishToString(e.stdout)}\n${bufferishToString(e.stderr)}`.trim();
+        const authFailure = claudeAuthFailureFromOutput(output);
+        return {
+            checked: true,
+            ok: false,
+            message: authFailure || e.message || "claude-code auth probe failed",
+        };
+    }
+}
+function bufferishToString(raw) {
+    return Buffer.isBuffer(raw) ? raw.toString("utf8") : String(raw ?? "");
+}
+function claudeAuthFailureFromOutput(output) {
+    for (const line of output.split(/\r?\n/)) {
+        const s = line.trim();
+        if (!s)
+            continue;
+        try {
+            const obj = JSON.parse(s);
+            if (obj.type === "result" &&
+                typeof obj.result === "string" &&
+                looksLikeRuntimeAuthFailure(obj.result)) {
+                return obj.result;
+            }
+        }
+        catch {
+            if (looksLikeRuntimeAuthFailure(s))
+                return s;
+        }
+    }
+    return looksLikeRuntimeAuthFailure(output) ? output : null;
+}
+/**
+ * Claude Code adapter — spawn `claude -p "<text>" --output-format stream-json`
+ * （有会话时加 `--resume <sid>`）并解析 ndjson 流。
+ *
+ * stream-json 形状（节选）：
+ *   {type:"system", subtype:"init", session_id:"...", ...}
+ *   {type:"assistant", message:{content:[{type:"text", text:"..."} | {type:"tool_use", ...}]}}
+ *   {type:"user", message:{content:[{type:"tool_result", ...}]}}
+ *   {type:"result", subtype:"success", session_id:"...", total_cost_usd: 0.01, result:"final text"}
+ */
+export class ClaudeCodeAdapter extends NdjsonStreamAdapter {
+    id = "claude-code";
+    explicitBinary;
+    resolvedBinary = null;
+    constructor(opts) {
+        super(opts?.logger);
+        this.explicitBinary = opts?.binary ?? process.env.BOTLEARN_CLAUDE_BIN;
+    }
+    async run(opts) {
+        // 非法 sessionId 不抛：返回空 newSessionId 作为「删除存量会话」信号。
+        if (opts.sessionId && !isValidClaudeSessionId(opts.sessionId)) {
+            return { text: "", newSessionId: "", error: invalidClaudeSessionIdError() };
+        }
+        return super.run(opts);
+    }
+    resolveBinary() {
+        if (this.explicitBinary)
+            return this.explicitBinary;
+        if (this.resolvedBinary)
+            return this.resolvedBinary;
+        this.resolvedBinary = resolveClaudeCommand() ?? "claude";
+        return this.resolvedBinary;
+    }
+    buildArgs(opts) {
+        const extraArgs = sanitizeClaudeExtraArgs(opts.extraArgs);
+        const args = ["-p", opts.text, "--output-format", "stream-json", "--verbose"];
+        // headless `-p` 默认不加载项目 .claude/；显式 opt-in 让工作区内种子 skills 可见。
+        if (!extraArgs.some((a) => a.startsWith("--setting-sources"))) {
+            args.push("--setting-sources", "project");
+        }
+        if (opts.sessionId) {
+            if (!isValidClaudeSessionId(opts.sessionId))
+                throw new Error(invalidClaudeSessionIdError());
+            args.push("--resume", opts.sessionId);
+        }
+        if (!extraArgs.some((a) => a.startsWith("--permission-mode"))) {
+            args.push("--permission-mode", "bypassPermissions");
+        }
+        // --append-system-prompt 按次生效、不进 resume transcript。
+        const systemPrompt = opts.systemContext?.trim() ? opts.systemContext : undefined;
+        if (systemPrompt && !extraArgs.includes("--append-system-prompt")) {
+            args.push("--append-system-prompt", systemPrompt);
+        }
+        if (extraArgs.length)
+            args.push(...extraArgs);
+        return args;
+    }
+    spawnEnv(opts) {
+        return scrubClaudeCodeAuthEnv(super.spawnEnv(opts));
+    }
+    handleEvent(raw, ctx) {
+        const obj = raw;
+        const status = claudeStatusEvent(obj);
+        if (status)
+            ctx.emitStatus(status);
+        ctx.emitBlock(normalizeBlock(obj, ctx.seq));
+        if (obj.type === "system" && obj.session_id) {
+            ctx.state.newSessionId = String(obj.session_id);
+            return;
+        }
+        if (obj.type === "assistant" && Array.isArray(obj.message?.content)) {
+            for (const c of obj.message.content) {
+                if (c?.type === "text" && typeof c.text === "string") {
+                    ctx.appendAssistantText(c.text);
+                }
+            }
+            return;
+        }
+        if (obj.type === "result") {
+            if (typeof obj.total_cost_usd === "number")
+                ctx.state.costUsd = obj.total_cost_usd;
+            if (obj.subtype === "success") {
+                const result = typeof obj.result === "string" ? obj.result : "";
+                // 认证失败会以 cost=0 的 success result 出现，必须重新归类为错误。
+                const looksLikeAuthFailure = obj.total_cost_usd === 0 && looksLikeRuntimeAuthFailure(result);
+                if (looksLikeAuthFailure) {
+                    this.log.error("claude-code authentication failed; check ~/.claude login or unset stale Anthropic env vars", { error: result });
+                    ctx.state.newSessionId = "";
+                    ctx.state.finalText = "";
+                    ctx.state.assistantTextChunks = [];
+                    ctx.state.assistantTextBytes = 0;
+                    ctx.state.errorText = result;
+                }
+                else {
+                    if (typeof obj.session_id === "string")
+                        ctx.state.newSessionId = obj.session_id;
+                    if (typeof obj.result === "string")
+                        ctx.state.finalText = obj.result;
+                }
+            }
+            else {
+                // 非 success（如 resume 目标缺失）：CLI 仍会为空会话发新 session_id，
+                // 持久化它会永远 resume 一个无用 UUID —— 清空让上层删除存量条目。
+                // CLI 同时非零退出，obj.result 缺失时基类会从 stderr 合成 errorText。
+                ctx.state.newSessionId = "";
+                if (typeof obj.result === "string")
+                    ctx.state.errorText = obj.result;
+            }
+        }
+    }
+}
+function claudeStatusEvent(obj) {
+    if (obj.type === "system" && obj.subtype === "init") {
+        return { kind: "thinking", phase: "started", label: "Starting session" };
+    }
+    // assistant 事件可能混合 text 与 tool_use：有 text 视为 thinking 结束，
+    // 只有 tool_use 时用工具名作为 label。
+    if (obj.type === "assistant" && Array.isArray(obj.message?.content)) {
+        const contents = obj.message.content;
+        const hasText = contents.some((c) => c?.type === "text" && typeof c.text === "string" && c.text.length > 0);
+        if (hasText)
+            return { kind: "thinking", phase: "stopped" };
+        const tool = contents.find((c) => c?.type === "tool_use");
+        if (tool) {
+            const name = typeof tool.name === "string" && tool.name ? tool.name : "tool";
+            return { kind: "thinking", phase: "updated", label: name };
+        }
+    }
+    if (obj.type === "result") {
+        return { kind: "thinking", phase: "stopped" };
+    }
+    return undefined;
+}
+function normalizeBlock(obj, seq) {
+    let kind = "other";
+    if (obj?.type === "assistant") {
+        const contents = Array.isArray(obj.message?.content) ? obj.message.content : [];
+        if (contents.some((c) => c?.type === "tool_use"))
+            kind = "tool_use";
+        else if (contents.some((c) => c?.type === "text"))
+            kind = "assistant_text";
+    }
+    else if (obj?.type === "user") {
+        const contents = Array.isArray(obj.message?.content) ? obj.message.content : [];
+        if (contents.some((c) => c?.type === "tool_result"))
+            kind = "tool_result";
+    }
+    else if (obj?.type === "system") {
+        kind = "system";
+    }
+    return { raw: obj, kind, seq };
+}
+export const claudeCodeModule = {
+    id: "claude-code",
+    displayName: "Claude Code",
+    binary: "claude",
+    envVar: "BOTLEARN_CLAUDE_BIN",
+    probe: async () => probeClaude(),
+    // auth 探测会真实执行一次 `claude -p ping`（慢且消耗 token），只留给 doctor 按需调用。
+    probeAuth: async () => probeClaudeAuth(),
+    create: () => wrapEngineAdapter("claude-code", new ClaudeCodeAdapter()),
+};

package/dist/runtimes/codex.d.ts

@@ -0,0 +1,44 @@
+import { NdjsonStreamAdapter, type NdjsonEventCtx } from "./ndjson-stream.js";
+import { type EngineRunOptions } from "./engine.js";
+import { type ProbeDeps } from "./probe.js";
+import type { Logger } from "../log.js";
+import type { RuntimeModule, RuntimeProbe } from "../types.js";
+export declare function sanitizeCodexExtraArgs(extraArgs: string[] | undefined): string[];
+/** 通过 PATH 或 macOS 桌面 bundle 解析 Codex CLI 可执行文件。 */
+export declare function resolveCodexCommand(deps?: ProbeDeps): string | null;
+/** 探测 Codex CLI 是否安装并读取版本。 */
+export declare function probeCodex(deps?: ProbeDeps): RuntimeProbe;
+/**
+ * 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 declare class CodexAdapter extends NdjsonStreamAdapter {
+    readonly id: "codex";
+    private readonly explicitBinary;
+    private resolvedBinary;
+    constructor(opts?: {
+        binary?: string;
+        logger?: Logger;
+    });
+    run(opts: EngineRunOptions): Promise<import("./engine.js").EngineRunResult>;
+    protected resolveBinary(): string;
+    /**
+     * 新会话：`exec <tail> -- <prompt>`；resume：`exec resume <sid> <tail> -- <prompt>`。
+     * 两条路径共享同一个 tail（sandbox/approval 用 -c 表达以兼容 resume）。
+     * `--` 隔开 flags 与 positionals，防止以 `-` 开头的 prompt 被解析成选项。
+     */
+    protected buildArgs(opts: EngineRunOptions): string[];
+    protected spawnEnv(_opts: EngineRunOptions): NodeJS.ProcessEnv;
+    protected handleEvent(raw: unknown, ctx: NdjsonEventCtx): void;
+}
+export declare const codexModule: RuntimeModule;