@whispering233/ai-editor-tools 0.0.30 → 0.0.33

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"}

package/dist/schemas/proposal.js

@@ -0,0 +1,123 @@
+// 工具参数 schema：提案域（propose_* 16 个）
+//
+// 语义（docs/api/tool-calling.md「提案类（需确认）」）：AI 不能直接修改数据——propose_*
+// 只产出提案对象；参数签名与工具目录逐字对齐（端点 id 的类型识别与 updated_at 快照
+// 由服务端生成时完成，故入参只需 id 字符串）。
+// patches（部分更新字段）以 `minProperties: 1` 表达「拒绝空对象」（等价原 zod `.refine`）。
+import { Type } from "@earendil-works/pi-ai";
+import { entityTypeSchema } from "./entity.js";
+import { relationTypeSchema } from "./relation.js";
+import { outlineNodeTypeSchema } from "./outline.js";
+import { deltaChangeSchema } from "./delta.js";
+import { freeFormObject } from "./helpers.js";
+/** 任意结构化的 data / metadata 载荷（record 形状与旧 zod `toJSONSchema()` 一致） */
+const dataRecordSchema = freeFormObject();
+// ============ 实体（proposal/entity.ts） ============
+/** propose_create_entity 入参：type + name（必填）+ data（可选自定义字段） */
+export const proposeCreateEntityArgsSchema = Type.Object({
+    type: entityTypeSchema,
+    name: Type.String({ minLength: 1 }),
+    data: Type.Optional(dataRecordSchema),
+}, { additionalProperties: false });
+/** propose_update_entity 入参：entity_id + patches（data 部分字段，至少一项） */
+export const proposeUpdateEntityArgsSchema = Type.Object({
+    entity_id: Type.String(),
+    patches: freeFormObject({ minProperties: 1 }),
+}, { additionalProperties: false });
+/** propose_delete_entity 入参：entity_id（软删 + 级联，可回收站还原） */
+export const proposeDeleteEntityArgsSchema = Type.Object({
+    entity_id: Type.String(),
+}, { additionalProperties: false });
+// ============ 关系（proposal/relation.ts） ============
+/**
+ * propose_add_relation 入参：source/target 为端点 id（实体 id 或大纲节点 id，类型生成时自动识别）；
+ * type 白名单（16 种，含 plot_edge/plants/advances/resolves）；metadata 可选
+ */
+export const proposeAddRelationArgsSchema = Type.Object({
+    source: Type.String(),
+    target: Type.String(),
+    type: relationTypeSchema,
+    metadata: Type.Optional(dataRecordSchema),
+}, { additionalProperties: false });
+/** propose_remove_relation 入参：relation_id（手动删关系 = 物理删，不进回收站） */
+export const proposeRemoveRelationArgsSchema = Type.Object({
+    relation_id: Type.String(),
+}, { additionalProperties: false });
+// ============ Delta（proposal/delta.ts） ============
+/** propose_add_delta 入参：node_id（触发节点）+ target（变更目标）+ changes（至少一项） */
+export const proposeAddDeltaArgsSchema = Type.Object({
+    node_id: Type.String(),
+    target: Type.String(),
+    changes: Type.Array(deltaChangeSchema, { minItems: 1 }),
+}, { additionalProperties: false });
+// ============ 大纲（proposal/outline.ts） ============
+/** propose_outline_node 入参：type（volume|chapter|scene）+ title + parent_id（缺省挂根；scene 必须挂 chapter） */
+export const proposeOutlineNodeArgsSchema = Type.Object({
+    type: outlineNodeTypeSchema,
+    title: Type.String({ minLength: 1 }),
+    parent_id: Type.Optional(Type.String()),
+}, { additionalProperties: false });
+/**
+ * propose_move_node 入参：node_id + parent_id（目标父节点，**可为 "root"**）+ order（目标位置，0 起）。
+ * order 无上限：超出目标父 children 长度的行为由执行层定义（提案只承载意图）。
+ */
+export const proposeMoveNodeArgsSchema = Type.Object({
+    node_id: Type.String(),
+    parent_id: Type.String(),
+    order: Type.Integer({ minimum: 0 }),
+}, { additionalProperties: false });
+/** propose_delete_node 入参：node_id（软删 + 递归子树，可回收站还原） */
+export const proposeDeleteNodeArgsSchema = Type.Object({
+    node_id: Type.String(),
+}, { additionalProperties: false });
+// ============ 伏笔（proposal/hook.ts） ============
+/** propose_create_hook 入参：name + data（可选伏笔字段）+ plant_at_node_id（可选埋设节点） */
+export const proposeCreateHookArgsSchema = Type.Object({
+    name: Type.String({ minLength: 1 }),
+    data: Type.Optional(dataRecordSchema),
+    plant_at_node_id: Type.Optional(Type.String()),
+}, { additionalProperties: false });
+/** propose_update_hook 入参：hook_id + patches（data 部分字段，至少一项） */
+export const proposeUpdateHookArgsSchema = Type.Object({
+    hook_id: Type.String(),
+    patches: freeFormObject({ minProperties: 1 }),
+}, { additionalProperties: false });
+/** propose_advance_hook 入参：hook_id + node_id + description（确认后复合写 delta+relations） */
+export const proposeAdvanceHookArgsSchema = Type.Object({
+    hook_id: Type.String(),
+    node_id: Type.String(),
+    description: Type.String({ minLength: 1 }),
+}, { additionalProperties: false });
+/** propose_resolve_hook 入参：hook_id + node_id + description（确认后复合写 delta+relations） */
+export const proposeResolveHookArgsSchema = Type.Object({
+    hook_id: Type.String(),
+    node_id: Type.String(),
+    description: Type.String({ minLength: 1 }),
+}, { additionalProperties: false });
+/** propose_abandon_hook 入参：hook_id + description（确认后复合写 delta 记 status=abandoned） */
+export const proposeAbandonHookArgsSchema = Type.Object({
+    hook_id: Type.String(),
+    description: Type.String({ minLength: 1 }),
+}, { additionalProperties: false });
+// ============ 时间轴（proposal/reorder-timepoints.ts，G2） ============
+/**
+ * propose_reorder_timepoints 入参：timepoint_ids——LLM 按时间点 name 语义识别先后后产出的
+ * **有序时间点 id 全量序列**（须覆盖当前全部未软删时间点，缺/多/重复由生成时校验拒绝）；
+ * 200 = 时间点量上限，与列表 limit 对齐。
+ */
+export const proposeReorderTimepointsArgsSchema = Type.Object({
+    timepoint_ids: Type.Array(Type.String(), { minItems: 1, maxItems: 200 }),
+}, { additionalProperties: false });
+// ============ 参考资料（proposal/reference.ts） ============
+/**
+ * propose_create_reference 入参：name 标题（必填）+ type 分类（自由文本，缺省 material
+ * 写入侧兜底）+ content 全文长文本 + source 来源（可选）+ tags 标签数组（可选）。
+ */
+export const proposeCreateReferenceArgsSchema = Type.Object({
+    name: Type.String({ minLength: 1 }),
+    type: Type.Optional(Type.String()),
+    content: Type.Optional(Type.String()),
+    source: Type.Optional(Type.Union([Type.String(), Type.Null()])),
+    tags: Type.Optional(Type.Array(Type.String())),
+}, { additionalProperties: false });
+//# sourceMappingURL=proposal.js.map

