niceeval 0.12.1 → 0.12.2-canary.31

package/dist/agents/shared.cjs

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shared = void 0;
+const index_ts_1 = require("../o11y/parsers/index.cjs");
+const index_ts_2 = require("../i18n/index.cjs");
+const util_ts_1 = require("../util.cjs");
+const shell_ts_1 = require("../sandbox/shell.cjs");
+const skills_ts_1 = require("./skills.cjs");
+const npm_staged_ts_1 = require("./npm-staged.cjs");
+/** 每个沙箱里「已经装过的全局包」去重,避免每轮 send 重复 npm i -g。 */
+const installedBySandbox = new WeakMap();
+function installKey(cmd, args) {
+    return [cmd, ...args].join(" ");
+}
+async function ensureInstalled(sandbox, cmd, args) {
+    let set = installedBySandbox.get(sandbox);
+    if (!set) {
+        set = new Set();
+        installedBySandbox.set(sandbox, set);
+    }
+    const key = installKey(cmd, args);
+    if (set.has(key))
+        return;
+    const res = await sandbox.runCommand(cmd, args);
+    if (res.exitCode !== 0) {
+        const tail = (res.stdout + res.stderr).trim().split("\n").slice(-12).join("\n");
+        throw new Error((0, index_ts_2.t)("agent.installFailed", { key, tail }));
+    }
+    set.add(key);
+}
+/**
+ * 在 dir(可含 ~)下找 mtime 最新的 *.jsonl,读回其内容;没有则 undefined。
+ * 「最新」是对的:同一沙箱内 send 严格串行,刚跑完的那次一定写在最后 —— 不要改成按
+ * session id 精确定位(claude --resume 会 fork 出新 session id 的新文件,旧 id 的
+ * 文件还在,精确匹配会读到过期 transcript,负断言静默假通过)。
+ * 用沙箱里的 node 递归找全局最新:不依赖 GNU find 的 -printf(BSD / 精简镜像没有),
+ * 也没有 `-exec ls -t +` 的 ARG_MAX 分批陷阱(每批各自排序,head -1 不是全局最新)。
+ * 沙箱必然有 node(agent CLI 靠 npm 装,预制镜像也带)。
+ *
+ * `excludeName` 可选:跳过文件名匹配的旁路产物(例如 OpenClaw 同目录下的
+ * `*.trajectory.jsonl`,mtime 常比 session transcript 新,但不是消息轨)。
+ */
+async function captureLatestJsonl(sandbox, dir, opts) {
+    const excludeSource = opts?.excludeName?.source ?? "";
+    const excludeFlags = opts?.excludeName?.flags ?? "";
+    // exclude 正则以 JSON 字面量塞进 node -e,避免 shell 转义坑;空串 = 不排除。
+    const script = 'const fs=require("fs"),p=require("path");let best=null;' +
+        `const exclude=${JSON.stringify(excludeSource)}?new RegExp(${JSON.stringify(excludeSource)},${JSON.stringify(excludeFlags)}):null;` +
+        "const walk=(d)=>{let es;try{es=fs.readdirSync(d,{withFileTypes:true})}catch{return}" +
+        "for(const e of es){const f=p.join(d,e.name);" +
+        "if(e.isDirectory())walk(f);" +
+        'else if(e.name.endsWith(".jsonl")&&!(exclude&&exclude.test(e.name))){try{const m=fs.statSync(f).mtimeMs;if(!best||m>best.m)best={f,m}}catch{}}}};' +
+        "walk(process.argv[1]);if(best)process.stdout.write(best.f);";
+    try {
+        // dir 不加引号以便 shell 展开 ~;受信内部路径(同 writeFile 的约定)。
+        const find = await sandbox.runShell(`node -e '${script}' ${dir}`);
+        const path = find.stdout.trim();
+        if (!path)
+            return undefined;
+        return await sandbox.readText(path);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * 写一个文件到沙箱任意路径(含 ~ / 绝对路径),用随机定界符的 heredoc,内容不被解释。
+ * 内容含已知凭据时必须同时传 `sensitiveValues`：原始 heredoc 仍交给 shell，记录面只保留
+ * 脱敏摘要；不把“配置文件通常安全”当成证据边界。
+ */
+async function writeFile(sandbox, path, content, options = {}) {
+    const delim = `FE_EOF_${Date.now().toString(36)}_${Math.floor(Math.random() * 1e9).toString(36)}`;
+    // path 不加引号,以便 bash 展开 ~;dirname 也走 $() 不加引号同理。这些是受信内部路径。
+    await sandbox.runShell(`mkdir -p $(dirname ${path}) && cat > ${path} <<'${delim}'\n${content}\n${delim}\n`, options);
+}
+/**
+ * JSONL 逐行扫描的唯一骨架:逐行 parse,把每行对象交给 pick 抠值,
+ * 按 mode 取第一个或最后一个非空命中。非 JSON 行跳过。
+ */
+function scanJsonl(raw, pick, mode = "first") {
+    if (!raw)
+        return undefined;
+    let hit;
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            const v = pick(JSON.parse(trimmed));
+            if (typeof v === "string" && v) {
+                if (mode === "first")
+                    return v;
+                hit = v;
+            }
+        }
+        catch {
+            // 跳过非 JSON 行
+        }
+    }
+    return hit;
+}
+/** Claude Code 的 transcript JSONL 里抠 sessionId(取最后一个,供下一轮 --resume)。 */
+function sessionIdFromClaudeTranscript(raw) {
+    return scanJsonl(raw, (obj) => (obj.sessionId ?? obj.session_id), "last");
+}
+/** 从混了普通日志的 stdout 里抠出 JSONL(只留看起来是 JSON 对象的行)。 */
+function extractJsonlFromStdout(stdout) {
+    if (!stdout || !stdout.trim())
+        return undefined;
+    const lines = stdout.split("\n").filter((line) => {
+        const t = line.trim();
+        return t.startsWith("{") && t.endsWith("}");
+    });
+    return lines.length ? lines.join("\n") : undefined;
+}
+/** 从 codex 的 --json stdout 里取 thread_id(thread.started 事件),供下一轮 resume。 */
+function codexThreadId(stdout) {
+    return scanJsonl(stdout, (obj) => obj.type === "thread.started" ? obj.thread_id : undefined);
+}
+/** 扫 JSONL,返回第一个出现的 field 的字符串值。 */
+function firstJsonField(raw, field) {
+    return scanJsonl(raw, (obj) => obj[field]);
+}
+/**
+ * 非零退出的通用诊断:退出码、transcript 有无、事件数、最后一条 error、输出末尾,
+ * 拼成一条可读信息。adapter 在 status=failed 时把它塞进 error 事件——
+ * 否则 transcript 为空时失败原因彻底丢失,用户只能干瞪眼。
+ *
+ * 分层:首行是一层可行动摘要(exit code · transcript 状态 · 最后一条 error 的首行),
+ * output tail 从第二行起按原始换行保留——scrollback 失败行 / 默认报告等单行面对 message 取
+ * 首行即得一层摘要,tail 归 `show` 的 attempt 详情展开(docs/feature/experiments/cli.md
+ * 「运行反馈」:执行错误即时输出一层摘要,不把 stack 或 SDK 输出灌进 scrollback)。
+ * lastErr 的完整多行文本已是 events 里的独立事件,首行截取不丢证据。
+ */
+function diagnoseFailure(res, events, rawTranscript) {
+    const parts = [(0, index_ts_2.t)("agent.diagnose.exitCode", { code: res.exitCode })];
+    if (rawTranscript === undefined)
+        parts.push((0, index_ts_2.t)("agent.diagnose.noTranscript"));
+    else if (events.length === 0)
+        parts.push((0, index_ts_2.t)("agent.diagnose.zeroEvents"));
+    const lastErr = [...events].reverse().find((e) => e.type === "error");
+    if (lastErr)
+        parts.push((0, index_ts_2.t)("agent.diagnose.lastError", { message: (0, util_ts_1.firstLine)(lastErr.message) }));
+    const headline = parts.join(" · ");
+    const errTail = outputTail(res.stderr) || outputTail(res.stdout);
+    return errTail ? `${headline}\n${(0, index_ts_2.t)("agent.diagnose.outputTail", { tail: errTail })}` : headline;
+}
+function outputTail(s, n = 6) {
+    return s.trim().split("\n").filter(Boolean).slice(-n).join("\n").slice(0, 600);
+}
+/**
+ * `shared`:用户写的沙箱 adapter 唯一要碰的工具袋。解析器把各 agent 的原始 JSONL
+ * 归一化成标准事件流 + token 用量(ParsedTranscript),adapter 直接 return 即可。
+ */
+exports.shared = {
+    ensureInstalled,
+    /** 解析 staged / 预装 CLI 路径(用户前缀优先)。 */
+    agentBin: npm_staged_ts_1.agentBin,
+    captureLatestJsonl,
+    writeFile,
+    sessionIdFromClaudeTranscript,
+    extractJsonlFromStdout,
+    codexThreadId,
+    firstJsonField,
+    /** 把文本包成 shell 单引号字面量(含转义)。与 sandbox provider 同一份实现,别在 adapter 里手写。 */
+    shellQuote: shell_ts_1.shellQuote,
+    diagnoseFailure,
+    /**
+     * 把 SkillSpec 装进沙箱的 `opts.dir`(本地目录/文件按原字节上传;repo 按 ref clone、按
+     * 选择集拷贝),返回 manifest 用的 Skill 记录。装进 workspace 的东西自动排除出 diff。
+     */
+    installSkills(sandbox, specs, opts) {
+        return (0, skills_ts_1.installSkills)(sandbox, specs, opts);
+    },
+    /** manifest 里的 Skill 记录 → 沙箱里实际的目录名。 */
+    installedSkillNames: skills_ts_1.installedSkillNames,
+    /** 没有原生 Skill 加载机制的 agent 要写的发现指引段落(装了不提示 = 白装)。 */
+    skillDiscoveryInstruction: skills_ts_1.skillDiscoveryInstruction,
+    /** 把一段 project instruction 追加进沙箱里的 AGENTS.md(新建的文件顺手排除出 diff)。 */
+    appendProjectInstruction: skills_ts_1.appendProjectInstruction,
+    /** 把 setup 自己写进 workspace 的路径排除出 agent diff(git 基线早于 agent.setup)。 */
+    excludeFromDiff: skills_ts_1.excludeFromDiff,
+    /**
+     * setup 收尾交回安装 manifest:宿主侧内存对象直接给运行器,存成 attempt artifact
+     * `agent-setup.json`;沙箱磁盘上不落它,也不落任何其它框架文件。什么都没装就别调
+     * (空 artifact 不落文件)。secret 不进 manifest。
+     */
+    writeAgentSetup(ctx, manifest) {
+        ctx.reportSetup(manifest);
+    },
+    /** 原始 codex JSONL → 标准事件流 + 用量 + 压缩计数。 */
+    parseCodex(raw) {
+        return (0, index_ts_1.parseCodexTranscript)(raw);
+    },
+    parseClaudeCode(raw) {
+        return (0, index_ts_1.parseClaudeCodeTranscript)(raw);
+    },
+    parseBub(raw) {
+        return (0, index_ts_1.parseBubTranscript)(raw);
+    },
+};
+//# sourceMappingURL=shared.cjs.map

