@whispering233/ai-editor-tools 0.0.29 → 0.0.32

package/dist/proposal/reference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../src/proposal/reference.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,aAAa,EAAwB,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE1F;;2CAE2C;AAC3C,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,0BAA0B,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAchI;AAED,+CAA+C;AAC/C,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,0BAA0B,EAChC,MAAM,CAAC,EAAE,WAAW,GACnB,kBAAkB,CAIpB"}
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../src/proposal/reference.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,aAAa,EAAwB,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE1F;;2CAE2C;AAC3C,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,0BAA0B,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAchI;AAED,+CAA+C;AAC/C,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,0BAA0B,EAChC,MAAM,CAAC,EAAE,WAAW,GACnB,kBAAkB,CAIpB"}

package/dist/proposal/reference.js

@@ -1,4 +1,4 @@
-// 提案类工具：参考资料（批次九）
+// 提案类工具：参考资料
 // propose_create_reference——AI 读到灵感/素材后建议保存为参考资料（外部素材/灵感笔记，非本书正文）
 //
 // 语义对齐 S6.6 提案工具：build 只产出提案对象（不落盘），run 返回 { proposal_id, summary }

package/dist/proposal/reference.js.map

@@ -1 +1 @@
-{"version":3,"file":"reference.js","sourceRoot":"","sources":["../../src/proposal/reference.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAClB,kEAAkE;AAClE,EAAE;AACF,oEAAoE;AACpE,wDAAwD;AACxD,2FAA2F;AAC3F,6EAA6E;AAI7E,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAA2B,MAAM,YAAY,CAAC;AAE1F;;2CAE2C;AAC3C,MAAM,UAAU,2BAA2B,CAAC,GAAgB,EAAE,IAAgC;IAC5F,MAAM,IAAI,GAA4B,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACvD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACnD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;QAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7D,6DAA6D;IAC5D,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;IACtD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACnD,OAAO,aAAa,CAClB,GAAG,EACH,0BAA0B,EAC1B,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,EACzB,EAAE,EACF,UAAU,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACzE,CAAC;AACJ,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,yBAAyB,CACvC,GAAgB,EAChB,IAAgC,EAChC,MAAoB;IAEpB,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAG,2BAA2B,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxD,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;AAC1E,CAAC"}
+{"version":3,"file":"reference.js","sourceRoot":"","sources":["../../src/proposal/reference.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,kEAAkE;AAClE,EAAE;AACF,oEAAoE;AACpE,wDAAwD;AACxD,2FAA2F;AAC3F,6EAA6E;AAI7E,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAA2B,MAAM,YAAY,CAAC;AAE1F;;2CAE2C;AAC3C,MAAM,UAAU,2BAA2B,CAAC,GAAgB,EAAE,IAAgC;IAC5F,MAAM,IAAI,GAA4B,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACvD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACnD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;QAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7D,6DAA6D;IAC5D,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;IACtD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACnD,OAAO,aAAa,CAClB,GAAG,EACH,0BAA0B,EAC1B,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,EACzB,EAAE,EACF,UAAU,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACzE,CAAC;AACJ,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,yBAAyB,CACvC,GAAgB,EAChB,IAAgC,EAChC,MAAoB;IAEpB,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAG,2BAA2B,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxD,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;AAC1E,CAAC"}

package/dist/proposal/relation.d.ts

@@ -1,4 +1,4 @@
-import type { ProposeAddRelationArgs, ProposeRemoveRelationArgs } from "@whispering233/ai-editor-shared";
+import type { ProposeAddRelationArgs, ProposeRemoveRelationArgs } from "../schemas/index.js";
 import type { ToolContext } from "../context.js";
 import { type Proposal, type ToolProposalResult } from "./types.js";
 /** 产出新增关系提案（端点类型生成时自动识别，执行形态规范化到 args） */

package/dist/proposal/relation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relation.d.ts","sourceRoot":"","sources":["../../src/proposal/relation.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AACzG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAqE,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEvI,0CAA0C;AAC1C,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,sBAAsB,GAAG,QAAQ,CAmBhG;AAED,+BAA+B;AAC/B,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,sBAAsB,EAC5B,MAAM,CAAC,EAAE,WAAW,GACnB,kBAAkB,CAIpB;AAED,6BAA6B;AAC7B,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,yBAAyB,GAAG,QAAQ,CAYtG;AAED,kCAAkC;AAClC,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,yBAAyB,EAC/B,MAAM,CAAC,EAAE,WAAW,GACnB,kBAAkB,CAIpB"}
+{"version":3,"file":"relation.d.ts","sourceRoot":"","sources":["../../src/proposal/relation.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAqE,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEvI,0CAA0C;AAC1C,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,sBAAsB,GAAG,QAAQ,CAmBhG;AAED,+BAA+B;AAC/B,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,sBAAsB,EAC5B,MAAM,CAAC,EAAE,WAAW,GACnB,kBAAkB,CAIpB;AAED,6BAA6B;AAC7B,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,yBAAyB,GAAG,QAAQ,CAYtG;AAED,kCAAkC;AAClC,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,yBAAyB,EAC/B,MAAM,CAAC,EAAE,WAAW,GACnB,kBAAkB,CAIpB"}

package/dist/proposal/reorder-timepoints.d.ts

@@ -1,4 +1,4 @@
-import type { ProposeReorderTimepointsArgs } from "@whispering233/ai-editor-shared";
+import type { ProposeReorderTimepointsArgs } from "../schemas/index.js";
 import type { ToolContext } from "../context.js";
 import { type Proposal, type ToolProposalResult } from "./types.js";
 /**
@@ -10,6 +10,6 @@ import { type Proposal, type ToolProposalResult } from "./types.js";
  * 4. preview.changes：仅列位置变化时间点（「「<name>」从第 X 位移到第 Y 位」，1-based）
  */
 export declare function buildProposeReorderTimepoints(ctx: ToolContext, args: ProposeReorderTimepointsArgs): Proposal;
-/** propose_reorder_timepoints run：中止检查 + 产出裁剪结果（tool_result 不含预览， 2026-08 修订） */
+/** propose_reorder_timepoints run：中止检查 + 产出裁剪结果（tool_result 不含预览，2026-08 修订） */
 export declare function runProposeReorderTimepoints(ctx: ToolContext, args: ProposeReorderTimepointsArgs, signal?: AbortSignal): ToolProposalResult;
 //# sourceMappingURL=reorder-timepoints.d.ts.map

package/dist/proposal/reorder-timepoints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reorder-timepoints.d.ts","sourceRoot":"","sources":["../../src/proposal/reorder-timepoints.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AACpF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAkD,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAuBpH;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,4BAA4B,GAAG,QAAQ,CA8B5G;AAED,iFAAiF;AACjF,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,4BAA4B,EAClC,MAAM,CAAC,EAAE,WAAW,GACnB,kBAAkB,CAIpB"}
+{"version":3,"file":"reorder-timepoints.d.ts","sourceRoot":"","sources":["../../src/proposal/reorder-timepoints.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAkD,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAuBpH;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,4BAA4B,GAAG,QAAQ,CA8B5G;AAED,gFAAgF;AAChF,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,4BAA4B,EAClC,MAAM,CAAC,EAAE,WAAW,GACnB,kBAAkB,CAIpB"}

package/dist/proposal/reorder-timepoints.js

@@ -1,11 +1,11 @@
 // 提案类工具：时间轴时间点批量重排（G2，「提案类」propose_reorder_timepoints）
 //
-// 语义（ G2 修订注记 + 权限分级）：AI 按时间点 name（时间标签文本，如
+// 语义（G2 修订注记 + 权限分级）：AI 按时间点 name（时间标签文本，如
 // 「第二天黄昏」「少年时」）语义识别先后 → 产出**有序时间点 id 全量序列**（args.timepoint_ids，
 // 顺序 = 建议新序）→ 本工具只产出提案对象（buildProposal，prop_ 运行时 id），**不落盘、
 // 不写任何数据**——排序由用户确认后 S6.7 reorder_timepoints 执行器落库（与 moveTimepoint
 // 拖拽权威语义不变：排序结果即 timepoint.sort_order 线性序；重排时间点**不改其下事件序**——
-// 双独立线性序， G2 修订）。
+// 双独立线性序，G2 修订）。
 //
 // 生成时校验（延伸）：
 // - args.timepoint_ids 与当前**全部未软删时间点** id 集合**完全相等**（缺/多/重复 → 抛错——
@@ -14,9 +14,9 @@
 // 存在性 + updated_at（用户拖拽改序后 AI 提案自动失效，409 PROPOSAL_STALE）
 // - preview = { changes: [...] }（Proposal.preview，F9 起可选字段）：仅列**位置变化**的
 // 时间点（对比当前序与新序，1-based 位置，人类可读；name 缺失/空串用 id 兜底）——
-// 完整预览经 SSE proposal 事件推送 GUI 展示提案卡
+// 完整预览随 tool_execution_end 帧的 result.details 推送 GUI 展示提案卡
 //
-// tool_result 语义（ 2026-08 修订）：run 只返回 { proposal_id, summary }，不含预览细节。
+// tool_result 语义（2026-08 修订）：run 只返回 { proposal_id, summary }，不含预览细节。
 import { listTimepoints } from "@whispering233/ai-editor-db";
 import { buildProposal, checkProposalAborted, refEntity } from "./types.js";
 /**
@@ -70,7 +70,7 @@ export function buildProposeReorderTimepoints(ctx, args) {
     return buildProposal(ctx, "propose_reorder_timepoints", { timepoint_ids: args.timepoint_ids }, references, // 全部时间点 updated_at 快照
     `按时间标签语义排序 ${timepoints.length} 个时间点`, { changes });
 }
-/** propose_reorder_timepoints run：中止检查 + 产出裁剪结果（tool_result 不含预览， 2026-08 修订） */
+/** propose_reorder_timepoints run：中止检查 + 产出裁剪结果（tool_result 不含预览，2026-08 修订） */
 export function runProposeReorderTimepoints(ctx, args, signal) {
     checkProposalAborted(signal);
     const proposal = buildProposeReorderTimepoints(ctx, args);

package/dist/proposal/reorder-timepoints.js.map

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

package/dist/proposal/types.d.ts

@@ -2,7 +2,7 @@ import type { EntityRow, OutlineFileNode, RelationRow } from "@whispering233/ai-
 import type { ToolContext } from "../context.js";
 /** 被引用对象种类（确认时按 kind 走对应存在性 + updated_at 重校验路径） */
 export type ProposalReferenceKind = "entity" | "relation" | "delta" | "outline_node";
-/** 单个引用快照：被引用对象 id + updated_at（ 快照比对） */
+/** 单个引用快照：被引用对象 id + updated_at（快照比对） */
 export interface ProposalReference {
     kind: ProposalReferenceKind;
     id: string;
@@ -11,7 +11,7 @@ export interface ProposalReference {
 }
 /** 提案对象（仅内存；S7.4 提案仓存储，S7.5 confirm/reject 消费） */
 export interface Proposal {
-    /** 运行时 id（prop_ 前缀， id 约定） */
+    /** 运行时 id（prop_ 前缀，id 约定） */
     proposal_id: string;
     /** 工具名（propose_*，PROPOSAL_TOOLS 一员） */
     type: string;
@@ -25,14 +25,14 @@ export interface Proposal {
     summary: string;
     /**
     * 结构化预览细节（F9 起可选）：如 propose_reorder_timepoints 的 { changes: string[] }（顺序变化
-    * 说明，供前端提案卡 JSON 展示）；经 SSE proposal 事件推送 GUI。未设置时 S7.4 executor
+    * 说明，供前端提案卡 JSON 展示）；随 tool_execution_end 帧的 result.details 推送 GUI。未设置时
     * 回退为 { type, summary, args }（既有提案工具默认预览形态，行为不变）。
     */
     preview?: Record<string, unknown>;
     /** ISO 8601 创建时间（应用层写入约定；TTL 计算基准，S7.4） */
     createdAt: string;
 }
-/** propose_* tool_result（ 2026-08 修订：仅「提案已发出」提示，不含预览细节） */
+/** propose_* tool_result（2026-08 修订：仅「提案已发出」提示，不含预览细节） */
 export interface ToolProposalResult {
     proposal_id: string;
     summary: string;
@@ -70,7 +70,7 @@ export declare function resolveEndpoint(ctx: ToolContext, id: string): {
 export declare function requireOutlineNode(ctx: ToolContext, nodeId: string): OutlineFileNode;
 /**
  * 按 id 取伏笔实体（type === "hook" 且未软删，类型一致性校验）；否则抛错。
- * 伏笔即 type=hook 的实体（：用户手动创建或 AI 提案创建），快照用实体自身 updated_at。
+ * 伏笔即 type=hook 的实体（用户手动创建或 AI 提案创建），快照用实体自身 updated_at。
  */
 export declare function requireHook(ctx: ToolContext, hookId: string): EntityRow;
 /** 提案工具入口统一中止检查（长工具执行中检查 signal；提案生成是同步短操作，入口检查一次即可） */

package/dist/proposal/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/proposal/types.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE/F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD,mDAAmD;AACnD,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,cAAc,CAAC;AAErF,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,EAAE,EAAE,MAAM,CAAC;IACZ,iDAAiD;IAChD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,kDAAkD;AAClD,MAAM,WAAW,QAAQ;IACxB,8BAA8B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACtC,IAAI,EAAE,MAAM,CAAC;IACd,gDAAgD;IAC/C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,qCAAqC;IACpC,UAAU,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC9B,UAAU,EAAE,iBAAiB,EAAE,CAAC;IACjC,kCAAkC;IACjC,OAAO,EAAE,MAAM,CAAC;IACjB;;;;MAIE;IACD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,2CAA2C;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,iBAAiB,EAAE,EAC/B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,QAAQ,CAWV;AAED,+BAA+B;AAC/B,wBAAgB,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,iBAAiB,CAE3D;AAED,+BAA+B;AAC/B,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,iBAAiB,CAE/D;AAED,gCAAgC;AAChC,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,iBAAiB,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,WAAW,EAChB,EAAE,EAAE,MAAM,GACT;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,iBAAiB,CAAA;CAAE,CAa1C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAMpF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAMvE;AAED,wDAAwD;AACxD,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAE/D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/proposal/types.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE/F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD,mDAAmD;AACnD,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,cAAc,CAAC;AAErF,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,EAAE,EAAE,MAAM,CAAC;IACZ,iDAAiD;IAChD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,kDAAkD;AAClD,MAAM,WAAW,QAAQ;IACxB,6BAA6B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACtC,IAAI,EAAE,MAAM,CAAC;IACd,gDAAgD;IAC/C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,qCAAqC;IACpC,UAAU,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC9B,UAAU,EAAE,iBAAiB,EAAE,CAAC;IACjC,kCAAkC;IACjC,OAAO,EAAE,MAAM,CAAC;IACjB;;;;MAIE;IACD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,2CAA2C;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,iBAAiB,EAAE,EAC/B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,QAAQ,CAWV;AAED,+BAA+B;AAC/B,wBAAgB,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,iBAAiB,CAE3D;AAED,+BAA+B;AAC/B,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,iBAAiB,CAE/D;AAED,gCAAgC;AAChC,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,iBAAiB,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,WAAW,EAChB,EAAE,EAAE,MAAM,GACT;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,iBAAiB,CAAA;CAAE,CAa1C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAMpF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAMvE;AAED,wDAAwD;AACxD,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAE/D"}

package/dist/proposal/types.js

@@ -5,7 +5,7 @@
 // 属 S7.4 范围，本模块只负责**产出提案对象结构**。
 //
 // 提案对象结构：
-// - proposal_id：prop_ 前缀（generateRuntimeId， id 约定）
+// - proposal_id：prop_ 前缀（generateRuntimeId，id 约定）
 // - type：工具名（PROPOSAL_TOOLS 一员，S7.4 executor 按名调度）
 // - args：**执行信息**——确认后调用 S6.7 执行工具所需的全部参数（端点类工具已把
 // id 解析为 {source_type, source_id} 等规范化形态，执行时可直接透传）
@@ -16,12 +16,12 @@
 // - summary：一句话摘要（tool_result + GUI 展示）
 // - createdAt：ISO 8601（应用层写入约定；TTL 计算基准）
 // - preview（F9 起可选）：结构化预览细节（如 propose_reorder_timepoints 的 { changes: [...] }）——
-// 经 SSE proposal 事件推送 GUI 展示提案卡；未设置时 S7.4 executor 回退为
+// 随 tool_execution_end 帧的 result.details 推送 GUI 展示提案卡；未设置时回退为
 // { type, summary, args }（既有提案工具的默认预览形态）。
 //
 // tool_result 语义（「返回语义」2026-08 修订）：propose_* 的 run 只返回
 // { proposal_id, summary }，**不含预览细节**——避免 LLM 误以为提案已生效而重复提案；
-// 完整预览经 SSE proposal 事件推送 GUI（S7 实现）。
+// 完整预览随 tool_execution_end 帧的 result.details 推送 GUI。
 import { getEntity } from "@whispering233/ai-editor-db";
 import { nowIso } from "@whispering233/ai-editor-db";
 import { generateRuntimeId } from "@whispering233/ai-editor-shared";
@@ -93,7 +93,7 @@ export function requireOutlineNode(ctx, nodeId) {
 }
 /**
  * 按 id 取伏笔实体（type === "hook" 且未软删，类型一致性校验）；否则抛错。
- * 伏笔即 type=hook 的实体（：用户手动创建或 AI 提案创建），快照用实体自身 updated_at。
+ * 伏笔即 type=hook 的实体（用户手动创建或 AI 提案创建），快照用实体自身 updated_at。
  */
 export function requireHook(ctx, hookId) {
     const entity = getEntity(ctx.db, hookId);

package/dist/proposal/types.js.map

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

package/dist/query/delta.d.ts

@@ -1,8 +1,8 @@
 import type { ComputeStateResult, DeltaRecord } from "@whispering233/ai-editor-shared";
 import type { ToolContext } from "../context.js";
-import type { ComputeStateArgs, GetDeltaHistoryArgs } from "@whispering233/ai-editor-shared";
+import type { ComputeStateArgs, GetDeltaHistoryArgs } from "../schemas/index.js";
 /**
- * 实体到达指定节点时的累积状态（ compute_state(target_type, target_id, at_node_id)）。
+ * 实体到达指定节点时的累积状态（compute_state(target_type, target_id, at_node_id)）。
  * 透传 db computeState：只沿大纲树父链（根 → at_node_id）累积已确认 Delta，
  * 节点间按树路径序、节点内按 order 双层排序；plot_edge 不参与；op=update from 校验失败
  * **跳过该 change 并继续累积**，结果在 conflicts 中标注 { field, expected, actual }
@@ -11,7 +11,7 @@ import type { ComputeStateArgs, GetDeltaHistoryArgs } from "@whispering233/ai-ed
  */
 export declare function runComputeState(ctx: ToolContext, args: ComputeStateArgs): ComputeStateResult | null;
 /**
- * 目标实体的全部属性变更记录（ get_delta_history(target_type, target_id)）。
+ * 目标实体的全部属性变更记录（get_delta_history(target_type, target_id)）。
  * 透传 db listDeltasByTarget：按 target_id 查询 + 全局 order ASC（时间序）排序 +
  * 可见性三态过滤（delta 自身 / 触发节点 / 目标端点任一软删即不可见）+
  * targetName 联表填充。target_type 仅由 db 侧用于判定目标端点类型（实体/大纲节点）。

package/dist/query/delta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delta.d.ts","sourceRoot":"","sources":["../../src/query/delta.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAI7F;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,gBAAgB,GAAG,kBAAkB,GAAG,IAAI,CAMnG;AAID;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,mBAAmB,GAAG,WAAW,EAAE,CAE7F"}
+{"version":3,"file":"delta.d.ts","sourceRoot":"","sources":["../../src/query/delta.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAIjF;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,gBAAgB,GAAG,kBAAkB,GAAG,IAAI,CAMnG;AAID;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,mBAAmB,GAAG,WAAW,EAAE,CAE7F"}

package/dist/query/delta.js

@@ -7,12 +7,12 @@
 // 工具层参数映射透传；at_node_id 不存在时 db 抛错（视为调用方 bug，路由层前置校验
 // 的约定），工具层不捕获——executor 统一转结构化错误喂回 LLM 自纠
 // - get_delta_history：db listDeltasByTarget（S6.3 下沉）已实现按目标端点查询 +
-// 可见性三态过滤（delta 自身/触发节点/目标端点软删，，与 listDeltasByNode
+// 可见性三态过滤（delta 自身/触发节点/目标端点软删，与 listDeltasByNode
 // 共享 filterVisibleDeltas 实现）——工具层一行透传
 import { computeState as dbComputeState, listDeltasByTarget } from "@whispering233/ai-editor-db";
 // ============ compute_state ============
 /**
- * 实体到达指定节点时的累积状态（ compute_state(target_type, target_id, at_node_id)）。
+ * 实体到达指定节点时的累积状态（compute_state(target_type, target_id, at_node_id)）。
  * 透传 db computeState：只沿大纲树父链（根 → at_node_id）累积已确认 Delta，
  * 节点间按树路径序、节点内按 order 双层排序；plot_edge 不参与；op=update from 校验失败
  * **跳过该 change 并继续累积**，结果在 conflicts 中标注 { field, expected, actual }
@@ -28,7 +28,7 @@ export function runComputeState(ctx, args) {
 }
 // ============ get_delta_history ============
 /**
- * 目标实体的全部属性变更记录（ get_delta_history(target_type, target_id)）。
+ * 目标实体的全部属性变更记录（get_delta_history(target_type, target_id)）。
  * 透传 db listDeltasByTarget：按 target_id 查询 + 全局 order ASC（时间序）排序 +
  * 可见性三态过滤（delta 自身 / 触发节点 / 目标端点任一软删即不可见）+
  * targetName 联表填充。target_type 仅由 db 侧用于判定目标端点类型（实体/大纲节点）。

package/dist/query/delta.js.map

@@ -1 +1 @@
-{"version":3,"file":"delta.js","sourceRoot":"","sources":["../../src/query/delta.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,sDAAsD;AACtD,EAAE;AACF,mDAAmD;AACnD,kEAAkE;AAClE,qDAAqD;AACrD,oDAAoD;AACpD,0CAA0C;AAC1C,iEAAiE;AACjE,mDAAmD;AACnD,sCAAsC;AAEtC,OAAO,EAAE,YAAY,IAAI,cAAc,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAKjG,0CAA0C;AAE1C;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,GAAgB,EAAE,IAAsB;IACtE,OAAO,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,UAAU,EAAE;QAC5C,UAAU,EAAE,IAAI,CAAC,WAAW;QAC5B,QAAQ,EAAE,IAAI,CAAC,SAAS;QACxB,QAAQ,EAAE,IAAI,CAAC,UAAU;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,8CAA8C;AAE9C;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAgB,EAAE,IAAyB;IAC5E,OAAO,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;AACpE,CAAC"}
+{"version":3,"file":"delta.js","sourceRoot":"","sources":["../../src/query/delta.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,sDAAsD;AACtD,EAAE;AACF,mDAAmD;AACnD,kEAAkE;AAClE,qDAAqD;AACrD,oDAAoD;AACpD,0CAA0C;AAC1C,iEAAiE;AACjE,kDAAkD;AAClD,sCAAsC;AAEtC,OAAO,EAAE,YAAY,IAAI,cAAc,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAKjG,0CAA0C;AAE1C;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,GAAgB,EAAE,IAAsB;IACtE,OAAO,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,UAAU,EAAE;QAC5C,UAAU,EAAE,IAAI,CAAC,WAAW;QAC5B,QAAQ,EAAE,IAAI,CAAC,SAAS;QACxB,QAAQ,EAAE,IAAI,CAAC,UAAU;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,8CAA8C;AAE9C;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAgB,EAAE,IAAyB;IAC5E,OAAO,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;AACpE,CAAC"}

package/dist/query/entity.d.ts

@@ -1,9 +1,9 @@
 import type { Entity } from "@whispering233/ai-editor-shared";
 import type { EntityListResult, EntitySummaryStats } from "@whispering233/ai-editor-db";
 import type { ToolContext } from "../context.js";
-import type { GetEntityArgs, GetEntitySummaryArgs, SearchEntitiesArgs } from "@whispering233/ai-editor-shared";
+import type { GetEntityArgs, GetEntitySummaryArgs, SearchEntitiesArgs } from "../schemas/index.js";
 /**
- * 实体详情（ get_entity(type, id) → 实体详情，含 data JSON 解析后的字段）。
+ * 实体详情（get_entity(type, id) → 实体详情，含 data JSON 解析后的字段）。
  * - db 层 getEntity 默认过滤软删（回收站对象不可见）
  * - type 与行内实际类型不一致 → null（参数错误，id 前缀体系下正常调用不会出现；
  * LLM 传错类型时得到「不存在」而非脏数据）
@@ -13,14 +13,14 @@ export declare function runGetEntity(ctx: ToolContext, args: GetEntityArgs): Ent
 /** search_entities 结果：匹配实体摘要列表 + 过滤后总数（db listEntities 同构） */
 export type SearchEntitiesResult = EntityListResult;
 /**
- * 实体搜索（ search_entities(type, query, filters?) → 匹配实体列表）。
+ * 实体搜索（search_entities(type, query, filters?) → 匹配实体列表）。
  * 透传 db listEntities：type + name LIKE 模糊匹配 + **软删过滤**
  * + filters（tags AND / status 精确匹配，data 字段 JS 过滤）+ 摘要提取（db 单一实现）。
  * limit 传 200（db clamp 上限）：搜索结果尽量全（token 截断由上层按 处理）。
  */
 export declare function runSearchEntities(ctx: ToolContext, args: SearchEntitiesArgs): SearchEntitiesResult;
 /**
- * 实体聚合统计（ get_entity_summary(type) → 总数、角色分布、能力分布等）。
+ * 实体聚合统计（get_entity_summary(type) → 总数、角色分布、能力分布等）。
  * 透传 db getEntitySummaryStats：仅统计非软删实体；分布字段按类型
  * 稀疏出现（character→byRole/byStatus/topAbilities、setting→byTags（分类由
  * rules 标签承接）、location→byType、hook→byStatus/byPayoffTiming），缺字段不报错。

package/dist/query/entity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../src/query/entity.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACxF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAI/G;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAIjF;AAID,8DAA8D;AAC9D,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,kBAAkB,GAAG,oBAAoB,CAOlG;AAID;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,oBAAoB,GAAG,kBAAkB,CAEpG"}
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../src/query/entity.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACxF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAInG;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAIjF;AAID,8DAA8D;AAC9D,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,kBAAkB,GAAG,oBAAoB,CAOlG;AAID;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,oBAAoB,GAAG,kBAAkB,CAEpG"}

package/dist/query/entity.js

@@ -12,7 +12,7 @@ import { getEntity as dbGetEntity, getEntitySummaryStats, listEntities } from "@
 import { mapRowToEntity } from "@whispering233/ai-editor-shared";
 // ============ get_entity ============
 /**
- * 实体详情（ get_entity(type, id) → 实体详情，含 data JSON 解析后的字段）。
+ * 实体详情（get_entity(type, id) → 实体详情，含 data JSON 解析后的字段）。
  * - db 层 getEntity 默认过滤软删（回收站对象不可见）
  * - type 与行内实际类型不一致 → null（参数错误，id 前缀体系下正常调用不会出现；
  * LLM 传错类型时得到「不存在」而非脏数据）
@@ -25,7 +25,7 @@ export function runGetEntity(ctx, args) {
     return mapRowToEntity(row);
 }
 /**
- * 实体搜索（ search_entities(type, query, filters?) → 匹配实体列表）。
+ * 实体搜索（search_entities(type, query, filters?) → 匹配实体列表）。
  * 透传 db listEntities：type + name LIKE 模糊匹配 + **软删过滤**
  * + filters（tags AND / status 精确匹配，data 字段 JS 过滤）+ 摘要提取（db 单一实现）。
  * limit 传 200（db clamp 上限）：搜索结果尽量全（token 截断由上层按 处理）。
@@ -40,7 +40,7 @@ export function runSearchEntities(ctx, args) {
 }
 // ============ get_entity_summary ============
 /**
- * 实体聚合统计（ get_entity_summary(type) → 总数、角色分布、能力分布等）。
+ * 实体聚合统计（get_entity_summary(type) → 总数、角色分布、能力分布等）。
  * 透传 db getEntitySummaryStats：仅统计非软删实体；分布字段按类型
  * 稀疏出现（character→byRole/byStatus/topAbilities、setting→byTags（分类由
  * rules 标签承接）、location→byType、hook→byStatus/byPayoffTiming），缺字段不报错。

package/dist/query/outline.d.ts

@@ -1,8 +1,8 @@
 import type { OutlineTree } from "@whispering233/ai-editor-shared";
 import type { ToolContext } from "../context.js";
-import type { GetOutlinePathArgs } from "@whispering233/ai-editor-shared";
+import type { GetOutlinePathArgs } from "../schemas/index.js";
 /**
- * 完整大纲树（ get_outline → 严格三层树）。
+ * 完整大纲树（get_outline → 严格三层树）。
  * - 默认不含 metadata 统计（省 token；需统计走 API GET /outline?with_metadata=）
  * - 软删节点过滤
  * - 返回 API 形态 OutlineTree（camelCase；data 嵌套字段原样透传）
@@ -10,7 +10,7 @@ import type { GetOutlinePathArgs } from "@whispering233/ai-editor-shared";
  */
 export declare function runGetOutline(ctx: ToolContext): OutlineTree;
 /**
- * 根 → 目标节点的路径 ID 列表（ get_outline_path(node_id)，含 root，
+ * 根 → 目标节点的路径 ID 列表（get_outline_path(node_id)，含 root，
  * 如 ["root", "vol-1", "ch-3", "sc-15"]；严格三层下路径唯一）。
  * - 节点不存在 → null（db getOutlinePathIds 抛错，工具层转查询无结果）
  * - 路径上任一节点软删 → null（软删对象不可见——目标节点软删时

package/dist/query/outline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"outline.d.ts","sourceRoot":"","sources":["../../src/query/outline.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAmB,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACpF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAkB1E;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,CAI3D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,kBAAkB,GAAG,MAAM,EAAE,GAAG,IAAI,CAc7F"}
+{"version":3,"file":"outline.d.ts","sourceRoot":"","sources":["../../src/query/outline.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAmB,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACpF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAkB9D;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,CAI3D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,kBAAkB,GAAG,MAAM,EAAE,GAAG,IAAI,CAc7F"}

package/dist/query/outline.js

@@ -4,7 +4,7 @@
 // db 层能力确认与分工：
 // - get_outline：db readOutlineFile 返回存储形态 OutlineFileTree——
 // 工具层 mapOutlineFileToTree 映射为 API 形态（camelCase）；**默认不含 metadata**
-// （省 token， 明确：需统计走 API with_metadata）；软删节点整棵剔除
+// （省 token，明确：需统计走 API with_metadata）；软删节点整棵剔除
 // （查询类工具不返回回收站中的对象）
 // - get_outline_path：db getOutlinePathIds 返回根 → 目标节点路径（含 root）；
 // 节点不存在抛错——工具层转 null（查询无结果）；路径上任一节点软删 → null（不可见）
@@ -27,7 +27,7 @@ function stripDeletedNodes(nodes) {
     return out;
 }
 /**
- * 完整大纲树（ get_outline → 严格三层树）。
+ * 完整大纲树（get_outline → 严格三层树）。
  * - 默认不含 metadata 统计（省 token；需统计走 API GET /outline?with_metadata=）
  * - 软删节点过滤
  * - 返回 API 形态 OutlineTree（camelCase；data 嵌套字段原样透传）
@@ -39,7 +39,7 @@ export function runGetOutline(ctx) {
     return mapOutlineFileToTree(stripped);
 }
 /**
- * 根 → 目标节点的路径 ID 列表（ get_outline_path(node_id)，含 root，
+ * 根 → 目标节点的路径 ID 列表（get_outline_path(node_id)，含 root，
  * 如 ["root", "vol-1", "ch-3", "sc-15"]；严格三层下路径唯一）。
  * - 节点不存在 → null（db getOutlinePathIds 抛错，工具层转查询无结果）
  * - 路径上任一节点软删 → null（软删对象不可见——目标节点软删时

package/dist/query/outline.js.map

@@ -1 +1 @@
-{"version":3,"file":"outline.js","sourceRoot":"","sources":["../../src/query/outline.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,yCAAyC;AACzC,EAAE;AACF,eAAe;AACf,4DAA4D;AAC5D,mEAAmE;AACnE,gDAAgD;AAChD,oBAAoB;AACpB,gEAAgE;AAChE,kDAAkD;AAElD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAClG,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAKvE;;;;;GAKG;AACH,SAAS,iBAAiB,CAA4B,KAAmB;IACvE,MAAM,GAAG,GAAQ,EAAE,CAAC;IACpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;YAAE,SAAS;QACpC,MAAM,QAAQ,GAAI,IAAkD,CAAC,QAAQ,CAAC;QAC9E,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EAAQ,CAAC,CAAC;IACtG,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,GAAgB;IAC5C,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;IACzE,OAAO,oBAAoB,CAAC,QAAQ,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAgB,EAAE,IAAwB;IAC1E,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,IAAc,CAAC;IACnB,IAAI,CAAC;QACH,IAAI,GAAG,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,wCAAwC;IACvD,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,IAAI,EAAE,CAAC;QAC1B,IAAI,MAAM,KAAK,MAAM;YAAE,SAAS,CAAC,iBAAiB;QAClD,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3C,IAAI,IAAI,EAAE,OAAO,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"outline.js","sourceRoot":"","sources":["../../src/query/outline.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,yCAAyC;AACzC,EAAE;AACF,eAAe;AACf,4DAA4D;AAC5D,mEAAmE;AACnE,+CAA+C;AAC/C,oBAAoB;AACpB,gEAAgE;AAChE,kDAAkD;AAElD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAClG,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAKvE;;;;;GAKG;AACH,SAAS,iBAAiB,CAA4B,KAAmB;IACvE,MAAM,GAAG,GAAQ,EAAE,CAAC;IACpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;YAAE,SAAS;QACpC,MAAM,QAAQ,GAAI,IAAkD,CAAC,QAAQ,CAAC;QAC9E,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EAAQ,CAAC,CAAC;IACtG,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,GAAgB;IAC5C,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;IACzE,OAAO,oBAAoB,CAAC,QAAQ,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAgB,EAAE,IAAwB;IAC1E,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,IAAc,CAAC;IACnB,IAAI,CAAC;QACH,IAAI,GAAG,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,wCAAwC;IACvD,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,IAAI,EAAE,CAAC;QAC1B,IAAI,MAAM,KAAK,MAAM;YAAE,SAAS,CAAC,iBAAiB;QAClD,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3C,IAAI,IAAI,EAAE,OAAO,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/query/reference.d.ts

@@ -1,6 +1,6 @@
 import type { EntityListResult } from "@whispering233/ai-editor-db";
 import type { ToolContext } from "../context.js";
-import type { SearchReferencesArgs } from "@whispering233/ai-editor-shared";
-/** 参考资料搜索（ search_references(query, type?, tags?) → 摘要列表） */
+import type { SearchReferencesArgs } from "../schemas/index.js";
+/** 参考资料搜索（search_references(query, type?, tags?) → 摘要列表） */
 export declare function runSearchReferences(ctx: ToolContext, args: SearchReferencesArgs): EntityListResult;
 //# sourceMappingURL=reference.d.ts.map

package/dist/query/reference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../src/query/reference.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAE5E,6DAA6D;AAC7D,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,CAalG"}
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../src/query/reference.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,4DAA4D;AAC5D,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,CAalG"}

package/dist/query/reference.js

@@ -1,4 +1,4 @@
-// 查询类工具：参考资料（批次九）
+// 查询类工具：参考资料
 // search_references——AI 不知道书里有哪些参考资料时先搜索（标题+tags 关键词命中）再按需取全文
 //
 // 靠工具按需拉取保护 token 预算）。全文取详情走 get_entity('reference', id) 的 reference 分支。
@@ -9,7 +9,7 @@
 // search 的 type 参数指「参考资料分类」（data.type 枚举），非实体类型——listEntities 的
 // filters 不支持 data.type 过滤（仅 tags/status），故在结果层做 JS 过滤（total 同步修正）。
 import { listEntities } from "@whispering233/ai-editor-db";
-/** 参考资料搜索（ search_references(query, type?, tags?) → 摘要列表） */
+/** 参考资料搜索（search_references(query, type?, tags?) → 摘要列表） */
 export function runSearchReferences(ctx, args) {
     const result = listEntities(ctx.db, {
         type: "reference",

package/dist/query/reference.js.map

@@ -1 +1 @@
-{"version":3,"file":"reference.js","sourceRoot":"","sources":["../../src/query/reference.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAClB,8DAA8D;AAC9D,EAAE;AACF,yEAAyE;AACzE,EAAE;AACF,0EAA0E;AAC1E,6EAA6E;AAC7E,+BAA+B;AAC/B,gEAAgE;AAChE,oEAAoE;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAK3D,6DAA6D;AAC7D,MAAM,UAAU,mBAAmB,CAAC,GAAgB,EAAE,IAA0B;IAC9E,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE;QAClC,IAAI,EAAE,WAAW;QACjB,CAAC,EAAE,IAAI,CAAC,KAAK;QACb,OAAO,EAAE,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;QAClE,KAAK,EAAE,GAAG;KACX,CAAC,CAAC;IACJ,6EAA6E;IAC5E,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/E,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IACrD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"reference.js","sourceRoot":"","sources":["../../src/query/reference.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,8DAA8D;AAC9D,EAAE;AACF,yEAAyE;AACzE,EAAE;AACF,0EAA0E;AAC1E,6EAA6E;AAC7E,+BAA+B;AAC/B,gEAAgE;AAChE,oEAAoE;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAK3D,4DAA4D;AAC5D,MAAM,UAAU,mBAAmB,CAAC,GAAgB,EAAE,IAA0B;IAC9E,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE;QAClC,IAAI,EAAE,WAAW;QACjB,CAAC,EAAE,IAAI,CAAC,KAAK;QACb,OAAO,EAAE,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;QAClE,KAAK,EAAE,GAAG;KACX,CAAC,CAAC;IACJ,6EAA6E;IAC5E,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/E,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IACrD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/query/relation.d.ts

@@ -1,8 +1,8 @@
 import type { RelationQueryResult } from "@whispering233/ai-editor-shared";
 import type { ToolContext } from "../context.js";
-import type { QueryRelationshipsArgs } from "@whispering233/ai-editor-shared";
+import type { QueryRelationshipsArgs } from "../schemas/index.js";
 /**
- * 关系图子图（ query_relationships → [{source,target,type,metadata}] 简写；
+ * 关系图子图（query_relationships → [{source,target,type,metadata}] 简写；
  * 实际透传 db 的 RelationQueryResult 完整形态：relations: RelationRecord[]（含
  * sourceName/targetName 联表名）+ depth>=2 时 paths: RelationPath[]）。
  * 参数映射：snake_case 工具参数 → db 层 camelCase RelationQuery（字段一一对应）；

package/dist/query/relation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relation.d.ts","sourceRoot":"","sources":["../../src/query/relation.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE9E;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,sBAAsB,GAAG,mBAAmB,CAazG"}
+{"version":3,"file":"relation.d.ts","sourceRoot":"","sources":["../../src/query/relation.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,sBAAsB,GAAG,mBAAmB,CAazG"}

package/dist/query/relation.js

@@ -10,7 +10,7 @@
 // 工具层仅做参数映射透传，无额外过滤逻辑。
 import { listRelations } from "@whispering233/ai-editor-db";
 /**
- * 关系图子图（ query_relationships → [{source,target,type,metadata}] 简写；
+ * 关系图子图（query_relationships → [{source,target,type,metadata}] 简写；
  * 实际透传 db 的 RelationQueryResult 完整形态：relations: RelationRecord[]（含
  * sourceName/targetName 联表名）+ depth>=2 时 paths: RelationPath[]）。
  * 参数映射：snake_case 工具参数 → db 层 camelCase RelationQuery（字段一一对应）；

package/dist/registry.d.ts

@@ -1,40 +1,47 @@
-import type { z } from "zod";
+import { type Static, type TSchema } from "@earendil-works/pi-ai";
 import type { ToolPermission } from "@whispering233/ai-editor-shared";
 import type { ToolContext } from "./context.js";
 /**
- * 工具定义（argsSchema 的推断类型约束 run 的 args 入参）。
+ * 工具定义（parameters 的推断类型约束 run 的 args 入参）。
  * run 声明为**方法**（而非函数属性）：方法参数双变检查——具体 schema 的
- * ToolDefinition<X> 可赋给容器默认的 ToolDefinition<z.ZodTypeAny>（run args 为
- * unknown），executor 从注册表取出后先 schema 校验（parsed.data 为 unknown）再执行，
- * 运行时由 argsSchema 兜底，类型层面双变无实际风险。
+ * ToolDefinition<X> 可赋给容器默认的 ToolDefinition<TSchema>（run args 为 unknown），
+ * executor 从注册表取出后先校验（validateToolArgs 返回 unknown）再执行，
+ * 运行时由 parameters 兜底，类型层面双变无实际风险。
  */
-export interface ToolDefinition<TSchema extends z.ZodTypeAny = z.ZodTypeAny> {
-    /** 工具名（ 工具目录，如 get_entity；LLM tool_call 的 tool 字段） */
+export interface ToolDefinition<TSchema_ extends TSchema = TSchema> {
+    /** 工具名（工具目录，如 get_entity；LLM tool_call 的 tool 字段） */
     name: string;
     /** 人类可读描述（注入 LLM 工具列表，说明用途与参数语义） */
     description: string;
-    /** 参数 zod schema（入参校验；推断类型即 run 的 args 类型） */
-    argsSchema: TSchema;
+    /** 参数 TypeBox schema（入参校验；`Static<>` 即 run 的 args 类型） */
+    parameters: TSchema_;
     /** 权限级别（TOOL_PERMISSION.AUTO / PROPOSAL） */
     permission: ToolPermission;
     /**
     * 执行函数：注入 ToolContext（db/outlineDir/projectId），返回可序列化结果或抛错。
-    * signal：可选取消通道（「长工具执行中检查 signal」）——S6.4 分析类
-    * 是长任务候选，executor 在 SSE 断开时中止在途工具；同步短工具可不检查。
+    * signal：可选取消通道（「长工具执行中检查 signal」）——分析类长任务在 executor
+    * 中止在途工具时命中；同步短工具可不检查。
     */
-    run(ctx: ToolContext, args: z.infer<TSchema>, signal?: AbortSignal): unknown;
+    run(ctx: ToolContext, args: Static<TSchema_>, signal?: AbortSignal): unknown;
 }
+/**
+ * 参数校验（执行前 preflight；校验语义与 pi agent 循环一致——pi-ai 的
+ * validateToolArguments：先做原始类型 coerce，再按 schema 检查，失败抛错）。
+ * 校验通过返回（可能被 coerce 的）参数对象。
+ * @throws Error 校验失败（消息含工具名 + 字段路径 + 原始参数）
+ */
+export declare function validateToolArgs(def: ToolDefinition, args: unknown): unknown;
 /**
  * 注册单个工具：重复注册同名工具抛错——防后续切片扩展时撞名，
  * 保证「注册表 = 工具目录唯一事实来源」。
- * 防呆：name 必须为非空字符串（S6.4-6.7 拼错名不应静默注册新工具）。
+ * 防呆：name 必须为非空字符串（拼错名不应静默注册新工具）。
  */
 export declare function registerTool(def: ToolDefinition): void;
 /** 批量注册（各工具模块组装定义数组后统一挂载；内部逐个调 registerTool 保证判重） */
 export declare function registerTools(defs: readonly ToolDefinition[]): void;
 /** 按名查询工具；未注册返回 undefined（executor 收到未知工具名时按失败处理） */
 export declare function getTool(name: string): ToolDefinition | undefined;
-/** 全部已注册工具（按名称排序，稳定输出；供 S7.2 上下文组装注入 LLM 工具列表） */
+/** 全部已注册工具（按名称排序，稳定输出；供上下文组装注入 LLM 工具列表） */
 export declare function listTools(): ToolDefinition[];
 /** 当前注册的工具数量（冒烟/测试断言用） */
 export declare function toolCount(): number;

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,WAAW,cAAc,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;IAC1E,sDAAsD;IACrD,IAAI,EAAE,MAAM,CAAC;IACd,oCAAoC;IACnC,WAAW,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC7C,UAAU,EAAE,OAAO,CAAC;IACrB,4CAA4C;IAC3C,UAAU,EAAE,cAAc,CAAC;IAC5B;;;;MAIE;IACD,GAAG,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;CAC9E;AAKD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAQtD;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI,CAEnE;AAED,qDAAqD;AACrD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEhE;AAED,kDAAkD;AAClD,wBAAgB,SAAS,IAAI,cAAc,EAAE,CAE5C;AAED,0BAA0B;AAC1B,wBAAgB,SAAS,IAAI,MAAM,CAElC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAWA,OAAO,EAAyB,KAAK,MAAM,EAAE,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,WAAW,cAAc,CAAC,QAAQ,SAAS,OAAO,GAAG,OAAO;IACjE,qDAAqD;IACpD,IAAI,EAAE,MAAM,CAAC;IACd,oCAAoC;IACnC,WAAW,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACxD,UAAU,EAAE,QAAQ,CAAC;IACtB,4CAA4C;IAC3C,UAAU,EAAE,cAAc,CAAC;IAC5B;;;;MAIE;IACD,GAAG,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;CAC9E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAU5E;AAKD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAQtD;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI,CAEnE;AAED,qDAAqD;AACrD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEhE;AAED,4CAA4C;AAC5C,wBAAgB,SAAS,IAAI,cAAc,EAAE,CAE5C;AAED,0BAA0B;AAC1B,wBAAgB,SAAS,IAAI,MAAM,CAElC"}