@xiaobuyu/nodesign 0.0.1 → 0.0.3

package/server/engine/agent/hooks/post-trim.js

@@ -1,58 +1,58 @@
-/**
- * PostToolUse(Edit|Write) handler —— 干掉 tool_response.originalFile 防上下文累积。
- * （2026-08-14 可维护性行动：从 hooks.js 原样迁出，语义零改动）
- *
- * 背景：
- *   FileEditOutput.originalFile / FileWriteOutput.originalFile (sdk-tools.d.ts:2270, 2328)
- *   是完整原文件内容。canvas.html 25KB 一次 Edit 在 tool_result 里等于 6k tokens。
- *   30 turn 累积 ≈ 180k tokens → 跟 Kimi 256k 上限挤爆（用户实测 418k 报错）。
- *
- *   structuredPatch（diff 行）是模型理解改动所需的全部信息；oldString/newString
- *   是模型自己刚才传的 input，本来就在上下文里。originalFile 对模型基本无用 —
- *   要看完整文件后续再 Read 即可。
- *
- * 行为：
- *   updatedToolOutput 是 SDK 提供的"改写发给 model 的 tool_result"通道
- *   (sdk.d.ts:1944)。**只影响 model 视图**，jsonl 持久化仍是原 tool_response。
- *   也就是 forkSession / 断线恢复看到的还是完整产物 — 不丢数据。
- *
- *   保留字段：filePath / oldString / newString / structuredPatch / type / gitDiff
- *   清掉字段：originalFile（替换为 null，保持类型 string|null）
- *
- *   非 Edit/Write 的 tool_response 形态（如 input 不带 originalFile） noop。
- *
- * input: PostToolUseHookInput (sdk.d.ts:1926)
- * output: PostToolUseHookSpecificOutput (sdk.d.ts:1938)
- */
-export function makePostToolUseEditWriteTrimHandler({ ctx }) {
-  return async (input, _toolUseId, _options) => {
-    try {
-      const resp = input?.tool_response;
-      if (!resp || typeof resp !== 'object') return {};
-      if (!('originalFile' in resp)) return {};
-      const originalSize = typeof resp.originalFile === 'string' ? resp.originalFile.length : 0;
-      if (originalSize === 0) return {};  // 新建文件 originalFile 本就是 null
-
-      const trimmed = { ...resp, originalFile: null };
-
-      try {
-        ctx.emit({
-          type: 'run.tool_response_trimmed',
-          tool: input?.tool_name || 'Edit/Write',
-          field: 'originalFile',
-          savedChars: originalSize,
-        });
-      } catch { /* emit fail-safe */ }
-
-      return {
-        hookSpecificOutput: {
-          hookEventName: 'PostToolUse',
-          updatedToolOutput: trimmed,
-        },
-      };
-    } catch (err) {
-      console.warn(`[hooks/PostToolUse Edit|Write trim] handler threw:`, err.message);
-      return {};
-    }
-  };
-}
+/**
+ * PostToolUse(Edit|Write) handler —— 干掉 tool_response.originalFile 防上下文累积。
+ * （2026-08-14 可维护性行动：从 hooks.js 原样迁出，语义零改动）
+ *
+ * 背景：
+ *   FileEditOutput.originalFile / FileWriteOutput.originalFile (sdk-tools.d.ts:2270, 2328)
+ *   是完整原文件内容。canvas.html 25KB 一次 Edit 在 tool_result 里等于 6k tokens。
+ *   30 turn 累积 ≈ 180k tokens → 跟 Kimi 256k 上限挤爆（用户实测 418k 报错）。
+ *
+ *   structuredPatch（diff 行）是模型理解改动所需的全部信息；oldString/newString
+ *   是模型自己刚才传的 input，本来就在上下文里。originalFile 对模型基本无用 —
+ *   要看完整文件后续再 Read 即可。
+ *
+ * 行为：
+ *   updatedToolOutput 是 SDK 提供的"改写发给 model 的 tool_result"通道
+ *   (sdk.d.ts:1944)。**只影响 model 视图**，jsonl 持久化仍是原 tool_response。
+ *   也就是 forkSession / 断线恢复看到的还是完整产物 — 不丢数据。
+ *
+ *   保留字段：filePath / oldString / newString / structuredPatch / type / gitDiff
+ *   清掉字段：originalFile（替换为 null，保持类型 string|null）
+ *
+ *   非 Edit/Write 的 tool_response 形态（如 input 不带 originalFile） noop。
+ *
+ * input: PostToolUseHookInput (sdk.d.ts:1926)
+ * output: PostToolUseHookSpecificOutput (sdk.d.ts:1938)
+ */
+export function makePostToolUseEditWriteTrimHandler({ ctx }) {
+  return async (input, _toolUseId, _options) => {
+    try {
+      const resp = input?.tool_response;
+      if (!resp || typeof resp !== 'object') return {};
+      if (!('originalFile' in resp)) return {};
+      const originalSize = typeof resp.originalFile === 'string' ? resp.originalFile.length : 0;
+      if (originalSize === 0) return {};  // 新建文件 originalFile 本就是 null
+
+      const trimmed = { ...resp, originalFile: null };
+
+      try {
+        ctx.emit({
+          type: 'run.tool_response_trimmed',
+          tool: input?.tool_name || 'Edit/Write',
+          field: 'originalFile',
+          savedChars: originalSize,
+        });
+      } catch { /* emit fail-safe */ }
+
+      return {
+        hookSpecificOutput: {
+          hookEventName: 'PostToolUse',
+          updatedToolOutput: trimmed,
+        },
+      };
+    } catch (err) {
+      console.warn(`[hooks/PostToolUse Edit|Write trim] handler threw:`, err.message);
+      return {};
+    }
+  };
+}

