@zmzai/agent-framework 0.1.0 → 0.2.1

package/README.md

@@ -0,0 +1,37 @@
+# @zmzai/agent-framework
+
+zmzai 生态的 coding agent 内核库——sessions、permissions、tools、runner、events（OpenCode 风格事件溯源）。
+
+自 `zmzai-agent/packages/agent-framework` 经 `git subtree split` 抽出为独立仓库，git 历史完整保留。
+
+## 消费方
+
+- **zmzai-agent**（平台应用）：Mongo workspace / skills / memory recall 装配
+- **zmzai-harness**（本地工作台）：fs workspace / 多项目 / terminal / checkpoints 装配
+
+两端均以 `link:../zmzai-framework` 消费；开发 framework 时跑 `npx tsc -p tsconfig.build.json --watch`（或 `pnpm run build:watch`，如已配置），两端 dev server 重载即生效。
+
+## 开发
+
+```bash
+pnpm install
+pnpm run typecheck   # tsc --noEmit
+pnpm test            # vitest run
+pnpm run build       # tsc -p tsconfig.build.json → dist/
+```
+
+## 能力地图
+
+| 模块 | 位置 | 说明 |
+|---|---|---|
+| 会话与消息 | `src/core/session/` | jsonl / SQLite（node:sqlite）双存储 |
+| 事件流 | `src/core/events/` | 事件溯源 + seq 重放（manifest 定义 schema） |
+| 工具集 | `src/core/tools/` | read/glob/grep/write/edit/bash/terminal/git/todo/apply_patch/web… |
+| 权限引擎 | `src/core/permissions/` | ruleset LAST-match + approvalMode 档位 |
+| 压缩 | `src/core/runtime/compaction.ts` | 投影式 compaction（不改历史） |
+| 沙箱 | `src/adapters/subprocess-sandbox.ts` | 快照 + 产物回写（本机单用户形态） |
+| 模型接入 | `src/adapters/openai-provider.ts` | relay/OpenAI 兼容 + failover + reasoningEffort |
+
+## 版本策略
+
+[changesets](./.changeset/README.md) 管理：feature → minor，fix → patch。合入 main 前跑 `pnpm changeset` 提交变更集；Release workflow 自动汇总版本、开 "Version Packages" PR，合并后自动 build + `npm publish` + 打 tag。

package/dist/adapters/openai-provider.d.ts

@@ -1,4 +1,24 @@
 import type { ModelProvider } from "./index.js";
+/** 动态额外请求头（如登录态 cookie）。函数形式每次请求前求值，支持异步。 */
+export type ProviderHeaders = Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
+/** 故障转移端点：主端点在首个流事件即报错时依次尝试（abort 不切）。 */
+export type FailoverEndpoint = {
+    baseUrl: string;
+    apiKey?: string;
+    /** 备用端点上的模型 id（缺省沿用主模型 id）。 */
+    modelId?: string;
+};
+/** 降级事件（P0 可观测）：每次实际发生端点切换时回调一次。 */
+export type FailoverEvent = {
+    /** 被放弃的端点（undefined = 主端点）。 */
+    from?: string;
+    /** 切换到的端点。 */
+    to: string;
+    /** 触发降级的首事件错误文本。 */
+    error: string;
+    /** 第几次尝试（1 起）。 */
+    attempt: number;
+};
 /** OpenAI-compatible ModelProvider (M5 CLI reference): drives the framework
  *  against any OpenAI-compatible chat-completions endpoint via env vars:
  *
@@ -8,10 +28,19 @@ import type { ModelProvider } from "./index.js";
  *
  *  The same provider serves relay-compatible backends (m.zmzai.cloud uses the
  *  OpenAI wire format), so the framework runs standalone with zero product
- *  coupling. */
+ *  coupling. headers 选项用于注入登录态 cookie 等动态鉴权头；baseUrl 支持
+ *  函数形式（每次请求求值，宿主可在运行时切换端点，如设置页改 relay 地址）。
+ *
+ *  路由降级（N2a）：failoverEndpoints 配置备用 OpenAI 兼容端点。主端点在
+ *  首个流事件即返回 error（reason=error，网络断/5xx/429/配置失效）时依次
+ *  切换；首个事件已正常（连接 + 上游可用）则后续错误不再降级。 */
 export declare function createOpenAiModelProvider(input?: {
-    baseUrl?: string;
+    baseUrl?: string | (() => string);
     apiKey?: string;
     defaultModel?: string;
+    headers?: ProviderHeaders;
+    failoverEndpoints?: FailoverEndpoint[];
+    /** 降级发生时回调（宿主用于日志/UI 提示）。 */
+    onFailover?: (event: FailoverEvent) => void;
 }): ModelProvider;
 //# sourceMappingURL=openai-provider.d.ts.map

