@actalk/inkos-core 1.2.0 → 1.3.0

package/dist/interaction/session.d.ts

@@ -18,18 +18,169 @@ export declare const PendingDecisionSchema: z.ZodObject<{
     chapterNumber?: number | undefined;
 }>;
 export type PendingDecision = z.infer<typeof PendingDecisionSchema>;
+export declare const PipelineStageSchema: z.ZodObject<{
+    label: z.ZodString;
+    status: z.ZodEnum<["pending", "active", "completed"]>;
+}, "strip", z.ZodTypeAny, {
+    status: "active" | "completed" | "pending";
+    label: string;
+}, {
+    status: "active" | "completed" | "pending";
+    label: string;
+}>;
+export type PipelineStage = z.infer<typeof PipelineStageSchema>;
+export declare const ToolExecutionSchema: z.ZodObject<{
+    id: z.ZodString;
+    tool: z.ZodString;
+    agent: z.ZodOptional<z.ZodString>;
+    label: z.ZodString;
+    status: z.ZodEnum<["running", "processing", "completed", "error"]>;
+    args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    result: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    stages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        status: z.ZodEnum<["pending", "active", "completed"]>;
+    }, "strip", z.ZodTypeAny, {
+        status: "active" | "completed" | "pending";
+        label: string;
+    }, {
+        status: "active" | "completed" | "pending";
+        label: string;
+    }>, "many">>;
+    startedAt: z.ZodNumber;
+    completedAt: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    status: "completed" | "error" | "running" | "processing";
+    id: string;
+    tool: string;
+    label: string;
+    startedAt: number;
+    error?: string | undefined;
+    agent?: string | undefined;
+    args?: Record<string, unknown> | undefined;
+    result?: string | undefined;
+    stages?: {
+        status: "active" | "completed" | "pending";
+        label: string;
+    }[] | undefined;
+    completedAt?: number | undefined;
+}, {
+    status: "completed" | "error" | "running" | "processing";
+    id: string;
+    tool: string;
+    label: string;
+    startedAt: number;
+    error?: string | undefined;
+    agent?: string | undefined;
+    args?: Record<string, unknown> | undefined;
+    result?: string | undefined;
+    stages?: {
+        status: "active" | "completed" | "pending";
+        label: string;
+    }[] | undefined;
+    completedAt?: number | undefined;
+}>;
+export type ToolExecution = z.infer<typeof ToolExecutionSchema>;
 export declare const InteractionMessageSchema: z.ZodObject<{
     role: z.ZodEnum<["user", "assistant", "system"]>;
     content: z.ZodString;
+    thinking: z.ZodOptional<z.ZodString>;
+    toolExecutions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        tool: z.ZodString;
+        agent: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+        status: z.ZodEnum<["running", "processing", "completed", "error"]>;
+        args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        result: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+        stages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            status: z.ZodEnum<["pending", "active", "completed"]>;
+        }, "strip", z.ZodTypeAny, {
+            status: "active" | "completed" | "pending";
+            label: string;
+        }, {
+            status: "active" | "completed" | "pending";
+            label: string;
+        }>, "many">>;
+        startedAt: z.ZodNumber;
+        completedAt: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        status: "completed" | "error" | "running" | "processing";
+        id: string;
+        tool: string;
+        label: string;
+        startedAt: number;
+        error?: string | undefined;
+        agent?: string | undefined;
+        args?: Record<string, unknown> | undefined;
+        result?: string | undefined;
+        stages?: {
+            status: "active" | "completed" | "pending";
+            label: string;
+        }[] | undefined;
+        completedAt?: number | undefined;
+    }, {
+        status: "completed" | "error" | "running" | "processing";
+        id: string;
+        tool: string;
+        label: string;
+        startedAt: number;
+        error?: string | undefined;
+        agent?: string | undefined;
+        args?: Record<string, unknown> | undefined;
+        result?: string | undefined;
+        stages?: {
+            status: "active" | "completed" | "pending";
+            label: string;
+        }[] | undefined;
+        completedAt?: number | undefined;
+    }>, "many">>;
     timestamp: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
     content: string;
