@kienmatu/inkos-studio 1.0.1 → 4.0.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,EAwHL,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;AA0jFD,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, normalizeProbedModels, 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
+        || (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
-        || record.status !== "complete"
+        || (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,
             });
@@ -1325,7 +1387,6 @@ async function loadStudioShortList(root) {
 }
 const subscribers = new Set();
 const bookCreateStatus = new Map();
-// 内存缓存：service -> 模型列表 + 更新时间戳；避免每次 sidebar 挂载时都打真实 LLM /models
 const modelListCache = new Map();
 function broadcast(event, data) {
     for (const handler of subscribers) {
@@ -1407,16 +1468,50 @@ function normalizeServiceModelIds(value) {
     }
     return models;
 }
+function normalizeServiceModelCapabilities(value, models) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return {};
+    const allowed = models ? new Set(models.map((model) => model.toLowerCase())) : undefined;
+    const result = {};
+    for (const [model, raw] of Object.entries(value)) {
+        if (!model.trim() || (allowed && !allowed.has(model.toLowerCase())))
+            continue;
+        if (!raw || typeof raw !== "object" || Array.isArray(raw))
+            continue;
+        const record = raw;
+        const contextWindow = positiveInteger(record.contextWindow);
+        const candidateMax = positiveInteger(record.maxOutput);
+        const maxOutput = candidateMax !== undefined
+            && (contextWindow === undefined || candidateMax <= contextWindow)
+            ? candidateMax
+            : undefined;
+        if (maxOutput === undefined && contextWindow === undefined)
+            continue;
+        result[model] = {
+            ...(maxOutput !== undefined ? { maxOutput } : {}),
+            ...(contextWindow !== undefined ? { contextWindow } : {}),
+        };
+    }
+    return result;
+}
+function positiveInteger(value) {
+    return typeof value === "number" && Number.isFinite(value) && Number.isInteger(value) && value > 0
+        ? value
+        : undefined;
+}
 function mergeServiceModelIds(...groups) {
     return normalizeServiceModelIds(groups.flatMap((group) => group ?? []));
 }
 function normalizeServiceEntry(serviceId, value) {
+    const models = Array.isArray(value.models) ? normalizeServiceModelIds(value.models) : undefined;
+    const modelCapabilities = normalizeServiceModelCapabilities(value.modelCapabilities, models);
     if (serviceId.startsWith("custom:")) {
         return {
             service: "custom",
             name: decodeURIComponent(serviceId.slice("custom:".length)),
             ...(typeof value.baseUrl === "string" && value.baseUrl.length > 0 ? { baseUrl: value.baseUrl } : {}),
-            ...(Array.isArray(value.models) ? { models: normalizeServiceModelIds(value.models) } : {}),
+            ...(models ? { models } : {}),
+            ...(Object.keys(modelCapabilities).length > 0 ? { modelCapabilities } : {}),
             ...(typeof value.temperature === "number" ? { temperature: value.temperature } : {}),
             ...(value.apiFormat === "chat" || value.apiFormat === "responses" ? { apiFormat: value.apiFormat } : {}),
             ...(typeof value.stream === "boolean" ? { stream: value.stream } : {}),
@@ -1427,7 +1522,8 @@ function normalizeServiceEntry(serviceId, value) {
             service: "custom",
             ...(typeof value.name === "string" && value.name.length > 0 ? { name: value.name } : {}),
             ...(typeof value.baseUrl === "string" && value.baseUrl.length > 0 ? { baseUrl: value.baseUrl } : {}),
-            ...(Array.isArray(value.models) ? { models: normalizeServiceModelIds(value.models) } : {}),
+            ...(models ? { models } : {}),
+            ...(Object.keys(modelCapabilities).length > 0 ? { modelCapabilities } : {}),
             ...(typeof value.temperature === "number" ? { temperature: value.temperature } : {}),
             ...(value.apiFormat === "chat" || value.apiFormat === "responses" ? { apiFormat: value.apiFormat } : {}),
             ...(typeof value.stream === "boolean" ? { stream: value.stream } : {}),
@@ -1435,7 +1531,8 @@ function normalizeServiceEntry(serviceId, value) {
     }
     return {
         service: serviceId,
-        ...(Array.isArray(value.models) ? { models: normalizeServiceModelIds(value.models) } : {}),
+        ...(models ? { models } : {}),
+        ...(Object.keys(modelCapabilities).length > 0 ? { modelCapabilities } : {}),
         ...(typeof value.temperature === "number" ? { temperature: value.temperature } : {}),
         ...(value.apiFormat === "chat" || value.apiFormat === "responses" ? { apiFormat: value.apiFormat } : {}),
         ...(typeof value.stream === "boolean" ? { stream: value.stream } : {}),
@@ -1448,15 +1545,7 @@ function normalizeServiceConfig(raw) {
     if (Array.isArray(raw)) {
         return raw
             .filter((entry) => Boolean(entry) && typeof entry === "object")
-            .map((entry) => ({
-            service: typeof entry.service === "string" && entry.service.length > 0 ? entry.service : "custom",
-            ...(typeof entry.name === "string" && entry.name.length > 0 ? { name: entry.name } : {}),
-            ...(typeof entry.baseUrl === "string" && entry.baseUrl.length > 0 ? { baseUrl: entry.baseUrl } : {}),
-            ...(Array.isArray(entry.models) ? { models: normalizeServiceModelIds(entry.models) } : {}),
-            ...(typeof entry.temperature === "number" ? { temperature: entry.temperature } : {}),
-            ...(entry.apiFormat === "chat" || entry.apiFormat === "responses" ? { apiFormat: entry.apiFormat } : {}),
-            ...(typeof entry.stream === "boolean" ? { stream: entry.stream } : {}),
-        }));
+            .map((entry) => normalizeServiceEntry(typeof entry.service === "string" && entry.service.length > 0 ? entry.service : "custom", entry));
     }
     if (raw && typeof raw === "object") {
         return Object.entries(raw)
@@ -1474,6 +1563,9 @@ function mergeServiceConfig(existing, updates) {
             ...previous,
             ...update,
             ...(update.models === undefined && previous?.models ? { models: previous.models } : {}),
+            ...(update.modelCapabilities === undefined && previous?.modelCapabilities
+                ? { modelCapabilities: previous.modelCapabilities }
+                : {}),
         });
     }
     return [...merged.values()];
@@ -1518,6 +1610,12 @@ function syncTopLevelLlmMirror(llm) {
         llm.apiFormat = selectedEntry.apiFormat;
     if (selectedEntry.stream !== undefined)
         llm.stream = selectedEntry.stream;
+    if (selectedEntry.modelCapabilities && Object.keys(selectedEntry.modelCapabilities).length > 0) {
+        llm.modelCapabilities = selectedEntry.modelCapabilities;
+    }
+    else {
+        delete llm.modelCapabilities;
+    }
 }
 async function loadRawConfig(root) {
     const configPath = join(root, "inkos.json");
@@ -1893,10 +1991,7 @@ async function fetchModelsFromServiceBaseUrl(serviceId, baseUrl, apiKey, proxyUr
                 authFailed: res.status === 401 || res.status === 403,
             };
         }
-        const json = await res.json();
-        return {
-            models: (json.data ?? []).map((m) => ({ id: m.id, name: m.id })),
-        };
+        return { models: normalizeProbedModels(await res.json()) };
     }
     catch (error) {
         return {
@@ -2067,6 +2162,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 +2186,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 +2201,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 +4288,7 @@ export function createStudioServer(initialConfig, root, overrides = {}) {
                 }
                 finally {
                     activeConfirmedTasks.delete(taskId);
+                    confirmedTaskRevisions.delete(taskId);
                     reservedProductionSessions.delete(reservedSessionId);
                 }
             }
@@ -5395,6 +5498,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 = [];