package/server/engine/agent/hooks/pre-board-neighborhood.js

@@ -1,34 +1,34 @@
-/**
- * PreToolUse(Read|Edit|Write) —— 关系线邻域注入（2026-08-14 切片③）。
- *
- * agent 正要摸的文件身上如果连着线（用户手画的标注、改自/对照谱系），这一刻
- * 就是它最相关的时刻。每个文件一个会话只注一次（线是慢变数据，重复注是噪音）；
- * fail-soft —— 注不上不能挡工具。
- *
- * UserPromptSubmit 的全图摘要截断后，这里做精确补充。
- */
-import { fileNeighborhood } from '../../../lib/board-relations.js';
-import { toWorkspaceRel } from '../../../lib/workspace-path.js';
-
-export function makePreToolUseBoardNeighborhoodInjector({ workspaceRoot, projectId }) {
-  const seen = new Set();
-  return async (input) => {
-    try {
-      if (!projectId) return {};
-      const fp = input?.tool_input?.file_path;
-      if (typeof fp !== 'string' || !fp) return {};
-      const rel = toWorkspaceRel(fp, workspaceRoot);
-      if (!rel || seen.has(rel)) return {};
-      seen.add(rel);
-      const brief = await fileNeighborhood(projectId, rel, { limit: 6 });
-      if (!brief) return {};
-      return {
-        hookSpecificOutput: {
-          hookEventName: 'PreToolUse',
-          permissionDecision: 'allow',
-          additionalContext: `画布上连着 ${rel} 的关系线：\n${brief}`,
-        },
-      };
-    } catch { return {}; }
-  };
-}
+/**
+ * PreToolUse(Read|Edit|Write) —— 关系线邻域注入（2026-08-14 切片③）。
+ *
+ * agent 正要摸的文件身上如果连着线（用户手画的标注、改自/对照谱系），这一刻
+ * 就是它最相关的时刻。每个文件一个会话只注一次（线是慢变数据，重复注是噪音）；
+ * fail-soft —— 注不上不能挡工具。
+ *
+ * UserPromptSubmit 的全图摘要截断后，这里做精确补充。
+ */
+import { fileNeighborhood } from '../../../lib/board-relations.js';
+import { toWorkspaceRel } from '../../../lib/workspace-path.js';
+
+export function makePreToolUseBoardNeighborhoodInjector({ workspaceRoot, projectId }) {
+  const seen = new Set();
+  return async (input) => {
+    try {
+      if (!projectId) return {};
+      const fp = input?.tool_input?.file_path;
+      if (typeof fp !== 'string' || !fp) return {};
+      const rel = toWorkspaceRel(fp, workspaceRoot);
+      if (!rel || seen.has(rel)) return {};
+      seen.add(rel);
+      const brief = await fileNeighborhood(projectId, rel, { limit: 6 });
+      if (!brief) return {};
+      return {
+        hookSpecificOutput: {
+          hookEventName: 'PreToolUse',
+          permissionDecision: 'allow',
+          additionalContext: `画布上连着 ${rel} 的关系线：\n${brief}`,
+        },
+      };
+    } catch { return {}; }
+  };
+}

package/server/engine/agent/hooks/pre-defaults.js

