@steerable/agent-shell 0.8.0 → 0.8.2

package/dist/host/runtime.js

@@ -38,7 +38,7 @@ import { createJsonStore } from '../json-store.js';
 import { bindWorkspaceSkillRoots, listSkillRoots } from '../local-backend/skill-loader.js';
 import { collectPackExecWritableRoots } from '../local-backend/pack-turn-hooks.js';
 import { getChatAttachmentsDir } from '../attachments.js';
-import { ensureChatWorkspace } from '../project-home.js';
+import { ensureChatWorkspace, ensureWritableRoots } from '../project-home.js';
 import { recordInsightTurn } from '../insights/record.js';
 import { llmService } from '../llm/index.js';
 import { isProductLlmLocked, resolveRuntimeLlmSettings } from '../host-tools-runtime.js';
@@ -323,12 +323,14 @@ export async function createHostRuntime(options) {
                     ];
                 },
                 // 写：源文件夹、包声明的可写根，以及各自的子目录。附件目录保持只读。
+                // ensureWritableRoots 让这些名字先落成目录：Landlock/bwrap 在安装沙箱
+                // 规则时要 open 它们，声明了却还没建过的目录会让子进程起不来。
                 resolveAdditionalWriteRoots: async (chatId) => {
                     const project = await localBackendRouter.resolveChatProject(chatId);
-                    return [
+                    return ensureWritableRoots([
                         ...(project?.sourceFolders ?? []),
                         ...collectPackExecWritableRoots(chatId),
-                    ];
+                    ]);
                 },
                 approvalHandler: approvalBridge.handler,
                 askUserHandler: askUserBridge.handler,

package/dist/local-backend/router.js

@@ -52,7 +52,7 @@ import { parseImageAttachments, processImageAttachments } from '../image-attachm
 import { chatAttachmentsDirPath, isValidChatAttachmentsKey } from '../attachments.js';
 import { canonicalFencePath, canonicalPathInside } from '../fence-path.js';
 import { listProjectRuleFiles, loadProjectRuleFiles } from '../project-rules.js';
-import { allocateProjectHome, chatWorkspacePath, ensureChatWorkspace, ensureProjectHome, expandUserPath, } from '../project-home.js';
+import { allocateProjectHome, chatWorkspacePath, ensureChatWorkspace, ensureProjectHome, ensureWritableRoots, expandUserPath, } from '../project-home.js';
 import { registerLiveStream, getLiveStream, removeLiveStream } from './live-stream.js';
 import { compactHistory, forkHistory, rewindFrom } from './history-edit.js';
 import { copyForkDirectory, DEFAULT_FORK_WORKSPACE_MAX_BYTES, directorySizeBytes, forkPathRewriter, removeForkDirectory, } from './fork-copy.js';
