@whispering233/ai-editor-tools 0.0.29 → 0.0.32

package/dist/registry.js

@@ -1,20 +1,34 @@
-// 工具注册表（S6.3）：统一工具定义结构 + 注册/查询 API
-// 供后续切片扩展：S6.4 分析类 / S6.5 伏笔 / S6.6 提案 / S6.7 执行 + executor 均可
-// registerTool 挂载新工具；S7.4 executor 通过 getTool(name) 按名调度。
+// 工具注册表：统一工具定义结构 + 注册/查询 API + 参数校验入口
+// registerTool 挂载新工具；executor 通过 getTool(name) 按名调度。
 //
-// 定义结构 { name, description, argsSchema, permission, run }：
-// - argsSchema：zod 参数校验（执行前 preflight 校验，批量 tool_call 先全部校验再执行，
-// 「工具执行」）；校验失败即抛错（executor 统一转结构化 tool_result 喂回 LLM）
+// 定义结构 { name, description, parameters, permission, run }：
+// - parameters：TypeBox 参数 schema（运行时即 JSON Schema；执行前 preflight 校验，
+//   批量 tool_call 先全部校验再执行）；校验失败即抛错（executor 统一转结构化 tool_result 喂回 LLM）
 // - permission：TOOL_PERMISSION.AUTO（自动）/ PROPOSAL（提案确认）两级（「工具分级」）
 // - run(ctx, args)：同步执行，返回 JSON 可序列化结果；抛错即失败（不把失败编码进正常 content）
 //
