@actalk/inkos-studio 1.3.12 → 1.4.0-canary.43.1

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,EAsCL,KAAK,aAAa,EAGnB,MAAM,oBAAoB,CAAC;AAk3B5B,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,8EAouE5E;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,EAyCL,KAAK,aAAa,EAGnB,MAAM,oBAAoB,CAAC;AAyoC5B,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,8EAi2E5E;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,8 +2,8 @@ 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, createInteractionToolsFromDeps, computeAnalytics, loadProjectConfig, loadProjectSession, processProjectInteractionRequest, resolveSessionActiveBook, listBookSessions, loadBookSession, appendManualSessionMessages, createAndPersistBookSession, renameBookSession, deleteBookSession, migrateBookSession, SessionAlreadyMigratedError, runAgentSession, buildAgentSystemPrompt, resolveServicePreset, resolveServiceProviderFamily, resolveServiceModelsBaseUrl, resolveServiceModel, loadSecrets, saveSecrets, listModelsForService, isApiKeyOptionalForEndpoint, getAllEndpoints, probeModelsFromUpstream, fetchWithProxy, chatCompletion, buildExportArtifact, GLOBAL_ENV_PATH, Scheduler, } from "@actalk/inkos-core";
-import { access, mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import { StateManager, PipelineRunner, createLLMClient, createLogger, createInteractionToolsFromDeps, computeAnalytics, loadProjectConfig, loadProjectSession, processProjectInteractionRequest, resolveSessionActiveBook, listBookSessions, loadBookSession, appendManualSessionMessages, createAndPersistBookSession, renameBookSession, deleteBookSession, migrateBookSession, SessionAlreadyMigratedError, runAgentSession, buildAgentSystemPrompt, resolveServicePreset, resolveServiceProviderFamily, resolveServiceModelsBaseUrl, resolveServiceModel, loadSecrets, saveSecrets, listModelsForService, isApiKeyOptionalForEndpoint, getAllEndpoints, probeModelsFromUpstream, fetchWithProxy, chatCompletion, buildExportArtifact, GLOBAL_ENV_PATH, COVER_PROVIDER_PRESETS, Scheduler, coverSecretKey, resolveCoverProviderPreset, } from "@actalk/inkos-core";
+import { access, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
 import { isAbsolute, join, relative, resolve } from "node:path";
 import { isSafeBookId } from "./safety.js";
 import { ApiError } from "./errors.js";
@@ -31,6 +31,8 @@ const AGENT_LABELS = {
 };
 const TOOL_LABELS = {
     read: "读取文件", edit: "编辑文件", grep: "搜索", ls: "列目录",
+    short_fiction_run: "短篇生产",
+    generate_cover: "生成封面",
 };
 function resolveToolLabel(tool, agent) {
     if (tool === "sub_agent" && agent)
@@ -50,10 +52,12 @@ function summarizeResult(result) {
     return String(result).slice(0, 200);
 }
 function compareServiceListItems(left, right) {
-    if (left.service === "kkaiapi" && right.service !== "kkaiapi")
-        return -1;
-    if (right.service === "kkaiapi" && left.service !== "kkaiapi")
-        return 1;
+    const priority = ["kkaiapi", "openrouter", "newapi", "siliconcloud"];
+    const leftPriority = priority.indexOf(left.service);
+    const rightPriority = priority.indexOf(right.service);
+    if (leftPriority !== -1 || rightPriority !== -1) {
+        return (leftPriority === -1 ? 999 : leftPriority) - (rightPriority === -1 ? 999 : rightPriority);
+    }
     return 0;
 }
 function isHeaderSafeApiKey(value) {
@@ -117,6 +121,41 @@ function extractToolError(result) {
     }
     return String(result).slice(0, 500);
 }
+function resolveProjectImageFile(root, rawPath) {
+    let relPath;
+    try {
+        relPath = decodeURIComponent(rawPath).replace(/^\/+/u, "");
+    }
+    catch {
+        throw new ApiError(400, "INVALID_PROJECT_FILE_PATH", "Invalid project file path");
+    }
+    if (!relPath
+        || relPath.includes("\0")
+        || isAbsolute(relPath)
+        || relPath.split(/[\\/]+/u).includes("..")) {
+        throw new ApiError(400, "INVALID_PROJECT_FILE_PATH", "Invalid project file path");
+    }
+    if (!relPath.startsWith("shorts/") && !relPath.startsWith("covers/")) {
+        throw new ApiError(400, "INVALID_PROJECT_FILE_PATH", "Only generated shorts/ and covers/ images can be previewed");
+    }
+    const ext = relPath.split(".").pop()?.toLowerCase() ?? "";
+    const contentTypes = {
+        png: "image/png",
+        jpg: "image/jpeg",
+        jpeg: "image/jpeg",
+        webp: "image/webp",
+    };
+    const contentType = contentTypes[ext];
+    if (!contentType) {
+        throw new ApiError(415, "UNSUPPORTED_PROJECT_FILE_TYPE", "Unsupported project file type");
+    }
+    const resolved = resolve(root, relPath);
+    const rel = relative(root, resolved);
+    if (!rel || rel.startsWith("..") || isAbsolute(rel)) {
+        throw new ApiError(400, "INVALID_PROJECT_FILE_PATH", "Invalid project file path");
+    }
+    return { resolved, contentType };
+}
 function isLikelyFailedToolResult(exec) {
     if (exec.status === "error")
         return true;
@@ -134,6 +173,175 @@ function isWriteNextInstruction(instruction) {
     return /^(continue|继续|继续写|写下一章|write next|下一章|再来一章)$/i.test(trimmed)
         || /(继续写|写下一章|下一章|再来一章|write\s+next)/i.test(trimmed);
 }
+const CHAT_EDIT_WARNING = "[warning] Chat external edit requires review before continuation.";
+const CHAT_EDIT_TEXT_EXTENSIONS = /\.(md|txt|json|ya?ml)$/i;
+const CHAT_EDIT_ALLOWED_ROOTS = new Set(["books", "shorts", "covers", "genres"]);
+function parseReplacementInstruction(instruction) {
+    const inFileQuoted = instruction.match(/(?:里|里的|中|中的|里面)\s*[「“"]([\s\S]+?)[」”"]\s*(?:改成|替换成|换成)\s*[「“"]([\s\S]+?)[」”"]/);
+    if (inFileQuoted?.[1] && inFileQuoted[2] !== undefined) {
+        return { oldText: inFileQuoted[1], newText: inFileQuoted[2] };
+    }
+    const quoted = instruction.match(/(?:把|将)\s*[「“"]([\s\S]+?)[」”"]\s*(?:改成|替换成|换成)\s*[「“"]([\s\S]+?)[」”"]/);
+    if (quoted?.[1] && quoted[2] !== undefined) {
+        return { oldText: quoted[1], newText: quoted[2] };
+    }
+    const plain = instruction.match(/(?:把|将)\s+([^\s，。；;]+)\s*(?:改成|替换成|换成)\s+([^\n，。；;]+)/);
+    if (plain?.[1] && plain[2] !== undefined) {
+        return { oldText: plain[1], newText: plain[2].trim() };
+    }
+    return null;
+}
+function parseChapterNumberForEdit(instruction) {
+    const match = instruction.match(/第\s*(\d{1,4})\s*章/);
+    if (!match?.[1])
+        return null;
+    const chapterNumber = Number.parseInt(match[1], 10);
+    return Number.isInteger(chapterNumber) && chapterNumber > 0 ? chapterNumber : null;
+}
+function parseExplicitEditPath(instruction) {
+    const match = instruction.match(/(?:把|将)\s+([^「“"\s，。；;]+?\.[A-Za-z0-9]+)\s*(?:里|里的|中|中的|里面)/);
+    return match?.[1]?.trim() ?? null;
+}
+function countContentUnits(content) {
+    const stripped = content
+        .replace(/^#{1,6}\s+.*$/gm, "")
+        .trim();
+    if (!stripped)
+        return 0;
+    if (/[\u3400-\u9fff]/.test(stripped)) {
+        return stripped.replace(/\s/g, "").length;
+    }
+    return stripped.split(/\s+/).filter(Boolean).length;
+}
+function resolveExternalChatEditPath(root, requestedPath) {
+    if (isAbsolute(requestedPath)) {
+        throw new ApiError(400, "UNSUPPORTED_CHAT_EDIT_TARGET", "Chat external edits only support project-relative content paths.");
+    }
+    const projectRoot = resolve(root);
+    const resolved = resolve(projectRoot, requestedPath);
+    const rel = relative(projectRoot, resolved).replace(/\\/g, "/");
+    if (!rel || rel.startsWith("../") || rel === "..") {
+        throw new ApiError(400, "UNSUPPORTED_CHAT_EDIT_TARGET", "Chat external edit path escapes the project root.");
+    }
+    const first = rel.split("/")[0] ?? "";
+    if (!CHAT_EDIT_ALLOWED_ROOTS.has(first)) {
+        throw new ApiError(400, "UNSUPPORTED_CHAT_EDIT_TARGET", "Chat external edits cannot modify source code, config, or arbitrary project files.");
+    }
+    if (rel.includes("/.inkos/") || rel.endsWith("/.inkos") || rel.includes("/secrets") || rel.endsWith(".env")) {
+        throw new ApiError(400, "UNSUPPORTED_CHAT_EDIT_TARGET", "Chat external edits cannot modify secrets or runtime internals.");
+    }
+    if (!CHAT_EDIT_TEXT_EXTENSIONS.test(rel)) {
+        throw new ApiError(400, "UNSUPPORTED_CHAT_EDIT_TARGET", "Chat external edits only support text content files.");
+    }
+    return { path: resolved, rel };
+}
+async function findChapterFile(root, bookId, chapterNumber) {
+    const chaptersDir = join(root, "books", bookId, "chapters");
+    const padded = String(chapterNumber).padStart(4, "0");
+    const files = await readdir(chaptersDir).catch(() => []);
+    const match = files.find((file) => file.startsWith(`${padded}_`) && file.endsWith(".md"));
+    return match ? join(chaptersDir, match) : null;
+}
+function parseBookChapterFromRelativePath(rel) {
+    const match = rel.match(/^books\/([^/]+)\/chapters\/(\d{4})_[^/]+\.md$/);
+    if (!match?.[1] || !match[2])
+        return null;
+    const chapterNumber = Number.parseInt(match[2], 10);
+    return Number.isInteger(chapterNumber) ? { bookId: match[1], chapterNumber } : null;
+}
+async function syncExternalChapterEdit(params) {
+    const now = new Date().toISOString();
+    const index = [...(await params.state.loadChapterIndex(params.bookId))];
+    const updated = index.map((chapter) => chapter.number === params.chapterNumber
+        ? {
+            ...chapter,
+            status: "audit-failed",
+            wordCount: countContentUnits(params.content),
+            updatedAt: now,
+            auditIssues: [
+                ...chapter.auditIssues.filter((issue) => issue !== CHAT_EDIT_WARNING),
+                CHAT_EDIT_WARNING,
+            ],
+        }
+        : chapter);
+    if (updated.length > 0) {
+        await params.state.saveChapterIndex(params.bookId, updated);
+    }
+    const runtimeDir = join(params.root, "books", params.bookId, "story", "runtime");
+    const padded = String(params.chapterNumber).padStart(4, "0");
+    const runtimeFiles = await readdir(runtimeDir).catch(() => []);
+    await Promise.all(runtimeFiles
+        .filter((file) => file.startsWith(`chapter-${padded}.`))
+        .map((file) => rm(join(runtimeDir, file), { force: true })));
+}
+async function tryHandleExternalChatEdit(params) {
+    const replacement = parseReplacementInstruction(params.instruction);
+    if (!replacement)
+        return null;
+    const explicitPath = parseExplicitEditPath(params.instruction);
+    if (explicitPath) {
+        const target = resolveExternalChatEditPath(params.root, explicitPath);
+        const content = await readFile(target.path, "utf-8").catch((error) => {
+            throw new ApiError(404, "CHAT_EDIT_TARGET_NOT_FOUND", error instanceof Error ? error.message : String(error));
+        });
+        const first = content.indexOf(replacement.oldText);
+        if (first === -1) {
+            throw new ApiError(400, "EDIT_TARGET_NOT_FOUND", "要替换的原文没有在目标文件中找到。");
+        }
+        if (content.indexOf(replacement.oldText, first + replacement.oldText.length) !== -1) {
+            throw new ApiError(400, "EDIT_TARGET_AMBIGUOUS", "要替换的原文出现多次，请给出更具体的一段。");
+        }
+        const updated = content.slice(0, first) + replacement.newText + content.slice(first + replacement.oldText.length);
+        await writeFile(target.path, updated, "utf-8");
+        const chapterTarget = parseBookChapterFromRelativePath(target.rel);
+        if (chapterTarget) {
+            await syncExternalChapterEdit({
+                state: params.state,
+                root: params.root,
+                bookId: chapterTarget.bookId,
+                chapterNumber: chapterTarget.chapterNumber,
+                content: updated,
+            });
+        }
+        return {
+            activeBookId: chapterTarget?.bookId ?? params.activeBookId ?? undefined,
+            responseText: `已直接编辑 ${target.rel}${chapterTarget ? "，并标记为需要复核" : ""}。`,
+        };
+    }
+    if (!params.activeBookId)
+        return null;
+    const chapterNumber = parseChapterNumberForEdit(params.instruction);
+    if (!replacement || !chapterNumber)
+        return null;
+    const chapterPath = await findChapterFile(params.root, params.activeBookId, chapterNumber);
+    if (!chapterPath) {
+        throw new ApiError(404, "CHAPTER_NOT_FOUND", `Chapter ${chapterNumber} not found in ${params.activeBookId}`);
+    }
+    if (!CHAT_EDIT_TEXT_EXTENSIONS.test(chapterPath)) {
+        throw new ApiError(400, "UNSUPPORTED_EDIT_TARGET", "Chat external edits only support text files.");
+    }
+    const content = await readFile(chapterPath, "utf-8");
+    const first = content.indexOf(replacement.oldText);
+    if (first === -1) {
+        throw new ApiError(400, "EDIT_TARGET_NOT_FOUND", "要替换的原文没有在目标章节中找到。");
+    }
+    if (content.indexOf(replacement.oldText, first + replacement.oldText.length) !== -1) {
+        throw new ApiError(400, "EDIT_TARGET_AMBIGUOUS", "要替换的原文出现多次，请给出更具体的一段。");
+    }
+    const updated = content.slice(0, first) + replacement.newText + content.slice(first + replacement.oldText.length);
+    await writeFile(chapterPath, updated, "utf-8");
+    await syncExternalChapterEdit({
+        state: params.state,
+        root: params.root,
+        bookId: params.activeBookId,
+        chapterNumber,
+        content: updated,
+    });
+    return {
+        activeBookId: params.activeBookId,
+        responseText: `已直接编辑 ${params.activeBookId} 第 ${chapterNumber} 章，并标记为需要复核。`,
+    };
+}
 function looksLikeBookCreatedClaim(responseText) {
     return /(?:已|已经|成功).{0,12}(?:创建|建书|初始化|保存).{0,12}(?:作品|书|书籍|文件夹)?/.test(responseText)
         || /\b(?:created|initiali[sz]ed|saved)\b.{0,40}\b(?:book|project|novel)\b/i.test(responseText);
@@ -267,6 +475,42 @@ function mergeServiceConfig(existing, updates) {
     }
     return [...merged.values()];
 }
+function normalizeCoverConfig(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const record = raw;
+    const service = typeof record.service === "string" ? record.service : "";
+    const preset = resolveCoverProviderPreset(service);
+    if (!preset)
+        return undefined;
+    const requestedModel = typeof record.model === "string" ? record.model.trim() : "";
+    const model = requestedModel && preset.models.includes(requestedModel)
+        ? requestedModel
+        : preset.defaultModel;
+    return { service: preset.service, model };
+}
+function syncTopLevelLlmMirror(llm) {
+    const selectedService = typeof llm.service === "string" ? llm.service : undefined;
+    if (!selectedService)
+        return;
+    const services = normalizeServiceConfig(llm.services);
+    const selectedEntry = services.find((entry) => serviceConfigKey(entry) === selectedService)
+        ?? (!isCustomServiceId(selectedService) ? { service: selectedService } : undefined);
+    if (!selectedEntry)
+        return;
+    const preset = resolveServicePreset(selectedEntry.service);
+    llm.provider = resolveServiceProviderFamily(selectedEntry.service) ?? "openai";
+    llm.baseUrl = selectedEntry.baseUrl ?? preset?.baseUrl ?? "";
+    const defaultModel = typeof llm.defaultModel === "string" ? llm.defaultModel.trim() : "";
+    if (defaultModel)
+        llm.model = defaultModel;
+    if (selectedEntry.temperature !== undefined)
+        llm.temperature = selectedEntry.temperature;
+    if (selectedEntry.apiFormat !== undefined)
+        llm.apiFormat = selectedEntry.apiFormat;
+    if (selectedEntry.stream !== undefined)
+        llm.stream = selectedEntry.stream;
+}
 async function loadRawConfig(root) {
     const configPath = join(root, "inkos.json");
     const raw = await readFile(configPath, "utf-8");
@@ -1177,9 +1421,76 @@ export function createStudioServer(initialConfig, root) {
         if (body.service !== undefined) {
             llm.service = body.service;
         }
+        syncTopLevelLlmMirror(llm);
         await saveRawConfig(root, config);
         return c.json({ ok: true });
     });
+    app.get("/api/v1/cover/config", async (c) => {
+        const config = await loadRawConfig(root);
+        const llm = config.llm ?? {};
+        const cover = normalizeCoverConfig(llm.cover);
+        const secrets = await loadSecrets(root);
+        return c.json({
+            service: cover?.service ?? null,
+            model: cover?.model ?? null,
+            providers: COVER_PROVIDER_PRESETS.map((provider) => ({
+                service: provider.service,
+                label: provider.label,
+                baseUrl: provider.baseUrl,
+                defaultModel: provider.defaultModel,
+                models: provider.models,
+                connected: Boolean(secrets.services[coverSecretKey(provider.service)]?.apiKey || secrets.services[provider.service]?.apiKey),
+            })),
+        });
+    });
+    app.put("/api/v1/cover/config", async (c) => {
+        const body = await c.req.json();
+        const preset = resolveCoverProviderPreset(body.service);
+        if (!preset) {
+            return c.json({ error: "Unsupported cover service" }, 400);
+        }
+        const model = typeof body.model === "string" && preset.models.includes(body.model)
+            ? body.model
+            : preset.defaultModel;
+        const config = await loadRawConfig(root);
+        config.llm = config.llm ?? {};
+        const llm = config.llm;
+        llm.cover = {
+            service: preset.service,
+            model,
+        };
+        await saveRawConfig(root, config);
+        return c.json({ ok: true, service: preset.service, model });
+    });
+    app.get("/api/v1/cover/secret/:service", async (c) => {
+        const service = c.req.param("service");
+        if (!resolveCoverProviderPreset(service)) {
+            return c.json({ error: "Unsupported cover service" }, 400);
+        }
+        const secrets = await loadSecrets(root);
+        return c.json({ apiKey: secrets.services[coverSecretKey(service)]?.apiKey ?? "" });
+    });
+    app.put("/api/v1/cover/secret/:service", async (c) => {
+        const service = c.req.param("service");
+        if (!resolveCoverProviderPreset(service)) {
+            return c.json({ error: "Unsupported cover service" }, 400);
+        }
+        const body = await c.req.json();
+        const trimmedKey = body.apiKey?.trim() ?? "";
+        if (trimmedKey && !isHeaderSafeApiKey(trimmedKey)) {
+            return c.json({ error: "API Key 包含不能放入 HTTP Authorization header 的字符，请只粘贴原始密钥。" }, 400);
+        }
+        const secrets = await loadSecrets(root);
+        const key = coverSecretKey(service);
+        if (trimmedKey) {
+            secrets.services[key] = { apiKey: trimmedKey };
+        }
+        else {
+            delete secrets.services[key];
+        }
+        await saveSecrets(root, secrets);
+        return c.json({ ok: true, service });
+    });
     app.delete("/api/v1/services/:service", async (c) => {
         const service = c.req.param("service");
         const config = await loadRawConfig(root);
@@ -1380,6 +1691,21 @@ export function createStudioServer(initialConfig, root) {
             temperature: currentConfig.llm.temperature,
         });
     });
+    app.get("/api/v1/project/files/:file{.+}", async (c) => {
+        const file = resolveProjectImageFile(root, c.req.param("file"));
+        try {
+            const content = await readFile(file.resolved);
+            return new Response(content, {
+                headers: {
+                    "Content-Type": file.contentType,
+                    "Cache-Control": "no-store",
+                },
+            });
+        }
+        catch {
+            return c.notFound();
+        }
+    });
     // --- Config editing ---
     app.put("/api/v1/project", async (c) => {
         const updates = await c.req.json();
@@ -1638,6 +1964,40 @@ export function createStudioServer(initialConfig, root) {
                     sessionTitleBroadcasted = true;
                 }
             };
+            const externalEdit = await tryHandleExternalChatEdit({
+                root,
+                state,
+                instruction,
+                activeBookId: agentBookId,
+            });
+            if (externalEdit) {
+                await appendManualSessionMessages(root, bookSession.sessionId, [{
+                        role: "assistant",
+                        content: [{ type: "text", text: externalEdit.responseText }],
+                        api: "anthropic-messages",
+                        provider: config.llm.provider,
+                        model: config.llm.model,
+                        usage: {
+                            input: 0,
+                            output: 0,
+                            cacheRead: 0,
+                            cacheWrite: 0,
+                            totalTokens: 0,
+                            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+                        },
+                        stopReason: "stop",
+                        timestamp: Date.now(),
+                    }], instruction);
+                await refreshBookSessionFromTranscript();
+                broadcast("agent:complete", { instruction, activeBookId: externalEdit.activeBookId, sessionId: bookSession.sessionId });
+                return c.json({
+                    response: externalEdit.responseText,
+                    session: {
+                        sessionId: bookSession.sessionId,
+                        ...(externalEdit.activeBookId ? { activeBookId: externalEdit.activeBookId } : {}),
+                    },
+                });
+            }
             // Resolve model — multi-service resolution
             let resolvedModel;
             let resolvedApiKey;
@@ -1758,6 +2118,7 @@ export function createStudioServer(initialConfig, root) {
                         id: toolCallId,
                         tool: "sub_agent",
                         result: toolResult,
+                        details: toolResult.details,
                         isError: false,
                     });
                     await appendManualSessionMessages(root, bookSession.sessionId, [{
@@ -1899,6 +2260,7 @@ export function createStudioServer(initialConfig, root) {
                             id: event.toolCallId,
                             tool: event.toolName,
                             result: event.result,
+                            details: exec?.details,
                             isError: event.isError,
                         });
                     }