-    role: "system" | "user" | "assistant";
     timestamp: number;
+    role: "system" | "user" | "assistant";
+    thinking?: string | undefined;
+    toolExecutions?: {
+        status: "completed" | "error" | "running" | "processing";
+        id: string;
+        tool: string;
+        label: string;
+        startedAt: number;
+        error?: string | undefined;
+        agent?: string | undefined;
+        args?: Record<string, unknown> | undefined;
+        result?: string | undefined;
+        stages?: {
+            status: "active" | "completed" | "pending";
+            label: string;
+        }[] | undefined;
+        completedAt?: number | undefined;
+    }[] | undefined;
 }, {
     content: string;
-    role: "system" | "user" | "assistant";
     timestamp: number;
+    role: "system" | "user" | "assistant";
+    thinking?: string | undefined;
+    toolExecutions?: {
+        status: "completed" | "error" | "running" | "processing";
+        id: string;
+        tool: string;
+        label: string;
+        startedAt: number;
+        error?: string | undefined;
+        agent?: string | undefined;
+        args?: Record<string, unknown> | undefined;
+        result?: string | undefined;
+        stages?: {
+            status: "active" | "completed" | "pending";
+            label: string;
+        }[] | undefined;
+        completedAt?: number | undefined;
+    }[] | undefined;
 }>;
 export type InteractionMessage = z.infer<typeof InteractionMessageSchema>;
 export declare const BookCreationDraftSchema: z.ZodObject<{
@@ -97,6 +248,29 @@ export declare const BookCreationDraftSchema: z.ZodObject<{
     readyToCreate?: boolean | undefined;
 }>;
 export type BookCreationDraft = z.infer<typeof BookCreationDraftSchema>;
+export declare const DraftRoundSchema: z.ZodObject<{
+    roundId: z.ZodNumber;
+    userMessage: z.ZodString;
+    assistantRaw: z.ZodString;
+    fieldsUpdated: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    summary: z.ZodDefault<z.ZodString>;
+    timestamp: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    timestamp: number;
+    summary: string;
+    roundId: number;
+    userMessage: string;
+    assistantRaw: string;
+    fieldsUpdated: string[];
+}, {
+    timestamp: number;
+    roundId: number;
+    userMessage: string;
+    assistantRaw: string;
+    summary?: string | undefined;
+    fieldsUpdated?: string[] | undefined;
+}>;
+export type DraftRound = z.infer<typeof DraftRoundSchema>;
 export declare const InteractionSessionSchema: z.ZodObject<{
     sessionId: z.ZodString;
     projectRoot: z.ZodString;
@@ -166,19 +340,128 @@ export declare const InteractionSessionSchema: z.ZodObject<{
         missingFields?: string[] | undefined;
         readyToCreate?: boolean | undefined;
     }>>;
+    draftRounds: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        roundId: z.ZodNumber;
+        userMessage: z.ZodString;
+        assistantRaw: z.ZodString;
+        fieldsUpdated: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        summary: z.ZodDefault<z.ZodString>;
+        timestamp: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: number;
+        summary: string;
+        roundId: number;
+        userMessage: string;
+        assistantRaw: string;
+        fieldsUpdated: string[];
+    }, {
+        timestamp: number;
+        roundId: number;
+        userMessage: string;
+        assistantRaw: string;
+        summary?: string | undefined;
+        fieldsUpdated?: string[] | undefined;
+    }>, "many">>;
     automationMode: z.ZodDefault<z.ZodEnum<["auto", "semi", "manual"]>>;
     messages: z.ZodDefault<z.ZodArray<z.ZodObject<{
         role: z.ZodEnum<["user", "assistant", "system"]>;
         content: z.ZodString;
+        thinking: z.ZodOptional<z.ZodString>;
+        toolExecutions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            tool: z.ZodString;
+            agent: z.ZodOptional<z.ZodString>;
+            label: z.ZodString;
+            status: z.ZodEnum<["running", "processing", "completed", "error"]>;
+            args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            result: z.ZodOptional<z.ZodString>;
+            error: z.ZodOptional<z.ZodString>;
+            stages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                status: z.ZodEnum<["pending", "active", "completed"]>;
+            }, "strip", z.ZodTypeAny, {
+                status: "active" | "completed" | "pending";
+                label: string;
+            }, {
+                status: "active" | "completed" | "pending";
+                label: string;
+            }>, "many">>;
+            startedAt: z.ZodNumber;
+            completedAt: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            status: "completed" | "error" | "running" | "processing";
+            id: string;
+            tool: string;
+            label: string;
+            startedAt: number;
+            error?: string | undefined;
+            agent?: string | undefined;
+            args?: Record<string, unknown> | undefined;
+            result?: string | undefined;
+            stages?: {
+                status: "active" | "completed" | "pending";
+                label: string;
+            }[] | undefined;
+            completedAt?: number | undefined;
+        }, {
+            status: "completed" | "error" | "running" | "processing";
+            id: string;
+            tool: string;
+            label: string;
+            startedAt: number;
+            error?: string | undefined;
+            agent?: string | undefined;
+            args?: Record<string, unknown> | undefined;
+            result?: string | undefined;
+            stages?: {
+                status: "active" | "completed" | "pending";
+                label: string;
+            }[] | undefined;
+            completedAt?: number | undefined;
+        }>, "many">>;
         timestamp: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
         content: string;