package/dist/agents/shared.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["shared.ts"],"names":[],"mappings":"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","sourcesContent":["// 沙箱型 adapter 的共享工具(对应 agent-eval 的 shared.ts)。\n//\n// adapter 真正要写的只有「装 CLI / 鉴权 / 拼调用 / 模型 / 读 transcript」那几行,\n// 其余跨 agent 一致的活(装包去重、定位最新 transcript、写配置文件、从 stdout\n// 抠 JSONL、解析成标准事件流)都收在这里,经 `shared` 暴露给用户写的 adapter。\nimport type { ParsedTranscript } from \"../o11y/parsers/index.ts\";\nimport { parseCodexTranscript, parseClaudeCodeTranscript, parseBubTranscript, } from \"../o11y/parsers/index.ts\";\nimport type { AgentSetupManifest, AgentSetupSkill, CommandOptions, Sandbox, SkillSpec, StreamEvent } from \"../types.ts\";\nimport type { SandboxAgentSetupContext } from \"./types.ts\";\nimport { t } from \"../i18n/index.ts\";\nimport { firstLine } from \"../util.ts\";\nimport { shellQuote } from \"../sandbox/shell.ts\";\nimport { appendProjectInstruction, excludeFromDiff, installSkills, installedSkillNames, skillDiscoveryInstruction, type InstallSkillsOptions, } from \"./skills.ts\";\nimport { agentBin } from \"./npm-staged.ts\";\n/** 每个沙箱里「已经装过的全局包」去重,避免每轮 send 重复 npm i -g。 */\nconst installedBySandbox = new WeakMap<Sandbox, Set<string>>();\nfunction installKey(cmd: string, args: string[]): string {\n    return [cmd, ...args].join(\" \");\n}\nasync function ensureInstalled(sandbox: Sandbox, cmd: string, args: string[]): Promise<void> {\n    let set = installedBySandbox.get(sandbox);\n    if (!set) {\n        set = new Set();\n        installedBySandbox.set(sandbox, set);\n    }\n    const key = installKey(cmd, args);\n    if (set.has(key))\n        return;\n    const res = await sandbox.runCommand(cmd, args);\n    if (res.exitCode !== 0) {\n        const tail = (res.stdout + res.stderr).trim().split(\"\\n\").slice(-12).join(\"\\n\");\n        throw new Error(t(\"agent.installFailed\", { key, tail }));\n    }\n    set.add(key);\n}\n/**\n * 在 dir(可含 ~)下找 mtime 最新的 *.jsonl,读回其内容;没有则 undefined。\n * 「最新」是对的:同一沙箱内 send 严格串行,刚跑完的那次一定写在最后 —— 不要改成按\n * session id 精确定位(claude --resume 会 fork 出新 session id 的新文件,旧 id 的\n * 文件还在,精确匹配会读到过期 transcript,负断言静默假通过)。\n * 用沙箱里的 node 递归找全局最新:不依赖 GNU find 的 -printf(BSD / 精简镜像没有),\n * 也没有 `-exec ls -t +` 的 ARG_MAX 分批陷阱(每批各自排序,head -1 不是全局最新)。\n * 沙箱必然有 node(agent CLI 靠 npm 装,预制镜像也带)。\n *\n * `excludeName` 可选:跳过文件名匹配的旁路产物(例如 OpenClaw 同目录下的\n * `*.trajectory.jsonl`,mtime 常比 session transcript 新,但不是消息轨)。\n */\nasync function captureLatestJsonl(sandbox: Sandbox, dir: string, opts?: {\n    excludeName?: RegExp;\n}): Promise<string | undefined> {\n    const excludeSource = opts?.excludeName?.source ?? \"\";\n    const excludeFlags = opts?.excludeName?.flags ?? \"\";\n    // exclude 正则以 JSON 字面量塞进 node -e,避免 shell 转义坑;空串 = 不排除。\n    const script = 'const fs=require(\"fs\"),p=require(\"path\");let best=null;' +\n        `const exclude=${JSON.stringify(excludeSource)}?new RegExp(${JSON.stringify(excludeSource)},${JSON.stringify(excludeFlags)}):null;` +\n        \"const walk=(d)=>{let es;try{es=fs.readdirSync(d,{withFileTypes:true})}catch{return}\" +\n        \"for(const e of es){const f=p.join(d,e.name);\" +\n        \"if(e.isDirectory())walk(f);\" +\n        'else if(e.name.endsWith(\".jsonl\")&&!(exclude&&exclude.test(e.name))){try{const m=fs.statSync(f).mtimeMs;if(!best||m>best.m)best={f,m}}catch{}}}};' +\n        \"walk(process.argv[1]);if(best)process.stdout.write(best.f);\";\n    try {\n        // dir 不加引号以便 shell 展开 ~;受信内部路径(同 writeFile 的约定)。\n        const find = await sandbox.runShell(`node -e '${script}' ${dir}`);\n        const path = find.stdout.trim();\n        if (!path)\n            return undefined;\n        return await sandbox.readText(path);\n    }\n    catch {\n        return undefined;\n    }\n}\n/**\n * 写一个文件到沙箱任意路径(含 ~ / 绝对路径),用随机定界符的 heredoc,内容不被解释。\n * 内容含已知凭据时必须同时传 `sensitiveValues`：原始 heredoc 仍交给 shell，记录面只保留\n * 脱敏摘要；不把“配置文件通常安全”当成证据边界。\n */\nasync function writeFile(sandbox: Sandbox, path: string, content: string, options: Pick<CommandOptions, \"sensitiveValues\"> = {}): Promise<void> {\n    const delim = `FE_EOF_${Date.now().toString(36)}_${Math.floor(Math.random() * 1e9).toString(36)}`;\n    // path 不加引号,以便 bash 展开 ~;dirname 也走 $() 不加引号同理。这些是受信内部路径。\n    await sandbox.runShell(`mkdir -p $(dirname ${path}) && cat > ${path} <<'${delim}'\\n${content}\\n${delim}\\n`, options);\n}\n/**\n * JSONL 逐行扫描的唯一骨架:逐行 parse,把每行对象交给 pick 抠值,\n * 按 mode 取第一个或最后一个非空命中。非 JSON 行跳过。\n */\nfunction scanJsonl(raw: string | undefined, pick: (obj: globalThis.Record<string, unknown>) => string | undefined, mode: \"first\" | \"last\" = \"first\"): string | undefined {\n    if (!raw)\n        return undefined;\n    let hit: string | undefined;\n    for (const line of raw.split(\"\\n\")) {\n        const trimmed = line.trim();\n        if (!trimmed)\n            continue;\n        try {\n            const v = pick(JSON.parse(trimmed) as globalThis.Record<string, unknown>);\n            if (typeof v === \"string\" && v) {\n                if (mode === \"first\")\n                    return v;\n                hit = v;\n            }\n        }\n        catch {\n            // 跳过非 JSON 行\n        }\n    }\n    return hit;\n}\n/** Claude Code 的 transcript JSONL 里抠 sessionId(取最后一个,供下一轮 --resume)。 */\nfunction sessionIdFromClaudeTranscript(raw: string | undefined): string | undefined {\n    return scanJsonl(raw, (obj) => (obj.sessionId ?? obj.session_id) as string | undefined, \"last\");\n}\n/** 从混了普通日志的 stdout 里抠出 JSONL(只留看起来是 JSON 对象的行)。 */\nfunction extractJsonlFromStdout(stdout: string | undefined): string | undefined {\n    if (!stdout || !stdout.trim())\n        return undefined;\n    const lines = stdout.split(\"\\n\").filter((line) => {\n        const t = line.trim();\n        return t.startsWith(\"{\") && t.endsWith(\"}\");\n    });\n    return lines.length ? lines.join(\"\\n\") : undefined;\n}\n/** 从 codex 的 --json stdout 里取 thread_id(thread.started 事件),供下一轮 resume。 */\nfunction codexThreadId(stdout: string | undefined): string | undefined {\n    return scanJsonl(stdout, (obj) => obj.type === \"thread.started\" ? (obj.thread_id as string | undefined) : undefined);\n}\n/** 扫 JSONL,返回第一个出现的 field 的字符串值。 */\nfunction firstJsonField(raw: string | undefined, field: string): string | undefined {\n    return scanJsonl(raw, (obj) => obj[field] as string | undefined);\n}\n/**\n * 非零退出的通用诊断:退出码、transcript 有无、事件数、最后一条 error、输出末尾,\n * 拼成一条可读信息。adapter 在 status=failed 时把它塞进 error 事件——\n * 否则 transcript 为空时失败原因彻底丢失,用户只能干瞪眼。\n *\n * 分层:首行是一层可行动摘要(exit code · transcript 状态 · 最后一条 error 的首行),\n * output tail 从第二行起按原始换行保留——scrollback 失败行 / 默认报告等单行面对 message 取\n * 首行即得一层摘要,tail 归 `show` 的 attempt 详情展开(docs/feature/experiments/cli.md\n * 「运行反馈」:执行错误即时输出一层摘要,不把 stack 或 SDK 输出灌进 scrollback)。\n * lastErr 的完整多行文本已是 events 里的独立事件,首行截取不丢证据。\n */\nfunction diagnoseFailure(res: {\n    exitCode: number;\n    stdout: string;\n    stderr: string;\n}, events: readonly StreamEvent[], rawTranscript: string | undefined): string {\n    const parts: string[] = [t(\"agent.diagnose.exitCode\", { code: res.exitCode })];\n    if (rawTranscript === undefined)\n        parts.push(t(\"agent.diagnose.noTranscript\"));\n    else if (events.length === 0)\n        parts.push(t(\"agent.diagnose.zeroEvents\"));\n    const lastErr = [...events].reverse().find((e) => e.type === \"error\") as {\n        type: \"error\";\n        message: string;\n    } | undefined;\n    if (lastErr)\n        parts.push(t(\"agent.diagnose.lastError\", { message: firstLine(lastErr.message) }));\n    const headline = parts.join(\" · \");\n    const errTail = outputTail(res.stderr) || outputTail(res.stdout);\n    return errTail ? `${headline}\\n${t(\"agent.diagnose.outputTail\", { tail: errTail })}` : headline;\n}\nfunction outputTail(s: string, n = 6): string {\n    return s.trim().split(\"\\n\").filter(Boolean).slice(-n).join(\"\\n\").slice(0, 600);\n}\n/**\n * `shared`:用户写的沙箱 adapter 唯一要碰的工具袋。解析器把各 agent 的原始 JSONL\n * 归一化成标准事件流 + token 用量(ParsedTranscript),adapter 直接 return 即可。\n */\nexport const shared = {\n    ensureInstalled,\n    /** 解析 staged / 预装 CLI 路径(用户前缀优先)。 */\n    agentBin,\n    captureLatestJsonl,\n    writeFile,\n    sessionIdFromClaudeTranscript,\n    extractJsonlFromStdout,\n    codexThreadId,\n    firstJsonField,\n    /** 把文本包成 shell 单引号字面量(含转义)。与 sandbox provider 同一份实现,别在 adapter 里手写。 */\n    shellQuote,\n    diagnoseFailure,\n    /**\n     * 把 SkillSpec 装进沙箱的 `opts.dir`(本地目录/文件按原字节上传;repo 按 ref clone、按\n     * 选择集拷贝),返回 manifest 用的 Skill 记录。装进 workspace 的东西自动排除出 diff。\n     */\n    installSkills(sandbox: Sandbox, specs: readonly SkillSpec[], opts: InstallSkillsOptions): Promise<AgentSetupSkill[]> {\n        return installSkills(sandbox, specs, opts);\n    },\n    /** manifest 里的 Skill 记录 → 沙箱里实际的目录名。 */\n    installedSkillNames,\n    /** 没有原生 Skill 加载机制的 agent 要写的发现指引段落(装了不提示 = 白装)。 */\n    skillDiscoveryInstruction,\n    /** 把一段 project instruction 追加进沙箱里的 AGENTS.md(新建的文件顺手排除出 diff)。 */\n    appendProjectInstruction,\n    /** 把 setup 自己写进 workspace 的路径排除出 agent diff(git 基线早于 agent.setup)。 */\n    excludeFromDiff,\n    /**\n     * setup 收尾交回安装 manifest:宿主侧内存对象直接给运行器,存成 attempt artifact\n     * `agent-setup.json`;沙箱磁盘上不落它,也不落任何其它框架文件。什么都没装就别调\n     * (空 artifact 不落文件)。secret 不进 manifest。\n     */\n    writeAgentSetup(ctx: SandboxAgentSetupContext, manifest: AgentSetupManifest): void {\n        ctx.reportSetup(manifest);\n    },\n    /** 原始 codex JSONL → 标准事件流 + 用量 + 压缩计数。 */\n    parseCodex(raw: string | undefined): ParsedTranscript {\n        return parseCodexTranscript(raw);\n    },\n    parseClaudeCode(raw: string | undefined): ParsedTranscript {\n        return parseClaudeCodeTranscript(raw);\n    },\n    parseBub(raw: string | undefined): ParsedTranscript {\n        return parseBubTranscript(raw);\n    },\n};\nexport type Shared = typeof shared;\n"]}

