@kienmatu/inkos-core 0.1.0

package/dist/interaction/project-session-store.js

@@ -0,0 +1,64 @@
+import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { InteractionSessionSchema, GlobalSessionSchema } from "./session.js";
+const SESSION_DIR = ".inkos";
+const SESSION_FILE = "session.json";
+export function resolveProjectSessionPath(projectRoot) {
+    return join(projectRoot, SESSION_DIR, SESSION_FILE);
+}
+export function createProjectSession(projectRoot) {
+    return InteractionSessionSchema.parse({
+        sessionId: `${Date.now()}`,
+        projectRoot,
+        automationMode: "semi",
+        messages: [],
+    });
+}
+export async function loadProjectSession(projectRoot) {
+    try {
+        const raw = await readFile(resolveProjectSessionPath(projectRoot), "utf-8");
+        return InteractionSessionSchema.parse(JSON.parse(raw));
+    }
+    catch {
+        return createProjectSession(projectRoot);
+    }
+}
+export async function persistProjectSession(projectRoot, session) {
+    const dir = join(projectRoot, SESSION_DIR);
+    await mkdir(dir, { recursive: true });
+    await writeFile(resolveProjectSessionPath(projectRoot), JSON.stringify(session, null, 2), "utf-8");
+}
+export async function loadGlobalSession(projectRoot) {
+    try {
+        const raw = await readFile(join(projectRoot, SESSION_DIR, SESSION_FILE), "utf-8");
+        const data = JSON.parse(raw);
+        return GlobalSessionSchema.parse({
+            activeBookId: data.activeBookId,
+            automationMode: data.automationMode ?? "semi",
+        });
+    }
+    catch {
+        return { automationMode: "semi" };
+    }
+}
+export async function persistGlobalSession(projectRoot, global) {
+    const dir = join(projectRoot, SESSION_DIR);
+    await mkdir(dir, { recursive: true });
+    await writeFile(join(dir, SESSION_FILE), JSON.stringify(global, null, 2));
+}
+export async function resolveSessionActiveBook(projectRoot, session) {
+    const booksDir = join(projectRoot, "books");
+    const entries = await readdir(booksDir, { withFileTypes: true }).catch(() => []);
+    const bookIds = entries
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name)
+        .sort();
+    if (session.activeBookId && bookIds.includes(session.activeBookId)) {
+        return session.activeBookId;
+    }
+    if (bookIds.length === 1) {
+        return bookIds[0];
+    }
+    return undefined;
+}
+//# sourceMappingURL=project-session-store.js.map

package/dist/interaction/project-session-store.js.map

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

package/dist/interaction/project-tools.d.ts

@@ -0,0 +1,23 @@
+import type { PipelineRunner, StateManager, BookConfig } from "../index.js";
+import type { InteractionRuntimeTools } from "./runtime.js";
+export declare function assertSafeTruthFileName(fileName: string): string;
+type PipelineLike = Pick<PipelineRunner, "writeNextChapter" | "reviseDraft"> & {
+    readonly initBook?: (book: BookConfig, options?: {
+        readonly externalContext?: string;
+        readonly authorIntent?: string;
+        readonly currentFocus?: string;
+    }) => Promise<void>;
+};
+type StateLike = Pick<StateManager, "ensureControlDocuments" | "bookDir" | "loadBookConfig" | "loadChapterIndex" | "saveChapterIndex" | "listBooks" | "acquireBookLock">;
+export declare function buildChapterFileLookup(files: ReadonlyArray<string>): ReadonlyMap<number, string>;
+export declare function createInteractionToolsFromDeps(pipeline: PipelineLike, state: StateLike, hooks?: {
+    readonly onChatTextDelta?: (text: string) => void;
+    readonly onDraftTextDelta?: (text: string) => void;
+    readonly onDraftRawDelta?: (text: string) => void;
+    readonly getChatRequestOptions?: () => {
+        readonly temperature?: number;
+        readonly maxTokens?: number;
+    };
+}): InteractionRuntimeTools;
+export {};
+//# sourceMappingURL=project-tools.d.ts.map

