@actalk/inkos-core 1.3.12 → 1.4.0

package/dist/pipeline/short-fiction-runner.d.ts

@@ -0,0 +1,91 @@
+import type { AgentContext } from "../agents/base.js";
+import { type ShortFictionReference } from "../agents/short-fiction.js";
+import { type CoverProviderPreset } from "../llm/cover-providers.js";
+export interface ShortFictionRunRuntimes {
+    readonly planner: AgentContext;
+    readonly outlineReview: AgentContext;
+    readonly writer: AgentContext;
+    readonly draftReview: AgentContext;
+    readonly revise: AgentContext;
+    readonly package: AgentContext;
+}
+export interface ShortFictionRunOptions {
+    readonly projectRoot: string;
+    readonly direction: string;
+    readonly runtimes: ShortFictionRunRuntimes;
+    readonly reference?: ShortFictionReference;
+    readonly storyId?: string;
+    readonly outDir?: string;
+    readonly chapterCount?: number;
+    readonly charsPerChapter?: number;
+    readonly cover?: boolean;
+    readonly coverBaseUrl?: string;
+    readonly coverEndpoint?: string;
+    readonly coverModel?: string;
+    readonly coverSize?: string;
+    readonly coverApiKeyEnv?: string;
+    readonly onProgress?: (message: string) => void;
+}
+export interface ShortFictionRunResult {
+    readonly storyId: string;
+    readonly outlinePath: string;
+    readonly outlineReviewPath: string;
+    readonly draftReviewPath: string;
+    readonly finalMarkdownPath: string;
+    readonly finalJsonPath: string;
+    readonly salesPackagePath: string;
+    readonly coverPromptPath: string;
+    readonly coverImagePath?: string;
+    readonly coverError?: string;
+}
+export interface ShortFictionCoverOptions {
+    readonly projectRoot: string;
+    readonly title: string;
+    readonly intro?: string;
+    readonly sellingPoints?: string | ReadonlyArray<string>;
+    readonly coverPrompt?: string;
+    readonly outputDir?: string;
+    readonly coverBaseUrl?: string;
+    readonly coverEndpoint?: string;
+    readonly coverModel?: string;
+    readonly coverSize?: string;
+    readonly coverApiKeyEnv?: string;
+}
+export interface ShortFictionCoverResult {
+    readonly title: string;
+    readonly outputDir: string;
+    readonly coverPromptPath: string;
+    readonly coverImagePath: string;
+}
+export declare function runShortFictionProduction(options: ShortFictionRunOptions): Promise<ShortFictionRunResult>;
+export declare function generateShortFictionCover(options: ShortFictionCoverOptions): Promise<ShortFictionCoverResult>;
+export interface ShortFictionCoverRequest {
+    readonly api: CoverProviderPreset["api"];
+    readonly baseUrl: string;
+    readonly endpoint?: string;
+    readonly model: string;
+    readonly apiKey: string;
+}
+export declare function resolveCoverGenerationRequest(input: {
+    readonly root: string;
+    readonly coverBaseUrl?: string;
+    readonly coverEndpoint?: string;
+    readonly coverModel?: string;
+    readonly coverApiKeyEnv?: string;
+}): Promise<ShortFictionCoverRequest>;
+export declare function extractImagesGenerationImage(payload: unknown): ({
+    readonly base64: string;
+    readonly extension: "png" | "jpg";
+    readonly url?: undefined;
+} | {
+    readonly url: string;
+    readonly base64?: undefined;
+    readonly extension?: undefined;
+}) | undefined;
+export declare function extractResponsesImageBase64(payload: unknown): string | undefined;
+export declare function extractGeminiImageBase64(payload: unknown): {
+    readonly base64: string;
+    readonly extension: "png" | "jpg";
+} | undefined;
+export declare function resolveCoverApiKey(apiKeyEnv: string): string;
+//# sourceMappingURL=short-fiction-runner.d.ts.map

package/dist/pipeline/short-fiction-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"short-fiction-runner.d.ts","sourceRoot":"","sources":["../../src/pipeline/short-fiction-runner.ts"],"names":[],"mappings":"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"}