package/dist/agents/shared.d.cts

@@ -0,0 +1,95 @@
+import type { ParsedTranscript } from "../o11y/parsers/index.cjs";
+import type { AgentSetupManifest, AgentSetupSkill, CommandOptions, Sandbox, SkillSpec, StreamEvent } from "../types.cjs";
+import type { SandboxAgentSetupContext } from "./types.cjs";
+import { shellQuote } from "../sandbox/shell.cjs";
+import { appendProjectInstruction, excludeFromDiff, installedSkillNames, skillDiscoveryInstruction, type InstallSkillsOptions } from "./skills.cjs";
+import { agentBin } from "./npm-staged.cjs";
+declare function ensureInstalled(sandbox: Sandbox, cmd: string, args: string[]): Promise<void>;
+/**
+ * 在 dir(可含 ~)下找 mtime 最新的 *.jsonl,读回其内容;没有则 undefined。
+ * 「最新」是对的:同一沙箱内 send 严格串行,刚跑完的那次一定写在最后 —— 不要改成按
+ * session id 精确定位(claude --resume 会 fork 出新 session id 的新文件,旧 id 的
+ * 文件还在,精确匹配会读到过期 transcript,负断言静默假通过)。
+ * 用沙箱里的 node 递归找全局最新:不依赖 GNU find 的 -printf(BSD / 精简镜像没有),
+ * 也没有 `-exec ls -t +` 的 ARG_MAX 分批陷阱(每批各自排序,head -1 不是全局最新)。
+ * 沙箱必然有 node(agent CLI 靠 npm 装,预制镜像也带)。
+ *
+ * `excludeName` 可选:跳过文件名匹配的旁路产物(例如 OpenClaw 同目录下的
+ * `*.trajectory.jsonl`,mtime 常比 session transcript 新,但不是消息轨)。
+ */
+declare function captureLatestJsonl(sandbox: Sandbox, dir: string, opts?: {
+    excludeName?: RegExp;
+}): Promise<string | undefined>;
+/**
+ * 写一个文件到沙箱任意路径(含 ~ / 绝对路径),用随机定界符的 heredoc,内容不被解释。
+ * 内容含已知凭据时必须同时传 `sensitiveValues`：原始 heredoc 仍交给 shell，记录面只保留
+ * 脱敏摘要；不把“配置文件通常安全”当成证据边界。
+ */
+declare function writeFile(sandbox: Sandbox, path: string, content: string, options?: Pick<CommandOptions, "sensitiveValues">): Promise<void>;
+/** Claude Code 的 transcript JSONL 里抠 sessionId(取最后一个,供下一轮 --resume)。 */
+declare function sessionIdFromClaudeTranscript(raw: string | undefined): string | undefined;
+/** 从混了普通日志的 stdout 里抠出 JSONL(只留看起来是 JSON 对象的行)。 */
+declare function extractJsonlFromStdout(stdout: string | undefined): string | undefined;
+/** 从 codex 的 --json stdout 里取 thread_id(thread.started 事件),供下一轮 resume。 */
+declare function codexThreadId(stdout: string | undefined): string | undefined;
+/** 扫 JSONL,返回第一个出现的 field 的字符串值。 */
+declare function firstJsonField(raw: string | undefined, field: string): string | undefined;
+/**
+ * 非零退出的通用诊断:退出码、transcript 有无、事件数、最后一条 error、输出末尾,
+ * 拼成一条可读信息。adapter 在 status=failed 时把它塞进 error 事件——
+ * 否则 transcript 为空时失败原因彻底丢失,用户只能干瞪眼。
+ *
+ * 分层:首行是一层可行动摘要(exit code · transcript 状态 · 最后一条 error 的首行),
+ * output tail 从第二行起按原始换行保留——scrollback 失败行 / 默认报告等单行面对 message 取
+ * 首行即得一层摘要,tail 归 `show` 的 attempt 详情展开(docs/feature/experiments/cli.md
+ * 「运行反馈」:执行错误即时输出一层摘要,不把 stack 或 SDK 输出灌进 scrollback)。
+ * lastErr 的完整多行文本已是 events 里的独立事件,首行截取不丢证据。
+ */
+declare function diagnoseFailure(res: {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}, events: readonly StreamEvent[], rawTranscript: string | undefined): string;
+/**
+ * `shared`:用户写的沙箱 adapter 唯一要碰的工具袋。解析器把各 agent 的原始 JSONL
+ * 归一化成标准事件流 + token 用量(ParsedTranscript),adapter 直接 return 即可。
+ */
+export declare const shared: {
+    ensureInstalled: typeof ensureInstalled;
+    /** 解析 staged / 预装 CLI 路径(用户前缀优先)。 */
+    agentBin: typeof agentBin;
+    captureLatestJsonl: typeof captureLatestJsonl;
+    writeFile: typeof writeFile;
+    sessionIdFromClaudeTranscript: typeof sessionIdFromClaudeTranscript;
+    extractJsonlFromStdout: typeof extractJsonlFromStdout;
+    codexThreadId: typeof codexThreadId;
+    firstJsonField: typeof firstJsonField;
+    /** 把文本包成 shell 单引号字面量(含转义)。与 sandbox provider 同一份实现,别在 adapter 里手写。 */
+    shellQuote: typeof shellQuote;
+    diagnoseFailure: typeof diagnoseFailure;
+    /**
+     * 把 SkillSpec 装进沙箱的 `opts.dir`(本地目录/文件按原字节上传;repo 按 ref clone、按
+     * 选择集拷贝),返回 manifest 用的 Skill 记录。装进 workspace 的东西自动排除出 diff。
+     */
+    installSkills(sandbox: Sandbox, specs: readonly SkillSpec[], opts: InstallSkillsOptions): Promise<AgentSetupSkill[]>;
+    /** manifest 里的 Skill 记录 → 沙箱里实际的目录名。 */
+    installedSkillNames: typeof installedSkillNames;
+    /** 没有原生 Skill 加载机制的 agent 要写的发现指引段落(装了不提示 = 白装)。 */
+    skillDiscoveryInstruction: typeof skillDiscoveryInstruction;
+    /** 把一段 project instruction 追加进沙箱里的 AGENTS.md(新建的文件顺手排除出 diff)。 */
+    appendProjectInstruction: typeof appendProjectInstruction;
+    /** 把 setup 自己写进 workspace 的路径排除出 agent diff(git 基线早于 agent.setup)。 */
+    excludeFromDiff: typeof excludeFromDiff;
+    /**
+     * setup 收尾交回安装 manifest:宿主侧内存对象直接给运行器,存成 attempt artifact
+     * `agent-setup.json`;沙箱磁盘上不落它,也不落任何其它框架文件。什么都没装就别调
+     * (空 artifact 不落文件)。secret 不进 manifest。
+     */
+    writeAgentSetup(ctx: SandboxAgentSetupContext, manifest: AgentSetupManifest): void;
+    /** 原始 codex JSONL → 标准事件流 + 用量 + 压缩计数。 */
+    parseCodex(raw: string | undefined): ParsedTranscript;
+    parseClaudeCode(raw: string | undefined): ParsedTranscript;
+    parseBub(raw: string | undefined): ParsedTranscript;
+};
+export type Shared = typeof shared;
+export {};