package/dist/adapters/openai-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai-provider.d.ts","sourceRoot":"","sources":["../../src/adapters/openai-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD;;;;;;;;;gBASgB;AAChB,wBAAgB,yBAAyB,CAAC,KAAK,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAoG7H"}
+{"version":3,"file":"openai-provider.d.ts","sourceRoot":"","sources":["../../src/adapters/openai-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,6CAA6C;AAC7C,MAAM,MAAM,eAAe,GACvB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtB,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AAErE,0CAA0C;AAC1C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,oCAAoC;AACpC,MAAM,MAAM,aAAa,GAAG;IAC1B,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc;IACd,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;;;;sCAcsC;AACtC,wBAAgB,yBAAyB,CAAC,KAAK,CAAC,EAAE;IAChD,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACvC,6BAA6B;IAC7B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;CAC7C,GAAG,aAAa,CA+IhB"}

package/dist/adapters/openai-provider.js

@@ -7,11 +7,26 @@
  *
  *  The same provider serves relay-compatible backends (m.zmzai.cloud uses the
  *  OpenAI wire format), so the framework runs standalone with zero product
- *  coupling. */
+ *  coupling. headers 选项用于注入登录态 cookie 等动态鉴权头；baseUrl 支持
+ *  函数形式（每次请求求值，宿主可在运行时切换端点，如设置页改 relay 地址）。
+ *
+ *  路由降级（N2a）：failoverEndpoints 配置备用 OpenAI 兼容端点。主端点在
+ *  首个流事件即返回 error（reason=error，网络断/5xx/429/配置失效）时依次
+ *  切换；首个事件已正常（连接 + 上游可用）则后续错误不再降级。 */
 export function createOpenAiModelProvider(input) {
-    const baseUrl = (input?.baseUrl ?? process.env.OPENAI_BASE_URL ?? "https://api.openai.com/v1").replace(/\/$/, "");
+    // baseUrl 动态求值：函数形式每次请求重新解析（设置页改 relay 端点即时生效）
+    const baseUrlInput = input?.baseUrl;
+    const resolveBase = () => ((typeof baseUrlInput === "function" ? baseUrlInput() : baseUrlInput) ?? process.env.OPENAI_BASE_URL ?? "https://api.openai.com/v1").replace(/\/$/, "");
     const apiKey = input?.apiKey ?? process.env.OPENAI_API_KEY ?? "";
     const defaultModel = input?.defaultModel ?? process.env.OPENAI_MODEL ?? "gpt-4o";
+    const failovers = input?.failoverEndpoints ?? [];
+    const onFailover = input?.onFailover;
+    const resolveHeaders = async () => {
+        const h = input?.headers;
+        if (!h)
+            return {};
+        return typeof h === "function" ? await h() : h;
+    };
     return {
         getModel(ref) {
             return {
@@ -19,96 +34,125 @@ export function createOpenAiModelProvider(input) {
                 name: ref.modelId || defaultModel,
                 api: "openai-completions",
                 provider: "zmzai-openai",
-                baseUrl,
+                baseUrl: resolveBase(),
                 reasoning: false,
-                input: ["text"],
+                input: ["text", "image"],
                 cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
                 contextWindow: 128_000,
                 maxTokens: 16_384,
+                // 兼容开关收紧到经典 OpenAI 字段：部分上游（含 relay 的通道）对
+                // strict / stream_options 等新字段会 400，这里显式禁用。
+                // supportsReasoningEffort：relay 已按模型白名单接受 reasoning_effort
+                // （不支持的模型 relay 返回 400 REASONING_EFFORT_NOT_ALLOWED，UI 层
+                // 只在模型允许的档位上展示选择器）。
+                compat: {
+                    supportsStrictMode: false,
+                    maxTokensField: "max_tokens",
+                    supportsUsageInStreaming: false,
+                    supportsReasoningEffort: true,
+                    supportsFinishReason: true,
+                },
             };
         },
         streamFor(session) {
             void session;
-            // streamFn built per call; auth header injected by the provider wrapper.
+            // streamFn built per call; auth cookie injected by the custom fetch below.
             return (async (model, context, options) => {
+                const { streamSimple } = await import("@earendil-works/pi-ai/api/openai-completions");
                 const { createAssistantMessageEventStream } = await import("@earendil-works/pi-ai");
-                const stream = createAssistantMessageEventStream();
-                void (async () => {
+                const dynamicHeaders = await resolveHeaders();
+                // 每次调 streamFn 重新求值 headers（登录态/个人 key 可动态变化）
+                const attempt = async (ep) => {
+                    const target = ep
+                        ? { ...model, baseUrl: ep.baseUrl.replace(/\/$/, ""), ...(ep.modelId ? { id: ep.modelId, name: ep.modelId } : {}) }
+                        // 主端点同样每请求重算 baseUrl（summaryModel 等缓存的 model 对象也生效）
+                        : { ...model, baseUrl: resolveBase() };
+                    return streamSimple(target, context, {
+                        ...(options ?? {}),
+                        // 占位 key：pi-ai 要求非空 apiKey（否则 throw）。relay 不校验
+                        // Bearer，真实鉴权靠下方自定义 fetch 注入的登录 cookie。
+                        // 注意用 ||：apiKey 可能为空串（未配 key 且无 env），?? 不会回退。
+                        apiKey: ep?.apiKey || apiKey || "cookie-auth",
+                        maxTokens: options?.maxTokens ?? 16_384,
+                        // 自定义 fetch：剥掉 SDK 自动生成的 Authorization（relay 对无效
+                        // Bearer 直接 401，不会回退到 cookie 登录态），再注入动态头。
+                        fetch: async (url, init) => {
+                            const headers = new Headers(init?.headers);
+                            headers.delete("authorization");
+                            for (const [name, value] of Object.entries(dynamicHeaders))
+                                headers.set(name, value);
+                            return fetch(url, { ...(init ?? {}), headers });
+                        },
+                    });
+                };
+                // 无备用端点：直连主端点（零额外开销）
+                if (failovers.length === 0)
+                    return attempt();
+                // 有备用端点：peek 首事件判定健康度，error(reason=error) 时降级重试
+                const endpoints = [undefined, ...failovers];
+                let lastStream = null;
+                let lastFirst = null;
+                let lastIterator = null;
+                for (let i = 0; i < endpoints.length; i++) {
+                    let stream;
                     try {
-                        const messages = (context.messages ?? []).map((message) => {
-                            if (message.role === "user" || message.role === "assistant") {
-                                const content = message.content;
-                                if (typeof content === "string")
-                                    return { role: message.role, content };
-                                if (Array.isArray(content)) {
-                                    return { role: message.role, content: content.filter((b) => b.type === "text").map((b) => ({ type: "text", text: b.text ?? "" })) };
-                                }
-                            }
-                            if (message.role === "toolResult") {
-                                const text = Array.isArray(message.content)
-                                    ? message.content.filter((b) => b.type === "text").map((b) => b.text ?? "").join("\n")
-                                    : String(message.content ?? "");
-                                return { role: "tool", content: text, tool_call_id: message.toolCallId ?? "" };
-                            }
-                            return null;
-                        }).filter(Boolean);
-                        const response = await fetch(`${baseUrl}/chat/completions`, {
-                            method: "POST",
-                            headers: { "content-type": "application/json", ...(apiKey ? { authorization: `Bearer ${apiKey}` } : {}) },
-                            body: JSON.stringify({
-                                model: model.id,
-                                messages,
-                                stream: true,
-                                ...(options?.maxTokens ? { max_tokens: options.maxTokens } : {}),
-                            }),
-                        });
-                        if (!response.ok || !response.body) {
-                            const error = { type: "error", reason: "error", error: await response.text().catch(() => "HTTP error") };
-                            stream.push(error);
-                            stream.end(error);
-                            return;
+                        stream = await attempt(endpoints[i]);
+                    }
+                    catch (error) {
+                        if (i + 1 < endpoints.length)
+                            continue;
+                        throw error;
+                    }
+                    const iterator = stream[Symbol.asyncIterator]();
+                    const first = await iterator.next();
+                    const event = first.value;
+                    const retryable = !first.done && event?.type === "error" && event.reason === "error";
+                    if (retryable && i + 1 < endpoints.length) {
+                        // error 事件的 payload 是 AssistantMessage（含 errorMessage）
+                        const errPayload = event.error;
+                        const detail = errPayload?.errorMessage ?? JSON.stringify(errPayload ?? {}) ?? "上游不可用";
+                        try {
+                            onFailover?.({
+                                from: endpoints[i] ? endpoints[i].baseUrl : undefined,
+                                to: endpoints[i + 1].baseUrl,
+                                error: String(detail).slice(0, 300),
+                                attempt: i + 1,
+                            });
+                        }
+                        catch {
+                            // 观测回调永不影响主链路
                         }
-                        const reader = response.body.getReader();
-                        const decoder = new TextDecoder();
-                        let buffer = "";
-                        const partial = { role: "assistant", content: [{ type: "text", text: "" }] };
+                        continue;
+                    }
+                    lastStream = stream;
+                    lastFirst = first;
+                    lastIterator = iterator;
+                    break;
+                }
+                if (!lastStream || !lastIterator) {
+                    // 理论不可达（endpoints 至少一项）；防御性抛错
+                    throw new Error("模型请求失败：所有端点均不可用");
+                }
+                // 健康流桥接：peek 到的事件重放进 wrapper，后台继续透传剩余事件
+                const wrapper = createAssistantMessageEventStream();
+                void (async () => {
+                    try {
+                        if (!lastFirst.done && lastFirst.value)
+                            wrapper.push(lastFirst.value);
                         while (true) {
-                            const { done, value } = await reader.read();
-                            if (done)
-                                break;
-                            buffer += decoder.decode(value, { stream: true });
-                            const lines = buffer.split("\n");
-                            buffer = lines.pop() ?? "";
-                            for (const line of lines) {
-                                const trimmed = line.trim();
-                                if (!trimmed.startsWith("data:"))
-                                    continue;
-                                const data = trimmed.slice(5).trim();
-                                if (data === "[DONE]")
-                                    continue;
-                                try {
-                                    const chunk = JSON.parse(data);
-                                    const delta = chunk.choices?.[0]?.delta?.content;
-                                    if (delta) {
-                                        partial.content[0].text += delta;
-                                        stream.push({ type: "text_delta", contentIndex: 0, delta, partial });
-                                    }
-                                }
-                                catch {
-                                    // partial JSON — ignore
-                                }
+                            const next = await lastIterator.next();
+                            if (next.done) {
+                                wrapper.end();
+                                return;
                             }
+                            wrapper.push(next.value);
                         }
-                        stream.push({ type: "done", reason: "stop", message: partial });
-                        stream.end(partial);
                     }
-                    catch (error) {
-                        const err = error instanceof Error ? error.message : String(error);
-                        stream.push({ type: "error", reason: "error", error: err });
-                        stream.end({ role: "assistant", content: [{ type: "text", text: "" }], stopReason: "error", errorMessage: err });
+                    catch {
+                        wrapper.end();
                     }
                 })();
-                return stream;
+                return wrapper;
             });
         },
     };

package/dist/adapters/openai-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"openai-provider.js","sourceRoot":"","sources":["../../src/adapters/openai-provider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"openai-provider.js","sourceRoot":"","sources":["../../src/adapters/openai-provider.ts"],"names":[],"mappings":"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"}

package/dist/adapters/subprocess-sandbox.d.ts

@@ -1,7 +1,6 @@
 import type { SandboxExecutor } from "../adapters/index.js";
-/** Subprocess SandboxExecutor (M5 §5 CLI reference implementation): writes the
- *  snapshot to a temp dir and runs the command as a plain child process — NO
- *  isolation. Good enough to demo the framework standalone; production uses
- *  OpenSandbox. */
-export declare function createSubprocessSandbox(): SandboxExecutor;
+export declare function createSubprocessSandbox(input?: {
+    /** 提供后：快照从真实工作区采集、新产物回写工作区（函数形式随项目切换）。 */
+    workspaceRoot?: string | (() => string | null | undefined);
+}): SandboxExecutor;
 //# sourceMappingURL=subprocess-sandbox.d.ts.map

package/dist/adapters/subprocess-sandbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subprocess-sandbox.d.ts","sourceRoot":"","sources":["../../src/adapters/subprocess-sandbox.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D;;;mBAGmB;AACnB,wBAAgB,uBAAuB,IAAI,eAAe,CAoEzD"}
+{"version":3,"file":"subprocess-sandbox.d.ts","sourceRoot":"","sources":["../../src/adapters/subprocess-sandbox.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AA2B5D,wBAAgB,uBAAuB,CAAC,KAAK,CAAC,EAAE;IAC9C,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CAC5D,GAAG,eAAe,CAiIlB"}

package/dist/adapters/subprocess-sandbox.js

@@ -1,25 +1,82 @@
 import { spawn } from "node:child_process";
-import { mkdtemp, writeFile, rm, readdir, readFile } from "node:fs/promises";
+import { copyFile, mkdir, mkdtemp, readdir, readFile, rm, stat, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import path from "node:path";
-/** Subprocess SandboxExecutor (M5 §5 CLI reference implementation): writes the
- *  snapshot to a temp dir and runs the command as a plain child process — NO
- *  isolation. Good enough to demo the framework standalone; production uses
- *  OpenSandbox. */
-export function createSubprocessSandbox() {
+/** Subprocess SandboxExecutor (M5 §5): 快照到 temp 目录跑普通子进程——无隔离，
+ *  面向本机单用户宿主（生产隔离由 OpenSandbox 等真沙箱承担）。
+ *
+ *  快照/回写语义（E2E 实测修复）：
+ *  - 提供 workspaceRoot 时，buildSnapshot 从真实工作区采集文本文件（跳过
+ *    node_modules/.git 等重目录，限量防爆），bash 命令能看到并改动工作区文件；
+ *  - 命令结束后，快照外的新文件（npm install 的 node_modules、构建产物等）
+ *    直接 fs 回写工作区——不逐文件版本化，产物面板事件只收小文本样本，
+ *    避免 node_modules 数千条 artifact.created 刷屏。 */
+const SNAPSHOT_MAX_FILES = 5000;
+const SNAPSHOT_MAX_BYTES = 32 * 1024 * 1024;
+const SNAPSHOT_MAX_FILE_BYTES = 512 * 1024;
+/** 快照采集跳过的重目录（依赖/构建缓存不入快照，npm install 会重新生成）。 */
+const SNAPSHOT_SKIP_DIRS = new Set([
+    "node_modules", ".git", ".next", ".nuxt", "dist", "build", "out",
+    ".cache", ".venv", "venv", "__pycache__", ".turbo", ".harness-data",
+]);
+/** 产物面板/回写事件排除（批量落盘照常，只是不进事件流）。 */
+const ARTIFACT_SKIP_DIRS = new Set(["node_modules", ".git", "__pycache__", ".cache"]);
+const ARTIFACT_MAX_PATHS = 100;
+const WORKSPACE_CONTENT_MAX_FILES = 30;
+const WORKSPACE_CONTENT_MAX_BYTES = 256 * 1024;
+export function createSubprocessSandbox(input) {
+    const wsRoot = () => (typeof input?.workspaceRoot === "function" ? input.workspaceRoot() : input?.workspaceRoot) ?? null;
     return {
-        async buildSnapshot(input) {
-            void input;
-            return { revisionId: null, files: [] };
+        async buildSnapshot() {
+            const ws = wsRoot();
+            if (!ws)
+                return { revisionId: null, files: [] };
+            const files = [];
+            let total = 0;
+            const walk = async (dir) => {
+                if (files.length >= SNAPSHOT_MAX_FILES || total >= SNAPSHOT_MAX_BYTES)
+                    return;
+                const entries = await readdir(dir, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (files.length >= SNAPSHOT_MAX_FILES || total >= SNAPSHOT_MAX_BYTES)
+                        return;
+                    const full = path.join(dir, entry.name);
+                    if (entry.isDirectory()) {
+                        if (SNAPSHOT_SKIP_DIRS.has(entry.name))
+                            continue;
+                        await walk(full);
+                    }
+                    else if (entry.isFile()) {
+                        const info = await stat(full);
+                        if (info.size > SNAPSHOT_MAX_FILE_BYTES)
+                            continue;
+                        const content = await readFile(full, "utf8");
+                        if (content.includes("\uFFFD"))
+                            continue; // 二进制不入快照
+                        total += info.size;
+                        files.push({ path: path.relative(ws, full), content });
+                    }
+                }
+            };
+            try {
+                await walk(ws);
+            }
+            catch {
+                /* 工作区读取失败按空快照跑 */
+            }
+            return { revisionId: null, files };
         },
         async run(input) {
             const dir = await mkdtemp(path.join(tmpdir(), "fw-sandbox-"));
             try {
                 for (const file of input.snapshot.files) {
                     const full = path.join(dir, file.path);
+                    await mkdir(path.dirname(full), { recursive: true });
                     await writeFile(full, file.content, "utf8");
                 }
                 const cwd = input.command.cwd ? path.join(dir, input.command.cwd) : dir;
+                // cwd 可能指向快照里没有文件的子目录（如刚 mkdir 的空项目）：先建出来
+                await mkdir(cwd, { recursive: true });
                 const result = await new Promise((resolve, reject) => {
                     const child = spawn(input.command.program, input.command.args ?? [], {
                         cwd,
@@ -37,38 +94,69 @@ export function createSubprocessSandbox() {
                     child.on("error", reject);
                     child.on("close", (code) => resolve({ code, output }));
                 });
-                // Collect files written during the run as deliverables.
+                // 收集快照外的新文件：批量 fs 回写工作区 + 产物元数据（限流）
+                const snapshotPaths = new Set(input.snapshot.files.map((f) => f.path));
+                const ws = wsRoot();
                 const artifacts = [];
+                let contentSamples = 0;
+                let truncated = false;
                 const walk = async (dirPath) => {
+                    if (truncated)
+                        return;
                     const entries = await readdir(dirPath, { withFileTypes: true });
                     for (const entry of entries) {
+                        if (truncated)
+                            return;
                         const full = path.join(dirPath, entry.name);
                         if (entry.isDirectory()) {
                             await walk(full);
                         }
-                        else if (entry.name !== ".fw-sandbox") {
+                        else if (entry.isFile() && entry.name !== ".fw-sandbox") {
                             const rel = path.relative(dir, full);
-                            const content = await readFile(full);
+                            if (snapshotPaths.has(rel))
+                                continue;
+                            const info = await stat(full);
+                            // 批量回写：新文件原样落回工作区（node_modules 也落，install 才有意义）
+                            if (ws) {
+                                const parent = path.relative(dir, path.dirname(full));
+                                const destDir = parent ? path.join(ws, parent) : ws;
+                                await mkdir(destDir, { recursive: true });
+                                await copyFile(full, path.join(ws, rel));
+                            }
+                            if (ARTIFACT_SKIP_DIRS.has(rel.split(path.sep)[0] ?? ""))
+                                continue;
+                            if (artifacts.length >= ARTIFACT_MAX_PATHS) {
+                                truncated = true;
+                                continue;
+                            }
+                            // 事件样本：仅小文本给 workspaceContent（走版本化写入 + diff 卡片）
+                            let workspaceContent;
+                            if (info.size <= WORKSPACE_CONTENT_MAX_BYTES && contentSamples < WORKSPACE_CONTENT_MAX_FILES) {
+                                const text = await readFile(full, "utf8");
+                                if (!text.includes("\uFFFD")) {
+                                    workspaceContent = text;
+                                    contentSamples++;
+                                }
+                            }
                             artifacts.push({
                                 path: rel,
-                                bytes: content.length,
+                                bytes: info.size,
                                 contentType: guessContentType(rel),
-                                downloadUrl: `file://${full}`,
+                                // 回写后的文件指向工作区真实路径（temp 目录在 finally 里会删）
+                                downloadUrl: ws ? `file://${path.join(ws, rel)}` : `file://${full}`,
+                                ...(workspaceContent !== undefined ? { workspaceContent } : {}),
                             });
                         }
                     }
                 };
                 await walk(dir);
-                // Only files NOT in the original snapshot count as deliverables.
-                const snapshotPaths = new Set(input.snapshot.files.map((f) => f.path));
-                const deliverables = artifacts.filter((a) => !snapshotPaths.has(a.path));
                 return {
                     ok: result.code === 0,
                     outcome: result.code === 0 ? "succeeded" : "failed",
                     exitCode: result.code,
                     outputText: result.output,
                     durationMs: 0,
-                    artifacts: deliverables,
+                    artifacts,
                 };
             }
             finally {

package/dist/adapters/subprocess-sandbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"subprocess-sandbox.js","sourceRoot":"","sources":["../../src/adapters/subprocess-sandbox.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"subprocess-sandbox.js","sourceRoot":"","sources":["../../src/adapters/subprocess-sandbox.ts"],"names":[],"mappings":"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"}

package/dist/adapters/terminal-backend.d.ts

@@ -0,0 +1,5 @@
+import type { TerminalBackend } from "../core/tools/terminal.js";
+/** 宿主终端后端单例：优先真 PTY，node-pty 不可用或 spawn 探测失败时降级管道模式。
+ *  首次调用即锁定后端种类（同步），session 标签从此不存在竞态。 */
+export declare function createHostTerminalBackend(): TerminalBackend;
+//# sourceMappingURL=terminal-backend.d.ts.map

package/dist/adapters/terminal-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-backend.d.ts","sourceRoot":"","sources":["../../src/adapters/terminal-backend.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAqDjE;yCACyC;AACzC,wBAAgB,yBAAyB,IAAI,eAAe,CAQ3D"}