@kienmatu/inkos-studio 0.1.3 → 3.3.0

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;AAM5B,OAAO,EAsHL,KAAK,aAAa,EAIlB,KAAK,aAAa,EAMnB,MAAM,sBAAsB,CAAC;AAkB9B,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEhD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAItE;AAGD,wBAAgB,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGtF;AAu3ED,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE;IAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,aAAa,CAAA;CAAO,8EAq/H7I;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;AAM5B,OAAO,EAuHL,KAAK,aAAa,EAMlB,KAAK,aAAa,EAOnB,MAAM,sBAAsB,CAAC;AAkB9B,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEhD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAItE;AAGD,wBAAgB,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGtF;AAwgFD,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE;IAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,aAAa,CAAA;CAAO,8EAsjI7I;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

@@ -4,7 +4,7 @@ import { streamSSE } from "hono/streaming";
 import { serve } from "@hono/node-server";
 import { gzipSync } from "node:zlib";
 import { randomUUID } from "node:crypto";
-import { StateManager, PipelineRunner, createLLMClient, createLogger, createInteractionToolsFromDeps, computeAnalytics, loadProjectConfig, loadProjectSession, processProjectInteractionRequest, resolveSessionActiveBook, listBookSessions, loadBookSession, appendManualSessionMessages, createAndPersistBookSession, renameBookSession, deleteBookSession, migrateBookSession, SessionAlreadyMigratedError, abortAgentSession, runAgentSession, resolveServicePreset, resolveServiceProviderFamily, resolveServiceModelsBaseUrl, guessServiceFromBaseUrl, resolveServiceModel, loadSecrets, saveSecrets, listModelsForService, isApiKeyOptionalForEndpoint, getAllEndpoints, probeModelsFromUpstream, fetchWithProxy, chatCompletion, runWorkerAgent, buildExportArtifact, evaluateBookQuality, ConsolidatorAgent, DetectionConfigSchema, ResearchSearchConfigSchema, GLOBAL_ENV_PATH, COVER_PROVIDER_PRESETS, createPlayDB, PlayStore, buildPlayEntityImagePrompt, buildPlaySceneImagePrompt, generatePlayImage, readPlayImageManifest, readPlayImageSettings, writePlayImageSettings, Scheduler, coverSecretKey, normalizeCoverBaseUrl, resolveCoverProviderPreset, SessionKindSchema, normalizeActionSource as normalizeCoreActionSource, normalizeActionPayload as normalizeCoreActionPayload, normalizePlayMode as normalizeCorePlayMode, normalizeRequestedIntent as normalizeCoreRequestedIntent, normalizeSkillIdList as normalizeCoreSkillIdList, inferLanguage, toWritingLanguage, ingestMaterial, createSkillRegistry, loadAvailableAgentSkills, activatedSkillIds, mergeActivatedSkillGuidance, resolveProductionSkillActivations, parseAgentSkillDocument, getBuiltinPrompt, listBuiltinPromptPacks, listBuiltinPrompts, loadPromptPackPrompt, promptOverridePath, toPosixPath, createGenerateCoverTool, createInteractiveFilmCreationTool, createPlayStartTool, createScriptCreationTool, createShortFictionRunTool, createStoryboardCreationTool, createTranslationCreateTool, createFanficBookTool, createContinuationImportTool, createSpinoffBookTool, createImitationBookTool, createSubAgentTool, createDraftStructureTool, createConnectChoiceTool, createRemoveNodeTool, createLLMTranslationModel, deleteLatestChapter, executeEditTransaction, listChapterVersions, readChapterPlanDocument, readChapterUserBrief, readChapterVersion, saveChapterUserBrief, createTranslationProjectFromFile, loadTranslationChapter, loadTranslationManifest, runTranslationProject, writeTranslationExport, filmLLMDepsFromClient, applyGraphDelta, loadStoryGraph, reviewStoryGraph, exportInk, buildPlayableHtml, analyzeEmotionalArcs, analyzePathDistribution, generateNodeImage, defaultNodeImageDeps, } from "@kienmatu/inkos-core";
+import { StateManager, PipelineRunner, createLLMClient, createLogger, createInteractionToolsFromDeps, computeAnalytics, loadProjectConfig, loadProjectSession, processProjectInteractionRequest, resolveSessionActiveBook, listBookSessions, loadBookSession, appendManualSessionMessages, createAndPersistBookSession, renameBookSession, deleteBookSession, migrateBookSession, SessionAlreadyMigratedError, abortAgentSession, runAgentSession, resolveServicePreset, resolveServiceProviderFamily, resolveServiceModelsBaseUrl, guessServiceFromBaseUrl, resolveServiceModel, loadSecrets, saveSecrets, listModelsForService, isApiKeyOptionalForEndpoint, getAllEndpoints, probeModelsFromUpstream, fetchWithProxy, chatCompletion, runWorkerAgent, buildExportArtifact, createProductionRunSnapshot, evaluateBookQuality, ConsolidatorAgent, DetectionConfigSchema, ResearchSearchConfigSchema, GLOBAL_ENV_PATH, COVER_PROVIDER_PRESETS, createPlayDB, PlayStore, buildPlayEntityImagePrompt, buildPlaySceneImagePrompt, generatePlayImage, readPlayImageManifest, readPlayImageSettings, writePlayImageSettings, Scheduler, coverSecretKey, normalizeCoverBaseUrl, resolveCoverProviderPreset, SessionKindSchema, normalizeActionSource as normalizeCoreActionSource, normalizeActionPayload as normalizeCoreActionPayload, normalizePlayMode as normalizeCorePlayMode, normalizeRequestedIntent as normalizeCoreRequestedIntent, normalizeSkillIdList as normalizeCoreSkillIdList, inferLanguage, toWritingLanguage, ingestMaterial, createSkillRegistry, loadAvailableAgentSkills, activatedSkillIds, mergeActivatedSkillGuidance, resolveProductionSkillActivations, parseAgentSkillDocument, getBuiltinPrompt, listBuiltinPromptPacks, listBuiltinPrompts, loadPromptPackPrompt, promptOverridePath, toPosixPath, createGenerateCoverTool, createInteractiveFilmCreationTool, createPlayStartTool, createScriptCreationTool, createShortFictionRunTool, createStoryboardCreationTool, createTranslationCreateTool, createFanficBookTool, createContinuationImportTool, createSpinoffBookTool, createImitationBookTool, createSubAgentTool, createDraftStructureTool, createConnectChoiceTool, createRemoveNodeTool, createLLMTranslationModel, deleteLatestChapter, executeEditTransaction, listChapterVersions, readChapterPlanDocument, readChapterUserBrief, readChapterVersion, saveChapterUserBrief, createTranslationProjectFromFile, loadTranslationChapter, loadTranslationManifest, runTranslationProject, writeTranslationExport, filmLLMDepsFromClient, applyGraphDelta, loadStoryGraph, reviewStoryGraph, exportInk, buildPlayableHtml, analyzeEmotionalArcs, analyzePathDistribution, generateNodeImage, defaultNodeImageDeps, writeProductionRunSnapshot, } from "@kienmatu/inkos-core";
 import { isConfirmedProductionAction } from "../shared/confirmed-production.js";
 import { summarizeToolResult } from "../shared/tool-result.js";
 import { access, mkdir, readFile, readdir, rename, rm, stat, writeFile } from "node:fs/promises";