package/dist/agents/shared.d.mts

@@ -0,0 +1,95 @@
+import type { ParsedTranscript } from "../o11y/parsers/index.mjs";
+import type { AgentSetupManifest, AgentSetupSkill, CommandOptions, Sandbox, SkillSpec, StreamEvent } from "../types.mjs";
+import type { SandboxAgentSetupContext } from "./types.mjs";
+import { shellQuote } from "../sandbox/shell.mjs";
+import { appendProjectInstruction, excludeFromDiff, installedSkillNames, skillDiscoveryInstruction, type InstallSkillsOptions } from "./skills.mjs";
+import { agentBin } from "./npm-staged.mjs";
+declare function ensureInstalled(sandbox: Sandbox, cmd: string, args: string[]): Promise<void>;
+/**
+ * 在 dir(可含 ~)下找 mtime 最新的 *.jsonl,读回其内容;没有则 undefined。
+ * 「最新」是对的:同一沙箱内 send 严格串行,刚跑完的那次一定写在最后 —— 不要改成按
+ * session id 精确定位(claude --resume 会 fork 出新 session id 的新文件,旧 id 的
+ * 文件还在,精确匹配会读到过期 transcript,负断言静默假通过)。
+ * 用沙箱里的 node 递归找全局最新:不依赖 GNU find 的 -printf(BSD / 精简镜像没有),
+ * 也没有 `-exec ls -t +` 的 ARG_MAX 分批陷阱(每批各自排序,head -1 不是全局最新)。
+ * 沙箱必然有 node(agent CLI 靠 npm 装,预制镜像也带)。
+ *
+ * `excludeName` 可选:跳过文件名匹配的旁路产物(例如 OpenClaw 同目录下的
+ * `*.trajectory.jsonl`,mtime 常比 session transcript 新,但不是消息轨)。
+ */
+declare function captureLatestJsonl(sandbox: Sandbox, dir: string, opts?: {
+    excludeName?: RegExp;
+}): Promise<string | undefined>;
+/**
+ * 写一个文件到沙箱任意路径(含 ~ / 绝对路径),用随机定界符的 heredoc,内容不被解释。
+ * 内容含已知凭据时必须同时传 `sensitiveValues`：原始 heredoc 仍交给 shell，记录面只保留
+ * 脱敏摘要；不把“配置文件通常安全”当成证据边界。
+ */
+declare function writeFile(sandbox: Sandbox, path: string, content: string, options?: Pick<CommandOptions, "sensitiveValues">): Promise<void>;
+/** Claude Code 的 transcript JSONL 里抠 sessionId(取最后一个,供下一轮 --resume)。 */
+declare function sessionIdFromClaudeTranscript(raw: string | undefined): string | undefined;
+/** 从混了普通日志的 stdout 里抠出 JSONL(只留看起来是 JSON 对象的行)。 */
+declare function extractJsonlFromStdout(stdout: string | undefined): string | undefined;
+/** 从 codex 的 --json stdout 里取 thread_id(thread.started 事件),供下一轮 resume。 */
+declare function codexThreadId(stdout: string | undefined): string | undefined;
+/** 扫 JSONL,返回第一个出现的 field 的字符串值。 */
+declare function firstJsonField(raw: string | undefined, field: string): string | undefined;
+/**
+ * 非零退出的通用诊断:退出码、transcript 有无、事件数、最后一条 error、输出末尾,
+ * 拼成一条可读信息。adapter 在 status=failed 时把它塞进 error 事件——
+ * 否则 transcript 为空时失败原因彻底丢失,用户只能干瞪眼。
+ *
+ * 分层:首行是一层可行动摘要(exit code · transcript 状态 · 最后一条 error 的首行),
+ * output tail 从第二行起按原始换行保留——scrollback 失败行 / 默认报告等单行面对 message 取
+ * 首行即得一层摘要,tail 归 `show` 的 attempt 详情展开(docs/feature/experiments/cli.md
+ * 「运行反馈」:执行错误即时输出一层摘要,不把 stack 或 SDK 输出灌进 scrollback)。
+ * lastErr 的完整多行文本已是 events 里的独立事件,首行截取不丢证据。
+ */
+declare function diagnoseFailure(res: {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}, events: readonly StreamEvent[], rawTranscript: string | undefined): string;
+/**
+ * `shared`:用户写的沙箱 adapter 唯一要碰的工具袋。解析器把各 agent 的原始 JSONL
+ * 归一化成标准事件流 + token 用量(ParsedTranscript),adapter 直接 return 即可。
+ */
+export declare const shared: {
+    ensureInstalled: typeof ensureInstalled;
+    /** 解析 staged / 预装 CLI 路径(用户前缀优先)。 */
+    agentBin: typeof agentBin;
+    captureLatestJsonl: typeof captureLatestJsonl;
+    writeFile: typeof writeFile;
+    sessionIdFromClaudeTranscript: typeof sessionIdFromClaudeTranscript;
+    extractJsonlFromStdout: typeof extractJsonlFromStdout;
+    codexThreadId: typeof codexThreadId;
+    firstJsonField: typeof firstJsonField;
+    /** 把文本包成 shell 单引号字面量(含转义)。与 sandbox provider 同一份实现,别在 adapter 里手写。 */
+    shellQuote: typeof shellQuote;
+    diagnoseFailure: typeof diagnoseFailure;
+    /**
+     * 把 SkillSpec 装进沙箱的 `opts.dir`(本地目录/文件按原字节上传;repo 按 ref clone、按
+     * 选择集拷贝),返回 manifest 用的 Skill 记录。装进 workspace 的东西自动排除出 diff。
+     */
+    installSkills(sandbox: Sandbox, specs: readonly SkillSpec[], opts: InstallSkillsOptions): Promise<AgentSetupSkill[]>;
+    /** manifest 里的 Skill 记录 → 沙箱里实际的目录名。 */
+    installedSkillNames: typeof installedSkillNames;
+    /** 没有原生 Skill 加载机制的 agent 要写的发现指引段落(装了不提示 = 白装)。 */
+    skillDiscoveryInstruction: typeof skillDiscoveryInstruction;
+    /** 把一段 project instruction 追加进沙箱里的 AGENTS.md(新建的文件顺手排除出 diff)。 */
+    appendProjectInstruction: typeof appendProjectInstruction;
+    /** 把 setup 自己写进 workspace 的路径排除出 agent diff(git 基线早于 agent.setup)。 */
+    excludeFromDiff: typeof excludeFromDiff;
+    /**
+     * setup 收尾交回安装 manifest:宿主侧内存对象直接给运行器,存成 attempt artifact
+     * `agent-setup.json`;沙箱磁盘上不落它,也不落任何其它框架文件。什么都没装就别调
+     * (空 artifact 不落文件)。secret 不进 manifest。
+     */
+    writeAgentSetup(ctx: SandboxAgentSetupContext, manifest: AgentSetupManifest): void;
+    /** 原始 codex JSONL → 标准事件流 + 用量 + 压缩计数。 */
+    parseCodex(raw: string | undefined): ParsedTranscript;
+    parseClaudeCode(raw: string | undefined): ParsedTranscript;
+    parseBub(raw: string | undefined): ParsedTranscript;
+};
+export type Shared = typeof shared;
+export {};

