@kienmatu/inkos-studio 1.0.1 → 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;AAk8ED,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE;IAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,aAAa,CAAA;CAAO,8EA6gI7I;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";
@@ -1267,18 +1267,79 @@ async function executeConfirmedProductionAction(args) {
         throw new ConfirmedActionExecutionError(message, exec, error);
     }
 }
-function parseCompleteShortRunIndex(value, expectedStoryId) {
+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
-        || record.status !== "complete"
+        || (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, updatedAt: record.updatedAt };
+    return { storyId: expectedStoryId, status, updatedAt: record.updatedAt };
 }
 function parseShortStoryTitle(value) {
     if (!value || typeof value !== "object" || Array.isArray(value))
@@ -1304,15 +1365,16 @@ async function loadStudioShortList(root) {
         const shortDir = join(shortsDir, storyId);
         try {
             const status = JSON.parse(await readFile(join(shortDir, "status.json"), "utf-8"));
-            const run = parseCompleteShortRunIndex(status, storyId);
+            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 access(join(shortDir, "final", "full.md"));
+            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,
             });
@@ -2067,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 之前同步占位，占位失败的
@@ -2090,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,
@@ -2102,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);
@@ -4186,6 +4255,7 @@ export function createStudioServer(initialConfig, root, overrides = {}) {
                 }
                 finally {
                     activeConfirmedTasks.delete(taskId);
+                    confirmedTaskRevisions.delete(taskId);
                     reservedProductionSessions.delete(reservedSessionId);
                 }
             }
@@ -5395,6 +5465,36 @@ export function createStudioServer(initialConfig, root, overrides = {}) {
         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 = [];