@actalk/inkos-studio 1.6.1 → 1.6.3-canary.52.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;AAK5B,OAAO,EAyFL,KAAK,aAAa,EAIlB,KAAK,aAAa,EAKnB,MAAM,oBAAoB,CAAC;AA+6D5B,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE;IAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,aAAa,CAAA;CAAO,8EAq4G7I;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;AAK5B,OAAO,EAgGL,KAAK,aAAa,EAIlB,KAAK,aAAa,EAMnB,MAAM,oBAAoB,CAAC;AA8jE5B,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE;IAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,aAAa,CAAA;CAAO,8EAq7G7I;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

@@ -3,7 +3,7 @@ import { cors } from "hono/cors";
 import { streamSSE } from "hono/streaming";
 import { serve } from "@hono/node-server";
 import { gzipSync } from "node:zlib";
-import { StateManager, PipelineRunner, createLLMClient, createLogger, createInteractionToolsFromDeps, computeAnalytics, loadProjectConfig, loadProjectSession, processProjectInteractionRequest, resolveSessionActiveBook, listBookSessions, loadBookSession, appendManualSessionMessages, createAndPersistBookSession, renameBookSession, deleteBookSession, migrateBookSession, SessionAlreadyMigratedError, runAgentSession, resolveServicePreset, resolveServiceProviderFamily, resolveServiceModelsBaseUrl, guessServiceFromBaseUrl, resolveServiceModel, loadSecrets, saveSecrets, listModelsForService, isApiKeyOptionalForEndpoint, getAllEndpoints, probeModelsFromUpstream, fetchWithProxy, chatCompletion, buildExportArtifact, evaluateBookQuality, ConsolidatorAgent, DetectionConfigSchema, ResearchSearchConfigSchema, InputGovernanceModeSchema, GLOBAL_ENV_PATH, COVER_PROVIDER_PRESETS, createPlayDB, PlayStore, buildPlayEntityImagePrompt, buildPlaySceneImagePrompt, generatePlayImage, readPlayImageManifest, readPlayImageSettings, writePlayImageSettings, Scheduler, coverSecretKey, resolveCoverProviderPreset, SessionKindSchema, isExplicitWriteChapterCommand, isUsablePlayInitialScene, isWriteNextInstruction, normalizeActionSource as normalizeCoreActionSource, normalizeActionPayload as normalizeCoreActionPayload, normalizePlayMode as normalizeCorePlayMode, normalizeRequestedIntent as normalizeCoreRequestedIntent, normalizeSkillIdList as normalizeCoreSkillIdList, inferLanguage, createSkillRegistry, loadConfiguredCapabilitySkills, CapabilitySkillManifestSchema, createGenerateCoverTool, createInteractiveFilmCreationTool, createPlayStartTool, createScriptCreationTool, createShortFictionRunTool, createStoryboardCreationTool, createSubAgentTool, createDraftStructureTool, createConnectChoiceTool, createRemoveNodeTool, filmLLMDepsFromClient, applyGraphDelta, loadStoryGraph, reviewStoryGraph, exportInk, buildPlayableHtml, analyzeEmotionalArcs, analyzePathDistribution, generateNodeImage, defaultNodeImageDeps, } from "@actalk/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, buildExportArtifact, evaluateBookQuality, ConsolidatorAgent, DetectionConfigSchema, ResearchSearchConfigSchema, InputGovernanceModeSchema, GLOBAL_ENV_PATH, COVER_PROVIDER_PRESETS, createPlayDB, PlayStore, buildPlayEntityImagePrompt, buildPlaySceneImagePrompt, generatePlayImage, readPlayImageManifest, readPlayImageSettings, writePlayImageSettings, Scheduler, coverSecretKey, resolveCoverProviderPreset, SessionKindSchema, isExplicitWriteChapterCommand, isUsablePlayInitialScene, isWriteNextInstruction, normalizeActionSource as normalizeCoreActionSource, normalizeActionPayload as normalizeCoreActionPayload, normalizePlayMode as normalizeCorePlayMode, normalizeRequestedIntent as normalizeCoreRequestedIntent, normalizeSkillIdList as normalizeCoreSkillIdList, inferLanguage, createSkillRegistry, loadConfiguredCapabilitySkills, CapabilitySkillManifestSchema, getBuiltinPrompt, listBuiltinPromptPacks, listBuiltinPrompts, loadPromptPackPrompt, promptOverridePath, createGenerateCoverTool, createInteractiveFilmCreationTool, createPlayStartTool, createScriptCreationTool, createShortFictionRunTool, createStoryboardCreationTool, createSubAgentTool, createDraftStructureTool, createConnectChoiceTool, createRemoveNodeTool, filmLLMDepsFromClient, applyGraphDelta, loadStoryGraph, reviewStoryGraph, exportInk, buildPlayableHtml, analyzeEmotionalArcs, analyzePathDistribution, generateNodeImage, defaultNodeImageDeps, } from "@actalk/inkos-core";
 import { access, mkdir, readFile, readdir, rm, stat, writeFile } from "node:fs/promises";
 import { dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { isSafeBookId } from "./safety.js";
@@ -351,6 +351,106 @@ function normalizeStudioSkillId(value, field = "skillId") {
         throw new ApiError(400, "INVALID_SKILL_ID", `Invalid ${field}: empty`);
     return id;
 }
+const MAX_AGENT_ATTACHMENTS = 8;
+const MAX_AGENT_ATTACHMENT_BYTES = 4 * 1024 * 1024;
+const MAX_AGENT_ATTACHMENT_TEXT_CHARS = 120_000;
+function safeUploadFileName(value) {
+    const trimmed = value.trim().replace(/[/\\\0]/g, "_").replace(/\s+/g, " ");
+    const safe = trimmed.replace(/[^\p{L}\p{N}._ -]+/gu, "_").slice(0, 120).trim();
+    return safe || "upload";
+}
+function isTextAttachment(filename, mimeType) {
+    const lower = filename.toLowerCase();
+    return mimeType.startsWith("text/")
+        || [
+            ".txt",
+            ".md",
+            ".markdown",
+            ".json",
+            ".csv",
+            ".tsv",
+            ".yaml",
+            ".yml",
+            ".log",
+        ].some((suffix) => lower.endsWith(suffix));
+}
+function parseDataUrl(dataUrl) {
+    const match = /^data:([^;,]+)?(?:;[^,]*)?;base64,(.*)$/s.exec(dataUrl);
+    if (!match) {
+        throw new ApiError(400, "INVALID_ATTACHMENT_DATA_URL", "Attachment must be a base64 data URL");
+    }
+    const mimeType = match[1]?.trim() || "application/octet-stream";
+    return { mimeType, buffer: Buffer.from(match[2] ?? "", "base64") };
+}
+async function normalizeAgentAttachments(root, sessionId, value) {
+    if (value === undefined || value === null)
+        return [];
+    if (!Array.isArray(value)) {
+        throw new ApiError(400, "INVALID_ATTACHMENTS", "attachments must be an array");
+    }
+    if (value.length > MAX_AGENT_ATTACHMENTS) {
+        throw new ApiError(413, "TOO_MANY_ATTACHMENTS", `At most ${MAX_AGENT_ATTACHMENTS} files can be attached to one message`);
+    }
+    const uploadDir = join(root, ".inkos", "uploads", safeUploadFileName(sessionId));
+    const out = [];
+    for (const [index, raw] of value.entries()) {
+        if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+            throw new ApiError(400, "INVALID_ATTACHMENT", "Each attachment must be an object");
+        }
+        const payload = raw;
+        const filename = safeUploadFileName(payload.filename || `upload-${index + 1}`);
+        if (!payload.dataUrl) {
+            throw new ApiError(400, "INVALID_ATTACHMENT", `Attachment ${filename} is missing dataUrl`);
+        }
+        const parsed = parseDataUrl(payload.dataUrl);
+        const mimeType = payload.mediaType?.trim() || parsed.mimeType;
+        if (parsed.buffer.byteLength > MAX_AGENT_ATTACHMENT_BYTES) {
+            throw new ApiError(413, "ATTACHMENT_TOO_LARGE", `${filename} exceeds ${MAX_AGENT_ATTACHMENT_BYTES} bytes`);
+        }
+        await mkdir(uploadDir, { recursive: true });
+        const storedName = `${Date.now()}-${index + 1}-${filename}`;
+        const storedPath = join(uploadDir, storedName);
+        await writeFile(storedPath, parsed.buffer);
+        const relPath = relative(root, storedPath);
+        if (mimeType.startsWith("image/")) {
+            out.push({
+                id: payload.id || `${Date.now()}-${index}`,
+                filename,
+                mimeType,
+                size: parsed.buffer.byteLength,
+                storedPath: relPath,
+                image: {
+                    data: parsed.buffer.toString("base64"),
+                    mimeType,
+                },
+            });
+            continue;
+        }
+        if (isTextAttachment(filename, mimeType)) {
+            const text = parsed.buffer.toString("utf-8");
+            if (text.length > MAX_AGENT_ATTACHMENT_TEXT_CHARS) {
+                throw new ApiError(413, "ATTACHMENT_TEXT_TOO_LARGE", `${filename} is too large to inject without semantic compaction`);
+            }
+            out.push({
+                id: payload.id || `${Date.now()}-${index}`,
+                filename,
+                mimeType,
+                size: parsed.buffer.byteLength,
+                storedPath: relPath,
+                text,
+            });
+            continue;
+        }
+        out.push({
+            id: payload.id || `${Date.now()}-${index}`,
+            filename,
+            mimeType,
+            size: parsed.buffer.byteLength,
+            storedPath: relPath,
+        });
+    }
+    return out;
+}
 function projectSkillsDir(root) {
     return join(root, ".inkos", "skills");
 }