@@ -1,84 +1,84 @@
-/**
- * PreToolUse 默认值矫正族 —— 透明改 tool_input，agent 无感，结果更有用。
- * （2026-08-14 可维护性行动：从 hooks.js 原样迁出，语义零改动）
- */
-
-
-/**
- * PreToolUse(Agent) 强制前台 —— 透明改 input，不 hard deny。
- *
- * ⚠️ 2026-08-03 修：**默认值翻了面，这个 hook 之前形同虚设。**
- *
- * 老 SDK：`run_in_background` 不传 = 前台，所以只需拦 `=== true`。
- * 新 SDK（sdk-tools.d.ts AgentInput 原文）："Agents run in the background by
- * default; you will be notified when one completes. **Set to false** to run this
- * agent synchronously when you need its result before continuing."
- *
- * 也就是说**不传 = 后台**。模型自然写法就是不传（探针实测 bg=undefined），于是：
- * 主 agent 只拿到一句 "Async agent launched successfully"，报告永远不回来。
- * 真实事故：2026-08-03 一个 explorer 烧了 38k tokens / 20 次工具调用 / 108 秒查
- * 完时局资料，主 agent 收到的 tool_result 里一个字都没有，只好自己重搜四轮，
- * 还跟用户说了句"研究员跑完了但报告没回传到我这儿"。
- *
- * 所以判据从"等于 true 才改"改成"**不是显式 false 就补 false**"。
- * 显式传了 false 的（模型自己知道要前台）原样放过，不重复改也不发提示。
- *
- * 为什么 NoDesign 一定要前台：创作的核心反馈环是 agent 看 explorer /
- * vision-checker 传回的素材 URL 与 critique → 据此改产物 → 再自检。
- * fire-and-forget 等于把这个环剪断，agent 拿不到结果只能盲写。
- * forwardSubagentText 已开，前台等的时候用户看得见子代理实时进度，不会卡死。
- *
- * 兜底另有一层：DEFAULT_TOOL_ALLOWLIST 里挂了 `TaskOutput`，万一还是漏成后台
- * （比如 isolation:'remote' 强制后台），主 agent 能凭 task_id 把报告捞回来。
- */
-export function makePreToolUseAgentForceForegroundHandler() {
-  return async (input) => {
-    const t = input?.tool_input;
-    if (!t || typeof t !== 'object') return {};
-    // 显式前台，不动
-    if (t.run_in_background === false) return {};
-    return {
-      hookSpecificOutput: {
-        hookEventName: 'PreToolUse',
-        permissionDecision: 'allow',
-        updatedInput: { ...t, run_in_background: false },
-        // 一句事实就够：为什么要前台 prelude 硬规则里已经讲了，每次派遣重复一遍是 N 倍说教
-        additionalContext: '已改为前台执行（run_in_background: false），报告会在这次 tool_result 里回来。',
-      },
-    };
-  };
-}
-
-/**
- * PreToolUse(Grep) handler：把缺省 output_mode 改成 'content'。
- *
- * SDK Grep 工具默认 output_mode='files_with_matches' —— 只返回匹配到的文件名
- * 列表，不返回行内容。Agent 拿到文件名后还得再 Read 一遍，多一个 turn，浪费
- * tokens 和时延。NoDesign 设计场景下 agent grep 几乎都是想看实际文本（CSS
- * 类名定义在哪、某个 token 怎么用），'content' 是更合理的默认。
- *
- * 拦截规则：
- *   - 没传 output_mode 或传了空字符串 → updatedInput 改成 'content'
- *   - 显式传 'files_with_matches' / 'count' → 不动（agent 知道自己在做什么）
- *
- * ⚠️ Grep 的输入改写只许有这一个 handler：两个 handler 各返回 updatedInput，
- * 后跑的那个是拿原始 tool_input 拼的，会把前一个的改动抹掉（2026-08-15 演出
- * 隐私闸想在这儿加排除 glob 时踩明白的，那版已按用户决定撤回）。
- *
- * 不发 additionalContext —— agent 不需要知道这个变换，行为对它透明，结果
- * 直接更有用。
- */
-export function makePreToolUseGrepContentDefaultHandler() {
-  return async (input) => {
-    const t = input?.tool_input;
-    if (!t || typeof t !== 'object') return {};
-    if (t.output_mode && t.output_mode !== '') return {};
-    return {
-      hookSpecificOutput: {
-        hookEventName: 'PreToolUse',
-        permissionDecision: 'allow',
-        updatedInput: { ...t, output_mode: 'content' },
-      },
-    };
-  };
-}
+/**
+ * PreToolUse 默认值矫正族 —— 透明改 tool_input，agent 无感，结果更有用。
+ * （2026-08-14 可维护性行动：从 hooks.js 原样迁出，语义零改动）
+ */
+
+
+/**
+ * PreToolUse(Agent) 强制前台 —— 透明改 input，不 hard deny。
+ *
+ * ⚠️ 2026-08-03 修：**默认值翻了面，这个 hook 之前形同虚设。**
+ *
+ * 老 SDK：`run_in_background` 不传 = 前台，所以只需拦 `=== true`。
+ * 新 SDK（sdk-tools.d.ts AgentInput 原文）："Agents run in the background by
+ * default; you will be notified when one completes. **Set to false** to run this
+ * agent synchronously when you need its result before continuing."
+ *
+ * 也就是说**不传 = 后台**。模型自然写法就是不传（探针实测 bg=undefined），于是：
+ * 主 agent 只拿到一句 "Async agent launched successfully"，报告永远不回来。
+ * 真实事故：2026-08-03 一个 explorer 烧了 38k tokens / 20 次工具调用 / 108 秒查
+ * 完时局资料，主 agent 收到的 tool_result 里一个字都没有，只好自己重搜四轮，
+ * 还跟用户说了句"研究员跑完了但报告没回传到我这儿"。
+ *
+ * 所以判据从"等于 true 才改"改成"**不是显式 false 就补 false**"。
+ * 显式传了 false 的（模型自己知道要前台）原样放过，不重复改也不发提示。
+ *
+ * 为什么 NoDesign 一定要前台：创作的核心反馈环是 agent 看 explorer /
+ * vision-checker 传回的素材 URL 与 critique → 据此改产物 → 再自检。
+ * fire-and-forget 等于把这个环剪断，agent 拿不到结果只能盲写。
+ * forwardSubagentText 已开，前台等的时候用户看得见子代理实时进度，不会卡死。
+ *
+ * 兜底另有一层：DEFAULT_TOOL_ALLOWLIST 里挂了 `TaskOutput`，万一还是漏成后台
+ * （比如 isolation:'remote' 强制后台），主 agent 能凭 task_id 把报告捞回来。
+ */
+export function makePreToolUseAgentForceForegroundHandler() {
+  return async (input) => {
+    const t = input?.tool_input;
+    if (!t || typeof t !== 'object') return {};
+    // 显式前台，不动
+    if (t.run_in_background === false) return {};
+    return {
+      hookSpecificOutput: {
+        hookEventName: 'PreToolUse',
+        permissionDecision: 'allow',
+        updatedInput: { ...t, run_in_background: false },
+        // 一句事实就够：为什么要前台 prelude 硬规则里已经讲了，每次派遣重复一遍是 N 倍说教
+        additionalContext: '已改为前台执行（run_in_background: false），报告会在这次 tool_result 里回来。',
+      },
+    };
+  };
+}
+
+/**
+ * PreToolUse(Grep) handler：把缺省 output_mode 改成 'content'。
+ *
+ * SDK Grep 工具默认 output_mode='files_with_matches' —— 只返回匹配到的文件名
+ * 列表，不返回行内容。Agent 拿到文件名后还得再 Read 一遍，多一个 turn，浪费
+ * tokens 和时延。NoDesign 设计场景下 agent grep 几乎都是想看实际文本（CSS
+ * 类名定义在哪、某个 token 怎么用），'content' 是更合理的默认。
+ *
+ * 拦截规则：
+ *   - 没传 output_mode 或传了空字符串 → updatedInput 改成 'content'
+ *   - 显式传 'files_with_matches' / 'count' → 不动（agent 知道自己在做什么）
+ *
+ * ⚠️ Grep 的输入改写只许有这一个 handler：两个 handler 各返回 updatedInput，
+ * 后跑的那个是拿原始 tool_input 拼的，会把前一个的改动抹掉（2026-08-15 演出
+ * 隐私闸想在这儿加排除 glob 时踩明白的，那版已按用户决定撤回）。
+ *
+ * 不发 additionalContext —— agent 不需要知道这个变换，行为对它透明，结果
+ * 直接更有用。
+ */
+export function makePreToolUseGrepContentDefaultHandler() {
+  return async (input) => {
+    const t = input?.tool_input;
+    if (!t || typeof t !== 'object') return {};
+    if (t.output_mode && t.output_mode !== '') return {};
+    return {
+      hookSpecificOutput: {
+        hookEventName: 'PreToolUse',
+        permissionDecision: 'allow',
+        updatedInput: { ...t, output_mode: 'content' },
+      },
+    };
+  };
+}