zqy-story-studio 0.0.1

package/dist/api/book-create.d.ts

@@ -0,0 +1,40 @@
+import { type Platform } from "zqy-story-core";
+export interface StudioCreateBookBody {
+    readonly title: string;
+    readonly genre: string;
+    readonly language?: string;
+    readonly platform?: string;
+    readonly chapterWordCount?: number;
+    readonly targetChapters?: number;
+    readonly blurb?: string;
+}
+export interface StudioBookConfigDraft {
+    readonly id: string;
+    readonly title: string;
+    readonly platform: Platform;
+    readonly genre: string;
+    readonly status: "outlining";
+    readonly targetChapters: number;
+    readonly chapterWordCount: number;
+    readonly language?: "zh" | "en";
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+interface StudioBookDetail {
+    readonly book: {
+        readonly id: string;
+    };
+    readonly chapters: ReadonlyArray<unknown>;
+    readonly nextChapter: number;
+}
+interface WaitForStudioBookReadyOptions {
+    readonly fetchImpl?: typeof fetch;
+    readonly wait?: (delayMs: number) => Promise<void>;
+    readonly maxAttempts?: number;
+    readonly retryDelayMs?: number;
+}
+export declare function normalizeStudioPlatform(platform?: string): Platform;
+export declare function buildStudioBookConfig(body: StudioCreateBookBody, now: string): StudioBookConfigDraft;
+export declare function waitForStudioBookReady(bookId: string, options?: WaitForStudioBookReadyOptions): Promise<StudioBookDetail>;
+export {};
+//# sourceMappingURL=book-create.d.ts.map

package/dist/api/book-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"book-create.d.ts","sourceRoot":"","sources":["../../src/api/book-create.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,UAAU,gBAAgB;IACxB,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,UAAU,6BAA6B;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAEnE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,EAAE,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAqBpG;AAMD,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAAC,gBAAgB,CAAC,CAqB3B"}

package/dist/api/book-create.js

@@ -0,0 +1,48 @@
+import { normalizePlatformOrOther } from "zqy-story-core";
+export function normalizeStudioPlatform(platform) {
+    return normalizePlatformOrOther(platform);
+}
+export function buildStudioBookConfig(body, now) {
+    return {
+        id: body.title
+            .toLowerCase()
+            .replace(/[^a-z0-9\u4e00-\u9fff]/g, "-")
+            .replace(/-+/g, "-")
+            .slice(0, 30),
+        title: body.title,
+        platform: normalizeStudioPlatform(body.platform),
+        genre: body.genre,
+        status: "outlining",
+        targetChapters: body.targetChapters ?? 200,
+        chapterWordCount: body.chapterWordCount ?? 3000,
+        ...(body.language === "en"
+            ? { language: "en" }
+            : body.language === "zh"
+                ? { language: "zh" }
+                : {}),
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+function defaultWait(delayMs) {
+    return new Promise((resolve) => setTimeout(resolve, delayMs));
+}
+export async function waitForStudioBookReady(bookId, options = {}) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const wait = options.wait ?? defaultWait;
+    const maxAttempts = options.maxAttempts ?? 5;
+    const retryDelayMs = options.retryDelayMs ?? 150;
+    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+        const response = await fetchImpl(`/api/v1/books/${encodeURIComponent(bookId)}`);
+        if (response.ok) {
+            return await response.json();
+        }
+        if (attempt < maxAttempts && response.status === 404) {
+            await wait(retryDelayMs);
+            continue;
+        }
+        break;
+    }
+    throw new Error(`Book "${bookId}" was not ready after ${maxAttempts} attempts.`);
+}
+//# sourceMappingURL=book-create.js.map

package/dist/api/book-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"book-create.js","sourceRoot":"","sources":["../../src/api/book-create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAiB,MAAM,gBAAgB,CAAC;AAsCzE,MAAM,UAAU,uBAAuB,CAAC,QAAiB;IACvD,OAAO,wBAAwB,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAA0B,EAAE,GAAW;IAC3E,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,KAAK;aACX,WAAW,EAAE;aACb,OAAO,CAAC,yBAAyB,EAAE,GAAG,CAAC;aACvC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;aACnB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,uBAAuB,CAAC,IAAI,CAAC,QAAQ,CAAC;QAChD,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,WAAW;QACnB,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,GAAG;QAC1C,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,IAAI;QAC/C,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI;YACxB,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAa,EAAE;YAC7B,CAAC,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI;gBACtB,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAa,EAAE;gBAC7B,CAAC,CAAC,EAAE,CAAC;QACT,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;KACf,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAc,EACd,UAAyC,EAAE;IAE3C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;IACzC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,GAAG,CAAC;IAEjD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAC3D,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,iBAAiB,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAChF,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YAChB,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAsB,CAAC;QACnD,CAAC;QAED,IAAI,OAAO,GAAG,WAAW,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACrD,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC;YACzB,SAAS;QACX,CAAC;QAED,MAAM;IACR,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,SAAS,MAAM,yBAAyB,WAAW,YAAY,CAAC,CAAC;AACnF,CAAC"}

package/dist/api/errors.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Structured API error handling.
+ * Ported from PR #96 (Te9ui1a) — typed error codes for consistent JSON responses.
+ */
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +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"}

package/dist/api/errors.js

@@ -0,0 +1,15 @@
+/**
+ * Structured API error handling.
+ * Ported from PR #96 (Te9ui1a) — typed error codes for consistent JSON responses.
+ */
+export class ApiError extends Error {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message);
+        this.name = "ApiError";
+        this.status = status;
+        this.code = code;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/api/errors.js.map

@@ -0,0 +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"}

package/dist/api/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":""}

package/dist/api/index.js

@@ -0,0 +1,27 @@
+import { startStudioServer } from "./server.js";
+import { resolve, join, dirname } from "node:path";
+import { existsSync } from "node:fs";
+import { execSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const root = resolve(process.argv[2] ?? process.env.INKOS_PROJECT_ROOT ?? process.cwd());
+const port = parseInt(process.env.INKOS_STUDIO_PORT ?? "4567", 10);
+// Find studio package root (2 levels up from src/api/)
+const studioRoot = resolve(__dirname, "../..");
+const distDir = join(studioRoot, "dist");
+// Auto-build frontend if dist/ doesn't exist
+if (!existsSync(join(distDir, "index.html"))) {
+    console.log("Building frontend...");
+    try {
+        execSync("npx vite build", { cwd: studioRoot, stdio: "inherit" });
+    }
+    catch {
+        console.error("Failed to build frontend. Run 'cd packages/studio && pnpm build' manually.");
+        process.exit(1);
+    }
+}
+startStudioServer(root, port, { staticDir: distDir }).catch((e) => {
+    console.error("Failed to start studio:", e);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACzF,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;AAEnE,uDAAuD;AACvD,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAEzC,6CAA6C;AAC7C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACpC,IAAI,CAAC;QACH,QAAQ,CAAC,gBAAgB,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,KAAK,CAAC,4EAA4E,CAAC,CAAC;QAC5F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;IAChE,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,CAAC,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/api/lib/run-store.d.ts

@@ -0,0 +1,29 @@
+/**
+ * In-memory event store for run lifecycle tracking.
+ * Ported from PR #96 (Te9ui1a) — immutable updates, pub/sub per run.
+ */
+import type { RunAction, RunLogEntry, RunStatus, RunStreamEvent, StudioRun } from "../../shared/contracts.js";
+type RunSubscriber = (event: RunStreamEvent) => void;
+export declare class RunStore {
+    private readonly runs;
+    private readonly subscribers;
+    create(input: {
+        bookId: string;
+        chapterNumber?: number;
+        action: RunAction;
+    }): StudioRun;
+    list(): ReadonlyArray<StudioRun>;
+    get(runId: string): StudioRun | null;
+    findActiveRun(bookId: string): StudioRun | null;
+    markRunning(runId: string, stage: string): StudioRun;
+    updateStage(runId: string, stage: string): StudioRun;
+    appendLog(runId: string, log: RunLogEntry): StudioRun;
+    succeed(runId: string, result: unknown): StudioRun;
+    fail(runId: string, error: string): StudioRun;
+    subscribe(runId: string, subscriber: RunSubscriber): () => void;
+    private update;
+    private publish;
+}
+export declare function isTerminalRunStatus(status: RunStatus): boolean;
+export {};
+//# sourceMappingURL=run-store.d.ts.map

package/dist/api/lib/run-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-store.d.ts","sourceRoot":"","sources":["../../../src/api/lib/run-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,cAAc,EACd,SAAS,EACV,MAAM,2BAA2B,CAAC;AAEnC,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAErD,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IACrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyC;IAErE,MAAM,CAAC,KAAK,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAM,EAAE,SAAS,CAAC;KACnB,GAAG,SAAS;IAsBb,IAAI,IAAI,aAAa,CAAC,SAAS,CAAC;IAMhC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIpC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAY/C,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;IAWpD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;IAIpD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,SAAS;IAMrD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS;IAelD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;IAc7C,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,GAAG,MAAM,IAAI;IAc/D,OAAO,CAAC,MAAM;IA2Bd,OAAO,CAAC,OAAO;CAahB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAE9D"}

package/dist/api/lib/run-store.js

@@ -0,0 +1,122 @@
+/**
+ * In-memory event store for run lifecycle tracking.
+ * Ported from PR #96 (Te9ui1a) — immutable updates, pub/sub per run.
+ */
+import { randomUUID } from "node:crypto";
+export class RunStore {
+    runs = new Map();
+    subscribers = new Map();
+    create(input) {
+        const now = new Date().toISOString();
+        const run = {
+            id: randomUUID(),
+            bookId: input.bookId,
+            chapter: input.chapterNumber ?? null,
+            chapterNumber: input.chapterNumber ?? null,
+            action: input.action,
+            status: "queued",
+            stage: "Queued",
+            createdAt: now,
+            updatedAt: now,
+            startedAt: null,
+            finishedAt: null,
+            logs: [],
+        };
+        this.runs.set(run.id, run);
+        this.publish(run.id, { type: "snapshot", runId: run.id, run });
+        return run;
+    }
+    list() {
+        return [...this.runs.values()].sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    }
+    get(runId) {
+        return this.runs.get(runId) ?? null;
+    }
+    findActiveRun(bookId) {
+        for (const run of this.runs.values()) {
+            if (run.bookId === bookId &&
+                (run.status === "queued" || run.status === "running")) {
+                return run;
+            }
+        }
+        return null;
+    }
+    markRunning(runId, stage) {
+        return this.update(runId, { status: "running", stage, startedAt: new Date().toISOString() }, [
+            { type: "status", runId, status: "running" },
+            { type: "stage", runId, stage },
+        ]);
+    }
+    updateStage(runId, stage) {
+        return this.update(runId, { stage }, [{ type: "stage", runId, stage }]);
+    }
+    appendLog(runId, log) {
+        return this.update(runId, (run) => ({ logs: [...run.logs, log] }), [
+            { type: "log", runId, log },
+        ]);
+    }
+    succeed(runId, result) {
+        return this.update(runId, {
+            status: "succeeded",
+            stage: "Completed",
+            finishedAt: new Date().toISOString(),
+            result,
+            error: undefined,
+        }, [{ type: "status", runId, status: "succeeded", result }], true);
+    }
+    fail(runId, error) {
+        return this.update(runId, {
+            status: "failed",
+            stage: "Failed",
+            finishedAt: new Date().toISOString(),
+            error,
+        }, [{ type: "status", runId, status: "failed", error }], true);
+    }
+    subscribe(runId, subscriber) {
+        const current = this.subscribers.get(runId) ?? new Set();
+        current.add(subscriber);
+        this.subscribers.set(runId, current);
+        return () => {
+            const listeners = this.subscribers.get(runId);
+            if (!listeners)
+                return;
+            listeners.delete(subscriber);
+            if (listeners.size === 0)
+                this.subscribers.delete(runId);
+        };
+    }
+    update(runId, patch, events, publishSnapshot = false) {
+        const current = this.runs.get(runId);
+        if (!current)
+            throw new Error(`Run ${runId} not found.`);
+        const partial = typeof patch === "function" ? patch(current) : patch;
+        const next = {
+            ...current,
+            ...partial,
+            updatedAt: new Date().toISOString(),
+        };
+        this.runs.set(runId, next);
+        for (const event of events) {
+            this.publish(runId, event);
+        }
+        if (publishSnapshot) {
+            this.publish(runId, { type: "snapshot", runId, run: next });
+        }
+        return next;
+    }
+    publish(runId, event) {
+        const listeners = this.subscribers.get(runId);
+        if (!listeners || listeners.size === 0)
+            return;
+        const payload = event.type === "snapshot"
+            ? { ...event, run: event.run ?? this.get(runId) ?? undefined }
+            : event;
+        for (const listener of listeners) {
+            listener(payload);
+        }
+    }
+}
+export function isTerminalRunStatus(status) {
+    return status === "succeeded" || status === "failed";
+}
+//# sourceMappingURL=run-store.js.map

package/dist/api/lib/run-store.js.map

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

package/dist/api/lib/sse.d.ts

@@ -0,0 +1,7 @@
+/**
+ * SSE stream factory for run event streaming.
+ * Ported from PR #96 (Te9ui1a) — typed ReadableStream with auto-close.
+ */
+import type { RunStreamEvent } from "../../shared/contracts.js";
+export declare function createRunEventStream(initialEvent: RunStreamEvent, subscribe: (send: (event: RunStreamEvent) => void) => () => void, shouldClose: (event: RunStreamEvent) => boolean): Response;
+//# sourceMappingURL=sse.d.ts.map

package/dist/api/lib/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../src/api/lib/sse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAMhE,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,cAAc,EAC5B,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,KAAK,MAAM,IAAI,EAChE,WAAW,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,GAC9C,QAAQ,CAkCV"}

package/dist/api/lib/sse.js

@@ -0,0 +1,39 @@
+/**
+ * SSE stream factory for run event streaming.
+ * Ported from PR #96 (Te9ui1a) — typed ReadableStream with auto-close.
+ */
+function encodeSse(event) {
+    return new TextEncoder().encode(`data: ${JSON.stringify(event)}\n\n`);
+}
+export function createRunEventStream(initialEvent, subscribe, shouldClose) {
+    let unsubscribe = null;
+    const stream = new ReadableStream({
+        start(controller) {
+            controller.enqueue(encodeSse(initialEvent));
+            if (shouldClose(initialEvent)) {
+                controller.close();
+                return;
+            }
+            unsubscribe = subscribe((event) => {
+                controller.enqueue(encodeSse(event));
+                if (shouldClose(event)) {
+                    unsubscribe?.();
+                    unsubscribe = null;
+                    controller.close();
+                }
+            });
+        },
+        cancel() {
+            unsubscribe?.();
+            unsubscribe = null;
+        },
+    });
+    return new Response(stream, {
+        headers: {
+            "content-type": "text/event-stream; charset=utf-8",
+            "cache-control": "no-cache",
+            connection: "keep-alive",
+        },
+    });
+}
+//# sourceMappingURL=sse.js.map

package/dist/api/lib/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../../src/api/lib/sse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,SAAS,SAAS,CAAC,KAAqB;IACtC,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,YAA4B,EAC5B,SAAgE,EAChE,WAA+C;IAE/C,IAAI,WAAW,GAAwB,IAAI,CAAC;IAE5C,MAAM,MAAM,GAAG,IAAI,cAAc,CAAa;QAC5C,KAAK,CAAC,UAAU;YACd,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC;YAE5C,IAAI,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC9B,UAAU,CAAC,KAAK,EAAE,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,WAAW,GAAG,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;gBAChC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;gBACrC,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;oBACvB,WAAW,EAAE,EAAE,CAAC;oBAChB,WAAW,GAAG,IAAI,CAAC;oBACnB,UAAU,CAAC,KAAK,EAAE,CAAC;gBACrB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QACD,MAAM;YACJ,WAAW,EAAE,EAAE,CAAC;YAChB,WAAW,GAAG,IAAI,CAAC;QACrB,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE;QAC1B,OAAO,EAAE;YACP,cAAc,EAAE,kCAAkC;YAClD,eAAe,EAAE,UAAU;YAC3B,UAAU,EAAE,YAAY;SACzB;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/api/safety.d.ts

@@ -0,0 +1,3 @@
+/** Validates bookId for API inputs and filesystem-backed book operations. */
+export declare function isSafeBookId(bookId: unknown): bookId is string;
+//# sourceMappingURL=safety.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"safety.d.ts","sourceRoot":"","sources":["../../src/api/safety.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,MAAM,CAE9D"}

package/dist/api/safety.js

@@ -0,0 +1,6 @@
+import { isSafeBookId as isSafeCoreBookId } from "zqy-story-core";
+/** Validates bookId for API inputs and filesystem-backed book operations. */
+export function isSafeBookId(bookId) {
+    return isSafeCoreBookId(bookId);
+}
+//# sourceMappingURL=safety.js.map

package/dist/api/safety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety.js","sourceRoot":"","sources":["../../src/api/safety.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElE,6EAA6E;AAC7E,MAAM,UAAU,YAAY,CAAC,MAAe;IAC1C,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC"}

package/dist/api/server.d.ts

@@ -0,0 +1,7 @@
+import { Hono } from "hono";
+import { type ProjectConfig } from "zqy-story-core";
+export declare function createStudioServer(initialConfig: ProjectConfig, root: string): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+export declare function startStudioServer(root: string, port?: number, options?: {
+    readonly staticDir?: string;
+}): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +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,EAyCL,KAAK,aAAa,EAGnB,MAAM,gBAAgB,CAAC;AAyoCxB,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,8EAk2E5E;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"}