package/dist/agents/shared.d.ts

@@ -0,0 +1,95 @@
+import type { ParsedTranscript } from "../o11y/parsers/index.js";
+import type { AgentSetupManifest, AgentSetupSkill, CommandOptions, Sandbox, SkillSpec, StreamEvent } from "../types.js";
+import type { SandboxAgentSetupContext } from "./types.js";
+import { shellQuote } from "../sandbox/shell.js";
+import { appendProjectInstruction, excludeFromDiff, installedSkillNames, skillDiscoveryInstruction, type InstallSkillsOptions } from "./skills.js";
+import { agentBin } from "./npm-staged.js";
+declare function ensureInstalled(sandbox: Sandbox, cmd: string, args: string[]): Promise<void>;
+/**
+ * 在 dir(可含 ~)下找 mtime 最新的 *.jsonl,读回其内容;没有则 undefined。
+ * 「最新」是对的:同一沙箱内 send 严格串行,刚跑完的那次一定写在最后 —— 不要改成按
+ * session id 精确定位(claude --resume 会 fork 出新 session id 的新文件,旧 id 的
+ * 文件还在,精确匹配会读到过期 transcript,负断言静默假通过)。
+ * 用沙箱里的 node 递归找全局最新:不依赖 GNU find 的 -printf(BSD / 精简镜像没有),
+ * 也没有 `-exec ls -t +` 的 ARG_MAX 分批陷阱(每批各自排序,head -1 不是全局最新)。
+ * 沙箱必然有 node(agent CLI 靠 npm 装,预制镜像也带)。
+ *
+ * `excludeName` 可选:跳过文件名匹配的旁路产物(例如 OpenClaw 同目录下的
+ * `*.trajectory.jsonl`,mtime 常比 session transcript 新,但不是消息轨)。
+ */
+declare function captureLatestJsonl(sandbox: Sandbox, dir: string, opts?: {
+    excludeName?: RegExp;
+}): Promise<string | undefined>;
+/**
+ * 写一个文件到沙箱任意路径(含 ~ / 绝对路径),用随机定界符的 heredoc,内容不被解释。
+ * 内容含已知凭据时必须同时传 `sensitiveValues`：原始 heredoc 仍交给 shell，记录面只保留
+ * 脱敏摘要；不把“配置文件通常安全”当成证据边界。
+ */
+declare function writeFile(sandbox: Sandbox, path: string, content: string, options?: Pick<CommandOptions, "sensitiveValues">): Promise<void>;
+/** Claude Code 的 transcript JSONL 里抠 sessionId(取最后一个,供下一轮 --resume)。 */
+declare function sessionIdFromClaudeTranscript(raw: string | undefined): string | undefined;
+/** 从混了普通日志的 stdout 里抠出 JSONL(只留看起来是 JSON 对象的行)。 */
+declare function extractJsonlFromStdout(stdout: string | undefined): string | undefined;
+/** 从 codex 的 --json stdout 里取 thread_id(thread.started 事件),供下一轮 resume。 */
+declare function codexThreadId(stdout: string | undefined): string | undefined;
+/** 扫 JSONL,返回第一个出现的 field 的字符串值。 */
+declare function firstJsonField(raw: string | undefined, field: string): string | undefined;
+/**
+ * 非零退出的通用诊断:退出码、transcript 有无、事件数、最后一条 error、输出末尾,
+ * 拼成一条可读信息。adapter 在 status=failed 时把它塞进 error 事件——
+ * 否则 transcript 为空时失败原因彻底丢失,用户只能干瞪眼。
+ *
+ * 分层:首行是一层可行动摘要(exit code · transcript 状态 · 最后一条 error 的首行),
+ * output tail 从第二行起按原始换行保留——scrollback 失败行 / 默认报告等单行面对 message 取
+ * 首行即得一层摘要,tail 归 `show` 的 attempt 详情展开(docs/feature/experiments/cli.md
+ * 「运行反馈」:执行错误即时输出一层摘要,不把 stack 或 SDK 输出灌进 scrollback)。
+ * lastErr 的完整多行文本已是 events 里的独立事件,首行截取不丢证据。
+ */
+declare function diagnoseFailure(res: {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}, events: readonly StreamEvent[], rawTranscript: string | undefined): string;
+/**
+ * `shared`:用户写的沙箱 adapter 唯一要碰的工具袋。解析器把各 agent 的原始 JSONL
+ * 归一化成标准事件流 + token 用量(ParsedTranscript),adapter 直接 return 即可。
+ */
+export declare const shared: {
+    ensureInstalled: typeof ensureInstalled;
+    /** 解析 staged / 预装 CLI 路径(用户前缀优先)。 */
+    agentBin: typeof agentBin;
+    captureLatestJsonl: typeof captureLatestJsonl;
+    writeFile: typeof writeFile;
+    sessionIdFromClaudeTranscript: typeof sessionIdFromClaudeTranscript;
+    extractJsonlFromStdout: typeof extractJsonlFromStdout;
+    codexThreadId: typeof codexThreadId;
+    firstJsonField: typeof firstJsonField;
+    /** 把文本包成 shell 单引号字面量(含转义)。与 sandbox provider 同一份实现,别在 adapter 里手写。 */
+    shellQuote: typeof shellQuote;
+    diagnoseFailure: typeof diagnoseFailure;
+    /**
+     * 把 SkillSpec 装进沙箱的 `opts.dir`(本地目录/文件按原字节上传;repo 按 ref clone、按
+     * 选择集拷贝),返回 manifest 用的 Skill 记录。装进 workspace 的东西自动排除出 diff。
+     */
+    installSkills(sandbox: Sandbox, specs: readonly SkillSpec[], opts: InstallSkillsOptions): Promise<AgentSetupSkill[]>;
+    /** manifest 里的 Skill 记录 → 沙箱里实际的目录名。 */
+    installedSkillNames: typeof installedSkillNames;
+    /** 没有原生 Skill 加载机制的 agent 要写的发现指引段落(装了不提示 = 白装)。 */
+    skillDiscoveryInstruction: typeof skillDiscoveryInstruction;
+    /** 把一段 project instruction 追加进沙箱里的 AGENTS.md(新建的文件顺手排除出 diff)。 */
+    appendProjectInstruction: typeof appendProjectInstruction;
+    /** 把 setup 自己写进 workspace 的路径排除出 agent diff(git 基线早于 agent.setup)。 */
+    excludeFromDiff: typeof excludeFromDiff;
+    /**
+     * setup 收尾交回安装 manifest:宿主侧内存对象直接给运行器,存成 attempt artifact
+     * `agent-setup.json`;沙箱磁盘上不落它,也不落任何其它框架文件。什么都没装就别调
+     * (空 artifact 不落文件)。secret 不进 manifest。
+     */
+    writeAgentSetup(ctx: SandboxAgentSetupContext, manifest: AgentSetupManifest): void;
+    /** 原始 codex JSONL → 标准事件流 + 用量 + 压缩计数。 */
+    parseCodex(raw: string | undefined): ParsedTranscript;
+    parseClaudeCode(raw: string | undefined): ParsedTranscript;
+    parseBub(raw: string | undefined): ParsedTranscript;
+};
+export type Shared = typeof shared;
+export {};

package/dist/agents/shared.js

@@ -0,0 +1,6 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./shared.cjs");
+const __niceevalExport0 = __niceevalCanonical["shared"];
+export { __niceevalExport0 as shared };
+//# sourceMappingURL=shared.js.map

package/dist/agents/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sources":[],"names":[],"mappings":""}