-        role: "system" | "user" | "assistant";
         timestamp: number;
+        role: "system" | "user" | "assistant";
+        thinking?: string | undefined;
+        toolExecutions?: {
+            status: "completed" | "error" | "running" | "processing";
+            id: string;
+            tool: string;
+            label: string;
+            startedAt: number;
+            error?: string | undefined;
+            agent?: string | undefined;
+            args?: Record<string, unknown> | undefined;
+            result?: string | undefined;
+            stages?: {
+                status: "active" | "completed" | "pending";
+                label: string;
+            }[] | undefined;
+            completedAt?: number | undefined;
+        }[] | undefined;
     }, {
         content: string;
-        role: "system" | "user" | "assistant";
         timestamp: number;
+        role: "system" | "user" | "assistant";
+        thinking?: string | undefined;
+        toolExecutions?: {
+            status: "completed" | "error" | "running" | "processing";
+            id: string;
+            tool: string;
+            label: string;
+            startedAt: number;
+            error?: string | undefined;
+            agent?: string | undefined;
+            args?: Record<string, unknown> | undefined;
+            result?: string | undefined;
+            stages?: {
+                status: "active" | "completed" | "pending";
+                label: string;
+            }[] | undefined;
+            completedAt?: number | undefined;
+        }[] | undefined;
     }>, "many">>;
     events: z.ZodDefault<z.ZodArray<z.ZodObject<{
         kind: z.ZodString;
@@ -245,11 +528,36 @@ export declare const InteractionSessionSchema: z.ZodObject<{
     }[];
     messages: {
         content: string;
-        role: "system" | "user" | "assistant";
         timestamp: number;
+        role: "system" | "user" | "assistant";
+        thinking?: string | undefined;
+        toolExecutions?: {
+            status: "completed" | "error" | "running" | "processing";
+            id: string;
+            tool: string;
+            label: string;
+            startedAt: number;
+            error?: string | undefined;
+            agent?: string | undefined;
+            args?: Record<string, unknown> | undefined;
+            result?: string | undefined;
+            stages?: {
+                status: "active" | "completed" | "pending";
+                label: string;
+            }[] | undefined;
+            completedAt?: number | undefined;
+        }[] | undefined;
     }[];
     sessionId: string;
     projectRoot: string;
+    draftRounds: {
+        timestamp: number;
+        summary: string;
+        roundId: number;
+        userMessage: string;
+        assistantRaw: string;
+        fieldsUpdated: string[];
+    }[];
     automationMode: "auto" | "semi" | "manual";
     activeBookId?: string | undefined;
     activeChapterNumber?: number | undefined;
@@ -300,8 +608,25 @@ export declare const InteractionSessionSchema: z.ZodObject<{
     }[] | undefined;
     messages?: {
         content: string;
-        role: "system" | "user" | "assistant";
         timestamp: number;
+        role: "system" | "user" | "assistant";
+        thinking?: string | undefined;
+        toolExecutions?: {
+            status: "completed" | "error" | "running" | "processing";
+            id: string;
+            tool: string;
+            label: string;
+            startedAt: number;
+            error?: string | undefined;
+            agent?: string | undefined;
+            args?: Record<string, unknown> | undefined;
+            result?: string | undefined;
+            stages?: {
+                status: "active" | "completed" | "pending";
+                label: string;
+            }[] | undefined;
+            completedAt?: number | undefined;
+        }[] | undefined;
     }[] | undefined;
     activeBookId?: string | undefined;
     activeChapterNumber?: number | undefined;
@@ -327,6 +652,14 @@ export declare const InteractionSessionSchema: z.ZodObject<{
         missingFields?: string[] | undefined;
         readyToCreate?: boolean | undefined;
     } | undefined;
+    draftRounds?: {
+        timestamp: number;
+        roundId: number;
+        userMessage: string;
+        assistantRaw: string;
+        summary?: string | undefined;
+        fieldsUpdated?: string[] | undefined;
+    }[] | undefined;
     automationMode?: "auto" | "semi" | "manual" | undefined;
     pendingDecision?: {
         bookId: string;
@@ -342,6 +675,392 @@ export declare const InteractionSessionSchema: z.ZodObject<{
     } | undefined;
 }>;
 export type InteractionSession = z.infer<typeof InteractionSessionSchema>;
+export declare const BookSessionSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    bookId: z.ZodNullable<z.ZodString>;
+    messages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<["user", "assistant", "system"]>;
+        content: z.ZodString;
+        thinking: z.ZodOptional<z.ZodString>;
+        toolExecutions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            tool: z.ZodString;
+            agent: z.ZodOptional<z.ZodString>;
+            label: z.ZodString;
+            status: z.ZodEnum<["running", "processing", "completed", "error"]>;
+            args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            result: z.ZodOptional<z.ZodString>;
+            error: z.ZodOptional<z.ZodString>;
+            stages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                status: z.ZodEnum<["pending", "active", "completed"]>;
+            }, "strip", z.ZodTypeAny, {
+                status: "active" | "completed" | "pending";
+                label: string;
+            }, {
+                status: "active" | "completed" | "pending";
+                label: string;
+            }>, "many">>;
+            startedAt: z.ZodNumber;
+            completedAt: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            status: "completed" | "error" | "running" | "processing";
+            id: string;
+            tool: string;
+            label: string;
+            startedAt: number;
+            error?: string | undefined;
+            agent?: string | undefined;
+            args?: Record<string, unknown> | undefined;
+            result?: string | undefined;
+            stages?: {
+                status: "active" | "completed" | "pending";
+                label: string;
+            }[] | undefined;
+            completedAt?: number | undefined;
+        }, {
+            status: "completed" | "error" | "running" | "processing";
+            id: string;
+            tool: string;
+            label: string;
+            startedAt: number;
+            error?: string | undefined;
+            agent?: string | undefined;
+            args?: Record<string, unknown> | undefined;
+            result?: string | undefined;
+            stages?: {
+                status: "active" | "completed" | "pending";
+                label: string;
+            }[] | undefined;
+            completedAt?: number | undefined;
+        }>, "many">>;
+        timestamp: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        content: string;
+        timestamp: number;
+        role: "system" | "user" | "assistant";
+        thinking?: string | undefined;
+        toolExecutions?: {
+            status: "completed" | "error" | "running" | "processing";
+            id: string;
+            tool: string;
+            label: string;
+            startedAt: number;
+            error?: string | undefined;
+            agent?: string | undefined;
+            args?: Record<string, unknown> | undefined;
+            result?: string | undefined;
+            stages?: {
+                status: "active" | "completed" | "pending";
+                label: string;
+            }[] | undefined;
+            completedAt?: number | undefined;
+        }[] | undefined;
+    }, {
+        content: string;
+        timestamp: number;
+        role: "system" | "user" | "assistant";
+        thinking?: string | undefined;
+        toolExecutions?: {
+            status: "completed" | "error" | "running" | "processing";
+            id: string;
+            tool: string;
+            label: string;
+            startedAt: number;
+            error?: string | undefined;
+            agent?: string | undefined;
+            args?: Record<string, unknown> | undefined;
+            result?: string | undefined;
+            stages?: {
+                status: "active" | "completed" | "pending";
+                label: string;
+            }[] | undefined;
+            completedAt?: number | undefined;
+        }[] | undefined;
+    }>, "many">>;
+    creationDraft: z.ZodOptional<z.ZodObject<{
+        concept: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        genre: z.ZodOptional<z.ZodString>;
+        platform: z.ZodOptional<z.ZodString>;
+        language: z.ZodOptional<z.ZodEnum<["zh", "en"]>>;
+        targetChapters: z.ZodOptional<z.ZodNumber>;
+        chapterWordCount: z.ZodOptional<z.ZodNumber>;
+        blurb: z.ZodOptional<z.ZodString>;
+        worldPremise: z.ZodOptional<z.ZodString>;
+        settingNotes: z.ZodOptional<z.ZodString>;
+        protagonist: z.ZodOptional<z.ZodString>;
+        supportingCast: z.ZodOptional<z.ZodString>;
+        conflictCore: z.ZodOptional<z.ZodString>;
+        volumeOutline: z.ZodOptional<z.ZodString>;
+        constraints: z.ZodOptional<z.ZodString>;
+        authorIntent: z.ZodOptional<z.ZodString>;
+        currentFocus: z.ZodOptional<z.ZodString>;
+        nextQuestion: z.ZodOptional<z.ZodString>;
+        missingFields: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        readyToCreate: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        concept: string;
+        missingFields: string[];
+        readyToCreate: boolean;
+        title?: string | undefined;
+        platform?: string | undefined;
+        genre?: string | undefined;
+        targetChapters?: number | undefined;
+        chapterWordCount?: number | undefined;
+        language?: "zh" | "en" | undefined;
+        protagonist?: string | undefined;
+        authorIntent?: string | undefined;
+        currentFocus?: string | undefined;
+        volumeOutline?: string | undefined;
+        blurb?: string | undefined;
+        worldPremise?: string | undefined;
+        settingNotes?: string | undefined;
+        supportingCast?: string | undefined;
+        conflictCore?: string | undefined;
+        constraints?: string | undefined;
+        nextQuestion?: string | undefined;
+    }, {
+        concept: string;
+        title?: string | undefined;
+        platform?: string | undefined;
+        genre?: string | undefined;
+        targetChapters?: number | undefined;
+        chapterWordCount?: number | undefined;
+        language?: "zh" | "en" | undefined;
+        protagonist?: string | undefined;
+        authorIntent?: string | undefined;
+        currentFocus?: string | undefined;
+        volumeOutline?: string | undefined;
+        blurb?: string | undefined;
+        worldPremise?: string | undefined;
+        settingNotes?: string | undefined;
+        supportingCast?: string | undefined;
+        conflictCore?: string | undefined;
+        constraints?: string | undefined;
+        nextQuestion?: string | undefined;
+        missingFields?: string[] | undefined;
+        readyToCreate?: boolean | undefined;
+    }>>;
+    draftRounds: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        roundId: z.ZodNumber;
+        userMessage: z.ZodString;
+        assistantRaw: z.ZodString;
+        fieldsUpdated: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        summary: z.ZodDefault<z.ZodString>;
+        timestamp: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: number;
+        summary: string;
+        roundId: number;
+        userMessage: string;
+        assistantRaw: string;
+        fieldsUpdated: string[];
+    }, {
+        timestamp: number;
+        roundId: number;
+        userMessage: string;
+        assistantRaw: string;
+        summary?: string | undefined;
+        fieldsUpdated?: string[] | undefined;
+    }>, "many">>;
+    events: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        timestamp: z.ZodNumber;
+        status: z.ZodEnum<["idle", "planning", "composing", "writing", "assessing", "repairing", "persisting", "waiting_human", "blocked", "completed", "failed"]>;
+        bookId: z.ZodOptional<z.ZodString>;
+        chapterNumber: z.ZodOptional<z.ZodNumber>;
+        detail: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "completed" | "planning" | "idle" | "composing" | "writing" | "assessing" | "repairing" | "persisting" | "waiting_human" | "blocked" | "failed";
+        kind: string;
+        timestamp: number;
+        detail?: string | undefined;
+        bookId?: string | undefined;
+        chapterNumber?: number | undefined;
+    }, {
+        status: "completed" | "planning" | "idle" | "composing" | "writing" | "assessing" | "repairing" | "persisting" | "waiting_human" | "blocked" | "failed";
+        kind: string;
+        timestamp: number;
+        detail?: string | undefined;
+        bookId?: string | undefined;
+        chapterNumber?: number | undefined;
+    }>, "many">>;
+    currentExecution: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<["idle", "planning", "composing", "writing", "assessing", "repairing", "persisting", "waiting_human", "blocked", "completed", "failed"]>;
+        bookId: z.ZodOptional<z.ZodString>;
+        chapterNumber: z.ZodOptional<z.ZodNumber>;
+        stageLabel: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "completed" | "planning" | "idle" | "composing" | "writing" | "assessing" | "repairing" | "persisting" | "waiting_human" | "blocked" | "failed";
+        bookId?: string | undefined;
+        chapterNumber?: number | undefined;
+        stageLabel?: string | undefined;
+    }, {
+        status: "completed" | "planning" | "idle" | "composing" | "writing" | "assessing" | "repairing" | "persisting" | "waiting_human" | "blocked" | "failed";
+        bookId?: string | undefined;
+        chapterNumber?: number | undefined;
+        stageLabel?: string | undefined;
+    }>>;
+    createdAt: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    createdAt: number;
+    updatedAt: number;
+    events: {
+        status: "completed" | "planning" | "idle" | "composing" | "writing" | "assessing" | "repairing" | "persisting" | "waiting_human" | "blocked" | "failed";
+        kind: string;
+        timestamp: number;
+        detail?: string | undefined;
+        bookId?: string | undefined;
+        chapterNumber?: number | undefined;
+    }[];
+    messages: {
+        content: string;
+        timestamp: number;
+        role: "system" | "user" | "assistant";
+        thinking?: string | undefined;
+        toolExecutions?: {
+            status: "completed" | "error" | "running" | "processing";
+            id: string;
+            tool: string;
+            label: string;
+            startedAt: number;
+            error?: string | undefined;
+            agent?: string | undefined;
+            args?: Record<string, unknown> | undefined;
+            result?: string | undefined;
+            stages?: {
+                status: "active" | "completed" | "pending";
+                label: string;
+            }[] | undefined;
+            completedAt?: number | undefined;
+        }[] | undefined;
+    }[];
+    bookId: string | null;
+    sessionId: string;
+    draftRounds: {
+        timestamp: number;
+        summary: string;
+        roundId: number;
+        userMessage: string;
+        assistantRaw: string;
+        fieldsUpdated: string[];
+    }[];
+    creationDraft?: {
+        concept: string;
+        missingFields: string[];
+        readyToCreate: boolean;
+        title?: string | undefined;
+        platform?: string | undefined;
+        genre?: string | undefined;
+        targetChapters?: number | undefined;
+        chapterWordCount?: number | undefined;
+        language?: "zh" | "en" | undefined;
+        protagonist?: string | undefined;
+        authorIntent?: string | undefined;
+        currentFocus?: string | undefined;
+        volumeOutline?: string | undefined;
+        blurb?: string | undefined;
+        worldPremise?: string | undefined;
+        settingNotes?: string | undefined;
+        supportingCast?: string | undefined;
+        conflictCore?: string | undefined;
+        constraints?: string | undefined;
+        nextQuestion?: string | undefined;
+    } | undefined;
+    currentExecution?: {
+        status: "completed" | "planning" | "idle" | "composing" | "writing" | "assessing" | "repairing" | "persisting" | "waiting_human" | "blocked" | "failed";
+        bookId?: string | undefined;
+        chapterNumber?: number | undefined;
+        stageLabel?: string | undefined;
+    } | undefined;
+}, {
+    createdAt: number;
+    updatedAt: number;
+    bookId: string | null;
+    sessionId: string;
+    events?: {
+        status: "completed" | "planning" | "idle" | "composing" | "writing" | "assessing" | "repairing" | "persisting" | "waiting_human" | "blocked" | "failed";
+        kind: string;
+        timestamp: number;
+        detail?: string | undefined;
+        bookId?: string | undefined;
+        chapterNumber?: number | undefined;
+    }[] | undefined;
+    messages?: {
+        content: string;
+        timestamp: number;
+        role: "system" | "user" | "assistant";
+        thinking?: string | undefined;
+        toolExecutions?: {
+            status: "completed" | "error" | "running" | "processing";
+            id: string;
+            tool: string;
+            label: string;
+            startedAt: number;
+            error?: string | undefined;
+            agent?: string | undefined;
+            args?: Record<string, unknown> | undefined;
+            result?: string | undefined;
+            stages?: {
+                status: "active" | "completed" | "pending";
+                label: string;
+            }[] | undefined;
+            completedAt?: number | undefined;
+        }[] | undefined;
+    }[] | undefined;
+    creationDraft?: {
+        concept: string;
+        title?: string | undefined;
+        platform?: string | undefined;
+        genre?: string | undefined;
+        targetChapters?: number | undefined;
+        chapterWordCount?: number | undefined;
+        language?: "zh" | "en" | undefined;
+        protagonist?: string | undefined;
+        authorIntent?: string | undefined;
+        currentFocus?: string | undefined;
+        volumeOutline?: string | undefined;
+        blurb?: string | undefined;
+        worldPremise?: string | undefined;
+        settingNotes?: string | undefined;
+        supportingCast?: string | undefined;
+        conflictCore?: string | undefined;
+        constraints?: string | undefined;
+        nextQuestion?: string | undefined;
+        missingFields?: string[] | undefined;
+        readyToCreate?: boolean | undefined;
+    } | undefined;
+    draftRounds?: {
+        timestamp: number;
+        roundId: number;
+        userMessage: string;
+        assistantRaw: string;
+        summary?: string | undefined;
+        fieldsUpdated?: string[] | undefined;
+    }[] | undefined;
+    currentExecution?: {
+        status: "completed" | "planning" | "idle" | "composing" | "writing" | "assessing" | "repairing" | "persisting" | "waiting_human" | "blocked" | "failed";
+        bookId?: string | undefined;
+        chapterNumber?: number | undefined;
+        stageLabel?: string | undefined;
+    } | undefined;
+}>;
+export type BookSession = z.infer<typeof BookSessionSchema>;
+export declare const GlobalSessionSchema: z.ZodObject<{
+    activeBookId: z.ZodOptional<z.ZodString>;
+    automationMode: z.ZodDefault<z.ZodEnum<["auto", "semi", "manual"]>>;
+}, "strip", z.ZodTypeAny, {
+    automationMode: "auto" | "semi" | "manual";
+    activeBookId?: string | undefined;
+}, {
+    activeBookId?: string | undefined;
+    automationMode?: "auto" | "semi" | "manual" | undefined;
+}>;
+export type GlobalSession = z.infer<typeof GlobalSessionSchema>;
+export declare function createBookSession(bookId: string | null): BookSession;
+export declare function appendBookSessionMessage(session: BookSession, message: InteractionMessage): BookSession;
 export declare function bindActiveBook(session: InteractionSession, bookId: string, chapterNumber?: number): InteractionSession;
 export declare function clearPendingDecision(session: InteractionSession): InteractionSession;
 export declare function updateCreationDraft(session: InteractionSession, draft: BookCreationDraft): InteractionSession;