@steerable/agent-shell 0.6.17 → 0.6.18

package/dist/local-backend/router.js

@@ -898,7 +898,19 @@ export class LocalBackendRouter {
             }
         }
         if (method === 'DELETE' && pathname.startsWith('/api/v2/chat-agents/skills/delete/')) {
-            const skillName = pathname.slice('/api/v2/chat-agents/skills/delete/'.length).trim();
+            // URL.pathname 保留百分号编码——目录名/frontmatter 名含空格等字符时
+            // 客户端发来的是 fancy%20skill，不 decode 永远匹配不上 fancy skill
+            // （projects/mcp 路由段都 decode，这里对齐）。非法编码按 400 处理。
+            let skillName;
+            try {
+                skillName = decodeURIComponent(pathname.slice('/api/v2/chat-agents/skills/delete/'.length)).trim();
+            }
+            catch {
+                return {
+                    status: 400,
+                    data: { error: 'skillName is not valid percent-encoding' },
+                };
+            }
             if (!skillName) {
                 return {
                     status: 400,
@@ -1743,6 +1755,14 @@ export class LocalBackendRouter {
             // user+assistant pair onto history while the original (possibly bad)
             // assistant reply stayed in place — the model saw both and had no real
             // reason to answer differently.
+            //
+            // sidecar 门必须先于任何写操作：rerun 回合只能跑在 sidecar 上
+            // （handleCoreLoopTurn 无 sidecar 直接 503）。若先截断再 503，旧回复
+            // 已删、新回复不会产生、record 也不存在——非破坏性承诺破窗。
+            if (!getSidecarSupervisor()) {
+                emit(this.sse('error', { message: 'coreloop enabled but sidecar is not running' }));
+                return { status: 503 };
+            }
             const targetMessageId = regenerateMatch[2];
             // The user turn that prompted the target reply is whatever immediately
             // precedes it — re-derive its text so buildConversationMessages gets

package/dist/local-executor.d.ts

@@ -30,12 +30,22 @@ export interface LocalFileReadRequest {
     path: string;
     encoding?: BufferEncoding;
     maxSize?: number;
+    /** 1-based 起始行（CC Read 风格分页）。与 limit 配合做部分视图读取。 */
+    offset?: number;
+    /** 最多返回的行数（配合 offset 分页）；缺省返回到文件尾。 */
+    limit?: number;
 }
 export interface LocalFileReadResult {
     success: boolean;
     content?: string;
     /** 内容版本令牌（SHA-256）。读后写场景把它回传给 edit/write 做冲突检测。 */
     version?: string;
+    /**
+     * 本次返回的只是部分视图（offset/limit 分页或超长裁剪）——模型没看到完整
+     * 内容，本会话对该路径的整体覆写将被拒绝（框架 partial_reads / CC
+     * isPartialView 对齐）；定点修改走 local_edit_file 不受此限。
+     */
+    partial?: boolean;
     error?: string;
 }
 export interface LocalFileWriteRequest {
@@ -105,6 +115,18 @@ export interface LocalRunCodeResult extends LocalExecResult {
     /** 本次调用实际安装成功的依赖。 */
     installedPackages?: string[];
 }
+/**
+ * 部分视图裁剪（框架 `_clip` / CC Read 对齐）。version 永远基于完整内容计算，
+ * 部分视图的 CAS 令牌保持有效；返回的 partial 标记驱动整体覆写门。
+ *
+ * - 给了 offset/limit：按 1-based 行号切片，并在省略处打行数标记（含继续
+ *   分页的下一个 offset）；
+ * - 没给但内容超长：头尾裁剪，中间打省略字符数标记。
+ */
+export declare function slicePartialView(content: string, offset?: number, limit?: number): {
+    content: string;
+    partial: boolean;
+};
 /** 内容版本令牌：UTF-8 内容的 SHA-256。用于 read-before-write 冲突检测。 */
 /**
  * read-before-write 冲突令牌：内容的 SHA-256（UTF-8）十六进制。与框架
@@ -167,6 +189,13 @@ export declare class LocalExecutor {
      * 由 sidecar 的 `read_state.seed` 反向调用重灌（seedReadState）。
      */
     private readonly readFileState;
+    /**
+     * 部分视图门（框架 partial_reads / CC isPartialView 对齐）：本会话只读到
+     * 部分内容的分页/裁剪读取把路径登记在这里；writeLocalFile 拒绝整体覆写
+     * 未见全文的文件。完整读取或本会话自己的写/编辑成功后销记。会话恢复不
+     * 重灌此集合（与框架一致：resume 只重建 version 证据，门退化为 CAS）。
+     */
+    private readonly partialReadPaths;
     constructor(maxOutputBytes?: number, applyEditsFn?: ApplyEditsFn);
     updateSafetyConfig(config: CommandSafetyConfigPayload): void;
     /**

package/dist/local-executor.js

@@ -61,6 +61,55 @@ const NPM_PACKAGE_RE = /^(@[A-Za-z0-9._-]+\/)?[A-Za-z0-9._-]+(@[A-Za-z0-9._~^<>=
 const DEFAULT_TIMEOUT_MS = 30_000;
 const DEFAULT_MAX_OUTPUT_BYTES = 100 * 1024;
 const DEFAULT_MAX_READ_SIZE = 1024 * 1024;
+/**
+ * 单次读取返回给模型的字符上限（框架 workspace_tools `_MAX_OUTPUT` 对齐）。
+ * 超出部分头尾裁剪并打标记——保留尾部，日志/编译错误的关键行通常在末尾。
+ */
+const MAX_READ_OUTPUT_CHARS = 100_000;
+/**
+ * 部分视图裁剪（框架 `_clip` / CC Read 对齐）。version 永远基于完整内容计算，
+ * 部分视图的 CAS 令牌保持有效；返回的 partial 标记驱动整体覆写门。
+ *
+ * - 给了 offset/limit：按 1-based 行号切片，并在省略处打行数标记（含继续
+ *   分页的下一个 offset）；
+ * - 没给但内容超长：头尾裁剪，中间打省略字符数标记。
+ */
+export function slicePartialView(content, offset, limit) {
+    if (offset !== undefined || limit !== undefined) {
+        const start = offset ?? 1;
+        if (!Number.isInteger(start) || start < 1) {
+            throw new Error(`offset 必须是 >= 1 的整数（1-based 行号），收到 ${offset}`);
+        }
+        if (limit !== undefined && (!Number.isInteger(limit) || limit < 1)) {
+            throw new Error(`limit 必须是 >= 1 的整数，收到 ${limit}`);
+        }
+        const lines = content.split('\n');
+        if (start > lines.length) {
+            throw new Error(`offset ${start} 超出文件行数（共 ${lines.length} 行）。`);
+        }
+        const end = limit === undefined ? lines.length : Math.min(lines.length, start - 1 + limit);
+        let view = lines.slice(start - 1, end).join('\n');
+        const omittedAbove = start - 1;
+        const omittedBelow = lines.length - end;
+        if (omittedAbove > 0) {
+            view = `...[{上文省略 ${omittedAbove} 行}]...\n${view}`;
+        }
+        if (omittedBelow > 0) {
+            view = `${view}\n...[{下文省略 ${omittedBelow} 行；用 offset=${end + 1} 继续}]...`;
+        }
+        return { content: view, partial: omittedAbove > 0 || omittedBelow > 0 };
+    }
+    if (content.length <= MAX_READ_OUTPUT_CHARS) {
+        return { content, partial: false };
+    }
+    const head = Math.floor(MAX_READ_OUTPUT_CHARS / 5);
+    const tail = MAX_READ_OUTPUT_CHARS - head;
+    const omitted = content.length - head - tail;
+    return {
+        content: `${content.slice(0, head)}\n...[{省略 ${omitted} 字符；用 offset/limit 分段读取}]...\n${content.slice(-tail)}`,
+        partial: true,
+    };
+}
 /** 内容版本令牌：UTF-8 内容的 SHA-256。用于 read-before-write 冲突检测。 */
 /**
  * read-before-write 冲突令牌：内容的 SHA-256（UTF-8）十六进制。与框架
@@ -175,6 +224,13 @@ export class LocalExecutor {
      * 由 sidecar 的 `read_state.seed` 反向调用重灌（seedReadState）。
      */
     readFileState = new Map();
+    /**
+     * 部分视图门（框架 partial_reads / CC isPartialView 对齐）：本会话只读到
+     * 部分内容的分页/裁剪读取把路径登记在这里；writeLocalFile 拒绝整体覆写
+     * 未见全文的文件。完整读取或本会话自己的写/编辑成功后销记。会话恢复不
+     * 重灌此集合（与框架一致：resume 只重建 version 证据，门退化为 CAS）。
+     */
+    partialReadPaths = new Set();
     constructor(maxOutputBytes = DEFAULT_MAX_OUTPUT_BYTES, applyEditsFn = applyEdits) {
         this.maxOutputBytes = maxOutputBytes;
         this.applyEditsFn = applyEditsFn;
@@ -405,10 +461,19 @@ export class LocalExecutor {
                 return { success: false, error: `File too large (${fileStat.size} bytes), max=${maxSize}` };
             }
             const content = await readFile(filePath, { encoding });
+            // version 基于完整内容：部分视图的读证据 CAS 仍然有效（框架对齐）。
             const version = hashContent(content);
             // P2b: 记录读证据，后续 write/edit 缺省 expectedVersion 时自动 CAS。
             this.readFileState.set(filePath, version);
-            return { success: true, content, version };
+            const view = slicePartialView(content, request.offset, request.limit);
+            // 部分视图登记/销记：整体覆写门（writeLocalFile）据此拒绝未见全文的覆写。
+            if (view.partial) {
+                this.partialReadPaths.add(filePath);
+            }
+            else {
+                this.partialReadPaths.delete(filePath);
+            }
+            return { success: true, content: view.content, version, partial: view.partial };
         }
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);
@@ -427,6 +492,17 @@ export class LocalExecutor {
         return this.serializeFileOp(filePath, async () => {
             try {
                 const encoding = request.encoding ?? 'utf-8';
+                // 部分视图门：本会话对该路径只读到分页/裁剪后的内容，整体覆写会销毁
+                // 未见内容（框架 partial_reads / CC isPartialView 对齐）。定点修改走
+                // local_edit_file；确需整体重写时先用 offset/limit 分段读完。
+                if (this.partialReadPaths.has(filePath)) {
+                    return {
+                        success: false,
+                        error: `拒绝整体覆写：${filePath} 本会话只读到部分内容（分页/裁剪），` +
+                            '覆写会销毁未见内容。请改用 local_edit_file 做定点修改；' +
+                            '确需整体重写时先用 offset/limit 分段读完。',
+                    };
+                }
                 // P2b 自动 CAS：调用方没给 expectedVersion 时回落到本会话的读证据
                 // （含 read_state.seed 重灌的）。隐式期望只对仍存在的文件生效——
                 // 读后被删除的文件重新写入是新建，没有可覆盖的他人改动。
@@ -453,6 +529,8 @@ export class LocalExecutor {
                 const version = hashContent(request.content);
                 // 写成功后回写读证据：本会话自己的连续写不互相冲突。
                 this.readFileState.set(filePath, version);
+                // 模型亲自写了全文，部分视图门不再适用（框架对齐）。
+                this.partialReadPaths.delete(filePath);
                 return { success: true, version };
             }
             catch (error) {
@@ -498,6 +576,8 @@ export class LocalExecutor {
                 await this.atomicWrite(filePath, result.content, encoding);
                 const version = hashContent(result.content);
                 this.readFileState.set(filePath, version);
+                // 注意：编辑不销记 partialReadPaths——定点编辑不代表模型见过全文，
+                // 后续盲写仍会销毁未见内容（框架「Cleared by a full read or a write」对齐）。
                 return {
                     success: true,
                     version,

package/dist/runtime.js

@@ -124,8 +124,12 @@ export function resolveProductWebDist(entryUrl) {
     const here = path.dirname(fileURLToPath(entryUrl));
     const productId = path.basename(here);
     for (const candidate of [
+        // 源码平面：入口在 products/<id>/（web dist 在同级 web/dist）。
         path.join(here, 'web', 'dist'),
-        path.resolve(here, '..', '..', '..', '..', 'products', productId, 'web', 'dist'),
+        // 编译平面 A：入口在仓根 dist/products/<id>/（上溯 3 级到仓根）。
+        path.resolve(here, '..', '..', '..', 'products', productId, 'web', 'dist'),
+        // 编译平面 B：入口在产品内 products/<id>/dist/products/<id>/（上溯 5 级到仓根）。
+        path.resolve(here, '..', '..', '..', '..', '..', 'products', productId, 'web', 'dist'),
     ]) {
         if (fs.existsSync(path.join(candidate, 'index.html')))
             return candidate;

package/dist/tool-router.js

@@ -125,11 +125,24 @@ export class ToolRouter {
             },
             {
                 name: 'local_read_file',
-                description: 'Read a local text file',
+                description: 'Read a local text file. Large files can be paged with offset/limit (1-based line numbers); ' +
+                    'a paged or clipped result is marked `partial: true`, and a full-file overwrite of a path ' +
+                    'only partially read in this session is rejected — use local_edit_file for targeted changes, ' +
+                    'or finish reading all segments before rewriting.',
                 mode: 'read',
                 inputSchema: {
                     type: 'object',
-                    properties: { path: { type: 'string' } },
+                    properties: {
+                        path: { type: 'string' },
+                        offset: {
+                            type: 'number',
+                            description: 'Optional 1-based line number to start reading from (for paging large files).',
+                        },
+                        limit: {
+                            type: 'number',
+                            description: 'Optional maximum number of lines to return (for paging large files).',
+                        },
+                    },
                     required: ['path'],
                 },
             },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steerable/agent-shell",
-  "version": "0.6.17",
+  "version": "0.6.18",
   "description": "Steerable framework — product-neutral desktop/headless agent host (Tier 5). Electron main + preload + headless HTTP server (BS) sharing one storage/sidecar/tooling core; scenario packs extend it through the @steerable/pack-sdk contract and are composed at build time by the consuming product.",
   "license": "Apache-2.0",
   "homepage": "https://steerableframework.com/",
@@ -41,9 +41,9 @@
     "electron-store": "^8.1.0",
     "he": "^1.2.0",
     "node-pty": "^1.1.0",
-    "@steerable/agent-harness": "0.6.17",
-    "@steerable/pack-sdk": "0.6.17",
-    "@steerable/agent-protocol": "0.6.17"
+    "@steerable/pack-sdk": "0.6.18",
+    "@steerable/agent-harness": "0.6.18",
+    "@steerable/agent-protocol": "0.6.18"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",