@@ -3778,11 +3778,11 @@ export class LocalBackendRouter {
         // （项目根 + 包工作区），与沙箱是否启用无关——「完整权限」下根列表只是
         // 不再被强制，产物仍大概率落在这里；根之外的显式写由工具参数并集补。
         const turnStartedAtMs = Date.now();
-        const turnFileRoots = [
+        const turnFileRoots = ensureWritableRoots([
             ...collectPackExecWritableRoots(chatId),
             workspaceRoot,
             ...(chatProject?.sourceFolders ?? []),
-        ];
+        ]);
         try {
             const coreLoopOptions = {
                 supervisor,

package/dist/local-executor.d.ts

@@ -239,8 +239,14 @@ export declare class LocalExecutor {
     /**
      * P2b：会话恢复时重灌 read-before-write 证据。sidecar 扫描持久记录里的
      * 文件工具结果，把 path → version 经 `read_state.seed` 推到这里——进程
-     * 重启后自动 CAS 仍然成立（CC `seed_read_state` 语义）。键是 sidecar 侧
-     * 已解析的绝对路径，原样存储；resolvePath 对绝对路径是恒等，查询能命中。
+     * 重启后自动 CAS 仍然成立（CC `seed_read_state` 语义）。
+     *
+     * 键必须过一遍 `resolvePath`：读证据的每一次读写都用规范化后的路径做键，
+     * 而 seed 来的路径是 sidecar 记录的原文。两者不一致时自动 CAS 永远查不
+     * 中，write/edit 会退回「未读先写已拒绝」。macOS 上 `/var/folders/…` 与
+     * `/private/var/folders/…` 就是这种情形（`os.tmpdir()` 返回未解析的
+     * 形式），Linux 的 `/tmp` 符号链接同理。
+     *
      * 返回实际收录的条目数（畸形条目跳过）。
      */
     seedReadState(state: Record<string, unknown>): number;

package/dist/local-executor.js

@@ -329,15 +329,21 @@ export class LocalExecutor {
     /**
      * P2b：会话恢复时重灌 read-before-write 证据。sidecar 扫描持久记录里的
      * 文件工具结果，把 path → version 经 `read_state.seed` 推到这里——进程
-     * 重启后自动 CAS 仍然成立（CC `seed_read_state` 语义）。键是 sidecar 侧
-     * 已解析的绝对路径，原样存储；resolvePath 对绝对路径是恒等，查询能命中。
+     * 重启后自动 CAS 仍然成立（CC `seed_read_state` 语义）。
+     *
+     * 键必须过一遍 `resolvePath`：读证据的每一次读写都用规范化后的路径做键，
+     * 而 seed 来的路径是 sidecar 记录的原文。两者不一致时自动 CAS 永远查不
+     * 中，write/edit 会退回「未读先写已拒绝」。macOS 上 `/var/folders/…` 与
+     * `/private/var/folders/…` 就是这种情形（`os.tmpdir()` 返回未解析的
+     * 形式），Linux 的 `/tmp` 符号链接同理。
+     *
      * 返回实际收录的条目数（畸形条目跳过）。
      */
     seedReadState(state) {
         let seeded = 0;
         for (const [p, version] of Object.entries(state)) {
             if (typeof p === 'string' && p.length > 0 && typeof version === 'string') {
-                this.readFileState.set(p, version);
+                this.readFileState.set(this.resolvePath(p), version);
                 seeded += 1;
             }
         }

package/dist/project-home.d.ts

@@ -23,6 +23,18 @@ export declare function allocateProjectHome(projectName: string, options?: {
     exists?: (folderPath: string) => boolean;
 }): string;
 export declare function ensureProjectHome(folderPath: string): void;
+/**
+ * 把一批可写根落成真实目录，返回原列表（便于链式使用）。
+ *
+ * Linux 的 Landlock 在安装规则时逐个 open 这些路径，bwrap 则要 bind mount
+ * 它们；声明了但还没建过的目录会让被沙箱的子进程直接起不来
+ * （`writable root … does not exist`）。这与 supervisor 启动时对
+ * `sandboxWritableRoots` 做的 mkdir 是同一个前置条件。
+ *
+ * 建不出来的根**留在列表里**：沙箱应当因此明确拒绝这次调用，而不是悄悄
+ * 少一份写权限继续跑。
+ */
+export declare function ensureWritableRoots(roots: readonly string[]): string[];
 /** 无项目对话的工作区子目录名（与托管项目家目录并列，避免撞名）。 */
 export declare const CHAT_WORKSPACES_DIR = "conversations";
 /**

package/dist/project-home.js

@@ -56,6 +56,30 @@ export function allocateProjectHome(projectName, options) {
 export function ensureProjectHome(folderPath) {
     fs.mkdirSync(folderPath, { recursive: true });
 }
+/**
+ * 把一批可写根落成真实目录，返回原列表（便于链式使用）。
+ *
+ * Linux 的 Landlock 在安装规则时逐个 open 这些路径，bwrap 则要 bind mount
+ * 它们；声明了但还没建过的目录会让被沙箱的子进程直接起不来
+ * （`writable root … does not exist`）。这与 supervisor 启动时对
+ * `sandboxWritableRoots` 做的 mkdir 是同一个前置条件。
+ *
+ * 建不出来的根**留在列表里**：沙箱应当因此明确拒绝这次调用，而不是悄悄
+ * 少一份写权限继续跑。
+ */
+export function ensureWritableRoots(roots) {
+    for (const root of new Set(roots)) {
+        if (typeof root !== 'string' || !root.trim())
+            continue;
+        try {
+            fs.mkdirSync(root, { recursive: true });
+        }
+        catch (err) {
+            console.warn(`[project-home] cannot create writable root ${root}: ${err.message}`);
+        }
+    }
+    return [...roots];
+}
 /** 无项目对话的工作区子目录名（与托管项目家目录并列，避免撞名）。 */
 export const CHAT_WORKSPACES_DIR = 'conversations';
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steerable/agent-shell",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "Steerable framework — product-neutral Node HostRuntime and headless HTTP server shared by Tauri desktop and browser deployments; scenario packs extend it through @steerable/pack-sdk.",
   "license": "Apache-2.0",
   "homepage": "https://steerableframework.com/",
@@ -53,9 +53,9 @@
     "jpeg-js": "^0.4.4",
     "node-pty": "^1.1.0",
     "pngjs": "^7.0.0",
-    "@steerable/agent-harness": "0.8.0",
-    "@steerable/agent-protocol": "0.8.0",
-    "@steerable/pack-sdk": "0.8.0"
+    "@steerable/agent-harness": "0.8.2",
+    "@steerable/agent-protocol": "0.8.2",
+    "@steerable/pack-sdk": "0.8.2"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",