@actalk/inkos-studio 1.1.1 → 1.2.0

package/dist/api/errors.d.ts

@@ -7,5 +7,4 @@ export declare class ApiError extends Error {
     readonly code: string;
     constructor(status: number, code: string, message: string);
 }
-export declare function isMissingFileError(error: unknown): boolean;
 //# sourceMappingURL=errors.d.ts.map

package/dist/api/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/api/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAM1D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE1D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/api/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAM1D"}

package/dist/api/errors.js

@@ -12,7 +12,4 @@ export class ApiError extends Error {
         this.code = code;
     }
 }
-export function isMissingFileError(error) {
-    return error?.code === "ENOENT";
-}
 //# sourceMappingURL=errors.js.map

package/dist/api/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/api/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,MAAM,CAAS;IACf,IAAI,CAAS;IAEtB,YAAY,MAAc,EAAE,IAAY,EAAE,OAAe;QACvD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAQ,KAA2C,EAAE,IAAI,KAAK,QAAQ,CAAC;AACzE,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/api/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,MAAM,CAAS;IACf,IAAI,CAAS;IAEtB,YAAY,MAAc,EAAE,IAAY,EAAE,OAAe;QACvD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/api/safety.d.ts

@@ -1,31 +1,3 @@
-/**
- * Security validation utilities for Studio API.
- * Ported from PR #97 (PapainTea) — ReDoS prevention, path traversal, port parsing.
- */
-/** Validates fileId against whitelist to prevent path traversal. */
-export declare function isSafeUploadFileId(fileId: string): boolean;
 /** Validates bookId — blocks traversal sequences and null bytes. */
 export declare function isSafeBookId(bookId: string): boolean;
-/**
- * Builds a regex from user-provided pattern with ReDoS prevention.
- * Blocks grouping, alternation, backreferences, and lookahead/behind.
- */
-export declare function buildImportRegex(pattern: string): RegExp;
-/** Strips filesystem paths from upload responses — only returns relative/safe fields. */
-export declare function createUploadResponse(input: {
-    readonly fileId: string;
-    readonly size: number;
-    readonly chapterCount: number;
-    readonly firstTitle: string;
-    readonly totalChars: number;
-}): {
-    readonly ok: true;
-    readonly fileId: string;
-    readonly size: number;
-    readonly chapterCount: number;
-    readonly firstTitle: string;
-    readonly totalChars: number;
-};
-/** Parses port from environment with safe fallback. */
-export declare function resolveServerPort(env?: Record<string, string | undefined>): number;
 //# sourceMappingURL=safety.d.ts.map

package/dist/api/safety.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"safety.d.ts","sourceRoot":"","sources":["../../src/api/safety.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,oEAAoE;AACpE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAUpD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAoBxD;AAED,yFAAyF;AACzF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,GAAG;IACF,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CASA;AAED,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,MAAM,CAI/F"}
+{"version":3,"file":"safety.d.ts","sourceRoot":"","sources":["../../src/api/safety.ts"],"names":[],"mappings":"AAEA,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAUpD"}

package/dist/api/safety.js