@@ -443,6 +543,27 @@ async function loadStudioSkills(root) {
         diagnostics: configured.diagnostics,
     };
 }
+async function toStudioPromptPackPrompt(root, prompt) {
+    const loaded = await loadPromptPackPrompt({ promptId: prompt.id, projectRoot: root });
+    const overridePath = promptOverridePath(root, prompt.id);
+    return {
+        id: prompt.id,
+        packId: prompt.packId,
+        title: prompt.title,
+        defaultContent: prompt.content,
+        content: loaded.content,
+        source: loaded.source,
+        overridden: loaded.source === "project",
+        path: loaded.source === "project" ? relative(root, overridePath) : undefined,
+    };
+}
+function normalizeStudioPromptId(value) {
+    const promptId = typeof value === "string" ? value.trim().toLowerCase() : "";
+    if (!promptId || !getBuiltinPrompt(promptId)) {
+        throw new ApiError(404, "PROMPT_PACK_PROMPT_NOT_FOUND", `Prompt pack prompt not found: ${String(value)}`);
+    }
+    return promptId;
+}
 async function listProjectSkillIds(root) {
     try {
         const entries = await readdir(projectSkillsDir(root), { withFileTypes: true });
@@ -2613,6 +2734,37 @@ export function createStudioServer(initialConfig, root, overrides = {}) {
         const result = await loadStudioSkills(root);
         return c.json(result);
     });
+    app.get("/api/v1/prompt-packs", async (c) => {
+        const prompts = await Promise.all(listBuiltinPrompts().map((prompt) => toStudioPromptPackPrompt(root, prompt)));
+        return c.json({
+            packs: listBuiltinPromptPacks(),
+            prompts,
+        });
+    });
+    app.put("/api/v1/prompt-packs/:promptId", async (c) => {
+        const promptId = normalizeStudioPromptId(c.req.param("promptId"));
+        const payload = await c.req.json().catch(() => {
+            throw new ApiError(400, "INVALID_PROMPT_PACK_PAYLOAD", "Prompt pack payload must be JSON");
+        });
+        const content = payload && typeof payload === "object" && "content" in payload
+            ? payload.content
+            : undefined;
+        if (typeof content !== "string") {
+            throw new ApiError(400, "INVALID_PROMPT_PACK_PAYLOAD", "content must be a string");
+        }
+        const file = promptOverridePath(root, promptId);
+        await mkdir(dirname(file), { recursive: true });
+        await writeFile(file, content, "utf-8");
+        const prompt = listBuiltinPrompts().find((item) => item.id === promptId);
+        return c.json({ prompt: await toStudioPromptPackPrompt(root, prompt) });
+    });
+    app.delete("/api/v1/prompt-packs/:promptId", async (c) => {
+        const promptId = normalizeStudioPromptId(c.req.param("promptId"));
+        const file = promptOverridePath(root, promptId);
+        await rm(file, { force: true });
+        const prompt = listBuiltinPrompts().find((item) => item.id === promptId);
+        return c.json({ prompt: await toStudioPromptPackPrompt(root, prompt) });
+    });
     app.post("/api/v1/skills", async (c) => {
         const payload = await c.req.json().catch(() => {
             throw new ApiError(400, "INVALID_SKILL_PAYLOAD", "Skill payload must be JSON");
@@ -3093,8 +3245,14 @@ export function createStudioServer(initialConfig, root, overrides = {}) {
         await deleteBookSession(root, c.req.param("sessionId"));
         return c.json({ ok: true });
     });
+    app.post("/api/v1/sessions/:sessionId/abort", async (c) => {
+        const sessionId = c.req.param("sessionId");
+        const aborted = abortAgentSession(root, sessionId);
+        broadcast("agent:aborted", { sessionId, aborted });
+        return c.json({ ok: true, aborted });
+    });
     app.post("/api/v1/agent", async (c) => {
-        const { instruction, activeBookId, sessionId: reqSessionId, sessionKind: reqSessionKind, actionSource: reqActionSource, requestedIntent: reqRequestedIntent, actionPayload: reqActionPayload, requestedSkills: reqRequestedSkills, disabledSkills: reqDisabledSkills, playMode: reqPlayMode, model: reqModel, service: reqService, } = await c.req.json();
+        const { instruction, activeBookId, sessionId: reqSessionId, sessionKind: reqSessionKind, actionSource: reqActionSource, requestedIntent: reqRequestedIntent, actionPayload: reqActionPayload, requestedSkills: reqRequestedSkills, disabledSkills: reqDisabledSkills, attachments: reqAttachments, playMode: reqPlayMode, model: reqModel, service: reqService, } = await c.req.json();
         const sessionId = reqSessionId;
         if (!instruction?.trim()) {
             return c.json({ error: "No instruction provided" }, 400);
@@ -3111,8 +3269,9 @@ export function createStudioServer(initialConfig, root, overrides = {}) {
         const actionPayload = normalizeStudioActionPayload(reqActionPayload);
         const requestedSkills = normalizeStudioSkillIdList(reqRequestedSkills, "requestedSkills");
         const disabledSkills = normalizeStudioSkillIdList(reqDisabledSkills, "disabledSkills");
+        const attachments = await normalizeAgentAttachments(root, sessionId, reqAttachments);
         const playMode = normalizeStudioPlayMode(reqPlayMode);
-        broadcast("agent:start", { instruction, activeBookId, sessionId, actionSource, requestedIntent, requestedSkills });
+        broadcast("agent:start", { instruction, activeBookId, sessionId, actionSource, requestedIntent, requestedSkills, attachments: attachments.length });
         try {
             // Load config + create LLM client (pipeline created after model resolution)
             const config = await loadCurrentProjectConfig({ requireApiKey: false });
@@ -3494,6 +3653,7 @@ export function createStudioServer(initialConfig, root, overrides = {}) {
                 actionPayload,
                 requestedSkills,
                 disabledSkills,
+                attachments,
                 sessionId: bookSession.sessionId,
                 language: surfaceLanguage,
                 onContextCompression: (event) => {