@@ -879,6 +879,7 @@ function toolResultText(result, lang = "vi") {
 }
 async function executeConfirmedProductionAction(args) {
     const lang = args.language ?? "vi";
+    const uiLang = args.uiLanguage ?? lang;
     const id = args.taskId;
     const actionPayload = args.actionPayload;
     const configuredSkills = await loadAvailableAgentSkills({ projectRoot: args.root });
@@ -950,7 +951,7 @@ async function executeConfirmedProductionAction(args) {
     else if (args.requestedIntent === "generate_cover") {
         const payload = actionPayload?.generateCover;
         const title = requirePayloadText(payload?.title, pick(lang, "确认生成封面缺少标题，请重新生成确认卡。", "The cover generation confirmation is missing a title. Regenerate the confirmation card.", "Xác nhận tạo bìa sách thiếu tiêu đề. Vui lòng tạo lại thẻ xác nhận."));
-        tool = createGenerateCoverTool(args.root, { actionPayload });
+        tool = createGenerateCoverTool(args.root, { actionPayload, language: toWritingLanguage(lang) });
         params = {
             title,
             ...(payload?.intro ? { intro: payload.intro } : {}),
@@ -1204,10 +1205,10 @@ async function executeConfirmedProductionAction(args) {
         id,
         tool: tool.name,
         agent,
-        label: resolveToolLabel(tool.name, agent, lang),
+        label: resolveToolLabel(tool.name, agent, uiLang),
         status: "running",
         args: params,
-        stages: agent ? pipelineStages(agent, lang)?.map(label => ({ label, status: "pending" })) : undefined,
+        stages: agent ? pipelineStages(agent, uiLang)?.map(label => ({ label, status: "pending" })) : undefined,
         startedAt: Date.now(),
     };
     await args.onTaskChange(exec);
@@ -1266,6 +1267,124 @@ async function executeConfirmedProductionAction(args) {
         throw new ConfirmedActionExecutionError(message, exec, error);
     }
 }
+function parseProductionObservation(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    const record = value;
+    if (typeof record.metric !== "string"
+        || !["info", "warning", "blocking"].includes(String(record.severity))
+        || typeof record.repairable !== "boolean"
+        || (record.evidence !== undefined && typeof record.evidence !== "string")) {
+        return null;
+    }
+    return {
+        metric: record.metric,
+        expected: record.expected,
+        actual: record.actual,
+        severity: record.severity,
+        ...(typeof record.evidence === "string" ? { evidence: record.evidence } : {}),
+        repairable: record.repairable,
+    };
+}
+function parseStudioShortRun(value, expectedStoryId) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    const record = value;
+    const status = record.status;
+    const artifacts = Array.isArray(record.artifacts) && record.artifacts.every((item) => typeof item === "string")
+        ? record.artifacts
+        : null;
+    const observations = Array.isArray(record.observations)
+        ? record.observations.map(parseProductionObservation)
+        : null;
+    if (record.version !== 1
+        || record.kind !== "short-fiction"
+        || record.id !== expectedStoryId
+        || (status !== "complete" && status !== "needs-review")
+        || typeof record.stage !== "string"
+        || !artifacts
+        || !observations
+        || observations.some((observation) => observation === null)
+        || typeof record.updatedAt !== "string"
+        || (record.model !== undefined && typeof record.model !== "string")
+        || (record.skillIds !== undefined && (!Array.isArray(record.skillIds) || !record.skillIds.every((item) => typeof item === "string")))
+        || (record.resumeCursor !== undefined && typeof record.resumeCursor !== "string")
+        || (record.error !== undefined && typeof record.error !== "string")) {
+        return null;
+    }
+    return {
+        version: 1,
+        kind: "short-fiction",
+        id: expectedStoryId,
+        status,
+        stage: record.stage,
+        artifacts,
+        observations: observations,
+        ...(typeof record.model === "string" ? { model: record.model } : {}),
+        ...(Array.isArray(record.skillIds) ? { skillIds: record.skillIds } : {}),
+        ...(typeof record.resumeCursor === "string" ? { resumeCursor: record.resumeCursor } : {}),
+        ...(typeof record.error === "string" ? { error: record.error } : {}),
+        updatedAt: record.updatedAt,
+    };
+}
+function parseVisibleShortRunIndex(value, expectedStoryId) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    const record = value;
+    const status = record.status;
+    if (record.version !== 1
+        || record.kind !== "short-fiction"
+        || record.id !== expectedStoryId
+        || (status !== "complete" && status !== "needs-review")
+        || typeof record.updatedAt !== "string") {
+        return null;
+    }
+    return { storyId: expectedStoryId, status, updatedAt: record.updatedAt };
+}
+function parseShortStoryTitle(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    const storyTitle = value.storyTitle;
+    return typeof storyTitle === "string" && storyTitle.trim() ? storyTitle.trim() : null;
+}
+async function loadStudioShortList(root) {
+    const shortsDir = join(root, "shorts");
+    let storyIds = [];
+    try {
+        const entries = await readdir(shortsDir, { withFileTypes: true });
+        storyIds = entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+    const shorts = [];
+    for (const storyId of storyIds) {
+        if (!isSafeBookId(storyId))
+            continue;
+        const shortDir = join(shortsDir, storyId);
+        try {
+            const status = JSON.parse(await readFile(join(shortDir, "status.json"), "utf-8"));
+            const run = parseVisibleShortRunIndex(status, storyId);
+            if (!run)
+                continue;
+            const story = JSON.parse(await readFile(join(shortDir, "final", "short-story.json"), "utf-8"));
+            const title = parseShortStoryTitle(story) ?? storyId;
+            await readFile(join(shortDir, "final", "full.md"), "utf-8");
+            shorts.push({
+                storyId,
+                title,
+                status: run.status,
+                finalMarkdownPath: toPosixPath(join("shorts", storyId, "final", "full.md")),
+                updatedAt: run.updatedAt,
+            });
+        }
+        catch {
+            // A malformed or incomplete directory is not a completed short work.
+        }
+    }
+    return shorts;
+}
 const subscribers = new Set();
 const bookCreateStatus = new Map();
 // 内存缓存：service -> 模型列表 + 更新时间戳；避免每次 sidebar 挂载时都打真实 LLM /models
@@ -2010,6 +2129,7 @@ export function createStudioServer(initialConfig, root, overrides = {}) {
     const state = new StateManager(root);
     let cachedConfig = initialConfig;
     const activeConfirmedTasks = new Map();
+    const confirmedTaskRevisions = new Map();
     // 确认式生产任务的单任务名额（sessionId → taskId）。原来的检查是"await 读快照
     // → 之后才 set controller"的 check-then-act：两个并发确认请求都能通过检查，
     // 双任务同时启动、快照互相覆盖。这里在任何 await 之前同步占位，占位失败的
@@ -2033,8 +2153,11 @@ export function createStudioServer(initialConfig, root, overrides = {}) {
     const persistConfirmedTask = async (sessionId, requestedIntent, exec, sourceRequestId) => {
         if (deletedSessionIds.has(sessionId))
             return;
+        const revision = (confirmedTaskRevisions.get(exec.id) ?? 0) + 1;
+        confirmedTaskRevisions.set(exec.id, revision);
         const snapshot = {
             version: 1,
+            revision,
             sessionId,
             ...(sourceRequestId ? { sourceRequestId } : {}),
             requestedIntent,
@@ -2045,7 +2168,10 @@ export function createStudioServer(initialConfig, root, overrides = {}) {
                 ...(exec.logs ? { logs: [...exec.logs] } : {}),
             },
         };
+        // Publish the same durable snapshot that refresh recovery reads, so an
+        // already-open task card sees milestone logs without requiring a reload.
         await saveStudioTaskSnapshot(root, snapshot);
+        broadcast("task:snapshot", snapshot);
     };
     const loadReconciledTaskSnapshot = async (sessionId) => {
         const task = await loadStudioTaskSnapshot(root, sessionId);
@@ -2174,6 +2300,9 @@ export function createStudioServer(initialConfig, root, overrides = {}) {
             }
             : sseSink;
         const logger = createLogger({ tag: "studio", sinks: [scopedSseSink, consoleSink] });
+        // Progress lines are read by the person watching Studio, so they follow the
+        // UI language rather than the book's writing language.
+        const logLanguage = await currentProjectLanguage();
         return {
             client: overrides?.client ?? createLLMClient(currentConfig.llm),
             model: overrides?.model ?? currentConfig.llm.model,
@@ -2186,6 +2315,7 @@ export function createStudioServer(initialConfig, root, overrides = {}) {
             modelOverrides: currentConfig.modelOverrides,
             notifyChannels: currentConfig.notify,
             logger,
+            logLanguage,
             onContextCompression: (event) => {
                 broadcast("context:compression", {
                     ...(overrides?.sessionIdForSSE ? { sessionId: overrides.sessionIdForSSE } : {}),
@@ -3189,13 +3319,29 @@ export function createStudioServer(initialConfig, root, overrides = {}) {
             id: `custom:${s.name ?? "Custom"}`,
             baseUrl: s.baseUrl ?? "",
             label: s.name ?? "Custom",
+            configuredModels: s.models ?? [],
         }))
-            .filter((s) => s.baseUrl && Boolean(secrets.services[s.id]?.apiKey));
-        const groups = await Promise.all(customs.map(async (s) => ({
-            service: s.id,
-            label: s.label,
-            models: filterTextChatModels(await probeModelsFromUpstream(s.baseUrl, secrets.services[s.id].apiKey, 10_000)),
-        })));
+            .filter((s) => {
+            if (!s.baseUrl)
+                return false;
+            if (secrets.services[s.id]?.apiKey)
+                return true;
+            // Local/self-hosted endpoints are usable without a key.
+            return isApiKeyOptionalForEndpoint({
+                provider: resolveServiceProviderFamily("custom") ?? "openai",
+                baseUrl: s.baseUrl,
+            });
+        });
+        const groups = await Promise.all(customs.map(async (s) => {
+            const probed = filterTextChatModels(await probeModelsFromUpstream(s.baseUrl, secrets.services[s.id]?.apiKey ?? "", 10_000));
+            // The probe swallows every failure (timeout, offline upstream, bad
+            // gateway) and returns []. Without the configured ids as a fallback a
+            // single slow reload empties the model picker, so the UI drops back to
+            // "set up models" even though the service is configured.
+            const models = mergeServiceModelIds(probed.map((model) => model.id), s.configuredModels)
+                .map((id) => probed.find((model) => model.id.toLowerCase() === id.toLowerCase()) ?? { id, name: id });
+            return { service: s.id, label: s.label, models };
+        }));
         return c.json({ groups });
     });
     app.get("/api/v1/services/:service/models", async (c) => {
@@ -4025,6 +4171,7 @@ export function createStudioServer(initialConfig, root, overrides = {}) {
                         requestedSkills,
                         disabledSkills,
                         language: surfaceLanguage,
+                        uiLanguage: language,
                         taskId,
                         sourceRequestId,
                         signal: taskController.signal,
@@ -4108,6 +4255,7 @@ export function createStudioServer(initialConfig, root, overrides = {}) {
                 }
                 finally {
                     activeConfirmedTasks.delete(taskId);
+                    confirmedTaskRevisions.delete(taskId);
                     reservedProductionSessions.delete(reservedSessionId);
                 }
             }
@@ -5313,6 +5461,40 @@ export function createStudioServer(initialConfig, root, overrides = {}) {
         films.sort((a, b) => a.title.localeCompare(b.title, "zh"));
         return c.json({ films });
     });
+    app.get("/api/v1/shorts", async (c) => {
+        const shorts = await loadStudioShortList(root);
+        return c.json({ shorts });
+    });
+    app.post("/api/v1/shorts/:id/complete", async (c) => {
+        const storyId = c.req.param("id");
+        if (!isSafeBookId(storyId)) {
+            return c.json({ error: "Invalid short id" }, 400);
+        }
+        const runPath = join("shorts", storyId, "status.json");
+        let raw;
+        try {
+            raw = JSON.parse(await readFile(join(root, runPath), "utf-8"));
+        }
+        catch {
+            return c.json({ error: "Short not found" }, 404);
+        }
+        const run = parseStudioShortRun(raw, storyId);
+        if (!run) {
+            return c.json({ error: "Short status is invalid" }, 409);
+        }
+        if (run.status === "needs-review") {
+            await writeProductionRunSnapshot({
+                rootDir: root,
+                runPath,
+                run: createProductionRunSnapshot({
+                    ...run,
+                    status: "complete",
+                    updatedAt: new Date().toISOString(),
+                }),
+            });
+        }
+        return c.json({ ok: true, storyId, status: "complete" });
+    });
     app.get("/api/v1/translations", async (c) => {
         const translationsDir = join(root, "translations");
         let entries = [];