package/dist/schemas/proposal.js.map

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

package/dist/schemas/reference.d.ts

@@ -0,0 +1,13 @@
+import { Type, type Static } from "@earendil-works/pi-ai";
+/**
+ * search_references 入参：query 关键词（标题+tags 命中）+ 可选 type 分类过滤（自由文本，
+ * 原预置枚举已取消，建议沿用项目内已有分类）+ 可选 tags 过滤。
+ * 返回摘要列表（content 截断 120 字）。
+ */
+export declare const searchReferencesArgsSchema: Type.TObject<{
+    query: Type.TString;
+    type: Type.TOptional<Type.TString>;
+    tags: Type.TOptional<Type.TArray<Type.TString>>;
+}>;
+export type SearchReferencesArgs = Static<typeof searchReferencesArgsSchema>;
+//# sourceMappingURL=reference.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../src/schemas/reference.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;;;;EAOtC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/schemas/reference.js

@@ -0,0 +1,13 @@
+// 工具参数 schema：参考资料域（search_references）
+import { Type } from "@earendil-works/pi-ai";
+/**
+ * search_references 入参：query 关键词（标题+tags 命中）+ 可选 type 分类过滤（自由文本，
+ * 原预置枚举已取消，建议沿用项目内已有分类）+ 可选 tags 过滤。
+ * 返回摘要列表（content 截断 120 字）。
+ */
+export const searchReferencesArgsSchema = Type.Object({
+    query: Type.String(),
+    type: Type.Optional(Type.String()),
+    tags: Type.Optional(Type.Array(Type.String())),
+}, { additionalProperties: false });
+//# sourceMappingURL=reference.js.map