package/dist/interaction/project-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-tools.d.ts","sourceRoot":"","sources":["../../src/interaction/project-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,cAAc,EACd,YAAY,EAGZ,UAAU,EACX,MAAM,aAAa,CAAC;AAIrB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAiC5D,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiBhE;AAED,KAAK,YAAY,GAAG,IAAI,CAAC,cAAc,EAAE,kBAAkB,GAAG,aAAa,CAAC,GAAG;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAClB,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;QAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;KAChC,KACE,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB,CAAC;AACF,KAAK,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,wBAAwB,GAAG,SAAS,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,WAAW,GAAG,iBAAiB,CAAC,CAAC;AAyEzK,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAYhG;AAqLD,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,SAAS,EAChB,KAAK,CAAC,EAAE;IACN,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM;QACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;KAC7B,CAAC;CACH,GACA,uBAAuB,CAwLzB"}

package/dist/interaction/project-tools.js

@@ -0,0 +1,408 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { runWorkerAgent } from "../agent/worker-agent.js";
+import { executeEditTransaction } from "./edit-controller.js";
+import { defaultChapterLength } from "../utils/length-metrics.js";
+import { writeExportArtifact } from "./export-artifact.js";
+import { safeChildPath } from "../utils/path-safety.js";
+import { deriveBookIdFromTitle } from "../utils/book-id.js";
+import { normalizePlatformOrOther } from "../models/book.js";
+const SAFE_TRUTH_FLAT_FILE_NAMES = new Set([
+    "author_intent.md",
+    "current_focus.md",
+    "story_bible.md",
+    "volume_outline.md",
+    "book_rules.md",
+    "particle_ledger.md",
+    "subplot_board.md",
+    "emotional_arcs.md",
+    "style_guide.md",
+    "parent_canon.md",
+    "fanfic_canon.md",
+    "character_matrix.md",
+    "current_state.md",
+    "pending_hooks.md",
+    "chapter_summaries.md",
+]);
+const SAFE_TRUTH_OUTLINE_FILE_NAMES = new Set([
+    "outline/story_frame.md",
+    "outline/volume_map.md",
+    "outline/节奏原则.md",
+    "outline/rhythm_principles.md",
+]);
+const SAFE_ROLE_TRUTH_FILE_RE = /^roles\/(主要角色|次要角色|major|minor)\/[^/\\]+\.md$/u;
+export function assertSafeTruthFileName(fileName) {
+    const trimmed = fileName.trim();
+    const withExtension = trimmed.endsWith(".md") ? trimmed : `${trimmed}.md`;
+    const lower = withExtension.toLowerCase();
+    if (!trimmed ||
+        withExtension.startsWith("/") ||
+        withExtension.includes("\\") ||
+        withExtension.includes("\0") ||
+        withExtension.includes("..")) {
+        throw new Error(`Invalid truth file name: ${JSON.stringify(fileName)}`);
+    }
+    if (SAFE_TRUTH_FLAT_FILE_NAMES.has(lower))
+        return lower;
+    if (SAFE_TRUTH_OUTLINE_FILE_NAMES.has(lower))
+        return lower;
+    if (SAFE_ROLE_TRUTH_FILE_RE.test(withExtension))
+        return withExtension;
+    throw new Error(`Invalid truth file name: ${JSON.stringify(fileName)}`);
+}
+function buildBookConfig(input) {
+    const now = new Date().toISOString();
+    return {
+        id: deriveBookIdFromTitle(input.title) || `book-${Date.now().toString(36)}`,
+        title: input.title,
+        platform: normalizePlatformOrOther(input.platform),
+        genre: input.genre ?? "other",
+        status: "outlining",
+        targetChapters: input.targetChapters ?? 200,
+        chapterWordCount: input.chapterWordCount ?? defaultChapterLength(input.language === "en" ? "en" : "zh"),
+        ...(input.language ? { language: input.language } : {}),
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+function buildCreationExternalContext(input) {
+    const sections = [
+        input.worldPremise ? `## 世界观与核心设定\n${input.worldPremise}` : undefined,
+        input.settingNotes ? `## 补充设定\n${input.settingNotes}` : undefined,
+        input.protagonist ? `## 主角设定\n${input.protagonist}` : undefined,
+        input.supportingCast ? `## 关键角色与势力\n${input.supportingCast}` : undefined,
+        input.conflictCore ? `## 核心冲突\n${input.conflictCore}` : undefined,
+        input.volumeOutline ? `## 卷纲方向\n${input.volumeOutline}` : undefined,
+        input.blurb ? `## 简介卖点\n${input.blurb}` : undefined,
+        input.constraints ? `## 创作约束\n${input.constraints}` : undefined,
+    ].filter((section) => Boolean(section?.trim()));
+    if (sections.length === 0) {
+        return undefined;
+    }
+    return sections.join("\n\n");
+}
+async function withBookMutationLock(state, bookId, task) {
+    const releaseLock = await state.acquireBookLock(bookId);
+    try {
+        return await task();
+    }
+    finally {
+        await releaseLock();
+    }
+}
+export function buildChapterFileLookup(files) {
+    const lookup = new Map();
+    for (const file of files) {
+        if (!file.endsWith(".md") || !/^\d{4}/.test(file)) {
+            continue;
+        }
+        const chapterNumber = parseInt(file.slice(0, 4), 10);
+        if (!lookup.has(chapterNumber)) {
+            lookup.set(chapterNumber, file);
+        }
+    }
+    return lookup;
+}
+async function exportBookToPath(state, bookId, options) {
+    return writeExportArtifact(state, bookId, options);
+}
+function mapStageMessageToStatus(message) {
+    const lower = message.trim().toLowerCase();
+    if (lower.includes("planning next chapter")
+        || lower.includes("generating foundation")
+        || lower.includes("reviewing foundation")
+        || lower.includes("preparing chapter inputs")
+        || message.includes("规划下一章意图")
+        || message.includes("生成基础设定")
+        || message.includes("审核基础设定")
+        || message.includes("准备章节输入")) {
+        return "planning";
+    }
+    if (lower.includes("composing chapter runtime context")
+        || message.includes("组装章节运行时上下文")) {
+        return "composing";
+    }
+    if (lower.includes("writing chapter draft")
+        || message.includes("撰写章节草稿")) {
+        return "writing";
+    }
+    if (lower.includes("auditing draft")
+        || message.includes("审计草稿")) {
+        return "assessing";
+    }
+    if (lower.includes("fixing")
+        || lower.includes("revising chapter")
+        || lower.includes("rewrite")
+        || lower.includes("repair")
+        || message.includes("自动修复")
+        || message.includes("整章改写")
+        || message.includes("修订第")) {
+        return "repairing";
+    }
+    if (lower.includes("persist")
+        || lower.includes("saving")
+        || lower.includes("snapshot")
+        || lower.includes("rebuilding final truth files")
+        || lower.includes("validating truth file updates")
+        || lower.includes("syncing memory indexes")
+        || message.includes("落盘")
+        || message.includes("保存")
+        || message.includes("快照")
+        || message.includes("校验真相文件变更")
+        || message.includes("生成最终真相文件")
+        || message.includes("同步记忆索引")) {
+        return "persisting";
+    }
+    return undefined;
+}
+function extractStageDetail(message) {
+    if (message.startsWith("Stage: ")) {
+        return message.slice("Stage: ".length).trim();
+    }
+    if (message.startsWith("阶段：")) {
+        return message.slice("阶段：".length).trim();
+    }
+    return undefined;
+}
+function createInteractionLogger(original, events, bookId) {
+    const emit = (level, message) => {
+        const stageDetail = extractStageDetail(message);
+        const stageStatus = stageDetail ? mapStageMessageToStatus(stageDetail) : undefined;
+        if (stageDetail && stageStatus) {
+            events.push({
+                kind: "stage.changed",
+                timestamp: Date.now(),
+                status: stageStatus,
+                bookId,
+                detail: stageDetail,
+            });
+            return;
+        }
+        if (level === "warn") {
+            events.push({
+                kind: "task.warning",
+                timestamp: Date.now(),
+                status: "blocked",
+                bookId,
+                detail: message,
+            });
+            return;
+        }
+        if (level === "error") {
+            events.push({
+                kind: "task.failed",
+                timestamp: Date.now(),
+                status: "failed",
+                bookId,
+                detail: message,
+            });
+        }
+    };
+    const wrap = (base) => ({
+        debug: (msg, ctx) => {
+            emit("debug", msg);
+            base?.debug(msg, ctx);
+        },
+        info: (msg, ctx) => {
+            emit("info", msg);
+            base?.info(msg, ctx);
+        },
+        warn: (msg, ctx) => {
+            emit("warn", msg);
+            base?.warn(msg, ctx);
+        },
+        error: (msg, ctx) => {
+            emit("error", msg);
+            base?.error(msg, ctx);
+        },
+        child: (tag, extraCtx) => wrap(base?.child(tag, extraCtx)),
+    });
+    return wrap(original);
+}
+async function withPipelineInteractionTelemetry(pipeline, bookId, executor) {
+    const events = [];
+    const originalLogger = pipeline.config?.logger;
+    if (pipeline.config) {
+        pipeline.config.logger = createInteractionLogger(originalLogger, events, bookId);
+    }
+    try {
+        const result = await executor();
+        return {
+            ...result,
+            __interaction: {
+                events,
+                ...(typeof result.chapterNumber === "number"
+                    ? { activeChapterNumber: result.chapterNumber }
+                    : {}),
+            },
+        };
+    }
+    finally {
+        if (pipeline.config) {
+            pipeline.config.logger = originalLogger;
+        }
+    }
+}
+export function createInteractionToolsFromDeps(pipeline, state, hooks) {
+    const instrumentedPipeline = pipeline;
+    return {
+        listBooks: () => state.listBooks(),
+        createBook: async (input) => {
+            const book = buildBookConfig(input);
+            if (!pipeline.initBook) {
+                throw new Error("Pipeline does not support shared book creation.");
+            }
+            await pipeline.initBook(book, {
+                externalContext: buildCreationExternalContext(input),
+                authorIntent: input.authorIntent,
+                currentFocus: input.currentFocus,
+            });
+            return {
+                bookId: book.id,
+                title: book.title,
+                __interaction: {
+                    responseText: `Created ${book.title} (${book.id}).`,
+                    details: {
+                        kind: "book_created",
+                        bookId: book.id,
+                        title: book.title,
+                    },
+                },
+            };
+        },
+        exportBook: async (bookId, options) => {
+            const result = await exportBookToPath(state, bookId, options);
+            return {
+                ...result,
+                __interaction: {
+                    responseText: `Exported ${bookId} to ${result.outputPath} (${result.chaptersExported} chapters).`,
+                    details: {
+                        outputPath: result.outputPath,
+                        chaptersExported: result.chaptersExported,
+                        totalWords: result.totalWords,
+                        format: result.format,
+                    },
+                },
+            };
+        },
+        chat: async (input, options) => {
+            const bookLabel = options.bookId ?? "none";
+            const chatRequestOptions = hooks?.getChatRequestOptions?.() ?? {};
+            let response;
+            if (instrumentedPipeline.config?.client && instrumentedPipeline.config?.model) {
+                try {
+                    response = await runWorkerAgent(instrumentedPipeline.config.client, instrumentedPipeline.config.model, [
+                        {
+                            role: "system",
+                            content: [
+                                "You are InkOS inside the terminal workbench.",
+                                "Respond conversationally and briefly.",
+                                "If there is no active book, help the user decide what to write next.",
+                                "If there is an active book, keep the answer grounded in that book context.",
+                            ].join(" "),
+                        },
+                        {
+                            role: "user",
+                            content: `activeBook=${bookLabel}\nautomationMode=${options.automationMode}\nmessage=${input}`,
+                        },
+                    ], {
+                        temperature: chatRequestOptions.temperature ?? 0.4,
+                        ...(chatRequestOptions.maxTokens !== undefined && { maxTokens: chatRequestOptions.maxTokens }),
+                        onTextDelta: hooks?.onChatTextDelta,
+                    });
+                }
+                catch (err) {
+                    // Thinking models (e.g. kimi-k2.5) may return empty content for simple inputs.
+                    // Only swallow empty-content errors; re-throw everything else (network, auth, etc.)
+                    const msg = err instanceof Error ? err.message : "";
+                    if (!msg.includes("empty") && !msg.includes("content")) {
+                        throw err;
+                    }
+                }
+            }
+            return {
+                __interaction: {
+                    responseText: response?.content?.trim()
+                        || (options.bookId
+                            ? `I’m here. Active book is ${options.bookId}.`
+                            : "I’m here. No active book yet."),
+                },
+            };
+        },
+        writeNextChapter: (bookId) => withPipelineInteractionTelemetry(instrumentedPipeline, bookId, () => pipeline.writeNextChapter(bookId)),
+        reviseDraft: (bookId, chapterNumber, mode) => withPipelineInteractionTelemetry(instrumentedPipeline, bookId, () => pipeline.reviseDraft(bookId, chapterNumber, mode)),
+        patchChapterText: async (bookId, chapterNumber, targetText, replacementText) => withBookMutationLock(state, bookId, async () => {
+            const execution = await executeEditTransaction({
+                bookDir: (targetBookId) => state.bookDir(targetBookId),
+                loadChapterIndex: (targetBookId) => state.loadChapterIndex(targetBookId),
+                saveChapterIndex: (targetBookId, index) => state.saveChapterIndex(targetBookId, index),
+            }, {
+                kind: "chapter-local-edit",
+                bookId,
+                chapterNumber,
+                instruction: `Replace ${targetText} with ${replacementText}`,
+                targetText,
+                replacementText,
+            });
+            return {
+                __interaction: {
+                    activeChapterNumber: chapterNumber,
+                    responseText: execution.summary,
+                },
+            };
+        }),
+        replaceChapterText: async (bookId, chapterNumber, fullText) => withBookMutationLock(state, bookId, async () => {
+            const execution = await executeEditTransaction({
+                bookDir: (targetBookId) => state.bookDir(targetBookId),
+                loadChapterIndex: (targetBookId) => state.loadChapterIndex(targetBookId),
+                saveChapterIndex: (targetBookId, index) => state.saveChapterIndex(targetBookId, index),
+            }, {
+                kind: "chapter-replace",
+                bookId,
+                chapterNumber,
+                fullText,
+            });
+            return {
+                __interaction: {
+                    activeChapterNumber: chapterNumber,
+                    responseText: execution.summary,
+                },
+            };
+        }),
+        renameEntity: async (bookId, oldValue, newValue) => withBookMutationLock(state, bookId, async () => {
+            const execution = await executeEditTransaction({
+                bookDir: (targetBookId) => state.bookDir(targetBookId),
+                loadChapterIndex: (targetBookId) => state.loadChapterIndex(targetBookId),
+                saveChapterIndex: (targetBookId, index) => state.saveChapterIndex(targetBookId, index),
+            }, {
+                kind: "entity-rename",
+                bookId,
+                entityType: "character",
+                oldValue,
+                newValue,
+            });
+            return {
+                __interaction: {
+                    responseText: execution.summary,
+                },
+            };
+        }),
+        updateCurrentFocus: async (bookId, content) => withBookMutationLock(state, bookId, async () => {
+            await state.ensureControlDocuments(bookId);
+            await writeFile(join(state.bookDir(bookId), "story", "current_focus.md"), content, "utf-8");
+        }),
+        updateAuthorIntent: async (bookId, content) => withBookMutationLock(state, bookId, async () => {
+            await state.ensureControlDocuments(bookId);
+            await writeFile(join(state.bookDir(bookId), "story", "author_intent.md"), content, "utf-8");
+        }),
+        writeTruthFile: async (bookId, fileName, content) => withBookMutationLock(state, bookId, async () => {
+            await state.ensureControlDocuments(bookId);
+            const storyDir = join(state.bookDir(bookId), "story");
+            const safeFileName = assertSafeTruthFileName(fileName);
+            const targetPath = safeChildPath(storyDir, safeFileName);
+            await mkdir(dirname(targetPath), { recursive: true });
+            await writeFile(targetPath, content, "utf-8");
+        }),
+    };
+}
+//# sourceMappingURL=project-tools.js.map

package/dist/interaction/project-tools.js.map

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

package/dist/interaction/request-router.d.ts

@@ -0,0 +1,3 @@
+import { type InteractionRequest } from "./intents.js";
+export declare function routeInteractionRequest(input: InteractionRequest): InteractionRequest;
+//# sourceMappingURL=request-router.d.ts.map

package/dist/interaction/request-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-router.d.ts","sourceRoot":"","sources":["../../src/interaction/request-router.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEjF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,kBAAkB,GAAG,kBAAkB,CAErF"}

package/dist/interaction/request-router.js

@@ -0,0 +1,5 @@
+import { InteractionRequestSchema } from "./intents.js";
+export function routeInteractionRequest(input) {
+    return InteractionRequestSchema.parse(input);
+}
+//# sourceMappingURL=request-router.js.map

package/dist/interaction/request-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-router.js","sourceRoot":"","sources":["../../src/interaction/request-router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAA2B,MAAM,cAAc,CAAC;AAEjF,MAAM,UAAU,uBAAuB,CAAC,KAAyB;IAC/D,OAAO,wBAAwB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC/C,CAAC"}

package/dist/interaction/runtime.d.ts

@@ -0,0 +1,54 @@
+import type { AutomationMode } from "./modes.js";
+import type { InteractionRequest } from "./intents.js";
+import type { InteractionSession } from "./session.js";
+type ReviseMode = "local-fix" | "rewrite";
+export interface InteractionRuntimeTools {
+    readonly listBooks: () => Promise<ReadonlyArray<string>>;
+    readonly createBook?: (input: {
+        readonly title: string;
+        readonly genre?: string;
+        readonly platform?: string;
+        readonly language?: "zh" | "en";
+        readonly chapterWordCount?: number;
+        readonly targetChapters?: number;
+        readonly blurb?: string;
+        readonly worldPremise?: string;
+        readonly settingNotes?: string;
+        readonly protagonist?: string;
+        readonly supportingCast?: string;
+        readonly conflictCore?: string;
+        readonly volumeOutline?: string;
+        readonly constraints?: string;
+        readonly authorIntent?: string;
+        readonly currentFocus?: string;
+    }) => Promise<unknown>;
+    readonly exportBook?: (bookId: string, options: {
+        readonly format?: "txt" | "md" | "epub";
+        readonly approvedOnly?: boolean;
+        readonly outputPath?: string;
+    }) => Promise<unknown>;
+    readonly chat?: (input: string, options: {
+        readonly bookId?: string;
+        readonly automationMode: AutomationMode;
+    }) => Promise<unknown>;
+    readonly writeNextChapter: (bookId: string) => Promise<unknown>;
+    readonly reviseDraft: (bookId: string, chapterNumber: number, mode: ReviseMode) => Promise<unknown>;
+    readonly patchChapterText: (bookId: string, chapterNumber: number, targetText: string, replacementText: string) => Promise<unknown>;
+    readonly replaceChapterText: (bookId: string, chapterNumber: number, fullText: string) => Promise<unknown>;
+    readonly renameEntity: (bookId: string, oldValue: string, newValue: string) => Promise<unknown>;
+    readonly updateCurrentFocus: (bookId: string, content: string) => Promise<unknown>;
+    readonly updateAuthorIntent: (bookId: string, content: string) => Promise<unknown>;
+    readonly writeTruthFile: (bookId: string, fileName: string, content: string) => Promise<unknown>;
+}
+export interface InteractionRuntimeResult {
+    readonly session: InteractionSession;
+    readonly responseText?: string;
+    readonly details?: Readonly<Record<string, unknown>>;
+}
+export declare function runInteractionRequest(params: {
+    readonly session: InteractionSession;
+    readonly request: InteractionRequest;
+    readonly tools: InteractionRuntimeTools;
+}): Promise<InteractionRuntimeResult>;
+export {};
+//# sourceMappingURL=runtime.d.ts.map

package/dist/interaction/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/interaction/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,KAAK,EAAmB,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAUxE,KAAK,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAG1C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;QAChC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;KAChC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;QAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;QACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;QAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;KAC9B,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,CACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QACP,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;KACzC,KACE,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,QAAQ,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAChE,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpG,QAAQ,CAAC,gBAAgB,EAAE,CACzB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,KACpB,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,QAAQ,CAAC,kBAAkB,EAAE,CAC3B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,CACrB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,QAAQ,CAAC,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnF,QAAQ,CAAC,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnF,QAAQ,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAClG;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAkbD,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;CACzC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAinBpC"}