-// 注册语义：重复注册同名工具抛错（防 S6.4-6.7 与查询类撞名；注册表是唯一事实来源）。
+// 注册语义：重复注册同名工具抛错（防后续切片扩展时撞名；注册表是唯一事实来源）。
+import { validateToolArguments } from "@earendil-works/pi-ai";
+/**
+ * 参数校验（执行前 preflight；校验语义与 pi agent 循环一致——pi-ai 的
+ * validateToolArguments：先做原始类型 coerce，再按 schema 检查，失败抛错）。
+ * 校验通过返回（可能被 coerce 的）参数对象。
+ * @throws Error 校验失败（消息含工具名 + 字段路径 + 原始参数）
+ */
+export function validateToolArgs(def, args) {
+    return validateToolArguments({ name: def.name, description: def.description, parameters: def.parameters }, {
+        type: "toolCall",
+        id: `validate_${def.name}`,
+        name: def.name,
+        arguments: (args ?? {}),
+    });
+}
 /** 注册表内部存储（Map 保证按名 O(1) 查询） */
 const registry = new Map();
 /**
  * 注册单个工具：重复注册同名工具抛错——防后续切片扩展时撞名，
  * 保证「注册表 = 工具目录唯一事实来源」。
- * 防呆：name 必须为非空字符串（S6.4-6.7 拼错名不应静默注册新工具）。
+ * 防呆：name 必须为非空字符串（拼错名不应静默注册新工具）。
  */
 export function registerTool(def) {
     if (typeof def.name !== "string" || def.name.trim() === "") {
@@ -34,7 +48,7 @@ export function registerTools(defs) {
 export function getTool(name) {
     return registry.get(name);
 }
-/** 全部已注册工具（按名称排序，稳定输出；供 S7.2 上下文组装注入 LLM 工具列表） */
+/** 全部已注册工具（按名称排序，稳定输出；供上下文组装注入 LLM 工具列表） */
 export function listTools() {
     return [...registry.values()].sort((a, b) => a.name.localeCompare(b.name));
 }

package/dist/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,+DAA+D;AAC/D,0DAA0D;AAC1D,EAAE;AACF,2DAA2D;AAC3D,gEAAgE;AAChE,sDAAsD;AACtD,kEAAkE;AAClE,gEAAgE;AAChE,EAAE;AACF,iDAAiD;AA8BjD,gCAAgC;AAChC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;AAEnD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAmB;IAC9C,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,CAAC,IAAI,cAAc,CAAC,CAAC;IAC9D,CAAC;IACD,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,aAAa,CAAC,IAA+B;IAC3D,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,YAAY,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,0BAA0B;AAC1B,MAAM,UAAU,SAAS;IACvB,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,qDAAqD;AACrD,EAAE;AACF,2DAA2D;AAC3D,oEAAoE;AACpE,uEAAuE;AACvE,kEAAkE;AAClE,gEAAgE;AAChE,EAAE;AACF,0CAA0C;AAE1C,OAAO,EAAE,qBAAqB,EAA6B,MAAM,uBAAuB,CAAC;AA4BzF;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAmB,EAAE,IAAa;IACjE,OAAO,qBAAqB,CAC1B,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,EAC5E;QACE,IAAI,EAAE,UAAU;QAChB,EAAE,EAAE,YAAY,GAAG,CAAC,IAAI,EAAE;QAC1B,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,SAAS,EAAE,CAAC,IAAI,IAAI,EAAE,CAA4B;KACnD,CACF,CAAC;AACJ,CAAC;AAED,gCAAgC;AAChC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;AAEnD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAmB;IAC9C,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,CAAC,IAAI,cAAc,CAAC,CAAC;IAC9D,CAAC;IACD,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,aAAa,CAAC,IAA+B;IAC3D,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,YAAY,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,0BAA0B;AAC1B,MAAM,UAAU,SAAS;IACvB,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC"}

package/dist/schemas/analysis.d.ts

@@ -0,0 +1,51 @@
+import { Type, type Static } from "@earendil-works/pi-ai";
+/** analyze_consistency 入参：entity_id（检查该实体档案内部的矛盾） */
+export declare const analyzeConsistencyArgsSchema: Type.TObject<{
+    entity_id: Type.TString;
+}>;
+export type AnalyzeConsistencyArgs = Static<typeof analyzeConsistencyArgsSchema>;
+/**
+ * detect_conflicts 入参：types 限定参与检测的实体类型（缺省全部）；
+ * relation_filter 限定参与检测的关系类型（缺省用内置对称/互斥/互杀规则集）。
+ */
+export declare const detectConflictsArgsSchema: Type.TObject<{
+    types: Type.TOptional<Type.TArray<Type.TUnsafe<"character" | "setting" | "location" | "hook" | "event" | "timepoint" | "reference">>>;
+    relation_filter: Type.TOptional<Type.TArray<Type.TUnsafe<"belongs_to" | "owns" | "masters" | "ally" | "rival" | "mentor" | "family" | "kills" | "appears_in" | "occurs_at" | "plot_edge" | "plants" | "advances" | "resolves" | "depends_on" | "involves" | "occurs_in">>>;
+}>;
+export type DetectConflictsArgs = Static<typeof detectConflictsArgsSchema>;
+/** trace_plot_paths 入参：from_node_id → to_node_id（大纲节点） */
+export declare const tracePlotPathsArgsSchema: Type.TObject<{
+    from_node_id: Type.TString;
+    to_node_id: Type.TString;
+}>;
+export type TracePlotPathsArgs = Static<typeof tracePlotPathsArgsSchema>;
+/** find_orphan_elements 入参：无参（全项目扫描） */
+export declare const findOrphanElementsArgsSchema: Type.TObject<{}>;
+export type FindOrphanElementsArgs = Static<typeof findOrphanElementsArgsSchema>;
+/** suggest_connections 入参：entity_id（建议潜在关联） */
+export declare const suggestConnectionsArgsSchema: Type.TObject<{
+    entity_id: Type.TString;
+}>;
+export type SuggestConnectionsArgs = Static<typeof suggestConnectionsArgsSchema>;
+/** analyze_hook_health 入参：无参（全项目活跃伏笔健康总览） */
+export declare const analyzeHookHealthArgsSchema: Type.TObject<{}>;
+export type AnalyzeHookHealthArgs = Static<typeof analyzeHookHealthArgsSchema>;
+/** trace_hook_lifecycle 入参：hook_id（埋设/推进/回收节点 + 休眠章数 + 时间线图） */
+export declare const traceHookLifecycleArgsSchema: Type.TObject<{
+    hook_id: Type.TString;
+}>;
+export type TraceHookLifecycleArgs = Static<typeof traceHookLifecycleArgsSchema>;
+/** suggest_hook_payoff 入参：hook_id（基于埋设章节与半衰期推荐理想回收场景） */
+export declare const suggestHookPayoffArgsSchema: Type.TObject<{
+    hook_id: Type.TString;
+}>;
+export type SuggestHookPayoffArgs = Static<typeof suggestHookPayoffArgsSchema>;
+/** find_hook_opportunities 入参：outline_node_id（分析节点叙事特征，建议伏笔类别） */
+export declare const findHookOpportunitiesArgsSchema: Type.TObject<{
+    outline_node_id: Type.TString;
+}>;
+export type FindHookOpportunitiesArgs = Static<typeof findHookOpportunitiesArgsSchema>;
+/** detect_hook_conflicts 入参：无参（依赖循环/依赖废弃/时间悖论检测） */
+export declare const detectHookConflictsArgsSchema: Type.TObject<{}>;
+export type DetectHookConflictsArgs = Static<typeof detectHookConflictsArgsSchema>;
+//# sourceMappingURL=analysis.d.ts.map

package/dist/schemas/analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../src/schemas/analysis.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAM1D,qDAAqD;AACrD,eAAO,MAAM,4BAA4B;;EAKxC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAEjF;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;EAMrC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE3E,0DAA0D;AAC1D,eAAO,MAAM,wBAAwB;;;EAMpC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEzE,wCAAwC;AACxC,eAAO,MAAM,4BAA4B,kBAAmD,CAAC;AAE7F,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAEjF,+CAA+C;AAC/C,eAAO,MAAM,4BAA4B;;EAKxC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAIjF,6CAA6C;AAC7C,eAAO,MAAM,2BAA2B,kBAAmD,CAAC;AAE5F,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAE/E,gEAAgE;AAChE,eAAO,MAAM,4BAA4B;;EAKxC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAEjF,yDAAyD;AACzD,eAAO,MAAM,2BAA2B;;EAKvC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAE/E,kEAAkE;AAClE,eAAO,MAAM,+BAA+B;;EAK3C,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAEvF,oDAAoD;AACpD,eAAO,MAAM,6BAA6B,kBAAmD,CAAC;AAE9F,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,OAAO,6BAA6B,CAAC,CAAC"}

package/dist/schemas/analysis.js

@@ -0,0 +1,46 @@
+// 工具参数 schema：分析域（核心分析 5 + 伏笔分析 5；权限全为 AUTO）
+import { Type } from "@earendil-works/pi-ai";
+import { entityTypeSchema } from "./entity.js";
+import { relationTypeSchema } from "./relation.js";
+// ============ 核心分析（analysis/*，S6.4） ============
+/** analyze_consistency 入参：entity_id（检查该实体档案内部的矛盾） */
+export const analyzeConsistencyArgsSchema = Type.Object({
+    entity_id: Type.String(),
+}, { additionalProperties: false });
+/**
+ * detect_conflicts 入参：types 限定参与检测的实体类型（缺省全部）；
+ * relation_filter 限定参与检测的关系类型（缺省用内置对称/互斥/互杀规则集）。
+ */
+export const detectConflictsArgsSchema = Type.Object({
+    types: Type.Optional(Type.Array(entityTypeSchema)),
+    relation_filter: Type.Optional(Type.Array(relationTypeSchema)),
+}, { additionalProperties: false });
+/** trace_plot_paths 入参：from_node_id → to_node_id（大纲节点） */
+export const tracePlotPathsArgsSchema = Type.Object({
+    from_node_id: Type.String(),
+    to_node_id: Type.String(),
+}, { additionalProperties: false });
+/** find_orphan_elements 入参：无参（全项目扫描） */
+export const findOrphanElementsArgsSchema = Type.Object({}, { additionalProperties: false });
+/** suggest_connections 入参：entity_id（建议潜在关联） */
+export const suggestConnectionsArgsSchema = Type.Object({
+    entity_id: Type.String(),
+}, { additionalProperties: false });
+// ============ 伏笔分析（analysis/hook.ts，S6.5） ============
+/** analyze_hook_health 入参：无参（全项目活跃伏笔健康总览） */
+export const analyzeHookHealthArgsSchema = Type.Object({}, { additionalProperties: false });
+/** trace_hook_lifecycle 入参：hook_id（埋设/推进/回收节点 + 休眠章数 + 时间线图） */
+export const traceHookLifecycleArgsSchema = Type.Object({
+    hook_id: Type.String(),
+}, { additionalProperties: false });
+/** suggest_hook_payoff 入参：hook_id（基于埋设章节与半衰期推荐理想回收场景） */
+export const suggestHookPayoffArgsSchema = Type.Object({
+    hook_id: Type.String(),
+}, { additionalProperties: false });
+/** find_hook_opportunities 入参：outline_node_id（分析节点叙事特征，建议伏笔类别） */
+export const findHookOpportunitiesArgsSchema = Type.Object({
+    outline_node_id: Type.String(),
+}, { additionalProperties: false });
+/** detect_hook_conflicts 入参：无参（依赖循环/依赖废弃/时间悖论检测） */
+export const detectHookConflictsArgsSchema = Type.Object({}, { additionalProperties: false });
+//# sourceMappingURL=analysis.js.map

package/dist/schemas/analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.js","sourceRoot":"","sources":["../../src/schemas/analysis.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAE7C,OAAO,EAAE,IAAI,EAAe,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,kDAAkD;AAElD,qDAAqD;AACrD,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC,MAAM,CACrD;IACE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE;CACzB,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC,MAAM,CAClD;IACE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAClD,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;CAC/D,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF,0DAA0D;AAC1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC,MAAM,CACjD;IACE,YAAY,EAAE,IAAI,CAAC,MAAM,EAAE;IAC3B,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE;CAC1B,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF,wCAAwC;AACxC,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,CAAC;AAI7F,+CAA+C;AAC/C,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC,MAAM,CACrD;IACE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE;CACzB,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF,wDAAwD;AAExD,6CAA6C;AAC7C,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,CAAC;AAI5F,gEAAgE;AAChE,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC,MAAM,CACrD;IACE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;CACvB,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF,yDAAyD;AACzD,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAC,MAAM,CACpD;IACE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;CACvB,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF,kEAAkE;AAClE,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAI,CAAC,MAAM,CACxD;IACE,eAAe,EAAE,IAAI,CAAC,MAAM,EAAE;CAC/B,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF,oDAAoD;AACpD,MAAM,CAAC,MAAM,6BAA6B,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,CAAC"}

package/dist/schemas/delta.d.ts

@@ -0,0 +1,31 @@
+import { Type, type Static } from "@earendil-works/pi-ai";
+/** 变更操作类型（set/update/add/remove） */
+export declare const deltaOpSchema: Type.TUnsafe<"set" | "update" | "add" | "remove">;
+/** 单条属性变更（复用：propose_add_delta 的 changes 项） */
+export declare const deltaChangeSchema: Type.TObject<{
+    field: Type.TString;
+    op: Type.TUnsafe<"set" | "update" | "add" | "remove">;
+    /** 旧值（op=update 时服务端要求必填） */
+    from: Type.TOptional<Type.TUnion<[Type.TString, Type.TNumber, Type.TNull]>>;
+    /** 新值（op=set/update 时服务端要求必填；add/remove 用 value） */
+    to: Type.TOptional<Type.TUnion<[Type.TString, Type.TNumber, Type.TNull]>>;
+    /** 值（op=add/remove 时使用） */
+    value: Type.TOptional<Type.TUnion<[Type.TString, Type.TNumber]>>;
+}>;
+/**
+ * compute_state 入参（与 POST /api/v1/delta/compute 同构，api.ts deltaComputeReqSchema）：
+ * 目标实体到达 at_node_id 时的累积状态（只沿大纲树父链累积已确认 Delta）
+ */
+export declare const computeStateArgsSchema: Type.TObject<{
+    target_type: Type.TString;
+    target_id: Type.TString;
+    at_node_id: Type.TString;
+}>;
+export type ComputeStateArgs = Static<typeof computeStateArgsSchema>;
+/** get_delta_history 入参：target_type + target_id（该实体的全部属性变更记录，按时间/节点排序） */
+export declare const getDeltaHistoryArgsSchema: Type.TObject<{
+    target_type: Type.TString;
+    target_id: Type.TString;
+}>;
+export type GetDeltaHistoryArgs = Static<typeof getDeltaHistoryArgsSchema>;
+//# sourceMappingURL=delta.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delta.d.ts","sourceRoot":"","sources":["../../src/schemas/delta.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAG1D,oCAAoC;AACpC,eAAO,MAAM,aAAa,mDAA0D,CAAC;AAErF,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB;;;IAI1B,6BAA6B;;IAE7B,oDAAoD;;IAEpD,2BAA2B;;EAI9B,CAAC;AAGF;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;EAOlC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAErE,0EAA0E;AAC1E,eAAO,MAAM,yBAAyB;;;EAMrC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/schemas/delta.js

@@ -0,0 +1,35 @@
+// 工具参数 schema：Delta 域（compute_state / get_delta_history + 单条变更共用 schema）
+//
+// deltaChangeSchema 与 shared `types/api.ts` 的 zod `deltaChangeSchema`（REST 入参校验）
+// 同构：字段/可选性/联合类型逐项对齐；此处用 TypeBox 是为工具参数校验与模型 schema 同源。
+// 嵌套对象 `additionalProperties: false` 与旧 zod `toJSONSchema()` 输出一致（模型-facing schema 不变）。
+import { Type } from "@earendil-works/pi-ai";
+import { stringEnum } from "./helpers.js";
+/** 变更操作类型（set/update/add/remove） */
+export const deltaOpSchema = stringEnum(["set", "update", "add", "remove"]);
+/** 单条属性变更（复用：propose_add_delta 的 changes 项） */
+export const deltaChangeSchema = Type.Object({
+    field: Type.String(),
+    op: deltaOpSchema,
+    /** 旧值（op=update 时服务端要求必填） */
+    from: Type.Optional(Type.Union([Type.String(), Type.Number(), Type.Null()])),
+    /** 新值（op=set/update 时服务端要求必填；add/remove 用 value） */
+    to: Type.Optional(Type.Union([Type.String(), Type.Number(), Type.Null()])),
+    /** 值（op=add/remove 时使用） */
+    value: Type.Optional(Type.Union([Type.String(), Type.Number()])),
+}, { additionalProperties: false });
+/**
+ * compute_state 入参（与 POST /api/v1/delta/compute 同构，api.ts deltaComputeReqSchema）：
+ * 目标实体到达 at_node_id 时的累积状态（只沿大纲树父链累积已确认 Delta）
+ */
+export const computeStateArgsSchema = Type.Object({
+    target_type: Type.String(),
+    target_id: Type.String(),
+    at_node_id: Type.String(),
+}, { additionalProperties: false });
+/** get_delta_history 入参：target_type + target_id（该实体的全部属性变更记录，按时间/节点排序） */
+export const getDeltaHistoryArgsSchema = Type.Object({
+    target_type: Type.String(),
+    target_id: Type.String(),
+}, { additionalProperties: false });
+//# sourceMappingURL=delta.js.map

package/dist/schemas/delta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta.js","sourceRoot":"","sources":["../../src/schemas/delta.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,iFAAiF;AACjF,wDAAwD;AACxD,wFAAwF;AAExF,OAAO,EAAE,IAAI,EAAe,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,oCAAoC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAU,CAAC,CAAC;AAErF,+CAA+C;AAC/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAC1C;IACE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE;IACpB,EAAE,EAAE,aAAa;IACjB,6BAA6B;IAC7B,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5E,oDAAoD;IACpD,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1E,2BAA2B;IAC3B,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;CACjE,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAGF;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC,MAAM,CAC/C;IACE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE;IAC1B,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE;IACxB,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE;CAC1B,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC,MAAM,CAClD;IACE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE;IAC1B,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE;CACzB,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC"}

package/dist/schemas/entity.d.ts

@@ -0,0 +1,28 @@
+import { Type, type Static } from "@earendil-works/pi-ai";
+/** 实体类型白名单（跨 schema 复用；非法值在校验期拦下） */
+export declare const entityTypeSchema: Type.TUnsafe<"character" | "setting" | "location" | "hook" | "event" | "timepoint" | "reference">;
+/** get_entity 入参：type + id（id 前缀体系全局唯一，type 用于回显与一致性校验） */
+export declare const getEntityArgsSchema: Type.TObject<{
+    type: Type.TUnsafe<"character" | "setting" | "location" | "hook" | "event" | "timepoint" | "reference">;
+    id: Type.TString;
+}>;
+export type GetEntityArgs = Static<typeof getEntityArgsSchema>;
+/**
+ * search_entities 入参：type + query（name 模糊匹配）+ filters（data 字段过滤）
+ * filters.status：data.status 字符串相等匹配；filters.tags：data.tags 数组须包含全部指定 tags（AND）
+ */
+export declare const searchEntitiesArgsSchema: Type.TObject<{
+    type: Type.TUnsafe<"character" | "setting" | "location" | "hook" | "event" | "timepoint" | "reference">;
+    query: Type.TString;
+    filters: Type.TOptional<Type.TObject<{
+        tags: Type.TOptional<Type.TArray<Type.TString>>;
+        status: Type.TOptional<Type.TString>;
+    }>>;
+}>;
+export type SearchEntitiesArgs = Static<typeof searchEntitiesArgsSchema>;
+/** get_entity_summary 入参：type（指定类型实体的统计数据：总数 + 类型专属分布） */
+export declare const getEntitySummaryArgsSchema: Type.TObject<{
+    type: Type.TUnsafe<"character" | "setting" | "location" | "hook" | "event" | "timepoint" | "reference">;
+}>;
+export type GetEntitySummaryArgs = Static<typeof getEntitySummaryArgsSchema>;
+//# sourceMappingURL=entity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../src/schemas/entity.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAI1D,qCAAqC;AACrC,eAAO,MAAM,gBAAgB,mGAA2B,CAAC;AAEzD,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB;;;EAM/B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;EAepC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEzE,0DAA0D;AAC1D,eAAO,MAAM,0BAA0B;;EAKtC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/schemas/entity.js

@@ -0,0 +1,31 @@
+// 工具参数 schema：实体域（get_entity / search_entities / get_entity_summary）
+// 写法契约见 docs/api/tool-calling.md「工具定义（TypeBox）」：schema 运行时即 JSON Schema，
+// 一份定义同时给模型（tool parameters）、TS（Static<>）、pi 校验（validateToolArguments）。
+// 严格性：顶层对象 `additionalProperties: false` 等价原 zod `.strict()`（拒绝未知字段）。
+import { Type } from "@earendil-works/pi-ai";
+import { ENTITY_TYPES } from "@whispering233/ai-editor-shared";
+import { stringEnum } from "./helpers.js";
+/** 实体类型白名单（跨 schema 复用；非法值在校验期拦下） */
+export const entityTypeSchema = stringEnum(ENTITY_TYPES);
+/** get_entity 入参：type + id（id 前缀体系全局唯一，type 用于回显与一致性校验） */
+export const getEntityArgsSchema = Type.Object({
+    type: entityTypeSchema,
+    id: Type.String(),
+}, { additionalProperties: false });
+/**
+ * search_entities 入参：type + query（name 模糊匹配）+ filters（data 字段过滤）
+ * filters.status：data.status 字符串相等匹配；filters.tags：data.tags 数组须包含全部指定 tags（AND）
+ */
+export const searchEntitiesArgsSchema = Type.Object({
+    type: entityTypeSchema,
+    query: Type.String(),
+    filters: Type.Optional(Type.Object({
+        tags: Type.Optional(Type.Array(Type.String())),
+        status: Type.Optional(Type.String()),
+    }, { additionalProperties: false })),
+}, { additionalProperties: false });
+/** get_entity_summary 入参：type（指定类型实体的统计数据：总数 + 类型专属分布） */
+export const getEntitySummaryArgsSchema = Type.Object({
+    type: entityTypeSchema,
+}, { additionalProperties: false });
+//# sourceMappingURL=entity.js.map

package/dist/schemas/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../src/schemas/entity.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,yEAAyE;AACzE,wEAAwE;AACxE,sEAAsE;AAEtE,OAAO,EAAE,IAAI,EAAe,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,qCAAqC;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;AAEzD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC,MAAM,CAC5C;IACE,IAAI,EAAE,gBAAgB;IACtB,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE;CAClB,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC,MAAM,CACjD;IACE,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,IAAI,CAAC,QAAQ,CACpB,IAAI,CAAC,MAAM,CACT;QACE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9C,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;KACrC,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CACF;CACF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF,0DAA0D;AAC1D,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC,MAAM,CACnD;IACE,IAAI,EAAE,gBAAgB;CACvB,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC"}

package/dist/schemas/helpers.d.ts

@@ -0,0 +1,8 @@
+import { Type } from "@earendil-works/pi-ai";
+/** 字符串枚举：产出 `{"type":"string","enum":[...]}`，并保留字面量联合类型推导 */
+export declare function stringEnum<const T extends readonly string[]>(values: T): Type.TUnsafe<T[number]>;
+/** 自由形态对象（data / patches / metadata）：任意字符串键 + 任意值；可选 `minProperties`（拒绝空对象） */
+export declare function freeFormObject(options?: {
+    minProperties?: number;
+}): Type.TUnsafe<Record<string, unknown>>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/schemas/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/schemas/helpers.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAE7C,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,2BAEtE;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,yCAQtE"}

package/dist/schemas/helpers.js

@@ -0,0 +1,27 @@
+// 工具参数 schema 共用 helper（形状对齐旧 zod `toJSONSchema()` 输出，模型-facing schema 逐字不变）
+//
+// 背景（独立 oracle 比对新旧 JSON Schema 发现的差异）：`Type.Enum(values)` 产出 `{"enum":[...]}`
+// （无 type）、`Type.Record(...)` 产出 `patternProperties`；旧 zod 分别产出
+// `{"type":"string","enum":[...]}` 与 `{"type":"object","additionalProperties":{},"propertyNames":{...}}`。
+// 两者都是合法 JSON Schema，但为降低 OpenAI 兼容端点对少见形态的拒绝风险，这里用 `Type.Unsafe`
+// 产出旧形状（`Enum`/`Record` 不再使用）。
+//
+// 校验语义：`Type.Unsafe` 不带 TypeBox Kind 标记 → pi 的 `validateToolArguments` 走纯 JSON Schema
+// 路径（`coerceWithJsonSchema` + `Compile`），与 registry 的校验入口一致。
+import { Type } from "@earendil-works/pi-ai";
+/** 字符串枚举：产出 `{"type":"string","enum":[...]}`，并保留字面量联合类型推导 */
+export function stringEnum(values) {
+    return Type.Unsafe({ type: "string", enum: [...values] });
+}
+/** 自由形态对象（data / patches / metadata）：任意字符串键 + 任意值；可选 `minProperties`（拒绝空对象） */
+export function freeFormObject(options = {}) {
+    const schema = {
+        type: "object",
+        additionalProperties: {},
+        propertyNames: { type: "string" },
+    };
+    if (options.minProperties !== undefined)
+        schema.minProperties = options.minProperties;
+    return Type.Unsafe(schema);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/schemas/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/schemas/helpers.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,EAAE;AACF,+EAA+E;AAC/E,gEAAgE;AAChE,0GAA0G;AAC1G,kEAAkE;AAClE,+BAA+B;AAC/B,EAAE;AACF,sFAAsF;AACtF,6DAA6D;AAE7D,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAE7C,6DAA6D;AAC7D,MAAM,UAAU,UAAU,CAAoC,MAAS;IACrE,OAAO,IAAI,CAAC,MAAM,CAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAAC,UAAsC,EAAE;IACrE,MAAM,MAAM,GAA4B;QACtC,IAAI,EAAE,QAAQ;QACd,oBAAoB,EAAE,EAAE;QACxB,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAClC,CAAC;IACF,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS;QAAE,MAAM,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IACtF,OAAO,IAAI,CAAC,MAAM,CAA0B,MAAM,CAAC,CAAC;AACtD,CAAC"}

package/dist/schemas/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./entity.js";
+export * from "./relation.js";
+export * from "./outline.js";
+export * from "./delta.js";
+export * from "./reference.js";
+export * from "./analysis.js";
+export * from "./proposal.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAKA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/schemas/index.js

@@ -0,0 +1,12 @@
+// 工具参数 schema 聚合出口（TypeBox）
+//
+// 契约见 docs/api/tool-calling.md「工具定义（TypeBox）」：schema 定义在 tools 包
+// （不放 shared——client 不打包工具 schema），`Type`/`Static` 经 @earendil-works/pi-ai 重导出。
+export * from "./entity.js";
+export * from "./relation.js";
+export * from "./outline.js";
+export * from "./delta.js";
+export * from "./reference.js";
+export * from "./analysis.js";
+export * from "./proposal.js";
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,EAAE;AACF,iEAAiE;AACjE,gFAAgF;AAEhF,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/schemas/outline.d.ts

@@ -0,0 +1,11 @@
+import { Type, type Static } from "@earendil-works/pi-ai";
+/** 大纲节点层级（严格三层：卷 → 章 → 场景） */
+export declare const outlineNodeTypeSchema: Type.TUnsafe<"volume" | "chapter" | "scene">;
+/** get_outline 入参：无参；默认不含 metadata 统计（省 token，需统计走 API with_metadata） */
+export declare const getOutlineArgsSchema: Type.TObject<{}>;
+/** get_outline_path 入参：node_id（根 → 该节点的路径 ID 列表，含 root） */
+export declare const getOutlinePathArgsSchema: Type.TObject<{
+    node_id: Type.TString;
+}>;
+export type GetOutlinePathArgs = Static<typeof getOutlinePathArgsSchema>;
+//# sourceMappingURL=outline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"outline.d.ts","sourceRoot":"","sources":["../../src/schemas/outline.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAG1D,8BAA8B;AAC9B,eAAO,MAAM,qBAAqB,8CAAsD,CAAC;AAEzF,yEAAyE;AACzE,eAAO,MAAM,oBAAoB,kBAAmD,CAAC;AAGrF,2DAA2D;AAC3D,eAAO,MAAM,wBAAwB;;EAKpC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/schemas/outline.js

@@ -0,0 +1,12 @@
+// 工具参数 schema：大纲域（get_outline / get_outline_path）+ 大纲层级共用枚举
+import { Type } from "@earendil-works/pi-ai";
+import { stringEnum } from "./helpers.js";
+/** 大纲节点层级（严格三层：卷 → 章 → 场景） */
+export const outlineNodeTypeSchema = stringEnum(["volume", "chapter", "scene"]);
+/** get_outline 入参：无参；默认不含 metadata 统计（省 token，需统计走 API with_metadata） */
+export const getOutlineArgsSchema = Type.Object({}, { additionalProperties: false });
+/** get_outline_path 入参：node_id（根 → 该节点的路径 ID 列表，含 root） */
+export const getOutlinePathArgsSchema = Type.Object({
+    node_id: Type.String(),
+}, { additionalProperties: false });
+//# sourceMappingURL=outline.js.map

package/dist/schemas/outline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outline.js","sourceRoot":"","sources":["../../src/schemas/outline.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAE5D,OAAO,EAAE,IAAI,EAAe,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,8BAA8B;AAC9B,MAAM,CAAC,MAAM,qBAAqB,GAAG,UAAU,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAU,CAAC,CAAC;AAEzF,yEAAyE;AACzE,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,CAAC;AAGrF,2DAA2D;AAC3D,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC,MAAM,CACjD;IACE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;CACvB,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC"}

package/dist/schemas/proposal.d.ts

@@ -0,0 +1,125 @@
+import { Type, type Static } from "@earendil-works/pi-ai";
+/** propose_create_entity 入参：type + name（必填）+ data（可选自定义字段） */
+export declare const proposeCreateEntityArgsSchema: Type.TObject<{
+    type: Type.TUnsafe<"character" | "setting" | "location" | "hook" | "event" | "timepoint" | "reference">;
+    name: Type.TString;
+    data: Type.TOptional<Type.TUnsafe<Record<string, unknown>>>;
+}>;
+export type ProposeCreateEntityArgs = Static<typeof proposeCreateEntityArgsSchema>;
+/** propose_update_entity 入参：entity_id + patches（data 部分字段，至少一项） */
+export declare const proposeUpdateEntityArgsSchema: Type.TObject<{
+    entity_id: Type.TString;
+    patches: Type.TUnsafe<Record<string, unknown>>;
+}>;
+export type ProposeUpdateEntityArgs = Static<typeof proposeUpdateEntityArgsSchema>;
+/** propose_delete_entity 入参：entity_id（软删 + 级联，可回收站还原） */
+export declare const proposeDeleteEntityArgsSchema: Type.TObject<{
+    entity_id: Type.TString;
+}>;
+export type ProposeDeleteEntityArgs = Static<typeof proposeDeleteEntityArgsSchema>;
+/**
+ * propose_add_relation 入参：source/target 为端点 id（实体 id 或大纲节点 id，类型生成时自动识别）；
+ * type 白名单（16 种，含 plot_edge/plants/advances/resolves）；metadata 可选
+ */
+export declare const proposeAddRelationArgsSchema: Type.TObject<{
+    source: Type.TString;
+    target: Type.TString;
+    type: Type.TUnsafe<"belongs_to" | "owns" | "masters" | "ally" | "rival" | "mentor" | "family" | "kills" | "appears_in" | "occurs_at" | "plot_edge" | "plants" | "advances" | "resolves" | "depends_on" | "involves" | "occurs_in">;
+    metadata: Type.TOptional<Type.TUnsafe<Record<string, unknown>>>;
+}>;
+export type ProposeAddRelationArgs = Static<typeof proposeAddRelationArgsSchema>;
+/** propose_remove_relation 入参：relation_id（手动删关系 = 物理删，不进回收站） */
+export declare const proposeRemoveRelationArgsSchema: Type.TObject<{
+    relation_id: Type.TString;
+}>;
+export type ProposeRemoveRelationArgs = Static<typeof proposeRemoveRelationArgsSchema>;
+/** propose_add_delta 入参：node_id（触发节点）+ target（变更目标）+ changes（至少一项） */
+export declare const proposeAddDeltaArgsSchema: Type.TObject<{
+    node_id: Type.TString;
+    target: Type.TString;
+    changes: Type.TArray<Type.TObject<{
+        field: Type.TString;
+        op: Type.TUnsafe<"set" | "update" | "add" | "remove">;
+        from: Type.TOptional<Type.TUnion<[Type.TString, Type.TNumber, Type.TNull]>>;
+        to: Type.TOptional<Type.TUnion<[Type.TString, Type.TNumber, Type.TNull]>>;
+        value: Type.TOptional<Type.TUnion<[Type.TString, Type.TNumber]>>;
+    }>>;
+}>;
+export type ProposeAddDeltaArgs = Static<typeof proposeAddDeltaArgsSchema>;
+/** propose_outline_node 入参：type（volume|chapter|scene）+ title + parent_id（缺省挂根；scene 必须挂 chapter） */
+export declare const proposeOutlineNodeArgsSchema: Type.TObject<{
+    type: Type.TUnsafe<"volume" | "chapter" | "scene">;
+    title: Type.TString;
+    parent_id: Type.TOptional<Type.TString>;
+}>;
+export type ProposeOutlineNodeArgs = Static<typeof proposeOutlineNodeArgsSchema>;
+/**
+ * propose_move_node 入参：node_id + parent_id（目标父节点，**可为 "root"**）+ order（目标位置，0 起）。
+ * order 无上限：超出目标父 children 长度的行为由执行层定义（提案只承载意图）。
+ */
+export declare const proposeMoveNodeArgsSchema: Type.TObject<{
+    node_id: Type.TString;
+    parent_id: Type.TString;
+    order: Type.TInteger;
+}>;
+export type ProposeMoveNodeArgs = Static<typeof proposeMoveNodeArgsSchema>;
+/** propose_delete_node 入参：node_id（软删 + 递归子树，可回收站还原） */
+export declare const proposeDeleteNodeArgsSchema: Type.TObject<{
+    node_id: Type.TString;
+}>;
+export type ProposeDeleteNodeArgs = Static<typeof proposeDeleteNodeArgsSchema>;
+/** propose_create_hook 入参：name + data（可选伏笔字段）+ plant_at_node_id（可选埋设节点） */
+export declare const proposeCreateHookArgsSchema: Type.TObject<{
+    name: Type.TString;
+    data: Type.TOptional<Type.TUnsafe<Record<string, unknown>>>;
+    plant_at_node_id: Type.TOptional<Type.TString>;
+}>;
+export type ProposeCreateHookArgs = Static<typeof proposeCreateHookArgsSchema>;
+/** propose_update_hook 入参：hook_id + patches（data 部分字段，至少一项） */
+export declare const proposeUpdateHookArgsSchema: Type.TObject<{
+    hook_id: Type.TString;
+    patches: Type.TUnsafe<Record<string, unknown>>;
+}>;
+export type ProposeUpdateHookArgs = Static<typeof proposeUpdateHookArgsSchema>;
+/** propose_advance_hook 入参：hook_id + node_id + description（确认后复合写 delta+relations） */
+export declare const proposeAdvanceHookArgsSchema: Type.TObject<{
+    hook_id: Type.TString;
+    node_id: Type.TString;
+    description: Type.TString;
+}>;
+export type ProposeAdvanceHookArgs = Static<typeof proposeAdvanceHookArgsSchema>;
+/** propose_resolve_hook 入参：hook_id + node_id + description（确认后复合写 delta+relations） */
+export declare const proposeResolveHookArgsSchema: Type.TObject<{
+    hook_id: Type.TString;
+    node_id: Type.TString;
+    description: Type.TString;
+}>;
+export type ProposeResolveHookArgs = Static<typeof proposeResolveHookArgsSchema>;
+/** propose_abandon_hook 入参：hook_id + description（确认后复合写 delta 记 status=abandoned） */
+export declare const proposeAbandonHookArgsSchema: Type.TObject<{
+    hook_id: Type.TString;
+    description: Type.TString;
+}>;
+export type ProposeAbandonHookArgs = Static<typeof proposeAbandonHookArgsSchema>;
+/**
+ * propose_reorder_timepoints 入参：timepoint_ids——LLM 按时间点 name 语义识别先后后产出的
+ * **有序时间点 id 全量序列**（须覆盖当前全部未软删时间点，缺/多/重复由生成时校验拒绝）；
+ * 200 = 时间点量上限，与列表 limit 对齐。
+ */
+export declare const proposeReorderTimepointsArgsSchema: Type.TObject<{
+    timepoint_ids: Type.TArray<Type.TString>;
+}>;
+export type ProposeReorderTimepointsArgs = Static<typeof proposeReorderTimepointsArgsSchema>;
+/**
+ * propose_create_reference 入参：name 标题（必填）+ type 分类（自由文本，缺省 material
+ * 写入侧兜底）+ content 全文长文本 + source 来源（可选）+ tags 标签数组（可选）。
+ */
+export declare const proposeCreateReferenceArgsSchema: Type.TObject<{
+    name: Type.TString;
+    type: Type.TOptional<Type.TString>;
+    content: Type.TOptional<Type.TString>;
+    source: Type.TOptional<Type.TUnion<[Type.TString, Type.TNull]>>;
+    tags: Type.TOptional<Type.TArray<Type.TString>>;
+}>;
+export type ProposeCreateReferenceArgs = Static<typeof proposeCreateReferenceArgsSchema>;
+//# sourceMappingURL=proposal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proposal.d.ts","sourceRoot":"","sources":["../../src/schemas/proposal.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAY1D,8DAA8D;AAC9D,eAAO,MAAM,6BAA6B;;;;EAOzC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEnF,mEAAmE;AACnE,eAAO,MAAM,6BAA6B;;;EAMzC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEnF,yDAAyD;AACzD,eAAO,MAAM,6BAA6B;;EAKzC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAInF;;;GAGG;AACH,eAAO,MAAM,4BAA4B;;;;;EAQxC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAEjF,gEAAgE;AAChE,eAAO,MAAM,+BAA+B;;EAK3C,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAIvF,sEAAsE;AACtE,eAAO,MAAM,yBAAyB;;;;;;;;;;EAOrC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAI3E,oGAAoG;AACpG,eAAO,MAAM,4BAA4B;;;;EAOxC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAEjF;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;EAOrC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE3E,uDAAuD;AACvD,eAAO,MAAM,2BAA2B;;EAKvC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAI/E,2EAA2E;AAC3E,eAAO,MAAM,2BAA2B;;;;EAOvC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAE/E,+DAA+D;AAC/D,eAAO,MAAM,2BAA2B;;;EAMvC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAE/E,sFAAsF;AACtF,eAAO,MAAM,4BAA4B;;;;EAOxC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAEjF,sFAAsF;AACtF,eAAO,MAAM,4BAA4B;;;;EAOxC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAEjF,qFAAqF;AACrF,eAAO,MAAM,4BAA4B;;;EAMxC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAIjF;;;;GAIG;AACH,eAAO,MAAM,kCAAkC;;EAK9C,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,MAAM,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAI7F;;;GAGG;AACH,eAAO,MAAM,gCAAgC;;;;;;EAS5C,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG,MAAM,CAAC,OAAO,gCAAgC,CAAC,CAAC"}