package/dist/schemas/reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.js","sourceRoot":"","sources":["../../src/schemas/reference.ts"],"names":[],"mappings":"AAAA,uCAAuC;AAEvC,OAAO,EAAE,IAAI,EAAe,MAAM,uBAAuB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC,MAAM,CACnD;IACE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE;IACpB,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IAClC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;CAC/C,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC"}

package/dist/schemas/relation.d.ts

@@ -0,0 +1,17 @@
+import { Type, type Static } from "@earendil-works/pi-ai";
+/** 关系类型白名单（预定义 16 种；工具参数由 LLM 生成，枚举提前拦非法值——与 REST 层的宽松 string 不同） */
+export declare const relationTypeSchema: 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">;
+/**
+ * query_relationships 入参：source_type/target_type 为自由字符串（实体类型或 outline_node）；
+ * relation_type 白名单；depth 1=紧邻 / 2=k跳 / 3=全量（必填，与 API 层一致）
+ */
+export declare const queryRelationshipsArgsSchema: Type.TObject<{
+    source_type: Type.TOptional<Type.TString>;
+    source_id: Type.TOptional<Type.TString>;
+    target_type: Type.TOptional<Type.TString>;
+    target_id: Type.TOptional<Type.TString>;
+    relation_type: Type.TOptional<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">>;
+    depth: Type.TUnion<[Type.TLiteral<1>, Type.TLiteral<2>, Type.TLiteral<3>]>;
+}>;
+export type QueryRelationshipsArgs = Static<typeof queryRelationshipsArgsSchema>;
+//# sourceMappingURL=relation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relation.d.ts","sourceRoot":"","sources":["../../src/schemas/relation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAI1D,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,8NAA6B,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,4BAA4B;;;;;;;EAUxC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/schemas/relation.js

@@ -0,0 +1,19 @@
+// 工具参数 schema：关系域（query_relationships）
+import { Type } from "@earendil-works/pi-ai";
+import { RELATION_TYPES } from "@whispering233/ai-editor-shared";
+import { stringEnum } from "./helpers.js";
+/** 关系类型白名单（预定义 16 种；工具参数由 LLM 生成，枚举提前拦非法值——与 REST 层的宽松 string 不同） */
+export const relationTypeSchema = stringEnum(RELATION_TYPES);
+/**
+ * query_relationships 入参：source_type/target_type 为自由字符串（实体类型或 outline_node）；
+ * relation_type 白名单；depth 1=紧邻 / 2=k跳 / 3=全量（必填，与 API 层一致）
+ */
+export const queryRelationshipsArgsSchema = Type.Object({
+    source_type: Type.Optional(Type.String()),
+    source_id: Type.Optional(Type.String()),
+    target_type: Type.Optional(Type.String()),
+    target_id: Type.Optional(Type.String()),
+    relation_type: Type.Optional(relationTypeSchema),
+    depth: Type.Union([Type.Literal(1), Type.Literal(2), Type.Literal(3)]),
+}, { additionalProperties: false });
+//# sourceMappingURL=relation.js.map

package/dist/schemas/relation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation.js","sourceRoot":"","sources":["../../src/schemas/relation.ts"],"names":[],"mappings":"AAAA,uCAAuC;AAEvC,OAAO,EAAE,IAAI,EAAe,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,qEAAqE;AACrE,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;AAE7D;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC,MAAM,CACrD;IACE,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IACzC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IACvC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IACzC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IACvC,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAChD,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;CACvE,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whispering233/ai-editor-tools",
-  "version": "0.0.30",
+  "version": "0.0.33",
   "license": "MIT",
   "description": "AI 工具目录：工具定义 + 执行器",
   "type": "module",
@@ -26,12 +26,12 @@
     "postpack": "node ../../scripts/restore-package-json.mjs"
   },
   "dependencies": {
-    "@whispering233/ai-editor-db": "0.0.30",
-    "@whispering233/ai-editor-shared": "0.0.30"
+    "@earendil-works/pi-ai": "0.85.1",
+    "@whispering233/ai-editor-db": "0.0.33",
+    "@whispering233/ai-editor-shared": "0.0.33"
   },
   "devDependencies": {
-    "typescript": "^5.8.0",
-    "zod": "^4.0.0"
+    "typescript": "^5.8.0"
   },
   "repository": {
     "type": "git",