@whispering233/ai-editor-shared 0.0.1

package/dist/types/tool.d.ts

@@ -0,0 +1,304 @@
+import { z } from "zod";
+/** get_entity 入参：type（实体类型）+ id；id 前缀体系全局唯一，type 用于回显与一致性校验 */
+export declare const getEntityArgsSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        character: "character";
+        setting: "setting";
+        location: "location";
+        hook: "hook";
+    }>;
+    id: z.ZodString;
+}, z.core.$strict>;
+export type GetEntityArgs = z.infer<typeof getEntityArgsSchema>;
+/**
+ * search_entities 入参：type + query（name 模糊匹配）+ filters（data 字段过滤）
+ * filters.status：data.status 字符串相等匹配；filters.tags：data.tags 数组须包含全部指定 tags（AND）
+ */
+export declare const searchEntitiesArgsSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        character: "character";
+        setting: "setting";
+        location: "location";
+        hook: "hook";
+    }>;
+    query: z.ZodString;
+    filters: z.ZodOptional<z.ZodObject<{
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        status: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export type SearchEntitiesArgs = z.infer<typeof searchEntitiesArgsSchema>;
+/**
+ * query_relationships 入参：source_type/target_type 为自由字符串（实体类型或 outline_node）；
+ * relation_type 用 z.enum(RELATION_TYPES) **白名单校验**（schema.md 预定义 16 种，
+ * 与 REST relationQuerySchema 的宽松 string 不同——工具参数由 LLM 生成，枚举提前拦非法值）；
+ * depth 1=紧邻 / 2=k跳 / 3=全量（必填，与 API 层一致）
+ */
+export declare const queryRelationshipsArgsSchema: z.ZodObject<{
+    source_type: z.ZodOptional<z.ZodString>;
+    source_id: z.ZodOptional<z.ZodString>;
+    target_type: z.ZodOptional<z.ZodString>;
+    target_id: z.ZodOptional<z.ZodString>;
+    relation_type: z.ZodOptional<z.ZodEnum<{
+        belongs_to: "belongs_to";
+        owns: "owns";
+        masters: "masters";
+        ally: "ally";
+        rival: "rival";
+        mentor: "mentor";
+        family: "family";
+        kills: "kills";
+        appears_in: "appears_in";
+        occurs_at: "occurs_at";
+        plot_edge: "plot_edge";
+        plants: "plants";
+        advances: "advances";
+        resolves: "resolves";
+        depends_on: "depends_on";
+        involves: "involves";
+    }>>;
+    depth: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
+}, z.core.$strict>;
+export type QueryRelationshipsArgs = z.infer<typeof queryRelationshipsArgsSchema>;
+/** get_outline 入参：无参；默认不含 metadata 统计（省 token，需统计走 API with_metadata） */
+export declare const getOutlineArgsSchema: z.ZodObject<{}, z.core.$strict>;
+export type GetOutlineArgs = z.infer<typeof getOutlineArgsSchema>;
+/** get_outline_path 入参：node_id（根 → 该节点的路径 ID 列表，含 root） */
+export declare const getOutlinePathArgsSchema: z.ZodObject<{
+    node_id: z.ZodString;
+}, z.core.$strict>;
+export type GetOutlinePathArgs = z.infer<typeof getOutlinePathArgsSchema>;
+/**
+ * compute_state 入参（与 POST /api/v1/delta/compute 同构，api.ts deltaComputeReqSchema）：
+ * 目标实体到达 at_node_id 时的累积状态（只沿大纲树父链累积已确认 Delta，决策 9）
+ */
+export declare const computeStateArgsSchema: z.ZodObject<{
+    target_type: z.ZodString;
+    target_id: z.ZodString;
+    at_node_id: z.ZodString;
+}, z.core.$strict>;
+export type ComputeStateArgs = z.infer<typeof computeStateArgsSchema>;
+/** get_delta_history 入参：target_type + target_id（该实体的全部属性变更记录，按时间/节点排序） */
+export declare const getDeltaHistoryArgsSchema: z.ZodObject<{
+    target_type: z.ZodString;
+    target_id: z.ZodString;
+}, z.core.$strict>;
+export type GetDeltaHistoryArgs = z.infer<typeof getDeltaHistoryArgsSchema>;
+/** get_entity_summary 入参：type（指定类型实体的统计数据：总数 + 类型专属分布） */
+export declare const getEntitySummaryArgsSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        character: "character";
+        setting: "setting";
+        location: "location";
+        hook: "hook";
+    }>;
+}, z.core.$strict>;
+export type GetEntitySummaryArgs = z.infer<typeof getEntitySummaryArgsSchema>;
+/** analyze_consistency 入参：entity_id（检查该实体档案内部的矛盾，如性格反义词对/状态冲突） */
+export declare const analyzeConsistencyArgsSchema: z.ZodObject<{
+    entity_id: z.ZodString;
+}, z.core.$strict>;
+export type AnalyzeConsistencyArgs = z.infer<typeof analyzeConsistencyArgsSchema>;
+/**
+ * detect_conflicts 入参：types 限定参与检测的实体类型（缺省全部）；
+ * relation_filter 限定参与检测的关系类型（缺省用内置对称/互斥/互杀规则集）。
+ * 检测对象：对称关系单向缺失（ally/family）、互斥关系并存（ally+rival）、互杀（kills×2）。
+ */
+export declare const detectConflictsArgsSchema: z.ZodObject<{
+    types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        character: "character";
+        setting: "setting";
+        location: "location";
+        hook: "hook";
+    }>>>;
+    relation_filter: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        belongs_to: "belongs_to";
+        owns: "owns";
+        masters: "masters";
+        ally: "ally";
+        rival: "rival";
+        mentor: "mentor";
+        family: "family";
+        kills: "kills";
+        appears_in: "appears_in";
+        occurs_at: "occurs_at";
+        plot_edge: "plot_edge";
+        plants: "plants";
+        advances: "advances";
+        resolves: "resolves";
+        depends_on: "depends_on";
+        involves: "involves";
+    }>>>;
+}, z.core.$strict>;
+export type DetectConflictsArgs = z.infer<typeof detectConflictsArgsSchema>;
+/** trace_plot_paths 入参：from_node_id → to_node_id（大纲节点；输出树路径 + plot_edge 连线路径） */
+export declare const tracePlotPathsArgsSchema: z.ZodObject<{
+    from_node_id: z.ZodString;
+    to_node_id: z.ZodString;
+}, z.core.$strict>;
+export type TracePlotPathsArgs = z.infer<typeof tracePlotPathsArgsSchema>;
+/** find_orphan_elements 入参：无参（全项目扫描：闲置角色/未解决变更/悬空关系/跨存储软删不一致） */
+export declare const findOrphanElementsArgsSchema: z.ZodObject<{}, z.core.$strict>;
+export type FindOrphanElementsArgs = z.infer<typeof findOrphanElementsArgsSchema>;
+/** suggest_connections 入参：entity_id（基于共享场景/共同邻居/同分类等信号建议潜在关联） */
+export declare const suggestConnectionsArgsSchema: z.ZodObject<{
+    entity_id: z.ZodString;
+}, z.core.$strict>;
+export type SuggestConnectionsArgs = z.infer<typeof suggestConnectionsArgsSchema>;
+/** analyze_hook_health 入参：无参（全项目活跃伏笔健康总览：stale/overdue/blocked/warnings） */
+export declare const analyzeHookHealthArgsSchema: z.ZodObject<{}, z.core.$strict>;
+export type AnalyzeHookHealthArgs = z.infer<typeof analyzeHookHealthArgsSchema>;
+/** trace_hook_lifecycle 入参：hook_id（埋设/推进/回收节点 + 休眠章数 + 时间线图） */
+export declare const traceHookLifecycleArgsSchema: z.ZodObject<{
+    hook_id: z.ZodString;
+}, z.core.$strict>;
+export type TraceHookLifecycleArgs = z.infer<typeof traceHookLifecycleArgsSchema>;
+/** suggest_hook_payoff 入参：hook_id（基于埋设章节与半衰期推荐理想回收场景，top 3） */
+export declare const suggestHookPayoffArgsSchema: z.ZodObject<{
+    hook_id: z.ZodString;
+}, z.core.$strict>;
+export type SuggestHookPayoffArgs = z.infer<typeof suggestHookPayoffArgsSchema>;
+/** find_hook_opportunities 入参：outline_node_id（分析节点叙事特征，建议适合的伏笔类别） */
+export declare const findHookOpportunitiesArgsSchema: z.ZodObject<{
+    outline_node_id: z.ZodString;
+}, z.core.$strict>;
+export type FindHookOpportunitiesArgs = z.infer<typeof findHookOpportunitiesArgsSchema>;
+/** detect_hook_conflicts 入参：无参（依赖循环/依赖废弃/时间悖论检测） */
+export declare const detectHookConflictsArgsSchema: z.ZodObject<{}, z.core.$strict>;
+export type DetectHookConflictsArgs = z.infer<typeof detectHookConflictsArgsSchema>;
+/** 入参：type（实体类型）+ name（必填）+ data（可选自定义字段） */
+export declare const proposeCreateEntityArgsSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        character: "character";
+        setting: "setting";
+        location: "location";
+        hook: "hook";
+    }>;
+    name: z.ZodString;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export type ProposeCreateEntityArgs = z.infer<typeof proposeCreateEntityArgsSchema>;
+/** 入参：entity_id + patches（data 部分字段，至少一项）；快照校验基于实体自身 updated_at（决策 14） */
+export declare const proposeUpdateEntityArgsSchema: z.ZodObject<{
+    entity_id: z.ZodString;
+    patches: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>;
+export type ProposeUpdateEntityArgs = z.infer<typeof proposeUpdateEntityArgsSchema>;
+/** 入参：entity_id（软删 + 级联，可回收站还原，决策 12） */
+export declare const proposeDeleteEntityArgsSchema: z.ZodObject<{
+    entity_id: z.ZodString;
+}, z.core.$strict>;
+export type ProposeDeleteEntityArgs = z.infer<typeof proposeDeleteEntityArgsSchema>;
+/**
+ * 入参：source/target 为端点 id（实体 id 或大纲节点 id，类型生成时自动识别）；
+ * type 白名单（RELATION_TYPES 16 种，含 plot_edge/plants/advances/resolves）；metadata 可选
+ */
+export declare const proposeAddRelationArgsSchema: z.ZodObject<{
+    source: z.ZodString;
+    target: z.ZodString;
+    type: z.ZodEnum<{
+        belongs_to: "belongs_to";
+        owns: "owns";
+        masters: "masters";
+        ally: "ally";
+        rival: "rival";
+        mentor: "mentor";
+        family: "family";
+        kills: "kills";
+        appears_in: "appears_in";
+        occurs_at: "occurs_at";
+        plot_edge: "plot_edge";
+        plants: "plants";
+        advances: "advances";
+        resolves: "resolves";
+        depends_on: "depends_on";
+        involves: "involves";
+    }>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export type ProposeAddRelationArgs = z.infer<typeof proposeAddRelationArgsSchema>;
+/** 入参：relation_id（手动删关系 = 物理删，不进回收站，决策 12） */
+export declare const proposeRemoveRelationArgsSchema: z.ZodObject<{
+    relation_id: z.ZodString;
+}, z.core.$strict>;
+export type ProposeRemoveRelationArgs = z.infer<typeof proposeRemoveRelationArgsSchema>;
+/** 入参：node_id（触发节点）+ target（变更目标 id，实体或大纲节点）+ changes（至少一项，复用 deltaChangeSchema） */
+export declare const proposeAddDeltaArgsSchema: z.ZodObject<{
+    node_id: z.ZodString;
+    target: z.ZodString;
+    changes: z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        op: z.ZodEnum<{
+            set: "set";
+            update: "update";
+            add: "add";
+            remove: "remove";
+        }>;
+        from: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        to: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export type ProposeAddDeltaArgs = z.infer<typeof proposeAddDeltaArgsSchema>;
+/** 入参：type（volume|chapter|scene）+ title + parent_id（缺省挂根；scene 必须挂 chapter，决策 19） */
+export declare const proposeOutlineNodeArgsSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        volume: "volume";
+        chapter: "chapter";
+        scene: "scene";
+    }>;
+    title: z.ZodString;
+    parent_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ProposeOutlineNodeArgs = z.infer<typeof proposeOutlineNodeArgsSchema>;
+/**
+ * 入参：node_id + parent_id（目标父节点，**可为 "root"**——决策 19 允许 volume/chapter 挂根，
+ * db moveOutlineNode 支持 parentId === "root"）+ order（目标位置，0 起）。
+ * order 无范围上限：超出目标父 children 长度的行为（clamp 或抛错）由 S6.7/db 执行时定义，
+ * 生成时校验不做上限（提案只承载意图，合法性由执行层兜底）。
+ */
+export declare const proposeMoveNodeArgsSchema: z.ZodObject<{
+    node_id: z.ZodString;
+    parent_id: z.ZodString;
+    order: z.ZodNumber;
+}, z.core.$strict>;
+export type ProposeMoveNodeArgs = z.infer<typeof proposeMoveNodeArgsSchema>;
+/** 入参：node_id（软删 + 递归子树，可回收站还原，决策 12） */
+export declare const proposeDeleteNodeArgsSchema: z.ZodObject<{
+    node_id: z.ZodString;
+}, z.core.$strict>;
+export type ProposeDeleteNodeArgs = z.infer<typeof proposeDeleteNodeArgsSchema>;
+/** 入参：name + data（可选伏笔字段，如 payoff_timing/half_life/expected_resolve_node_id）+ plant_at_node_id（可选埋设节点） */
+export declare const proposeCreateHookArgsSchema: z.ZodObject<{
+    name: z.ZodString;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    plant_at_node_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ProposeCreateHookArgs = z.infer<typeof proposeCreateHookArgsSchema>;
+/** 入参：hook_id + patches（data 部分字段，至少一项）；快照校验基于伏笔实体自身 updated_at（决策 14） */
+export declare const proposeUpdateHookArgsSchema: z.ZodObject<{
+    hook_id: z.ZodString;
+    patches: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>;
+export type ProposeUpdateHookArgs = z.infer<typeof proposeUpdateHookArgsSchema>;
+/** 入参：hook_id + node_id（推进发生的节点）+ description（推进内容描述；确认后复合写 delta+relations，tools.md） */
+export declare const proposeAdvanceHookArgsSchema: z.ZodObject<{
+    hook_id: z.ZodString;
+    node_id: z.ZodString;
+    description: z.ZodString;
+}, z.core.$strict>;
+export type ProposeAdvanceHookArgs = z.infer<typeof proposeAdvanceHookArgsSchema>;
+/** 入参：hook_id + node_id（回收节点）+ description（回收内容描述；确认后复合写 delta+relations，tools.md） */
+export declare const proposeResolveHookArgsSchema: z.ZodObject<{
+    hook_id: z.ZodString;
+    node_id: z.ZodString;
+    description: z.ZodString;
+}, z.core.$strict>;
+export type ProposeResolveHookArgs = z.infer<typeof proposeResolveHookArgsSchema>;
+/** 入参：hook_id + description（废弃原因；确认后复合写 delta 记 status=abandoned，tools.md） */
+export declare const proposeAbandonHookArgsSchema: z.ZodObject<{
+    hook_id: z.ZodString;
+    description: z.ZodString;
+}, z.core.$strict>;
+export type ProposeAbandonHookArgs = z.infer<typeof proposeAbandonHookArgsSchema>;
+//# sourceMappingURL=tool.d.ts.map

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

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

package/dist/types/tool.js

@@ -0,0 +1,296 @@
+// AI 工具参数 Zod schema（@whispering233/ai-editor-shared/types/tool.ts，S6.3）
+// 契约来源：doc/api/tools.md「查询类（自动）」——8 个查询工具的入参/返回语义；
+//   字段名沿用 tools.md 的 snake_case 参数约定（工具参数由 LLM 直接生成，snake_case 与
+//   REST 请求体一致）；取值范围引用 constants/entity.ts 既有枚举（EntityType/RelationType），
+//   不另造类型。
+// **导出边界**：运行时 schema 仅经 @whispering233/ai-editor-shared/schemas/tools 子路径导出（供服务端
+//   tools 包/executor 使用）；types/index.ts 的 type-only barrel 只导出推断类型——
+//   client 浏览器包不打包 zod 校验函数（与 types/api.ts 同款约束，见 index.ts 头注释）。
+import { z } from "zod";
+import { ENTITY_TYPES, RELATION_TYPES } from "../constants/entity.js";
+import { deltaChangeSchema } from "./api.js"; // 复用 delta 单条变更 schema（api.ts 已导出）
+// ============ get_entity（实体详情，tools.md「实体查询」） ============
+/** get_entity 入参：type（实体类型）+ id；id 前缀体系全局唯一，type 用于回显与一致性校验 */
+export const getEntityArgsSchema = z
+    .object({
+    type: z.enum(ENTITY_TYPES),
+    id: z.string(),
+})
+    .strict();
+// ============ search_entities（实体搜索，tools.md「实体查询」） ============
+/**
+ * search_entities 入参：type + query（name 模糊匹配）+ filters（data 字段过滤）
+ * filters.status：data.status 字符串相等匹配；filters.tags：data.tags 数组须包含全部指定 tags（AND）
+ */
+export const searchEntitiesArgsSchema = z
+    .object({
+    type: z.enum(ENTITY_TYPES),
+    query: z.string(),
+    filters: z
+        .object({
+        tags: z.array(z.string()).optional(),
+        status: z.string().optional(),
+    })
+        .optional(),
+})
+    .strict();
+// ============ query_relationships（关系图子图，tools.md「关系查询」） ============
+/**
+ * query_relationships 入参：source_type/target_type 为自由字符串（实体类型或 outline_node）；
+ * relation_type 用 z.enum(RELATION_TYPES) **白名单校验**（schema.md 预定义 16 种，
+ * 与 REST relationQuerySchema 的宽松 string 不同——工具参数由 LLM 生成，枚举提前拦非法值）；
+ * depth 1=紧邻 / 2=k跳 / 3=全量（必填，与 API 层一致）
+ */
+export const queryRelationshipsArgsSchema = z
+    .object({
+    source_type: z.string().optional(),
+    source_id: z.string().optional(),
+    target_type: z.string().optional(),
+    target_id: z.string().optional(),
+    relation_type: z.enum(RELATION_TYPES).optional(),
+    depth: z.union([z.literal(1), z.literal(2), z.literal(3)]),
+})
+    .strict();
+// ============ get_outline（完整大纲树，tools.md「大纲查询」） ============
+/** get_outline 入参：无参；默认不含 metadata 统计（省 token，需统计走 API with_metadata） */
+export const getOutlineArgsSchema = z.object({}).strict();
+// ============ get_outline_path（节点路径，tools.md「大纲查询」） ============
+/** get_outline_path 入参：node_id（根 → 该节点的路径 ID 列表，含 root） */
+export const getOutlinePathArgsSchema = z
+    .object({
+    node_id: z.string(),
+})
+    .strict();
+// ============ compute_state（状态计算，tools.md「状态查询」） ============
+/**
+ * compute_state 入参（与 POST /api/v1/delta/compute 同构，api.ts deltaComputeReqSchema）：
+ * 目标实体到达 at_node_id 时的累积状态（只沿大纲树父链累积已确认 Delta，决策 9）
+ */
+export const computeStateArgsSchema = z
+    .object({
+    target_type: z.string(),
+    target_id: z.string(),
+    at_node_id: z.string(),
+})
+    .strict();
+// ============ get_delta_history（Delta 历史，tools.md「状态查询」） ============
+/** get_delta_history 入参：target_type + target_id（该实体的全部属性变更记录，按时间/节点排序） */
+export const getDeltaHistoryArgsSchema = z
+    .object({
+    target_type: z.string(),
+    target_id: z.string(),
+})
+    .strict();
+// ============ get_entity_summary（聚合统计，tools.md「聚合分析」） ============
+/** get_entity_summary 入参：type（指定类型实体的统计数据：总数 + 类型专属分布） */
+export const getEntitySummaryArgsSchema = z
+    .object({
+    type: z.enum(ENTITY_TYPES),
+})
+    .strict();
+// ============ 分析类工具（tools.md「分析类（自动）」，S6.4） ============
+// === analyze_consistency（一致性分析） ===
+/** analyze_consistency 入参：entity_id（检查该实体档案内部的矛盾，如性格反义词对/状态冲突） */
+export const analyzeConsistencyArgsSchema = z
+    .object({
+    entity_id: z.string(),
+})
+    .strict();
+// === detect_conflicts（跨实体矛盾检测） ===
+/**
+ * detect_conflicts 入参：types 限定参与检测的实体类型（缺省全部）；
+ * relation_filter 限定参与检测的关系类型（缺省用内置对称/互斥/互杀规则集）。
+ * 检测对象：对称关系单向缺失（ally/family）、互斥关系并存（ally+rival）、互杀（kills×2）。
+ */
+export const detectConflictsArgsSchema = z
+    .object({
+    types: z.array(z.enum(ENTITY_TYPES)).optional(),
+    relation_filter: z.array(z.enum(RELATION_TYPES)).optional(),
+})
+    .strict();
+// === trace_plot_paths（剧情路径推演） ===
+/** trace_plot_paths 入参：from_node_id → to_node_id（大纲节点；输出树路径 + plot_edge 连线路径） */
+export const tracePlotPathsArgsSchema = z
+    .object({
+    from_node_id: z.string(),
+    to_node_id: z.string(),
+})
+    .strict();
+// === find_orphan_elements（孤立元素诊断） ===
+/** find_orphan_elements 入参：无参（全项目扫描：闲置角色/未解决变更/悬空关系/跨存储软删不一致） */
+export const findOrphanElementsArgsSchema = z.object({}).strict();
+// === suggest_connections（关系发现） ===
+/** suggest_connections 入参：entity_id（基于共享场景/共同邻居/同分类等信号建议潜在关联） */
+export const suggestConnectionsArgsSchema = z
+    .object({
+    entity_id: z.string(),
+})
+    .strict();
+// ============ 伏笔分析工具（hooks.md「工具扩展」+ 决策 21，S6.5） ============
+// === analyze_hook_health（伏笔健康总览） ===
+/** analyze_hook_health 入参：无参（全项目活跃伏笔健康总览：stale/overdue/blocked/warnings） */
+export const analyzeHookHealthArgsSchema = z.object({}).strict();
+// === trace_hook_lifecycle（生命周期追踪） ===
+/** trace_hook_lifecycle 入参：hook_id（埋设/推进/回收节点 + 休眠章数 + 时间线图） */
+export const traceHookLifecycleArgsSchema = z
+    .object({
+    hook_id: z.string(),
+})
+    .strict();
+// === suggest_hook_payoff（回收建议） ===
+/** suggest_hook_payoff 入参：hook_id（基于埋设章节与半衰期推荐理想回收场景，top 3） */
+export const suggestHookPayoffArgsSchema = z
+    .object({
+    hook_id: z.string(),
+})
+    .strict();
+// === find_hook_opportunities（埋设机会发现） ===
+/** find_hook_opportunities 入参：outline_node_id（分析节点叙事特征，建议适合的伏笔类别） */
+export const findHookOpportunitiesArgsSchema = z
+    .object({
+    outline_node_id: z.string(),
+})
+    .strict();
+// === detect_hook_conflicts（伏笔矛盾检测） ===
+/** detect_hook_conflicts 入参：无参（依赖循环/依赖废弃/时间悖论检测） */
+export const detectHookConflictsArgsSchema = z.object({}).strict();
+// ============ 提案类工具（tools.md「提案类（需确认）」+ hooks.md「工具扩展」提案类，S6.6） ============
+//
+// 语义（tools.md「返回语义」2026-08 修订）：AI **不能直接修改数据**——propose_* 仅产出
+// 提案对象（proposal_id + 一句话摘要），tool_result 不含预览细节（避免 LLM 误以为提案已生效
+// 而重复提案）；完整预览只经 SSE proposal 事件推送 GUI（S7 实现）。
+// 参数签名与 tools.md 逐字对齐（propose_add_relation(source, target, type, metadata?) 等）：
+// 端点 id（source/target/plant_at_node_id 等）由服务端在生成时自动识别实体/大纲节点类型
+// 并采集 updated_at 快照（决策 14/19），故入参只需 id 字符串。
+// patches（部分更新字段）拒绝空对象——空补丁提案无意义（生成时校验）。
+// === propose_create_entity（创建实体提案） ===
+/** 入参：type（实体类型）+ name（必填）+ data（可选自定义字段） */
+export const proposeCreateEntityArgsSchema = z
+    .object({
+    type: z.enum(ENTITY_TYPES),
+    name: z.string().min(1),
+    data: z.record(z.string(), z.unknown()).optional(),
+})
+    .strict();
+// === propose_update_entity（更新实体提案） ===
+/** 入参：entity_id + patches（data 部分字段，至少一项）；快照校验基于实体自身 updated_at（决策 14） */
+export const proposeUpdateEntityArgsSchema = z
+    .object({
+    entity_id: z.string(),
+    patches: z.record(z.string(), z.unknown()).refine((p) => Object.keys(p).length > 0, {
+        message: "patches 不能为空（至少一项变更）",
+    }),
+})
+    .strict();
+// === propose_delete_entity（删除实体提案） ===
+/** 入参：entity_id（软删 + 级联，可回收站还原，决策 12） */
+export const proposeDeleteEntityArgsSchema = z
+    .object({
+    entity_id: z.string(),
+})
+    .strict();
+// === propose_add_relation（新增关系提案） ===
+/**
+ * 入参：source/target 为端点 id（实体 id 或大纲节点 id，类型生成时自动识别）；
+ * type 白名单（RELATION_TYPES 16 种，含 plot_edge/plants/advances/resolves）；metadata 可选
+ */
+export const proposeAddRelationArgsSchema = z
+    .object({
+    source: z.string(),
+    target: z.string(),
+    type: z.enum(RELATION_TYPES),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+})
+    .strict();
+// === propose_remove_relation（移除关系提案） ===
+/** 入参：relation_id（手动删关系 = 物理删，不进回收站，决策 12） */
+export const proposeRemoveRelationArgsSchema = z
+    .object({
+    relation_id: z.string(),
+})
+    .strict();
+// === propose_add_delta（追加属性变更提案） ===
+/** 入参：node_id（触发节点）+ target（变更目标 id，实体或大纲节点）+ changes（至少一项，复用 deltaChangeSchema） */
+export const proposeAddDeltaArgsSchema = z
+    .object({
+    node_id: z.string(),
+    target: z.string(),
+    changes: z.array(deltaChangeSchema).min(1),
+})
+    .strict();
+// === propose_outline_node（新增大纲节点提案） ===
+/** 入参：type（volume|chapter|scene）+ title + parent_id（缺省挂根；scene 必须挂 chapter，决策 19） */
+export const proposeOutlineNodeArgsSchema = z
+    .object({
+    type: z.enum(["volume", "chapter", "scene"]),
+    title: z.string().min(1),
+    parent_id: z.string().optional(),
+})
+    .strict();
+// === propose_move_node（移动大纲节点提案） ===
+/**
+ * 入参：node_id + parent_id（目标父节点，**可为 "root"**——决策 19 允许 volume/chapter 挂根，
+ * db moveOutlineNode 支持 parentId === "root"）+ order（目标位置，0 起）。
+ * order 无范围上限：超出目标父 children 长度的行为（clamp 或抛错）由 S6.7/db 执行时定义，
+ * 生成时校验不做上限（提案只承载意图，合法性由执行层兜底）。
+ */
+export const proposeMoveNodeArgsSchema = z
+    .object({
+    node_id: z.string(),
+    parent_id: z.string(),
+    order: z.number().int().min(0),
+})
+    .strict();
+// === propose_delete_node（删除大纲节点提案） ===
+/** 入参：node_id（软删 + 递归子树，可回收站还原，决策 12） */
+export const proposeDeleteNodeArgsSchema = z
+    .object({
+    node_id: z.string(),
+})
+    .strict();
+// === propose_create_hook（创建伏笔提案，hooks.md「工具扩展」提案类） ===
+/** 入参：name + data（可选伏笔字段，如 payoff_timing/half_life/expected_resolve_node_id）+ plant_at_node_id（可选埋设节点） */
+export const proposeCreateHookArgsSchema = z
+    .object({
+    name: z.string().min(1),
+    data: z.record(z.string(), z.unknown()).optional(),
+    plant_at_node_id: z.string().optional(),
+})
+    .strict();
+// === propose_update_hook（更新伏笔提案） ===
+/** 入参：hook_id + patches（data 部分字段，至少一项）；快照校验基于伏笔实体自身 updated_at（决策 14） */
+export const proposeUpdateHookArgsSchema = z
+    .object({
+    hook_id: z.string(),
+    patches: z.record(z.string(), z.unknown()).refine((p) => Object.keys(p).length > 0, {
+        message: "patches 不能为空（至少一项变更）",
+    }),
+})
+    .strict();
+// === propose_advance_hook（推进伏笔提案） ===
+/** 入参：hook_id + node_id（推进发生的节点）+ description（推进内容描述；确认后复合写 delta+relations，tools.md） */
+export const proposeAdvanceHookArgsSchema = z
+    .object({
+    hook_id: z.string(),
+    node_id: z.string(),
+    description: z.string().min(1),
+})
+    .strict();
+// === propose_resolve_hook（回收伏笔提案） ===
+/** 入参：hook_id + node_id（回收节点）+ description（回收内容描述；确认后复合写 delta+relations，tools.md） */
+export const proposeResolveHookArgsSchema = z
+    .object({
+    hook_id: z.string(),
+    node_id: z.string(),
+    description: z.string().min(1),
+})
+    .strict();
+// === propose_abandon_hook（废弃伏笔提案） ===
+/** 入参：hook_id + description（废弃原因；确认后复合写 delta 记 status=abandoned，tools.md） */
+export const proposeAbandonHookArgsSchema = z
+    .object({
+    hook_id: z.string(),
+    description: z.string().min(1),
+})
+    .strict();
+//# sourceMappingURL=tool.js.map

package/dist/types/tool.js.map

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

package/dist/utils/format.d.ts

@@ -0,0 +1,23 @@
+/**
+ * ISO 8601 时间戳 → 本地化 `YYYY-MM-DD HH:mm`（schema.md 时间约定：统一 ISO 8601 字符串）
+ * 非法输入（含空串）原样返回，防御性处理
+ */
+export declare function formatTimestamp(iso: string): string;
+/**
+ * 截断文本：返回总长（含省略号）不超过 maxLen 的字符串；未超长原样返回
+ * 用途：会话列表 lastMessage、长文本展示（endpoints.md）
+ * 边界：maxLen <= 0 返回空串；maxLen = 1 时返回单个省略号
+ */
+export declare function truncate(text: string, maxLen: number): string;
+/**
+ * API key 掩码展示（endpoints.md settings apiKeyMasked 示例 `sk-****1234`：保留前 3 后 4）
+ * 过短 key（<= 7 字符，前后缀重叠）整体掩码为 "****"；空串返回 "****"
+ */
+export declare function maskApiKey(key: string): string;
+/**
+ * 相对时间（会话行/概览最近更新展示）：刚刚 / n 分钟前 / n 小时前 / n 天前；
+ * ≥30 天回退绝对时间（formatTimestamp）；非法输入（含空串）原样返回
+ * 说明：从 client Dashboard/Sidebar 抽离（U4 oracle L1：两处重复实现 → shared 共享可单测）
+ */
+export declare function formatRelativeTime(iso: string): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKnD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAI7D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAWtD"}