@musnows/scriverse 0.5.12 → 0.6.1

package/dist/app.js

@@ -103,7 +103,7 @@ const presenceHeartbeatSchema = z.object({
     page: z.discriminatedUnion("kind", [
         z.object({ kind: z.literal(presencePageKinds[0]) }).strict(),
         z.object({ kind: z.literal(presencePageKinds[1]), resourceId: identifier }).strict(),
-        z.object({ kind: z.literal(presencePageKinds[2]), module: z.enum(["drafts", "settings", "characters", "races", "organizations", "timeline", "relationships", "outlines", "reviews", "tasks", "ai-settings"]) }).strict(),
+        z.object({ kind: z.literal(presencePageKinds[2]), module: z.enum(["drafts", "settings", "characters", "races", "organizations", "timeline", "comments", "relationships", "outlines", "reviews", "tasks", "ai-settings"]) }).strict(),
         z.object({ kind: z.literal(presencePageKinds[3]), module: z.enum(["setting", "character", "race", "organization", "relationship"]), resourceId: identifier.optional() }).strict(),
         z.object({ kind: z.literal(presencePageKinds[4]) }).strict()
     ])
@@ -293,15 +293,14 @@ const providerSchema = z.object({
     status: z.enum(["enabled", "disabled"]).optional(),
     note: z.string().max(10_000).optional(),
     concurrencyLimit: z.number().int().min(1).max(100).optional(),
-    rpmLimit: z.number().int().min(1).max(10_000).optional(),
-    maxTokens: z.number().int().min(1).max(32_768).optional()
+    rpmLimit: z.number().int().min(1).max(10_000).optional()
 });
 const modelSchema = z.object({
     displayName: nonEmpty.max(200),
     modelId: nonEmpty.max(300),
     purposes: optionalStrings,
     contextNote: z.string().max(10_000).optional(),
-    contextWindow: z.number().int().min(1_024).max(2_000_000).optional(),
+    contextWindow: z.number().int().min(32_768, "模型上下文不能低于 32768 Token").max(2_000_000).optional(),
     outputNote: z.string().max(10_000).optional(),
     preset: jsonObject.optional(),
     thinkingEnabled: z.boolean().optional(),
@@ -323,6 +322,7 @@ const platformPageSizesSchema = z.object({
     timeline: z.number().int().min(10).max(100).optional(),
     outlines: z.number().int().min(10).max(100).optional(),
     relationships: z.number().int().min(10).max(100).optional(),
+    comments: z.number().int().min(10).max(100).optional(),
     reviews: z.number().int().min(10).max(100).optional(),
     analysisTasks: z.number().int().min(10).max(100).optional(),
     fileVersions: z.number().int().min(10).max(100).optional()
@@ -362,6 +362,15 @@ const aiProcessStepSchema = z.discriminatedUnion("type", [
         round: z.number().int().min(1).max(20),
         toolCall: aiToolCallResultSchema,
         createdAt: z.string().datetime({ offset: true })
+    }).strict(),
+    z.object({
+        id: z.string().min(1).max(300),
+        type: z.literal("context_compaction"),
+        round: z.number().int().min(1).max(20),
+        sourceMessageCount: z.number().int().min(1).max(100),
+        sourceChars: z.number().int().min(1).max(10_000_000),
+        summaryChars: z.number().int().min(1).max(1_000_000),
+        createdAt: z.string().datetime({ offset: true })
     }).strict()
 ]);
 const workAiSettingsSchema = z.object({
@@ -373,7 +382,8 @@ const workAiSettingsSchema = z.object({
     autoRunFailureThreshold: z.number().int().min(1).max(10).optional(),
     bookSummaryContextPercent: z.number().int().min(1).max(90).optional(),
     contextCompactThreshold: z.number().int().min(50).max(90).optional(),
-    agentTools: z.array(z.enum(["story_index", "read_chapters", "grep", "search_story_entities", "read_character_sections", "search_drafts"])).max(6).optional()
+    agentTools: z.array(z.enum(["story_index", "read_chapters", "grep", "search_story_entities", "read_character_sections", "search_drafts"])).max(6).optional(),
+    titleGenerationModelId: z.string().trim().max(200).optional()
 }).strict();
 const contextSchema = z.object({
     type: z.enum(["none", "selection", "chapter", "volume", "book", "entities"]),
@@ -1049,6 +1059,12 @@ export function createRuntime(options) {
         data(response, pagination ? store.listChapterInsightsPage(request.params.chapterId, pagination) : store.listChapterInsights(request.params.chapterId));
     });
     app.get("/api/chapters/:chapterId/annotations", (request, response) => data(response, store.listChapterAnnotations(request.params.chapterId)));
+    app.get("/api/works/:workId/chapter-annotations", (request, response) => {
+        const pagination = parsePagination(request.query);
+        data(response, pagination
+            ? store.listWorkChapterAnnotationsPage(request.params.workId, pagination)
+            : store.listWorkChapterAnnotations(request.params.workId));
+    });
     app.post("/api/chapters/:chapterId/annotations", (request, response) => {
         const input = parse(z.object({
             kind: z.enum(["note", "todo"]),
@@ -1670,6 +1686,8 @@ export function createRuntime(options) {
     app.patch("/api/works/:workId/ai-settings", (request, response) => {
         const workId = request.params.workId;
         const input = parse(workAiSettingsSchema, request.body);
+        if (input.titleGenerationModelId)
+            ai.assertModelAvailable(input.titleGenerationModelId);
         const before = store.getWorkAiSettings(workId);
         let updated = store.updateWorkAiSettings(workId, input);
         if (updated.autoRunEnabled) {
@@ -1681,8 +1699,11 @@ export function createRuntime(options) {
         data(response, updated);
     });
     app.get("/api/works/:workId/ai-conversations", (request, response) => {
-        const pagination = parsePagination(request.query);
-        data(response, pagination ? store.listAiConversationsPage(request.params.workId, pagination) : store.listAiConversations(request.params.workId));
+        const pagination = parsePagination({
+            page: request.query.page ?? "1",
+            limit: request.query.limit ?? "20"
+        }) ?? { page: 1, limit: 20, offset: 0 };
+        data(response, store.listAiConversationsPage(request.params.workId, pagination));
     });
     app.post("/api/works/:workId/ai-conversations", (request, response) => {
         const input = parse(z.object({ title: z.string().max(200).optional() }), request.body ?? {});
@@ -1732,32 +1753,23 @@ export function createRuntime(options) {
     app.post("/api/ai-conversations/:conversationId/compact", async (request, response) => {
         const input = parse(z.object({ modelId: identifier.optional(), scope: contextSchema }), request.body);
         const conversation = store.getAiConversation(request.params.conversationId);
-        data(response, await ai.compactConversation({
+        const compacted = await ai.compactConversation({
             conversationId: request.params.conversationId,
             workId: String(conversation.workId),
             modelId: input.modelId,
             scope: input.scope
-        }));
-    });
-    app.post("/api/works/:workId/ai-context-usage", (request, response) => {
-        const input = parse(z.object({
-            modelId: identifier.optional(),
-            taskType: z.enum(TASK_TYPES).default("chat"),
-            scope: contextSchema,
-            instruction: z.string().max(100_000).default(""),
-            citations: aiCitationsSchema.optional(),
-            conversationId: identifier.optional(),
-            currentMessageId: identifier.optional()
-        }), request.body ?? {});
-        data(response, ai.getContextUsage({
-            workId: request.params.workId,
-            modelId: input.modelId,
-            taskType: input.taskType,
-            scope: input.scope,
-            instruction: instructionWithCitations(input.instruction, input.citations ?? []),
-            conversationId: input.conversationId,
-            excludeConversationMessageId: input.currentMessageId
-        }));
+        });
+        data(response, {
+            ...compacted,
+            usage: ai.getContextUsage({
+                workId: String(conversation.workId),
+                taskType: "chat",
+                instruction: "",
+                conversationId: request.params.conversationId,
+                modelId: input.modelId,
+                scope: input.scope
+            })
+        });
     });
     app.get("/api/works/:workId/providers", (request, response) => {
         store.getWork(request.params.workId);
@@ -1779,6 +1791,7 @@ export function createRuntime(options) {
         data(response, pagination ? ai.listModelsPage(request.params.providerId, pagination) : ai.listModels(request.params.providerId));
     });
     app.post("/api/providers/:providerId/models", (request, response) => data(response, ai.createModel(request.params.providerId, parse(modelSchema, request.body)), 201));
+    app.post("/api/models/:modelId/test", async (request, response) => data(response, await ai.testModel(request.params.modelId)));
     app.get("/api/models/:modelId", (request, response) => data(response, ai.getModel(request.params.modelId)));
     app.patch("/api/models/:modelId", (request, response) => data(response, ai.updateModel(request.params.modelId, parse(modelSchema.partial(), request.body))));
     app.delete("/api/models/:modelId", (request, response) => {
@@ -1858,6 +1871,40 @@ export function createRuntime(options) {
         };
         sendEvent("ready", { streaming: true });
         try {
+            const conversation = input.conversationId
+                ? store.getAiConversationSummary(input.conversationId)
+                : store.createAiConversation(request.params.workId);
+            if (String(conversation.workId) !== request.params.workId) {
+                throw new AppError(400, "CONVERSATION_WORK_MISMATCH", "AI 对话不属于当前作品");
+            }
+            const conversationId = String(conversation.id);
+            const prepared = await ai.prepareConversationContext({
+                conversationId,
+                workId: request.params.workId,
+                modelId: input.modelId,
+                scope: input.scope,
+                instruction: instructionWithCitations(input.instruction, citations),
+                excludeConversationMessageId: input.currentMessageId
+            });
+            sendEvent("context", {
+                ...prepared,
+                conversation: {
+                    ...store.getAiConversationSummary(conversationId),
+                    contextWarningPending: prepared.action === "warn"
+                }
+            });
+            if (prepared.action === "warn")
+                return;
+            const userMessage = input.currentMessageId
+                ? null
+                : store.addAiConversationMessage(conversationId, {
+                    role: "user",
+                    content: input.instruction,
+                    citations
+                });
+            const currentMessageId = input.currentMessageId ?? String(userMessage?.id ?? "");
+            if (userMessage)
+                sendEvent("user_message", { message: userMessage });
             const suggestion = await ai.createStreamingChat({
                 workId: request.params.workId,
                 instruction: instructionWithCitations(input.instruction, citations),
@@ -1865,9 +1912,10 @@ export function createRuntime(options) {
                 signal: controller.signal,
                 onToolCall: (toolCall, round) => sendEvent("tool_call", { ...toolCall, round }),
                 onProcessStep: (step) => sendEvent("process_step", step),
-                conversationId: input.conversationId,
-                excludeConversationMessageId: input.currentMessageId,
-                ...(input.currentMessageId ? { assistantMessageRequestId: `assistant:${input.currentMessageId}` } : {}),
+                onContextCompacted: (event) => sendEvent("context_compacted", event),
+                conversationId,
+                excludeConversationMessageId: currentMessageId,
+                ...(currentMessageId ? { assistantMessageRequestId: `assistant:${currentMessageId}` } : {}),
                 ...(input.modelId ? { modelId: input.modelId } : {}),
                 ...(input.parameters ? { parameters: input.parameters } : {})
             }, (delta) => sendEvent("delta", { delta }));
@@ -1881,6 +1929,9 @@ export function createRuntime(options) {
                 chapterVersion: suggestion.chapterVersion,
                 toolCalls: suggestion.toolCalls,
                 processSteps: suggestion.processSteps,
+                contextUsage: suggestion.contextUsage,
+                conversationId,
+                conversationTitle: suggestion.conversationTitle,
                 messageId: typeof suggestion.conversationMessage === "object" && suggestion.conversationMessage !== null
                     ? suggestion.conversationMessage.id
                     : undefined,
@@ -1891,9 +1942,19 @@ export function createRuntime(options) {
         }
         catch (error) {
             if (!controller.signal.aborted) {
+                const details = error instanceof AppError && error.details && typeof error.details === "object" && !Array.isArray(error.details)
+                    ? error.details
+                    : null;
                 sendEvent("error", {
                     code: error instanceof AppError ? error.code : "AI_STREAM_FAILED",
-                    message: error instanceof Error ? error.message : "AI 流式调用失败"
+                    message: error instanceof Error ? error.message : "AI 流式调用失败",
+                    ...(error instanceof AppError ? { status: error.status } : {}),
+                    ...(typeof details?.failure === "string" ? { failure: details.failure } : {}),
+                    ...(typeof details?.callId === "string" ? { callId: details.callId } : {}),
+                    ...(typeof details?.providerName === "string" ? { providerName: details.providerName } : {}),
+                    ...(typeof details?.providerId === "string" ? { providerId: details.providerId } : {}),
+                    ...(typeof details?.modelId === "string" ? { modelId: details.modelId } : {}),
+                    ...(typeof details?.modelRecordId === "string" ? { modelRecordId: details.modelRecordId } : {})
                 });
             }
         }