@whispering233/ai-editor-shared 0.0.1

package/dist/types/api.d.ts

@@ -0,0 +1,728 @@
+import { z } from "zod";
+import type { ComputeStateResult, DeltaRecord, EntitySummary, ProjectConfig, RelationRecord } from "./index.js";
+/** 实体类型（schema.md entities 表 CHECK 约束；与 ENTITY_TYPES 常量对齐） */
+export declare const entityTypeSchema: z.ZodEnum<{
+    character: "character";
+    setting: "setting";
+    location: "location";
+    hook: "hook";
+}>;
+/** 项目语言（schema.md project.json 契约） */
+export declare const projectLanguageSchema: z.ZodEnum<{
+    zh: "zh";
+    en: "en";
+}>;
+/**
+ * 错误码全量枚举
+ * 文档出处：endpoints.md 各端点错误响应；DELTA_CONFLICT 为 2026-08 修订废弃码
+ * （computeState 改为 skipped/conflicts 字段呈现，不再返回 409——保留枚举兼容历史引用）；
+ * 末尾四个为 tools.md 决策 15/16 补充命名（文档未给具体码名，按语义命名，供 SSE error 事件使用）
+ */
+export declare const ERROR_CODES: readonly ["VALIDATION_ERROR", "ENTITY_NOT_FOUND", "RELATION_EXISTS", "RELATION_NOT_FOUND", "OUTLINE_NODE_NOT_FOUND", "OUTLINE_ANCESTOR_DELETED", "INVALID_PROJECT_PATH", "PROPOSAL_STALE", "PROPOSAL_NOT_FOUND", "PROPOSAL_PROJECT_MISMATCH", "SCHEMA_VERSION_MISMATCH", "PROJECT_VERSION_NEWER", "DELTA_CONFLICT", "TOOL_RESULT_TOO_LARGE", "AGENT_DISPATCH_ERROR", "AGENT_INTERNAL_ERROR", "AGENT_MAX_ITERATIONS", "AGENT_TIMEOUT", "AGENT_TOKEN_BUDGET"];
+/** ErrorCode 枚举 schema */
+export declare const errorCodeSchema: z.ZodEnum<{
+    VALIDATION_ERROR: "VALIDATION_ERROR";
+    ENTITY_NOT_FOUND: "ENTITY_NOT_FOUND";
+    RELATION_EXISTS: "RELATION_EXISTS";
+    RELATION_NOT_FOUND: "RELATION_NOT_FOUND";
+    OUTLINE_NODE_NOT_FOUND: "OUTLINE_NODE_NOT_FOUND";
+    OUTLINE_ANCESTOR_DELETED: "OUTLINE_ANCESTOR_DELETED";
+    INVALID_PROJECT_PATH: "INVALID_PROJECT_PATH";
+    PROPOSAL_STALE: "PROPOSAL_STALE";
+    PROPOSAL_NOT_FOUND: "PROPOSAL_NOT_FOUND";
+    PROPOSAL_PROJECT_MISMATCH: "PROPOSAL_PROJECT_MISMATCH";
+    SCHEMA_VERSION_MISMATCH: "SCHEMA_VERSION_MISMATCH";
+    PROJECT_VERSION_NEWER: "PROJECT_VERSION_NEWER";
+    DELTA_CONFLICT: "DELTA_CONFLICT";
+    TOOL_RESULT_TOO_LARGE: "TOOL_RESULT_TOO_LARGE";
+    AGENT_DISPATCH_ERROR: "AGENT_DISPATCH_ERROR";
+    AGENT_INTERNAL_ERROR: "AGENT_INTERNAL_ERROR";
+    AGENT_MAX_ITERATIONS: "AGENT_MAX_ITERATIONS";
+    AGENT_TIMEOUT: "AGENT_TIMEOUT";
+    AGENT_TOKEN_BUDGET: "AGENT_TOKEN_BUDGET";
+}>;
+/** 错误码类型（REST 响应 / SSE error 事件 / 工具结果共用） */
+export type ErrorCode = z.infer<typeof errorCodeSchema>;
+/** 成功响应包裹：{ success: true, data: T } */
+export declare function apiSuccessSchema<T extends z.ZodType>(dataSchema: T): z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: T;
+}, z.core.$strip>;
+/** 错误响应包裹：{ success: false, error: { code, message, fields? } } */
+export declare const apiErrorSchema: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<{
+            VALIDATION_ERROR: "VALIDATION_ERROR";
+            ENTITY_NOT_FOUND: "ENTITY_NOT_FOUND";
+            RELATION_EXISTS: "RELATION_EXISTS";
+            RELATION_NOT_FOUND: "RELATION_NOT_FOUND";
+            OUTLINE_NODE_NOT_FOUND: "OUTLINE_NODE_NOT_FOUND";
+            OUTLINE_ANCESTOR_DELETED: "OUTLINE_ANCESTOR_DELETED";
+            INVALID_PROJECT_PATH: "INVALID_PROJECT_PATH";
+            PROPOSAL_STALE: "PROPOSAL_STALE";
+            PROPOSAL_NOT_FOUND: "PROPOSAL_NOT_FOUND";
+            PROPOSAL_PROJECT_MISMATCH: "PROPOSAL_PROJECT_MISMATCH";
+            SCHEMA_VERSION_MISMATCH: "SCHEMA_VERSION_MISMATCH";
+            PROJECT_VERSION_NEWER: "PROJECT_VERSION_NEWER";
+            DELTA_CONFLICT: "DELTA_CONFLICT";
+            TOOL_RESULT_TOO_LARGE: "TOOL_RESULT_TOO_LARGE";
+            AGENT_DISPATCH_ERROR: "AGENT_DISPATCH_ERROR";
+            AGENT_INTERNAL_ERROR: "AGENT_INTERNAL_ERROR";
+            AGENT_MAX_ITERATIONS: "AGENT_MAX_ITERATIONS";
+            AGENT_TIMEOUT: "AGENT_TIMEOUT";
+            AGENT_TOKEN_BUDGET: "AGENT_TOKEN_BUDGET";
+        }>;
+        message: z.ZodString;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** 错误响应类型 */
+export type ApiError = z.infer<typeof apiErrorSchema>;
+/**
+ * character 专属字段（schema.md：role/gender/age/personality[]/motivation/abilities[]/status/custom_fields）
+ * 注意：data 嵌套对象内部字段原样透传（snake_case，如 custom_fields），顶层契约字段才是 camelCase
+ */
+export declare const characterDataSchema: z.ZodObject<{
+    role: z.ZodOptional<z.ZodString>;
+    gender: z.ZodOptional<z.ZodString>;
+    age: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    personality: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    motivation: z.ZodOptional<z.ZodString>;
+    abilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    status: z.ZodOptional<z.ZodString>;
+    custom_fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+/** setting 专属字段（schema.md：category/parent_id/description/rules[]/custom_fields） */
+export declare const settingDataSchema: z.ZodObject<{
+    category: z.ZodOptional<z.ZodString>;
+    parent_id: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    rules: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    custom_fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+/** location 专属字段（schema.md：type/parent_id/description/custom_fields） */
+export declare const locationDataSchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodString>;
+    parent_id: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    custom_fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+/** hook 专属字段（hooks.md 第 30-56 行：status/category/expected_payoff/payoff_timing/half_life/is_core/notes/expected_resolve_node_id） */
+export declare const hookDataSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodEnum<{
+        planted: "planted";
+        progressing: "progressing";
+        resolved: "resolved";
+        abandoned: "abandoned";
+    }>>;
+    category: z.ZodOptional<z.ZodString>;
+    expected_payoff: z.ZodOptional<z.ZodString>;
+    payoff_timing: z.ZodOptional<z.ZodEnum<{
+        immediate: "immediate";
+        near_term: "near_term";
+        mid_arc: "mid_arc";
+        slow_burn: "slow_burn";
+        endgame: "endgame";
+    }>>;
+    half_life: z.ZodOptional<z.ZodNumber>;
+    is_core: z.ZodOptional<z.ZodBoolean>;
+    notes: z.ZodOptional<z.ZodString>;
+    expected_resolve_node_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$loose>;
+/**
+ * 各类型 data schema 注册表（服务端按实体 type 选用精确 schema 校验）
+ * 创建/更新请求中的 data 本体使用宽松 record（entityCreateReqSchema），
+ * 精确校验在服务端 route 层按 type 调用对应 schema
+ */
+export declare const ENTITY_DATA_SCHEMAS: {
+    readonly character: z.ZodObject<{
+        role: z.ZodOptional<z.ZodString>;
+        gender: z.ZodOptional<z.ZodString>;
+        age: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        personality: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        motivation: z.ZodOptional<z.ZodString>;
+        abilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        status: z.ZodOptional<z.ZodString>;
+        custom_fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>;
+    readonly setting: z.ZodObject<{
+        category: z.ZodOptional<z.ZodString>;
+        parent_id: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        rules: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        custom_fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>;
+    readonly location: z.ZodObject<{
+        type: z.ZodOptional<z.ZodString>;
+        parent_id: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        custom_fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>;
+    readonly hook: z.ZodObject<{
+        status: z.ZodOptional<z.ZodEnum<{
+            planted: "planted";
+            progressing: "progressing";
+            resolved: "resolved";
+            abandoned: "abandoned";
+        }>>;
+        category: z.ZodOptional<z.ZodString>;
+        expected_payoff: z.ZodOptional<z.ZodString>;
+        payoff_timing: z.ZodOptional<z.ZodEnum<{
+            immediate: "immediate";
+            near_term: "near_term";
+            mid_arc: "mid_arc";
+            slow_burn: "slow_burn";
+            endgame: "endgame";
+        }>>;
+        half_life: z.ZodOptional<z.ZodNumber>;
+        is_core: z.ZodOptional<z.ZodBoolean>;
+        notes: z.ZodOptional<z.ZodString>;
+        expected_resolve_node_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$loose>;
+};
+/** ProjectConfig 响应（GET /api/v1/project/config；与 types/project.ts 的 ProjectConfig 对齐） */
+export declare const projectConfigSchema: z.ZodType<ProjectConfig>;
+export declare const projectCreateReqSchema: z.ZodObject<{
+    path: z.ZodString;
+    config: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        language: z.ZodOptional<z.ZodEnum<{
+            zh: "zh";
+            en: "en";
+        }>>;
+        prompt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export declare const projectCreateResSchema: z.ZodObject<{
+    id: z.ZodString;
+    path: z.ZodString;
+    created: z.ZodLiteral<true>;
+}, z.core.$strip>;
+export declare const projectOpenReqSchema: z.ZodObject<{
+    path: z.ZodString;
+}, z.core.$strict>;
+export declare const projectOpenResSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    language: z.ZodEnum<{
+        zh: "zh";
+        en: "en";
+    }>;
+    config: z.ZodType<ProjectConfig, unknown, z.core.$ZodTypeInternals<ProjectConfig, unknown>>;
+}, z.core.$strip>;
+export declare const projectCloseResSchema: z.ZodObject<{
+    saved: z.ZodLiteral<true>;
+}, z.core.$strip>;
+export declare const projectListResSchema: z.ZodObject<{
+    rootPath: z.ZodString;
+    books: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        path: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ProjectListBook = z.infer<typeof projectListResSchema>["books"][number];
+export declare const projectConfigResSchema: z.ZodType<ProjectConfig, unknown, z.core.$ZodTypeInternals<ProjectConfig, unknown>>;
+export declare const projectConfigUpdateReqSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    language: z.ZodOptional<z.ZodEnum<{
+        zh: "zh";
+        en: "en";
+    }>>;
+    prompt: z.ZodOptional<z.ZodString>;
+    current_position: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export declare const projectConfigUpdateResSchema: z.ZodObject<{
+    updated: z.ZodLiteral<true>;
+}, z.core.$strip>;
+/**
+ * 导出 zip 内固定三文件名（E1：GET /api/v1/project/export 的 zip 条目名与数据文件
+ * 原名一致——import 侧按此固定名校验，缺失即坏包）
+ */
+export declare const PROJECT_EXPORT_FILE_NAMES: readonly ["project.json", "outline.json", "data.db"];
+/**
+ * GET /api/v1/project/export（E1 实现，E2 依赖）：
+ * - **响应为二进制 zip（application/zip），非 JSON 包裹**——endpoints.md「成功响应
+ *   {success,data}」通用约定的显式例外；Content-Disposition: attachment;
+ *   filename*=UTF-8''<书名>.zip（RFC 5987）
+ * - zip 内三文件：project.json + outline.json + data.db（导出前 wal_checkpoint(TRUNCATE)
+ *   保证 data.db 主文件完整快照；决策 17 key 存用户级配置，天然不入包）
+ * - 错误：无当前项目 → 409 NO_PROJECT_OPEN（服务端补充码，与 /config 一致）；
+ *   三文件缺失任一 → 500 INTERNAL_ERROR（打开的项目三文件必然齐全，缺失即损坏）
+ * - 二进制响应不走 Zod parse——契约以本注释 + PROJECT_EXPORT_FILE_NAMES 常量表达
+ */
+export declare const projectImportResSchema: z.ZodObject<{
+    imported: z.ZodLiteral<true>;
+    id: z.ZodString;
+    path: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strip>;
+/**
+ * 关系（GET /api/v1/relation depth=1 项；与 types/entity.ts RelationRecord 对齐）
+ * 定义于此处供 entity 详情响应（relations: RelationSummary[]，形状同 RelationRecord，
+ * endpoints.md L187 未单独列字段）与 relation 查询共用，避免同结构两处定义漂移
+ */
+export declare const relationRecordSchema: z.ZodType<RelationRecord>;
+/** EntitySummary（GET /api/v1/entity/:type 列表项；与 types/entity.ts 对齐） */
+export declare const entitySummarySchema: z.ZodType<EntitySummary>;
+export declare const entityListQuerySchema: z.ZodObject<{
+    q: z.ZodOptional<z.ZodString>;
+    offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        name: "name";
+        created_at: "created_at";
+        updated_at: "updated_at";
+    }>>;
+    order: z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+}, z.core.$strip>;
+export declare const entityListResSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodType<EntitySummary, unknown, z.core.$ZodTypeInternals<EntitySummary, unknown>>>;
+    total: z.ZodNumber;
+    offset: z.ZodNumber;
+    limit: z.ZodNumber;
+}, z.core.$strip>;
+export declare const entityDetailResSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<{
+        character: "character";
+        setting: "setting";
+        location: "location";
+        hook: "hook";
+    }>;
+    name: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    relations: z.ZodArray<z.ZodType<RelationRecord, unknown, z.core.$ZodTypeInternals<RelationRecord, unknown>>>;
+    deltaCount: z.ZodNumber;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const entityCreateReqSchema: z.ZodObject<{
+    name: z.ZodString;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export declare const entityCreateResSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<{
+        character: "character";
+        setting: "setting";
+        location: "location";
+        hook: "hook";
+    }>;
+    name: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export declare const entityUpdateReqSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export declare const entityUpdateResSchema: z.ZodObject<{
+    id: z.ZodString;
+    updated: z.ZodLiteral<true>;
+}, z.core.$strip>;
+export declare const entityDeleteResSchema: z.ZodObject<{
+    deleted: z.ZodLiteral<true>;
+    cascaded: z.ZodObject<{
+        relations: z.ZodNumber;
+        deltas: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** 路径结构（depth>=2，endpoints.md） */
+export declare const relationPathSchema: z.ZodObject<{
+    nodes: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    edges: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        relationType: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const relationQuerySchema: 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.ZodString>;
+    depth: z.ZodCoercedNumber<unknown>;
+}, z.core.$strip>;
+export declare const relationQueryResSchema: z.ZodObject<{
+    relations: z.ZodArray<z.ZodType<RelationRecord, unknown, z.core.$ZodTypeInternals<RelationRecord, unknown>>>;
+    paths: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        nodes: z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+        edges: z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+            relationType: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const relationCreateReqSchema: z.ZodObject<{
+    source_type: z.ZodString;
+    source_id: z.ZodString;
+    target_type: z.ZodString;
+    target_id: z.ZodString;
+    relation_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 declare const relationCreateResSchema: z.ZodObject<{
+    id: z.ZodString;
+    relation: z.ZodObject<{
+        sourceType: z.ZodString;
+        sourceId: z.ZodString;
+        targetType: z.ZodString;
+        targetId: z.ZodString;
+        relationType: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const relationDeleteResSchema: z.ZodObject<{
+    deleted: z.ZodLiteral<true>;
+}, z.core.$strip>;
+/** 变更操作类型（2026-08 修订语义：set/update/add/remove，见 endpoints.md） */
+export declare const deltaOpSchema: z.ZodEnum<{
+    set: "set";
+    update: "update";
+    add: "add";
+    remove: "remove";
+}>;
+/** 单条属性变更 */
+export declare const deltaChangeSchema: 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>;
+/** DeltaRecord（响应；与 types/entity.ts 对齐） */
+export declare const deltaRecordSchema: z.ZodType<DeltaRecord>;
+export declare const deltaCreateReqSchema: z.ZodObject<{
+    node_id: z.ZodString;
+    target_type: z.ZodString;
+    target_id: 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>>;
+    description: z.ZodString;
+}, z.core.$strict>;
+export declare const deltaCreateResSchema: z.ZodObject<{
+    id: z.ZodString;
+    applied: z.ZodType<DeltaRecord, unknown, z.core.$ZodTypeInternals<DeltaRecord, unknown>>;
+}, z.core.$strip>;
+export declare const deltaByNodeResSchema: z.ZodObject<{
+    nodeId: z.ZodString;
+    deltas: z.ZodArray<z.ZodType<DeltaRecord, unknown, z.core.$ZodTypeInternals<DeltaRecord, unknown>>>;
+}, z.core.$strip>;
+export declare const deltaComputeReqSchema: z.ZodObject<{
+    target_type: z.ZodString;
+    target_id: z.ZodString;
+    at_node_id: z.ZodString;
+}, z.core.$strict>;
+export declare const deltaComputeResSchema: z.ZodType<ComputeStateResult>;
+/**
+ * 大纲节点 data 字段 schema（决策 23，麦基《故事》字段集，schema.md outline.json「节点结构化信息」节）：
+ * scene——goal/conflict_levels/value_from/value_to；chapter——reversal/climax_scene；
+ * volume——climax_scene/inciting_scene。
+ * 宽松语义与 ENTITY_DATA_SCHEMAS 一致：
+ * - `.passthrough()` 允许未知字段（创作工具，用户自定义字段自由，未知字段原样保留透传）
+ * - 引用字段（climax_scene/inciting_scene）仅类型校验（字符串），不校验存在性/范围（决策 23：MVP 宽松）
+ * 请求体 data 本体使用宽松 record（outlineCreateReqSchema），精确校验在服务端 route 层按层级选用
+ */
+export declare const sceneDataSchema: z.ZodObject<{
+    goal: z.ZodOptional<z.ZodString>;
+    conflict_levels: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        inner: "inner";
+        personal: "personal";
+        extra_personal: "extra_personal";
+    }>>>;
+    value_from: z.ZodOptional<z.ZodString>;
+    value_to: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export declare const chapterDataSchema: z.ZodObject<{
+    reversal: z.ZodOptional<z.ZodString>;
+    climax_scene: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export declare const volumeDataSchema: z.ZodObject<{
+    climax_scene: z.ZodOptional<z.ZodString>;
+    inciting_scene: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/**
+ * 各层级 data schema 注册表（服务端按节点 type 选用精确 schema 校验，
+ * 与 ENTITY_DATA_SCHEMAS 同构；type 三选一 scene/chapter/volume，root 无 data）
+ */
+export declare const OUTLINE_NODE_DATA_SCHEMAS: {
+    readonly scene: z.ZodObject<{
+        goal: z.ZodOptional<z.ZodString>;
+        conflict_levels: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            inner: "inner";
+            personal: "personal";
+            extra_personal: "extra_personal";
+        }>>>;
+        value_from: z.ZodOptional<z.ZodString>;
+        value_to: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    readonly chapter: z.ZodObject<{
+        reversal: z.ZodOptional<z.ZodString>;
+        climax_scene: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    readonly volume: z.ZodObject<{
+        climax_scene: z.ZodOptional<z.ZodString>;
+        inciting_scene: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+};
+/** 大纲节点（递归 schema；type 三选一 + children 可选，比 T1.1 的判别联合宽松——
+ * 严格三层（卷→章→场景、scene 无 children）的类型约束由 types/outline.ts 承担，服务端负责层级校验，
+ * 故此处不做 z.ZodType<OutlineNode> 标注（宽松 infer 无法赋给判别联合））
+ */
+export declare const outlineNodeSchema: z.ZodTypeAny;
+/** 完整大纲树（GET /api/v1/outline） */
+export declare const outlineTreeSchema: z.ZodObject<{
+    id: z.ZodLiteral<"root">;
+    type: z.ZodLiteral<"root">;
+    schemaVersion: z.ZodNumber;
+    children: z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+}, z.core.$strip>;
+export declare const outlineGetQuerySchema: z.ZodObject<{
+    with_metadata: z.ZodOptional<z.ZodPipe<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>, z.ZodTransform<boolean, "true" | "false">>>;
+}, z.core.$strip>;
+export declare const outlineCreateReqSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        volume: "volume";
+        chapter: "chapter";
+        scene: "scene";
+    }>;
+    title: z.ZodString;
+    parent_id: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export declare const outlineCreateResSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<{
+        volume: "volume";
+        chapter: "chapter";
+        scene: "scene";
+    }>;
+    title: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const outlineUpdateReqSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export declare const outlineUpdateResSchema: z.ZodObject<{
+    updated: z.ZodLiteral<true>;
+}, z.core.$strip>;
+export declare const outlineMoveReqSchema: z.ZodObject<{
+    parent_id: z.ZodString;
+    order: z.ZodNumber;
+}, z.core.$strict>;
+export declare const outlineMoveResSchema: z.ZodObject<{
+    moved: z.ZodLiteral<true>;
+    previousParentId: z.ZodString;
+    newParentId: z.ZodString;
+}, z.core.$strip>;
+export declare const outlineDeleteResSchema: z.ZodObject<{
+    deleted: z.ZodLiteral<true>;
+    cascaded: z.ZodObject<{
+        children: z.ZodNumber;
+        relations: z.ZodNumber;
+        deltas: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const outlinePathResSchema: z.ZodObject<{
+    nodeId: z.ZodString;
+    path: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const trashListResSchema: z.ZodObject<{
+    entities: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        name: z.ZodString;
+        deletedAt: z.ZodString;
+    }, z.core.$strip>>;
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        title: z.ZodString;
+        deletedAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const trashRestoreEntityResSchema: z.ZodObject<{
+    restored: z.ZodLiteral<true>;
+    restoredRelations: z.ZodNumber;
+    restoredDeltas: z.ZodNumber;
+}, z.core.$strip>;
+export declare const trashRestoreNodeResSchema: z.ZodObject<{
+    restored: z.ZodLiteral<true>;
+    restoredChildren: z.ZodNumber;
+    restoredRelations: z.ZodNumber;
+    restoredDeltas: z.ZodNumber;
+}, z.core.$strip>;
+export declare const trashPurgeResSchema: z.ZodObject<{
+    purged: z.ZodLiteral<true>;
+}, z.core.$strip>;
+export declare const chatSendReqSchema: z.ZodObject<{
+    message: z.ZodString;
+    session_id: z.ZodOptional<z.ZodString>;
+    context: z.ZodOptional<z.ZodObject<{
+        focus_entity_type: z.ZodOptional<z.ZodEnum<{
+            character: "character";
+            setting: "setting";
+            location: "location";
+            hook: "hook";
+        }>>;
+        focus_entity_id: z.ZodOptional<z.ZodString>;
+        focus_node_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export declare const chatSessionSummarySchema: z.ZodObject<{
+    id: z.ZodString;
+    lastMessage: z.ZodString;
+    messageCount: z.ZodNumber;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const chatSessionsResSchema: z.ZodObject<{
+    sessions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        lastMessage: z.ZodString;
+        messageCount: z.ZodNumber;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const chatMessagesResSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    messages: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        role: z.ZodEnum<{
+            user: "user";
+            assistant: "assistant";
+            tool: "tool";
+        }>;
+        content: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        toolCalls: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+        toolCallId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const proposalConfirmResSchema: z.ZodObject<{
+    confirmed: z.ZodLiteral<true>;
+    result: z.ZodUnknown;
+}, z.core.$strip>;
+export declare const proposalRejectResSchema: z.ZodObject<{
+    rejected: z.ZodLiteral<true>;
+}, z.core.$strip>;
+export declare const settingsLlmGetResSchema: z.ZodObject<{
+    model: z.ZodString;
+    apiKeySet: z.ZodBoolean;
+    apiKeyMasked: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const settingsLlmPutReqSchema: z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+    api_key: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const settingsLlmPutResSchema: z.ZodObject<{
+    saved: z.ZodLiteral<true>;
+}, z.core.$strip>;
+/** 心跳 ping（每 15-30s，决策 20）：空 payload */
+export declare const ssePingEventSchema: z.ZodObject<{}, z.core.$strip>;
+/** tool_call：AI 调用了工具 */
+export declare const sseToolCallEventSchema: z.ZodObject<{
+    tool: z.ZodString;
+    args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    id: z.ZodString;
+}, z.core.$strip>;
+/** tool_result：工具执行结果 */
+export declare const sseToolResultEventSchema: z.ZodObject<{
+    tool: z.ZodString;
+    result: z.ZodUnknown;
+    id: z.ZodString;
+}, z.core.$strip>;
+/** text：AI 文本回复片段 */
+export declare const sseTextEventSchema: z.ZodObject<{
+    delta: z.ZodString;
+}, z.core.$strip>;
+/** proposal：AI 发出提案（完整预览仅经此事件推送 GUI，tool_result 不含预览，2026-08 修订） */
+export declare const sseProposalEventSchema: z.ZodObject<{
+    proposal_id: z.ZodString;
+    type: z.ZodString;
+    preview: z.ZodUnknown;
+}, z.core.$strip>;
+/** done：对话轮次结束 */
+export declare const sseDoneEventSchema: z.ZodObject<{
+    session_id: z.ZodString;
+}, z.core.$strip>;
+/** error：流终止（客户端收到即停止解析） */
+export declare const sseErrorEventSchema: z.ZodObject<{
+    code: z.ZodEnum<{
+        VALIDATION_ERROR: "VALIDATION_ERROR";
+        ENTITY_NOT_FOUND: "ENTITY_NOT_FOUND";
+        RELATION_EXISTS: "RELATION_EXISTS";
+        RELATION_NOT_FOUND: "RELATION_NOT_FOUND";
+        OUTLINE_NODE_NOT_FOUND: "OUTLINE_NODE_NOT_FOUND";
+        OUTLINE_ANCESTOR_DELETED: "OUTLINE_ANCESTOR_DELETED";
+        INVALID_PROJECT_PATH: "INVALID_PROJECT_PATH";
+        PROPOSAL_STALE: "PROPOSAL_STALE";
+        PROPOSAL_NOT_FOUND: "PROPOSAL_NOT_FOUND";
+        PROPOSAL_PROJECT_MISMATCH: "PROPOSAL_PROJECT_MISMATCH";
+        SCHEMA_VERSION_MISMATCH: "SCHEMA_VERSION_MISMATCH";
+        PROJECT_VERSION_NEWER: "PROJECT_VERSION_NEWER";
+        DELTA_CONFLICT: "DELTA_CONFLICT";
+        TOOL_RESULT_TOO_LARGE: "TOOL_RESULT_TOO_LARGE";
+        AGENT_DISPATCH_ERROR: "AGENT_DISPATCH_ERROR";
+        AGENT_INTERNAL_ERROR: "AGENT_INTERNAL_ERROR";
+        AGENT_MAX_ITERATIONS: "AGENT_MAX_ITERATIONS";
+        AGENT_TIMEOUT: "AGENT_TIMEOUT";
+        AGENT_TOKEN_BUDGET: "AGENT_TOKEN_BUDGET";
+    }>;
+    message: z.ZodString;
+}, z.core.$strip>;
+//# sourceMappingURL=api.d.ts.map