@@ -1,14 +1,4 @@
-/**
- * Security validation utilities for Studio API.
- * Ported from PR #97 (PapainTea) — ReDoS prevention, path traversal, port parsing.
- */
-const SAFE_UPLOAD_FILE_ID = /^[A-Za-z0-9-]{1,64}$/;
-const MAX_IMPORT_PATTERN_LENGTH = 160;
-const SAFE_IMPORT_PATTERN = /^[\p{L}\p{N}\s[\]\\.^$*+?{}\-，。:：、_]+$/u;
-/** Validates fileId against whitelist to prevent path traversal. */
-export function isSafeUploadFileId(fileId) {
-    return typeof fileId === "string" && SAFE_UPLOAD_FILE_ID.test(fileId);
-}
+// Validates book IDs to prevent path traversal in API requests.
 /** Validates bookId — blocks traversal sequences and null bytes. */
 export function isSafeBookId(bookId) {
     return (typeof bookId === "string"
@@ -19,46 +9,4 @@ export function isSafeBookId(bookId) {
         && !bookId.includes("..")
         && !/[\\/\0]/.test(bookId));
 }
-/**
- * Builds a regex from user-provided pattern with ReDoS prevention.
- * Blocks grouping, alternation, backreferences, and lookahead/behind.
- */
-export function buildImportRegex(pattern) {
-    const normalized = String(pattern ?? "").trim();
-    if (!normalized) {
-        throw new Error("Import pattern is required");
-    }
-    if (normalized.length > MAX_IMPORT_PATTERN_LENGTH) {
-        throw new Error(`Import pattern too long (max ${MAX_IMPORT_PATTERN_LENGTH} chars)`);
-    }
-    if (/[()|]/.test(normalized) || /\\[1-9]/.test(normalized) || normalized.includes("(?")) {
-        throw new Error("Import pattern uses unsafe regex features");
-    }
-    if (!SAFE_IMPORT_PATTERN.test(normalized)) {
-        throw new Error("Import pattern is invalid");
-    }
-    try {
-        return new RegExp(normalized, "g");
-    }
-    catch {
-        throw new Error("Import pattern is invalid");
-    }
-}
-/** Strips filesystem paths from upload responses — only returns relative/safe fields. */
-export function createUploadResponse(input) {
-    return {
-        ok: true,
-        fileId: input.fileId,
-        size: input.size,
-        chapterCount: input.chapterCount,
-        firstTitle: input.firstTitle,
-        totalChars: input.totalChars,
-    };
-}
-/** Parses port from environment with safe fallback. */
-export function resolveServerPort(env = process.env) {
-    const raw = env.INKOS_STUDIO_PORT ?? env.PORT ?? "4567";
-    const parsed = Number.parseInt(raw, 10);
-    return Number.isFinite(parsed) && parsed > 0 ? parsed : 4567;
-}
 //# sourceMappingURL=safety.js.map

package/dist/api/safety.js.map

@@ -1 +1 @@
-{"version":3,"file":"safety.js","sourceRoot":"","sources":["../../src/api/safety.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AACnD,MAAM,yBAAyB,GAAG,GAAG,CAAC;AACtC,MAAM,mBAAmB,GAAG,yCAAyC,CAAC;AAEtE,oEAAoE;AACpE,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACxE,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;WACvB,MAAM,CAAC,MAAM,GAAG,CAAC;WACjB,MAAM,CAAC,IAAI,EAAE,KAAK,MAAM;WACxB,MAAM,KAAK,GAAG;WACd,MAAM,KAAK,IAAI;WACf,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;WACtB,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAC3B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAChD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,GAAG,yBAAyB,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,gCAAgC,yBAAyB,SAAS,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxF,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,oBAAoB,CAAC,KAMpC;IAQC,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC;AACJ,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,iBAAiB,CAAC,MAA0C,OAAO,CAAC,GAAG;IACrF,MAAM,GAAG,GAAG,GAAG,CAAC,iBAAiB,IAAI,GAAG,CAAC,IAAI,IAAI,MAAM,CAAC;IACxD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACxC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"safety.js","sourceRoot":"","sources":["../../src/api/safety.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAEhE,oEAAoE;AACpE,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;WACvB,MAAM,CAAC,MAAM,GAAG,CAAC;WACjB,MAAM,CAAC,IAAI,EAAE,KAAK,MAAM;WACxB,MAAM,KAAK,GAAG;WACd,MAAM,KAAK,IAAI;WACf,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;WACtB,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAC3B,CAAC;AACJ,CAAC"}

package/dist/api/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/api/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,OAAO,EAQL,KAAK,aAAa,EAGnB,MAAM,oBAAoB,CAAC;AAqB5B,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,8EAkuC5E;AAID,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,SAAO,EACX,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC,IAAI,CAAC,CA8Cf"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/api/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,OAAO,EAaL,KAAK,aAAa,EAGnB,MAAM,oBAAoB,CAAC;AAqB5B,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,8EAswC5E;AAID,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,SAAO,EACX,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC,IAAI,CAAC,CA8Cf"}

package/dist/api/server.js

@@ -2,7 +2,7 @@ import { Hono } from "hono";
 import { cors } from "hono/cors";
 import { streamSSE } from "hono/streaming";
 import { serve } from "@hono/node-server";
-import { StateManager, PipelineRunner, createLLMClient, createLogger, computeAnalytics, loadProjectConfig, } from "@actalk/inkos-core";
+import { StateManager, PipelineRunner, createLLMClient, createLogger, createInteractionToolsFromDeps, computeAnalytics, loadProjectConfig, loadProjectSession, processProjectInteractionInput, processProjectInteractionRequest, resolveSessionActiveBook, } from "@actalk/inkos-core";
 import { access, readFile, readdir } from "node:fs/promises";
 import { join } from "node:path";
 import { isSafeBookId } from "./safety.js";
@@ -54,7 +54,7 @@ export function createStudioServer(initialConfig, root) {
         cachedConfig = freshConfig;
         return freshConfig;
     }
-    async function buildPipelineConfig() {
+    async function buildPipelineConfig(overrides) {
         const currentConfig = await loadCurrentProjectConfig();
         const logger = createLogger({ tag: "studio", sinks: [sseSink] });
         return {
@@ -74,6 +74,7 @@ export function createStudioServer(initialConfig, root) {
                     });
                 }
             },
+            externalContext: overrides?.externalContext,
         };
     }
     // --- Books ---