package/dist/pipeline/short-fiction-runner.js

@@ -0,0 +1,535 @@
+import { Buffer } from "node:buffer";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { SHORT_FICTION_DEFAULT_CHAPTERS, SHORT_FICTION_DEFAULT_CHARS_PER_CHAPTER, SHORT_FICTION_MAX_CHAPTERS, SHORT_FICTION_MAX_CHARS_PER_CHAPTER, SHORT_FICTION_MIN_CHAPTERS, SHORT_FICTION_MIN_CHARS_PER_CHAPTER, ShortFictionDraftReviewerAgent, ShortFictionDraftReviserAgent, ShortFictionOutlineAgent, ShortFictionOutlineReviewerAgent, ShortFictionOutlineReviserAgent, ShortFictionPackagingAgent, ShortFictionWriterAgent, renderShortFictionDraftMarkdown, validateShortFictionDraftForFinal, } from "../agents/short-fiction.js";
+import { coverSecretKey, resolveCoverProviderPreset } from "../llm/cover-providers.js";
+import { loadSecrets } from "../llm/secrets.js";
+import { safeChildPath } from "../utils/path-safety.js";
+export async function runShortFictionProduction(options) {
+    const root = options.projectRoot;
+    const chapterCount = boundedInteger(options.chapterCount, SHORT_FICTION_DEFAULT_CHAPTERS, "chapterCount", SHORT_FICTION_MIN_CHAPTERS, SHORT_FICTION_MAX_CHAPTERS);
+    const charsPerChapter = boundedInteger(options.charsPerChapter, SHORT_FICTION_DEFAULT_CHARS_PER_CHAPTER, "charsPerChapter", SHORT_FICTION_MIN_CHARS_PER_CHAPTER, SHORT_FICTION_MAX_CHARS_PER_CHAPTER);
+    options.onProgress?.("Creating short fiction outline...");
+    const outlineAgent = new ShortFictionOutlineAgent(options.runtimes.planner);
+    const outlineV1 = await outlineAgent.createOutline({
+        direction: options.direction,
+        chapterCount,
+        charsPerChapter,
+        reference: options.reference,
+    });
+    const storyId = safeSegment(options.storyId || slugify(outlineV1.storyTitle || options.direction));
+    const baseDir = join(normalizeOutputDir(options.outDir ?? "shorts"), storyId);
+    await writeText(root, join(baseDir, "outline", "v001.md"), outlineV1.rawContent);
+    options.onProgress?.("Reviewing outline...");
+    const outlineReviewer = new ShortFictionOutlineReviewerAgent(options.runtimes.outlineReview);
+    const outlineReview = await outlineReviewer.reviewOutline({
+        direction: options.direction,
+        outline: outlineV1,
+        reference: options.reference,
+    });
+    await writeText(root, join(baseDir, "reviews", "outline-v001.md"), outlineReview);
+    options.onProgress?.("Revising outline once...");
+    const outlineReviser = new ShortFictionOutlineReviserAgent(options.runtimes.planner);
+    const outlineV2 = await outlineReviser.reviseOutline({
+        direction: options.direction,
+        outline: outlineV1,
+        review: outlineReview,
+        reference: options.reference,
+        chapterCount,
+        charsPerChapter,
+    });
+    await writeText(root, join(baseDir, "outline", "v002.md"), outlineV2.rawContent);
+    options.onProgress?.("Writing full short fiction draft...");
+    const writer = new ShortFictionWriterAgent(options.runtimes.writer);
+    const draftV1 = await writer.writeDraft({
+        direction: options.direction,
+        outlineMarkdown: outlineV2.rawContent,
+        chapterCount,
+        charsPerChapter,
+    });
+    await writeDraftArtifacts(root, baseDir, "v001", draftV1);
+    options.onProgress?.("Reviewing full draft...");
+    const draftReviewer = new ShortFictionDraftReviewerAgent(options.runtimes.draftReview);
+    const draftReview = await draftReviewer.reviewDraft({
+        direction: options.direction,
+        outlineMarkdown: outlineV2.rawContent,
+        draft: draftV1,
+        chapterCount,
+        charsPerChapter,
+    });
+    await writeText(root, join(baseDir, "reviews", "draft-v001.md"), draftReview);
+    options.onProgress?.("Revising full draft once...");
+    const reviser = new ShortFictionDraftReviserAgent(options.runtimes.revise);
+    const draftV2 = await reviser.reviseDraft({
+        direction: options.direction,
+        outlineMarkdown: outlineV2.rawContent,
+        draft: draftV1,
+        review: draftReview,
+        chapterCount,
+        charsPerChapter,
+    });
+    validateShortFictionDraftForFinal(draftV2, { expectedChapters: chapterCount });
+    await writeDraftArtifacts(root, baseDir, "v002", draftV2);
+    await writeFinalArtifacts(root, baseDir, draftV2);
+    options.onProgress?.("Generating synopsis and cover prompt...");
+    const packager = new ShortFictionPackagingAgent(options.runtimes.package);
+    const salesPackage = await packager.generatePackage({
+        direction: options.direction,
+        outlineMarkdown: outlineV2.rawContent,
+        draft: draftV2,
+    });
+    await writePackageArtifacts(root, baseDir, salesPackage);
+    const coverArtifacts = options.cover === false
+        ? { coverError: "disabled" }
+        : await generateCoverArtifact({
+            root,
+            baseDir,
+            salesPackage,
+            coverBaseUrl: options.coverBaseUrl,
+            coverEndpoint: options.coverEndpoint,
+            coverModel: options.coverModel,
+            coverSize: options.coverSize,
+            coverApiKeyEnv: options.coverApiKeyEnv,
+        }).catch((error) => ({ coverError: String(error) }));
+    return {
+        storyId,
+        outlinePath: join(baseDir, "outline", "v002.md"),
+        outlineReviewPath: join(baseDir, "reviews", "outline-v001.md"),
+        draftReviewPath: join(baseDir, "reviews", "draft-v001.md"),
+        finalMarkdownPath: join(baseDir, "final", "full.md"),
+        finalJsonPath: join(baseDir, "final", "short-story.json"),
+        salesPackagePath: join(baseDir, "final", "sales-package.md"),
+        coverPromptPath: join(baseDir, "final", "cover-prompt.md"),
+        coverImagePath: coverArtifacts.coverImagePath,
+        coverError: coverArtifacts.coverError,
+    };
+}
+export async function generateShortFictionCover(options) {
+    const title = options.title.trim();
+    if (!title) {
+        throw new Error("title is required for cover generation.");
+    }
+    const outputDir = normalizeOutputDir(options.outputDir ?? join("covers", safeSegment(title)));
+    const salesPackage = {
+        title,
+        intro: options.intro?.trim() ?? "",
+        sellingPoints: normalizeSellingPoints(options.sellingPoints),
+        coverPrompt: options.coverPrompt?.trim() ?? "",
+        rawContent: "",
+    };
+    const promptPath = join(outputDir, "cover-prompt.md");
+    await writeText(options.projectRoot, promptPath, buildCoverImagePrompt(salesPackage));
+    const artifact = await generateCoverImageArtifact({
+        root: options.projectRoot,
+        outputDir,
+        salesPackage,
+        coverBaseUrl: options.coverBaseUrl,
+        coverEndpoint: options.coverEndpoint,
+        coverModel: options.coverModel,
+        coverSize: options.coverSize,
+        coverApiKeyEnv: options.coverApiKeyEnv,
+    });
+    return {
+        title,
+        outputDir,
+        coverPromptPath: promptPath,
+        coverImagePath: artifact.coverImagePath,
+    };
+}
+async function writeDraftArtifacts(root, baseDir, version, draft) {
+    const draftDir = join(baseDir, "drafts", version);
+    await writeText(root, join(draftDir, "full.md"), renderShortFictionDraftMarkdown(draft));
+    await writeJson(root, join(draftDir, "draft.json"), draft);
+    await Promise.all(draft.chapters.map((chapter) => writeText(root, join(draftDir, "chapters", `${String(chapter.number).padStart(4, "0")}.md`), [
+        `# 第${chapter.number}章 ${chapter.title}`,
+        "",
+        chapter.content,
+    ].join("\n"))));
+}
+async function writeFinalArtifacts(root, baseDir, draft) {
+    const finalDir = join(baseDir, "final");
+    const markdown = renderShortFictionDraftMarkdown(draft);
+    await writeText(root, join(finalDir, "full.md"), markdown);
+    await writeText(root, join(finalDir, `${safeFileName(draft.storyTitle)}.md`), markdown);
+    await writeJson(root, join(finalDir, "short-story.json"), draft);
+    await Promise.all(draft.chapters.map((chapter) => writeText(root, join(finalDir, "chapters", `${String(chapter.number).padStart(4, "0")}.md`), [
+        `# 第${chapter.number}章 ${chapter.title}`,
+        "",
+        chapter.content,
+    ].join("\n"))));
+}
+async function writePackageArtifacts(root, baseDir, salesPackage) {
+    const finalDir = join(baseDir, "final");
+    await writeJson(root, join(finalDir, "sales-package.json"), salesPackage);
+    await writeText(root, join(finalDir, "sales-package.md"), [
+        `# ${salesPackage.title}`,
+        "",
+        "## 简介",
+        "",
+        salesPackage.intro,
+        "",
+        "## 卖点",
+        "",
+        ...salesPackage.sellingPoints.map((point) => `- ${point}`),
+        "",
+        "## 封面提示词",
+        "",
+        salesPackage.coverPrompt,
+    ].join("\n"));
+    await writeText(root, join(finalDir, "cover-prompt.md"), salesPackage.coverPrompt || "(empty)");
+}
+async function generateCoverArtifact(input) {
+    return generateCoverImageArtifact({
+        ...input,
+        outputDir: join(input.baseDir, "final"),
+    });
+}
+async function generateCoverImageArtifact(input) {
+    const request = await resolveCoverGenerationRequest({
+        root: input.root,
+        coverBaseUrl: input.coverBaseUrl,
+        coverEndpoint: input.coverEndpoint,
+        coverModel: input.coverModel,
+        coverApiKeyEnv: input.coverApiKeyEnv,
+    });
+    const size = input.coverSize || process.env.INKOS_COVER_SIZE || "1024x1360";
+    if (request.api === "gemini") {
+        const prompt = buildCoverImagePrompt(input.salesPackage);
+        const payload = await generateGeminiCover(request, prompt);
+        const coverPath = join(input.outputDir, payload.extension === "jpg" ? "cover.jpg" : "cover.png");
+        await writeBinary(input.root, coverPath, Buffer.from(payload.base64, "base64"));
+        return { coverImagePath: coverPath };
+    }
+    if (request.api === "images") {
+        const prompt = buildCoverImagePrompt(input.salesPackage);
+        const payload = await generateImagesCover(request, prompt, size);
+        const coverPath = join(input.outputDir, payload.extension === "jpg" ? "cover.jpg" : "cover.png");
+        await writeBinary(input.root, coverPath, payload.buffer);
+        return { coverImagePath: coverPath };
+    }
+    const endpoint = request.endpoint ?? `${request.baseUrl.replace(/\/+$/u, "")}/responses`;
+    const response = await fetch(endpoint, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${request.apiKey}`,
+        },
+        body: JSON.stringify({
+            model: request.model,
+            input: buildCoverImagePrompt(input.salesPackage),
+            tools: [{ type: "image_generation", size }],
+        }),
+    });
+    const text = await response.text();
+    if (!response.ok) {
+        throw new Error(`cover generation failed: HTTP ${response.status} ${text.slice(0, 500)}`);
+    }
+    let payload;
+    try {
+        payload = JSON.parse(text);
+    }
+    catch (error) {
+        throw new Error(`cover generation returned non-JSON response: ${String(error)}`);
+    }
+    const imageBase64 = extractResponsesImageBase64(payload);
+    if (!imageBase64) {
+        throw new Error("cover generation response did not include image_generation_call result.");
+    }
+    const coverPath = join(input.outputDir, "cover.png");
+    await writeBinary(input.root, coverPath, Buffer.from(imageBase64, "base64"));
+    return { coverImagePath: coverPath };
+}
+export async function resolveCoverGenerationRequest(input) {
+    if (input.coverEndpoint || input.coverBaseUrl || process.env.INKOS_COVER_ENDPOINT || process.env.INKOS_COVER_BASE_URL) {
+        const endpoint = resolveCoverEndpoint(input.coverEndpoint, input.coverBaseUrl);
+        const baseUrl = input.coverBaseUrl || process.env.INKOS_COVER_BASE_URL || endpoint
+            .replace(/\/responses\/?$/u, "")
+            .replace(/\/images\/generations\/?$/u, "");
+        return {
+            api: endpoint.includes("/responses") ? "responses" : "images",
+            baseUrl,
+            endpoint,
+            model: input.coverModel || process.env.INKOS_COVER_MODEL || "gpt-image-2",
+            apiKey: resolveCoverApiKey(input.coverApiKeyEnv || "INKOS_COVER_API_KEY"),
+        };
+    }
+    const projectCover = await readProjectCoverConfig(input.root);
+    if (!projectCover) {
+        throw new Error("cover endpoint is required. Configure cover generation in Studio or set INKOS_COVER_BASE_URL.");
+    }
+    const preset = resolveCoverProviderPreset(projectCover.service);
+    if (!preset) {
+        throw new Error(`Unsupported cover service: ${projectCover.service}`);
+    }
+    const apiKey = await resolveProjectCoverApiKey(input.root, projectCover.service);
+    if (!apiKey) {
+        throw new Error(`Cover API key is required. Configure a cover key for ${preset.label}.`);
+    }
+    return {
+        api: preset.api,
+        baseUrl: preset.baseUrl,
+        model: input.coverModel || projectCover.model || preset.defaultModel,
+        apiKey,
+    };
+}
+async function readProjectCoverConfig(root) {
+    try {
+        const raw = await readFile(join(root, "inkos.json"), "utf-8");
+        const parsed = JSON.parse(raw);
+        const service = typeof parsed.llm?.cover?.service === "string" ? parsed.llm.cover.service : "";
+        if (!service)
+            return undefined;
+        return {
+            service,
+            ...(typeof parsed.llm?.cover?.model === "string" && parsed.llm.cover.model.trim()
+                ? { model: parsed.llm.cover.model.trim() }
+                : {}),
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+async function resolveProjectCoverApiKey(root, service) {
+    const secrets = await loadSecrets(root);
+    return secrets.services[coverSecretKey(service)]?.apiKey
+        || secrets.services[service]?.apiKey
+        || process.env[`${service.replace(/[^a-zA-Z0-9]/g, "_").toUpperCase()}_API_KEY`]
+        || "";
+}
+async function generateImagesCover(request, prompt, size) {
+    const endpoint = request.endpoint ?? `${request.baseUrl.replace(/\/+$/u, "")}/images/generations`;
+    const response = await fetch(endpoint, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${request.apiKey}`,
+        },
+        body: JSON.stringify({
+            model: request.model,
+            prompt,
+            n: 1,
+            size,
+        }),
+    });
+    const text = await response.text();
+    if (!response.ok) {
+        throw new Error(`cover generation failed: HTTP ${response.status} ${text.slice(0, 500)}`);
+    }
+    let payload;
+    try {
+        payload = JSON.parse(text);
+    }
+    catch (error) {
+        throw new Error(`cover generation returned non-JSON response: ${String(error)}`);
+    }
+    const image = extractImagesGenerationImage(payload);
+    if (image?.base64) {
+        return {
+            buffer: Buffer.from(image.base64, "base64"),
+            extension: image.extension,
+        };
+    }
+    if (image?.url) {
+        return downloadGeneratedCoverImage(image.url, request.apiKey);
+    }
+    throw new Error("cover generation response did not include image URL or base64 data.");
+}
+export function extractImagesGenerationImage(payload) {
+    const data = payload.data;
+    if (!Array.isArray(data))
+        return undefined;
+    for (const item of data) {
+        const record = item;
+        if (typeof record.b64_json === "string" && record.b64_json.trim()) {
+            return { base64: record.b64_json.trim(), extension: "png" };
+        }
+        if (typeof record.url === "string" && record.url.trim()) {
+            return { url: record.url.trim() };
+        }
+    }
+    return undefined;
+}
+async function downloadGeneratedCoverImage(url, apiKey) {
+    const response = await fetch(url);
+    const fallbackResponse = response.status === 401 || response.status === 403
+        ? await fetch(url, { headers: { Authorization: `Bearer ${apiKey}` } })
+        : response;
+    if (!fallbackResponse.ok) {
+        const text = await fallbackResponse.text();
+        throw new Error(`cover image download failed: HTTP ${fallbackResponse.status} ${text.slice(0, 300)}`);
+    }
+    const contentType = fallbackResponse.headers.get("content-type") ?? "";
+    const buffer = Buffer.from(await fallbackResponse.arrayBuffer());
+    return {
+        buffer,
+        extension: coverImageExtension(contentType, url),
+    };
+}
+function coverImageExtension(contentType, url) {
+    const normalized = `${contentType} ${url}`.toLowerCase();
+    return normalized.includes("jpeg") || normalized.includes(".jpg") || normalized.includes(".jpeg") ? "jpg" : "png";
+}
+async function generateGeminiCover(request, prompt) {
+    const endpoint = `${request.baseUrl.replace(/\/+$/u, "")}/models/${encodeURIComponent(request.model)}:generateContent?key=${encodeURIComponent(request.apiKey)}`;
+    const response = await fetch(endpoint, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            contents: [{ role: "user", parts: [{ text: prompt }] }],
+            generationConfig: { responseModalities: ["IMAGE", "TEXT"] },
+        }),
+    });
+    const text = await response.text();
+    if (!response.ok) {
+        throw new Error(`cover generation failed: HTTP ${response.status} ${text.slice(0, 500)}`);
+    }
+    let payload;
+    try {
+        payload = JSON.parse(text);
+    }
+    catch (error) {
+        throw new Error(`cover generation returned non-JSON response: ${String(error)}`);
+    }
+    const image = extractGeminiImageBase64(payload);
+    if (!image) {
+        throw new Error("cover generation response did not include Gemini inline image data.");
+    }
+    return image;
+}
+export function extractResponsesImageBase64(payload) {
+    const output = payload.output;
+    if (!Array.isArray(output))
+        return undefined;
+    for (const item of output) {
+        const record = item;
+        if (record.type === "image_generation_call" && typeof record.result === "string" && record.result.trim()) {
+            return record.result.trim();
+        }
+        if (Array.isArray(record.content)) {
+            for (const contentItem of record.content) {
+                const contentRecord = contentItem;
+                if (typeof contentRecord.result === "string" && contentRecord.result.trim())
+                    return contentRecord.result.trim();
+                if (typeof contentRecord.image_base64 === "string" && contentRecord.image_base64.trim())
+                    return contentRecord.image_base64.trim();
+            }
+        }
+    }
+    return undefined;
+}
+export function extractGeminiImageBase64(payload) {
+    const candidates = payload.candidates;
+    if (!Array.isArray(candidates))
+        return undefined;
+    for (const candidate of candidates) {
+        const parts = candidate.content?.parts;
+        if (!Array.isArray(parts))
+            continue;
+        for (const part of parts) {
+            const inlineData = part.inlineData
+                ?? part.inline_data;
+            const record = inlineData;
+            if (typeof record?.data !== "string" || !record.data.trim())
+                continue;
+            const mimeType = String(record.mimeType ?? record.mime_type ?? "image/png").toLowerCase();
+            return {
+                base64: record.data.trim(),
+                extension: mimeType.includes("jpeg") || mimeType.includes("jpg") ? "jpg" : "png",
+            };
+        }
+    }
+    return undefined;
+}
+export function resolveCoverApiKey(apiKeyEnv) {
+    const apiKey = process.env[apiKeyEnv];
+    if (!apiKey) {
+        throw new Error(`Cover API key is required. Set ${apiKeyEnv} or pass coverApiKeyEnv.`);
+    }
+    return apiKey;
+}
+function resolveCoverEndpoint(coverEndpoint, coverBaseUrl) {
+    const endpoint = coverEndpoint || process.env.INKOS_COVER_ENDPOINT;
+    if (endpoint)
+        return endpoint;
+    const baseUrl = coverBaseUrl || process.env.INKOS_COVER_BASE_URL;
+    if (!baseUrl) {
+        throw new Error("cover endpoint is required. Set INKOS_COVER_BASE_URL or disable cover generation.");
+    }
+    return `${baseUrl.replace(/\/+$/u, "")}/images/generations`;
+}
+function buildCoverImagePrompt(salesPackage) {
+    return [
+        "为中文商业短篇小说生成手机端平台书封，3:4竖图。",
+        `主标题：${salesPackage.title}`,
+        salesPackage.intro ? `简介：${salesPackage.intro}` : "",
+        salesPackage.sellingPoints.length > 0 ? `卖点：${salesPackage.sellingPoints.join("；")}` : "",
+        salesPackage.coverPrompt ? `包装提示：${salesPackage.coverPrompt}` : "",
+        "",
+        "封面方向：平台短篇书封，不是电影海报。标题字要成为主视觉，预留两到四行大字排版区；人物近景或半身，表情有冷笑、震惊、崩溃、压迫或反杀感；道具少而大，一眼能看出冲突。",
+        "颜色高对比、高饱和，适合手机列表缩略图。避免写实会议摄影、横版视频缩略图、杂志大片、小清新细字和长段文字。",
+        "如果模型文字不稳定，优先生成明确标题留白/字块/排版空间，不要把大量乱码文字铺满画面。",
+    ].filter(Boolean).join("\n");
+}
+function normalizeSellingPoints(value) {
+    if (typeof value === "string" || value === undefined) {
+        return (value ?? "")
+            .split(/[;；\n]/u)
+            .map((point) => point.trim())
+            .filter(Boolean);
+    }
+    return value.map((point) => point.trim()).filter(Boolean);
+}
+async function writeBinary(root, path, value) {
+    const resolved = safeChildPath(root, path);
+    await mkdir(dirname(resolved), { recursive: true });
+    await writeFile(resolved, value);
+}
+async function writeJson(root, path, value) {
+    await writeText(root, path, JSON.stringify(value, null, 2));
+}
+async function writeText(root, path, value) {
+    const resolved = safeChildPath(root, path);
+    await mkdir(dirname(resolved), { recursive: true });
+    await writeFile(resolved, `${value.trimEnd()}\n`, "utf-8");
+}
+function normalizeOutputDir(value) {
+    const trimmed = value.trim() || "shorts";
+    safeChildPath("/", trimmed);
+    return trimmed.replace(/^\/+/u, "").replace(/\/+$/u, "") || "shorts";
+}
+function boundedInteger(value, fallback, name, min, max) {
+    const parsed = value ?? fallback;
+    if (!Number.isInteger(parsed) || parsed < min || parsed > max) {
+        throw new Error(`${name} must be an integer between ${min} and ${max}.`);
+    }
+    return parsed;
+}
+function slugify(value) {
+    const slug = value
+        .toLowerCase()
+        .replace(/['"]/g, "")
+        .replace(/[^\p{L}\p{N}]+/gu, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 60);
+    return slug || `short-${Date.now()}`;
+}
+function safeSegment(value) {
+    const cleaned = value
+        .replace(/[\\/:\0*?"<>|]/g, "-")
+        .replace(/\s+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 80);
+    if (!cleaned || cleaned === "." || cleaned === "..")
+        return `short-${Date.now()}`;
+    return cleaned;
+}
+function safeFileName(value) {
+    const cleaned = value
+        .replace(/[\\/:\0*?"<>|]/g, "_")
+        .replace(/\s+/g, " ")
+        .trim()
+        .slice(0, 80);
+    return cleaned || "short-fiction";
+}
+//# sourceMappingURL=short-fiction-runner.js.map