@@ -131,9 +132,23 @@ export function createStudioServer(initialConfig, root) {
         broadcast("book:creating", { bookId, title: body.title });
         bookCreateStatus.set(bookId, { status: "creating" });
         const pipeline = new PipelineRunner(await buildPipelineConfig());
-        pipeline.initBook(bookConfig).then(() => {
-            bookCreateStatus.delete(bookId);
-            broadcast("book:created", { bookId });
+        const tools = createInteractionToolsFromDeps(pipeline, state);
+        processProjectInteractionRequest({
+            projectRoot: root,
+            request: {
+                intent: "create_book",
+                title: body.title,
+                genre: body.genre,
+                language: body.language === "en" ? "en" : body.language === "zh" ? "zh" : undefined,
+                platform: body.platform,
+                chapterWordCount: body.chapterWordCount,
+                targetChapters: body.targetChapters,
+            },
+            tools,
+        }).then((result) => {
+            const createdBookId = result.details?.bookId ?? result.session.activeBookId ?? bookId;
+            bookCreateStatus.delete(createdBookId);
+            broadcast("book:created", { bookId: createdBookId });
         }, (e) => {
             const error = e instanceof Error ? e.message : String(e);
             bookCreateStatus.set(bookId, { status: "error", error });
@@ -266,9 +281,19 @@ export function createStudioServer(initialConfig, root) {
         const num = parseInt(c.req.param("num"), 10);
         try {
             const index = await state.loadChapterIndex(id);
-            const updated = index.map((ch) => ch.number === num ? { ...ch, status: "rejected" } : ch);
-            await state.saveChapterIndex(id, updated);
-            return c.json({ ok: true, chapterNumber: num, status: "rejected" });
+            const target = index.find((ch) => ch.number === num);
+            if (!target) {
+                return c.json({ error: `Chapter ${num} not found` }, 404);
+            }
+            const rollbackTarget = num - 1;
+            const discarded = await state.rollbackToChapter(id, rollbackTarget);
+            return c.json({
+                ok: true,
+                chapterNumber: num,
+                status: "rejected",
+                rolledBackTo: rollbackTarget,
+                discarded,
+            });
         }
         catch (e) {
             return c.json({ error: String(e) }, 500);
@@ -434,22 +459,44 @@ export function createStudioServer(initialConfig, root) {
         }
     });
     // --- Agent chat ---
+    app.get("/api/interaction/session", async (c) => {
+        const session = await loadProjectSession(root);
+        const activeBookId = await resolveSessionActiveBook(root, session);
+        return c.json({
+            session: activeBookId && session.activeBookId !== activeBookId
+                ? { ...session, activeBookId }
+                : session,
+            activeBookId,
+        });
+    });
     app.post("/api/agent", async (c) => {
-        const { instruction } = await c.req.json();
+        const { instruction, activeBookId } = await c.req.json();
         if (!instruction?.trim()) {
             return c.json({ error: "No instruction provided" }, 400);
         }
-        broadcast("agent:start", { instruction });
+        broadcast("agent:start", { instruction, activeBookId });
         try {
-            const { runAgentLoop } = await import("@actalk/inkos-core");
-            const result = await runAgentLoop(await buildPipelineConfig(), instruction);
-            broadcast("agent:complete", { instruction, response: result });
-            return c.json({ response: result });
+            const pipeline = new PipelineRunner(await buildPipelineConfig());
+            const tools = createInteractionToolsFromDeps(pipeline, state);
+            const result = await processProjectInteractionInput({
+                projectRoot: root,
+                input: instruction,
+                tools,
+                activeBookId,
+            });
+            const response = result.responseText ?? "Acknowledged.";
+            broadcast("agent:complete", { instruction, activeBookId, response });
+            return c.json({ response, session: result.session, request: result.request });
         }
         catch (e) {
             const msg = e instanceof Error ? e.message : String(e);
-            broadcast("agent:error", { instruction, error: msg });
-            return c.json({ response: msg });
+            broadcast("agent:error", { instruction, activeBookId, error: msg });
+            return c.json({
+                error: {
+                    code: "INTERACTION_ERROR",
+                    message: msg,
+                },
+            }, 500);
         }
     });
     // --- Language setup ---
@@ -505,7 +552,9 @@ export function createStudioServer(initialConfig, root) {
         const id = c.req.param("id");
         const chapterNum = parseInt(c.req.param("chapter"), 10);
         const bookDir = state.bookDir(id);
-        const body = await c.req.json().catch(() => ({ mode: "spot-fix" }));
+        const body = await c.req
+            .json()
+            .catch(() => ({ mode: "spot-fix", brief: undefined }));
         broadcast("revise:start", { bookId: id, chapter: chapterNum });
         try {
             const book = await state.loadBookConfig(id);
@@ -515,25 +564,11 @@ export function createStudioServer(initialConfig, root) {
             const match = files.find((f) => f.startsWith(paddedNum) && f.endsWith(".md"));
             if (!match)
                 return c.json({ error: "Chapter not found" }, 404);
-            const content = await readFile(join(chaptersDir, match), "utf-8");
-            // Get audit issues first
-            const index = await state.loadChapterIndex(id);
-            const chapterMeta = index.find((ch) => ch.number === chapterNum);
-            const issues = (chapterMeta?.auditIssues ?? []).map((desc) => ({
-                severity: "warning",
-                category: "general",
-                description: desc,
-                suggestion: "",
+            const pipeline = new PipelineRunner(await buildPipelineConfig({
+                externalContext: body.brief,
             }));
-            const currentConfig = await loadCurrentProjectConfig();
-            const { ReviserAgent } = await import("@actalk/inkos-core");
-            const reviser = new ReviserAgent({
-                client: createLLMClient(currentConfig.llm),
-                model: currentConfig.llm.model,
-                projectRoot: root,
-                bookId: id,
-            });
-            const result = await reviser.reviseChapter(bookDir, content, chapterNum, issues, (body.mode ?? "spot-fix"), book.genre);
+            const normalizedMode = body.mode ?? "spot-fix";
+            const result = await pipeline.reviseDraft(id, chapterNum, normalizedMode);
             broadcast("revise:complete", { bookId: id, chapter: chapterNum });
             return c.json(result);
         }
@@ -602,43 +637,30 @@ export function createStudioServer(initialConfig, root) {
     app.post("/api/books/:id/export-save", async (c) => {
         const id = c.req.param("id");
         const { format, approvedOnly } = await c.req.json().catch(() => ({ format: "txt", approvedOnly: false }));
-        const bookDir = state.bookDir(id);
-        const chaptersDir = join(bookDir, "chapters");
         const fmt = format ?? "txt";
         try {
-            const book = await state.loadBookConfig(id);
-            const index = await state.loadChapterIndex(id);
-            const approvedNums = new Set(approvedOnly ? index.filter((ch) => ch.status === "approved").map((ch) => ch.number) : []);
-            const files = await readdir(chaptersDir);
-            const mdFiles = files.filter((f) => f.endsWith(".md") && /^\d{4}/.test(f)).sort();
-            const filteredFiles = approvedOnly
-                ? mdFiles.filter((f) => approvedNums.has(parseInt(f.slice(0, 4), 10)))
-                : mdFiles;
-            const contents = await Promise.all(filteredFiles.map((f) => readFile(join(chaptersDir, f), "utf-8")));
-            const { writeFile: writeFileFs } = await import("node:fs/promises");
-            let outputPath;
-            let body;
-            if (fmt === "md") {
-                body = contents.join("\n\n---\n\n");
-                outputPath = join(bookDir, `${id}.md`);
-            }
-            else if (fmt === "epub") {
-                const chapters = contents.map((content, i) => {
-                    const title = content.match(/^#\s+(.+)$/m)?.[1] ?? `Chapter ${i + 1}`;
-                    const html = content.split("\n").filter((l) => !l.startsWith("#")).map((l) => l.trim() ? `<p>${l}</p>` : "").join("\n");
-                    return { title, html };
-                });
-                const toc = chapters.map((ch, i) => `<li><a href="#ch${i}">${ch.title}</a></li>`).join("\n");
-                const chapterHtml = chapters.map((ch, i) => `<h2 id="ch${i}">${ch.title}</h2>\n${ch.html}`).join("\n<hr/>\n");
-                body = `<!DOCTYPE html><html><head><meta charset="utf-8"><title>${book.title}</title><style>body{font-family:serif;max-width:40em;margin:auto;padding:2em;line-height:1.8}h2{margin-top:3em}</style></head><body><h1>${book.title}</h1><nav><ol>${toc}</ol></nav><hr/>${chapterHtml}</body></html>`;
-                outputPath = join(bookDir, `${id}.html`);
-            }
-            else {
-                body = contents.join("\n\n");
-                outputPath = join(bookDir, `${id}.txt`);
-            }
-            await writeFileFs(outputPath, body, "utf-8");
-            return c.json({ ok: true, path: outputPath, format: fmt, chapters: filteredFiles.length });
+            const pipeline = new PipelineRunner(await buildPipelineConfig());
+            const tools = createInteractionToolsFromDeps(pipeline, state);
+            const bookDir = state.bookDir(id);
+            const outputPath = join(bookDir, `${id}.${fmt === "epub" ? "epub" : fmt}`);
+            const result = await processProjectInteractionRequest({
+                projectRoot: root,
+                request: {
+                    intent: "export_book",
+                    bookId: id,
+                    format: fmt,
+                    approvedOnly,
+                    outputPath,
+                },
+                tools,
+                activeBookId: id,
+            });
+            return c.json({
+                ok: true,
+                path: result.details?.outputPath ?? outputPath,
+                format: fmt,
+                chapters: result.details?.chaptersExported ?? 0,
+            });
         }
         catch (e) {
             return c.json({ error: String(e) }, 500);
@@ -779,21 +801,41 @@ export function createStudioServer(initialConfig, root) {
     app.post("/api/books/:id/rewrite/:chapter", async (c) => {
         const id = c.req.param("id");
         const chapterNum = parseInt(c.req.param("chapter"), 10);
+        const body = await c.req
+            .json()
+            .catch(() => ({}));
         broadcast("rewrite:start", { bookId: id, chapter: chapterNum });
         try {
-            const restored = await state.restoreState(id, chapterNum);
-            if (!restored) {
-                return c.json({ error: `Cannot restore state to chapter ${chapterNum}` }, 400);
-            }
-            const pipeline = new PipelineRunner(await buildPipelineConfig());
+            const rollbackTarget = chapterNum - 1;
+            const discarded = await state.rollbackToChapter(id, rollbackTarget);
+            const pipeline = new PipelineRunner(await buildPipelineConfig({
+                externalContext: body.brief,
+            }));
             pipeline.writeNextChapter(id).then((result) => broadcast("rewrite:complete", { bookId: id, chapterNumber: result.chapterNumber, title: result.title, wordCount: result.wordCount }), (e) => broadcast("rewrite:error", { bookId: id, error: e instanceof Error ? e.message : String(e) }));
-            return c.json({ status: "rewriting", bookId: id, chapter: chapterNum });
+            return c.json({ status: "rewriting", bookId: id, chapter: chapterNum, rolledBackTo: rollbackTarget, discarded });
         }
         catch (e) {
             broadcast("rewrite:error", { bookId: id, error: String(e) });
             return c.json({ error: String(e) }, 500);
         }
     });
+    app.post("/api/books/:id/resync/:chapter", async (c) => {
+        const id = c.req.param("id");
+        const chapterNum = parseInt(c.req.param("chapter"), 10);
+        const body = await c.req
+            .json()
+            .catch(() => ({}));
+        try {
+            const pipeline = new PipelineRunner(await buildPipelineConfig({
+                externalContext: body.brief,
+            }));
+            const result = await pipeline.resyncChapterArtifacts(id, chapterNum);
+            return c.json(result);
+        }
+        catch (e) {
+            return c.json({ error: String(e) }, 500);
+        }
+    });
     // --- Detect All chapters ---
     app.post("/api/books/:id/detect-all", async (c) => {
         const id = c.req.param("id");