@musnows/scriverse 1.0.12 → 1.1.0

package/dist/ai.js

@@ -10,7 +10,9 @@ import { DEFAULT_AI_STREAM_IDLE_TIMEOUT_MS, normalizeAiStreamIdleTimeoutSeconds
 import { DEFAULT_AI_CHAT_IMAGE_MAX_BYTES, formatUploadLimit } from "./upload-limits.js";
 import { characterExtractionHash, characterExtractionSelectionFingerprint, editableCharacterExtractionCandidate, normalizeCharacterExtractionCandidate, parseStoredCharacterExtractionCandidates } from "./character-extraction.js";
 import { AI_WRITE_TOOL_IDS, aiWritePlanOperationToolSchemas, askAiUserQuestionInputSchema } from "./ai-write-plans.js";
+import { DEFAULT_CHAPTER_ANNOTATION_NOTE_MAX_LENGTH } from "./chapter-annotation-note.js";
 import { PLATFORM_AI_WORK_ID } from "./database.js";
+import { AiStreamSteerMailbox, formatAiSteerInstruction, isAiSteerRefreshError, createAiSteerRefreshError } from "./ai-stream-steer.js";
 import { AppError, notFound } from "./errors.js";
 import { assertOfficialGoogleVertexBaseUrl, fetchGoogleOAuthAccessToken, GoogleVertexTokenCache, maskServiceAccountHint, parseGoogleServiceAccount } from "./google-vertex-auth.js";
 import { HYBRID_SEARCH_TYPES, MAXIMUM_WORK_SEARCH_QUERY_LENGTH, buildHybridSearchSnippet, documentParagraphLineRangesFromLines, fuseHybridSearchChannels, hybridSearchPermissionModule, normalizeWorkSearchQuery } from "./hybrid-search.js";
@@ -1174,7 +1176,7 @@ const AGENT_TOOL_DEFINITIONS = {
         }
     }
 };
-export function writePlanToolDefinition(toggles) {
+export function writePlanToolDefinition(toggles, chapterAnnotationNoteMaxLength = DEFAULT_CHAPTER_ANNOTATION_NOTE_MAX_LENGTH) {
     const entityTypes = [
         ...(toggles.settings ? ["setting"] : []),
         ...(toggles.characters ? ["character"] : []),
@@ -1184,7 +1186,7 @@ export function writePlanToolDefinition(toggles) {
         ...(toggles.relationships ? ["relationship"] : []),
         ...(toggles.outlines ? ["chapter-outline", "foreshadow"] : [])
     ];
-    const operationSchemas = aiWritePlanOperationToolSchemas(toggles);
+    const operationSchemas = aiWritePlanOperationToolSchemas(toggles, chapterAnnotationNoteMaxLength);
     const operationTypes = [
         ...(entityTypes.length > 0 ? ["create_entry", "update_entry"] : []),
         ...(toggles.annotations ? ["create_annotation"] : []),
@@ -2033,7 +2035,16 @@ export class ContextBuilder {
                 const state = item.currentState;
                 const values = locked.map((key) => {
                     const entityValue = item[key];
-                    const value = entityValue === undefined || entityValue === null || entityValue === "" ? attributes[key] ?? state[key] : entityValue;
+                    const detailMatch = Array.isArray(attributes.details)
+                        ? attributes.details.find((detail) => detail && typeof detail === "object" && !Array.isArray(detail)
+                            && String(detail.label ?? "") === key)
+                        : undefined;
+                    const detailValue = detailMatch && typeof detailMatch === "object"
+                        ? detailMatch.value
+                        : undefined;
+                    const value = entityValue === undefined || entityValue === null || entityValue === ""
+                        ? attributes[key] ?? detailValue ?? state[key]
+                        : entityValue;
                     return `${key}=${String(value ?? "未填写")}`;
                 }).join("；");
                 return `- ${String(item.name)}：${values}`;
@@ -2453,10 +2464,18 @@ export class AiManager {
     remoteMcp;
     // 可写工具与用户提问的审批引擎：由应用装配层注入（app.ts），默认未注入 = 功能整体不可用。
     aiWritePlanManager = null;
+    steerMailbox = new AiStreamSteerMailbox();
     /** 注入 AI 写入审批管理器；注入后 propose_write_plan / ask_user_question 才可能被启用。 */
     attachWritePlanManager(manager) {
         this.aiWritePlanManager = manager;
     }
+    enqueueSteer(workId, conversationId, content) {
+        const conversation = this.store.getAiConversationSummary(conversationId);
+        if (String(conversation.workId) !== workId) {
+            throw new AppError(400, "CONVERSATION_WORK_MISMATCH", "AI 对话不属于当前作品");
+        }
+        return this.steerMailbox.enqueue(conversationId, content);
+    }
     constructor(store, vault, fetchImpl = fetch, validateOutboundUrl, authorizeTaskRun, attachmentStorage, options = {}) {
         this.store = store;
         this.vault = vault;
@@ -5133,21 +5152,35 @@ export class AiManager {
         const processStartedAt = process.hrtime.bigint();
         let persistedConversationMessage = null;
         let streamedConversationContent = "";
+        let assistantPersistRequestId = input.assistantMessageRequestId;
         const persistStreamDelta = (delta) => {
-            if (input.conversationId && input.assistantMessageRequestId && delta.length > 0) {
+            if (input.conversationId && assistantPersistRequestId && delta.length > 0) {
                 streamedConversationContent += delta;
-                persistedConversationMessage = this.store.upsertAiConversationAssistantMessage(input.conversationId, input.assistantMessageRequestId, streamedConversationContent);
+                persistedConversationMessage = this.store.upsertAiConversationAssistantMessage(input.conversationId, assistantPersistRequestId, streamedConversationContent);
             }
             onDelta(delta);
         };
         let generated;
         try {
-            generated = await this.generate({ ...effectiveInput, taskType: "chat" }, persistStreamDelta);
+            generated = await this.generate({
+                ...effectiveInput,
+                taskType: "chat",
+                onSteer: (event) => {
+                    if (input.conversationId && assistantPersistRequestId && streamedConversationContent.length > 0) {
+                        persistedConversationMessage = this.store.upsertAiConversationAssistantMessage(input.conversationId, assistantPersistRequestId, streamedConversationContent, {}, true);
+                    }
+                    assistantPersistRequestId = input.excludeConversationMessageId
+                        ? `assistant:${input.excludeConversationMessageId}:after:${event.id}`
+                        : `assistant:steer:${event.id}`;
+                    streamedConversationContent = "";
+                    input.onSteer?.(event);
+                }
+            }, persistStreamDelta);
         }
         catch (error) {
-            if (persistedConversationMessage && input.conversationId && input.assistantMessageRequestId) {
+            if (persistedConversationMessage && input.conversationId && assistantPersistRequestId) {
                 const interruptionCode = error instanceof AppError ? error.code : "AI_STREAM_FAILED";
-                persistedConversationMessage = this.store.upsertAiConversationAssistantMessage(input.conversationId, input.assistantMessageRequestId, streamedConversationContent, { interrupted: true, interruptionCode }, true);
+                persistedConversationMessage = this.store.upsertAiConversationAssistantMessage(input.conversationId, assistantPersistRequestId, streamedConversationContent, { interrupted: true, interruptionCode }, true);
             }
             throw error;
         }
@@ -5179,8 +5212,8 @@ export class AiManager {
                 : "已向你提出问题，等待回答后继续。";
             if (!streamedConversationContent.trim())
                 persistStreamDelta(suspendedContent);
-            const conversationMessage = input.conversationId && input.assistantMessageRequestId
-                ? this.store.upsertAiConversationAssistantMessage(input.conversationId, input.assistantMessageRequestId, suspendedContent, generatedMessageMetadata, true)
+            const conversationMessage = input.conversationId && assistantPersistRequestId
+                ? this.store.upsertAiConversationAssistantMessage(input.conversationId, assistantPersistRequestId, suspendedContent, generatedMessageMetadata, true)
                 : persistedConversationMessage;
             return {
                 id: `question:${generated.suspendedQuestionId}`,
@@ -5197,8 +5230,10 @@ export class AiManager {
                 ...(conversationMessage ? { conversationMessage } : {})
             };
         }
-        const conversationMessage = input.conversationId && input.assistantMessageRequestId
-            ? this.store.upsertAiConversationAssistantMessage(input.conversationId, input.assistantMessageRequestId, generated.content, {
+        const conversationMessage = input.conversationId && assistantPersistRequestId
+            ? this.store.upsertAiConversationAssistantMessage(input.conversationId, assistantPersistRequestId, assistantPersistRequestId === input.assistantMessageRequestId
+                ? generated.content
+                : streamedConversationContent, {
                 ...generatedMessageMetadata,
                 ...(activeWritingSkillName && !generated.toolCallLimit ? { activeSkills: [activeWritingSkillName] } : {}),
                 ...(input.toolContinuation
@@ -6897,11 +6932,13 @@ export class AiManager {
     }
     enabledAgentTools(workId, taskType, requestedToolIds, conversationId, roleplayCharacterIdOverride) {
         const toolIds = this.enabledAgentToolIds(workId, taskType, requestedToolIds, conversationId, roleplayCharacterIdOverride);
-        const writeToggles = this.aiWritePlanManager && conversationId
-            ? this.aiWritePlanManager.getConversationTools(workId, conversationId)
+        const writePlanManager = this.aiWritePlanManager;
+        const writeToggles = writePlanManager && conversationId
+            ? writePlanManager.getConversationTools(workId, conversationId)
             : null;
+        const chapterAnnotationNoteMaxLength = writePlanManager?.chapterAnnotationNoteMaxLength ?? DEFAULT_CHAPTER_ANNOTATION_NOTE_MAX_LENGTH;
         const builtInTools = toolIds.map((toolId) => toolId === "propose_write_plan" && writeToggles
-            ? writePlanToolDefinition(writeToggles)
+            ? writePlanToolDefinition(writeToggles, chapterAnnotationNoteMaxLength)
             : AGENT_TOOL_DEFINITIONS[toolId]);
         const roleplayCharacterId = roleplayCharacterIdOverride === undefined
             ? this.roleplayCharacterId(workId, conversationId)
@@ -8929,11 +8966,24 @@ export class AiManager {
                                 }
                             }
                             const controller = new AbortController();
+                            const steerRefreshController = new AbortController();
+                            const detachSteerRefresh = input.conversationId && input.taskType === "chat"
+                                ? this.steerMailbox.subscribe(input.conversationId, steerRefreshController)
+                                : () => undefined;
                             const forwardAbort = () => controller.abort(input.signal?.reason);
+                            const forwardSteerRefresh = () => {
+                                if (!controller.signal.aborted) {
+                                    controller.abort(steerRefreshController.signal.reason ?? createAiSteerRefreshError());
+                                }
+                            };
                             if (input.signal?.aborted)
                                 forwardAbort();
                             else
                                 input.signal?.addEventListener("abort", forwardAbort, { once: true });
+                            if (steerRefreshController.signal.aborted)
+                                forwardSteerRefresh();
+                            else
+                                steerRefreshController.signal.addEventListener("abort", forwardSteerRefresh, { once: true });
                             const streamWatchdog = streamResponse
                                 ? new InteractiveStreamIdleWatchdog(controller, this.interactiveStreamIdleTimeoutMs)
                                 : null;
@@ -9004,6 +9054,9 @@ export class AiManager {
                                     }
                                     throw interactiveStreamRequestCancelledError();
                                 }
+                                if (streamResponse && !input.signal?.aborted && isAiSteerRefreshError(controller.signal.reason)) {
+                                    throw createAiSteerRefreshError();
+                                }
                                 if (streamWatchdog?.failure)
                                     throw streamWatchdog.failure;
                                 if (streamResponse && !responseReceived) {
@@ -9016,6 +9069,7 @@ export class AiManager {
                                     clearTimeout(timeout);
                                 streamWatchdog?.dispose();
                                 input.signal?.removeEventListener("abort", forwardAbort);
+                                detachSteerRefresh();
                             }
                         }, input.beforeRequest);
                         logger.info("ai.call.attempt_completed", {
@@ -9083,6 +9137,22 @@ export class AiManager {
                         }
                     }
                     catch (error) {
+                        if (isAiSteerRefreshError(error)) {
+                            const parsed = {
+                                choices: [{
+                                        finish_reason: "stop",
+                                        message: { content: streamedRoundContent || null }
+                                    }]
+                            };
+                            completionDelivery.set(parsed, streamResponse ? "sse" : "json");
+                            if (streamResponse && purpose === "generation" && streamedRoundContent.length > 0) {
+                                streamedContent += streamedRoundContent;
+                            }
+                            traceAttempt.completedAt = now();
+                            traceAttempt.status = "completed";
+                            saveTrace();
+                            return parsed;
+                        }
                         lastFailure = error;
                         if (requestAttemptLimit !== null && !failureCounted)
                             requestFailureCount += 1;
@@ -9272,128 +9342,171 @@ export class AiManager {
             let suspendedQuestionId = null;
             let toolCallLimit;
             let toolCallLimitMessage = "";
-            while (choice?.message?.tool_calls?.length) {
-                const round = toolRound + 1;
-                recordChoiceProcess(payload, round, true);
-                const toolCalls = choice.message.tool_calls;
-                if (shouldRejectGlobalToolCalls(globalToolCallUsed, toolCalls.length, globalToolCallLimit)) {
-                    logger.warn("ai.tool_call.global_limit_reached", {
-                        callId,
-                        workId: input.workId,
-                        agentToolCallLimit,
-                        globalLimit: globalToolCallLimit,
-                        actualCalls: globalToolCallUsed,
-                        requestedCalls: toolCalls.length,
-                        compactCount: toolContextCompactCount,
-                        turnQuotaUsed: toolCallQuotaUsed,
-                        toolsCalled: executedToolCalls.map((item) => item.name)
+            const commitAssistantChoice = () => {
+                if (!choice?.message || choice.message.tool_calls?.length)
+                    return;
+                const content = typeof choice.message.content === "string" ? choice.message.content : "";
+                if (!content.trim() && !choice.message.reasoning_content)
+                    return;
+                completionMessages.push({
+                    role: "assistant",
+                    content: content || null,
+                    reasoning_content: choice.message.reasoning_content ?? null
+                });
+            };
+            const applyPendingSteers = () => {
+                if (!input.conversationId || input.taskType !== "chat")
+                    return false;
+                const pending = this.steerMailbox.drain(input.conversationId);
+                if (!pending.length)
+                    return false;
+                commitAssistantChoice();
+                for (const steer of pending) {
+                    const message = this.store.addAiConversationMessage(input.conversationId, {
+                        role: "user",
+                        content: steer.content,
+                        requestId: `steer:${steer.id}`,
+                        metadata: { kind: "steer" }
                     });
-                    toolCallLimit = { scope: "global", used: globalToolCallUsed, limit: globalToolCallLimit, requested: toolCalls.length };
-                }
-                if (!toolCallLimit && shouldRejectAgentToolCalls(toolCallQuotaUsed, toolCalls.length, agentToolCallLimit)) {
-                    toolCallLimit = { scope: "cycle", used: toolCallQuotaUsed, limit: agentToolCallLimit, requested: toolCalls.length };
+                    completionMessages.push({
+                        role: "user",
+                        content: formatAiSteerInstruction(steer.content)
+                    });
+                    input.onSteer?.({ id: steer.id, content: steer.content, message });
                 }
-                if (toolCallLimit) {
-                    const limitLabel = toolCallLimit.scope === "global" ? "整次回答的全局上限" : "本轮调用上限";
-                    toolCallLimitMessage = `Agent 工具调用额度不足：${limitLabel} ${toolCallLimit.limit} 次，已用 ${toolCallLimit.used} 次，模型还请求 ${toolCallLimit.requested} 次。\n\n已保留此前的回复与执行过程。你可以在本书 AI 设置中调整“Agent 工具调用上限”${toolCallLimit.scope === "global" ? "或全局倍数" : ""}，再发送“继续”完成剩余工作。`;
-                    if (input.taskType !== "chat" || input.im) {
-                        throw new AppError(409, "AI_TOOL_CALL_LIMIT_REACHED", toolCallLimitMessage, { toolCallLimit });
+                return true;
+            };
+            generationTurn: for (;;) {
+                while (choice?.message?.tool_calls?.length) {
+                    const round = toolRound + 1;
+                    recordChoiceProcess(payload, round, true);
+                    const toolCalls = choice.message.tool_calls;
+                    if (shouldRejectGlobalToolCalls(globalToolCallUsed, toolCalls.length, globalToolCallLimit)) {
+                        logger.warn("ai.tool_call.global_limit_reached", {
+                            callId,
+                            workId: input.workId,
+                            agentToolCallLimit,
+                            globalLimit: globalToolCallLimit,
+                            actualCalls: globalToolCallUsed,
+                            requestedCalls: toolCalls.length,
+                            compactCount: toolContextCompactCount,
+                            turnQuotaUsed: toolCallQuotaUsed,
+                            toolsCalled: executedToolCalls.map((item) => item.name)
+                        });
+                        toolCallLimit = { scope: "global", used: globalToolCallUsed, limit: globalToolCallLimit, requested: toolCalls.length };
                     }
-                    break;
-                }
-                const normalizedToolCalls = toolCalls.map((toolCall) => ({
-                    ...toolCall,
-                    function: {
-                        ...toolCall.function,
-                        arguments: typeof toolCall.function.arguments === "string" ? toolCall.function.arguments : JSON.stringify(toolCall.function.arguments ?? {})
+                    if (!toolCallLimit && shouldRejectAgentToolCalls(toolCallQuotaUsed, toolCalls.length, agentToolCallLimit)) {
+                        toolCallLimit = { scope: "cycle", used: toolCallQuotaUsed, limit: agentToolCallLimit, requested: toolCalls.length };
                     }
-                }));
-                const toolTraceRound = traceRounds.at(-1);
-                const assistantToolMessage = {
-                    role: "assistant",
-                    content: choice.message.content ?? null,
-                    reasoning_content: choice.message.reasoning_content ?? null,
-                    tool_calls: normalizedToolCalls,
-                    ...(choice.message.anthropic_content?.length ? { anthropic_content: choice.message.anthropic_content } : {})
-                };
-                if (shouldCompactBeforeToolRound(assistantToolMessage, toolCalls.length)) {
-                    await compactToolContext([], round);
-                }
-                const maximumResultChars = toolResultMaximumChars(assistantToolMessage, toolCalls.length);
-                const currentRoundMessages = [assistantToolMessage];
-                const nativeImageMessages = [];
-                for (const toolCall of toolCalls) {
-                    input.beforeRequest?.();
-                    const execution = await this.executeAgentTool(input.workId, toolCall, maximumResultChars, generationRoleplayCharacterId, allowedToolIds, input.signal, trackUsage, input.scope, model, provider, {
-                        conversationId: input.conversationId ?? null,
-                        im: Boolean(input.im),
-                        listImMembers: input.im?.listMembers,
-                        searchImMessages: input.im?.searchMessages
-                    }, stagedRoleplayMemoryCandidates, allowedRemoteMcpToolNames, input.beforeRequest);
-                    const { nativeImage, ...toolExecution } = execution;
-                    const permissionModules = this.executedAgentToolPermissionModules(input.workId, toolExecution);
-                    logger.info("ai.tool_call.completed", {
-                        callId,
-                        toolName: toolExecution.name,
-                        status: toolExecution.status,
-                        round,
-                        maximumResultChars
-                    });
-                    executedToolCalls.push(toolExecution);
-                    toolCallQuotaUsed += 1;
-                    globalToolCallUsed += 1;
-                    const remainingToolCalls = Math.max(0, agentToolCallLimit - toolCallQuotaUsed);
-                    toolExecution.result = withAgentToolCallQuotaNotice(toolExecution.result, remainingToolCalls, agentToolCallLimit);
-                    toolTraceRound?.toolExecutions.push(toolExecution);
-                    saveTrace();
-                    processSteps.push({ id: id("process"), type: "tool", round, toolCall: toolExecution, createdAt: toolExecution.calledAt });
-                    input.onToolCall?.(toolExecution, round, permissionModules);
-                    currentRoundMessages.push({ role: "tool", tool_call_id: toolCall.id, content: JSON.stringify(toolExecution.result) });
-                    const questionId = toolExecution.name === "ask_user_question" && toolExecution.status === "completed"
-                        ? String(toolExecution.result.question?.id ?? "")
-                        : "";
-                    if (questionId) {
-                        this.aiWritePlanManager?.saveQuestionContinuation(questionId, {
-                            workId: input.workId,
+                    if (toolCallLimit) {
+                        const limitLabel = toolCallLimit.scope === "global" ? "整次回答的全局上限" : "本轮调用上限";
+                        toolCallLimitMessage = `Agent 工具调用额度不足：${limitLabel} ${toolCallLimit.limit} 次，已用 ${toolCallLimit.used} 次，模型还请求 ${toolCallLimit.requested} 次。\n\n已保留此前的回复与执行过程。你可以在本书 AI 设置中调整“Agent 工具调用上限”${toolCallLimit.scope === "global" ? "或全局倍数" : ""}，再发送“继续”完成剩余工作。`;
+                        if (input.taskType !== "chat" || input.im) {
+                            throw new AppError(409, "AI_TOOL_CALL_LIMIT_REACHED", toolCallLimitMessage, { toolCallLimit });
+                        }
+                        break;
+                    }
+                    const normalizedToolCalls = toolCalls.map((toolCall) => ({
+                        ...toolCall,
+                        function: {
+                            ...toolCall.function,
+                            arguments: typeof toolCall.function.arguments === "string" ? toolCall.function.arguments : JSON.stringify(toolCall.function.arguments ?? {})
+                        }
+                    }));
+                    const toolTraceRound = traceRounds.at(-1);
+                    const assistantToolMessage = {
+                        role: "assistant",
+                        content: choice.message.content ?? null,
+                        reasoning_content: choice.message.reasoning_content ?? null,
+                        tool_calls: normalizedToolCalls,
+                        ...(choice.message.anthropic_content?.length ? { anthropic_content: choice.message.anthropic_content } : {})
+                    };
+                    if (shouldCompactBeforeToolRound(assistantToolMessage, toolCalls.length)) {
+                        await compactToolContext([], round);
+                    }
+                    const maximumResultChars = toolResultMaximumChars(assistantToolMessage, toolCalls.length);
+                    const currentRoundMessages = [assistantToolMessage];
+                    const nativeImageMessages = [];
+                    for (const toolCall of toolCalls) {
+                        input.beforeRequest?.();
+                        const execution = await this.executeAgentTool(input.workId, toolCall, maximumResultChars, generationRoleplayCharacterId, allowedToolIds, input.signal, trackUsage, input.scope, model, provider, {
                             conversationId: input.conversationId ?? null,
-                            scope: input.scope,
-                            modelId: input.modelId ?? stringValue(model, "id"),
-                            toolCallId: toolCall.id,
-                            assistantMessageRequestId: input.assistantMessageRequestId ?? null,
-                            toolMessages: sanitizeCompletionTraceMessages([
-                                ...(input.toolContinuation ? resolvedQuestionToolMessages(input.toolContinuation) : []),
-                                ...(compactedToolContextMessage ? [compactedToolContextMessage] : completionMessages.slice(baseMessageCount)),
-                                ...currentRoundMessages
-                            ]),
+                            im: Boolean(input.im),
+                            listImMembers: input.im?.listMembers,
+                            searchImMessages: input.im?.searchMessages
+                        }, stagedRoleplayMemoryCandidates, allowedRemoteMcpToolNames, input.beforeRequest);
+                        const { nativeImage, ...toolExecution } = execution;
+                        const permissionModules = this.executedAgentToolPermissionModules(input.workId, toolExecution);
+                        logger.info("ai.tool_call.completed", {
+                            callId,
+                            toolName: toolExecution.name,
+                            status: toolExecution.status,
                             round,
-                            createdAt: now()
+                            maximumResultChars
                         });
-                        suspendedQuestionId = questionId;
-                        break;
+                        executedToolCalls.push(toolExecution);
+                        toolCallQuotaUsed += 1;
+                        globalToolCallUsed += 1;
+                        const remainingToolCalls = Math.max(0, agentToolCallLimit - toolCallQuotaUsed);
+                        toolExecution.result = withAgentToolCallQuotaNotice(toolExecution.result, remainingToolCalls, agentToolCallLimit);
+                        toolTraceRound?.toolExecutions.push(toolExecution);
+                        saveTrace();
+                        processSteps.push({ id: id("process"), type: "tool", round, toolCall: toolExecution, createdAt: toolExecution.calledAt });
+                        input.onToolCall?.(toolExecution, round, permissionModules);
+                        currentRoundMessages.push({ role: "tool", tool_call_id: toolCall.id, content: JSON.stringify(toolExecution.result) });
+                        const questionId = toolExecution.name === "ask_user_question" && toolExecution.status === "completed"
+                            ? String(toolExecution.result.question?.id ?? "")
+                            : "";
+                        if (questionId) {
+                            this.aiWritePlanManager?.saveQuestionContinuation(questionId, {
+                                workId: input.workId,
+                                conversationId: input.conversationId ?? null,
+                                scope: input.scope,
+                                modelId: input.modelId ?? stringValue(model, "id"),
+                                toolCallId: toolCall.id,
+                                assistantMessageRequestId: input.assistantMessageRequestId ?? null,
+                                toolMessages: sanitizeCompletionTraceMessages([
+                                    ...(input.toolContinuation ? resolvedQuestionToolMessages(input.toolContinuation) : []),
+                                    ...(compactedToolContextMessage ? [compactedToolContextMessage] : completionMessages.slice(baseMessageCount)),
+                                    ...currentRoundMessages
+                                ]),
+                                round,
+                                createdAt: now()
+                            });
+                            suspendedQuestionId = questionId;
+                            break;
+                        }
+                        if (nativeImage) {
+                            nativeImageMessages.push({
+                                role: "user",
+                                content: [
+                                    { type: "text", text: "image 工具已将图片作为原生多模态内容附在本条消息中。请直接理解这张图片，不要再次调用 image 工具读取它。" },
+                                    { type: "image_url", image_url: { url: nativeImage.dataUrl, detail: "auto" } }
+                                ]
+                            });
+                        }
                     }
-                    if (nativeImage) {
-                        nativeImageMessages.push({
-                            role: "user",
-                            content: [
-                                { type: "text", text: "image 工具已将图片作为原生多模态内容附在本条消息中。请直接理解这张图片，不要再次调用 image 工具读取它。" },
-                                { type: "image_url", image_url: { url: nativeImage.dataUrl, detail: "auto" } }
-                            ]
-                        });
+                    currentRoundMessages.push(...nativeImageMessages);
+                    const projectedMessages = [...completionMessages, ...currentRoundMessages];
+                    try {
+                        this.constrainParametersForContext(model, projectedMessages, parameters, tools);
+                        completionMessages.push(...currentRoundMessages);
                     }
-                }
-                currentRoundMessages.push(...nativeImageMessages);
-                const projectedMessages = [...completionMessages, ...currentRoundMessages];
-                try {
-                    this.constrainParametersForContext(model, projectedMessages, parameters, tools);
-                    completionMessages.push(...currentRoundMessages);
-                }
-                catch (error) {
-                    if (!(error instanceof AppError) || error.code !== "CONTEXT_WINDOW_EXCEEDED")
-                        throw error;
-                    await compactToolContext(currentRoundMessages, round);
-                }
-                toolRound += 1;
-                if (suspendedQuestionId)
+                    catch (error) {
+                        if (!(error instanceof AppError) || error.code !== "CONTEXT_WINDOW_EXCEEDED")
+                            throw error;
+                        await compactToolContext(currentRoundMessages, round);
+                    }
+                    toolRound += 1;
+                    if (suspendedQuestionId)
+                        break generationTurn;
+                    applyPendingSteers();
+                    payload = await requestCompletion("auto");
+                    choice = payload.choices?.[0];
+                }
+                if (suspendedQuestionId || toolCallLimit)
+                    break;
+                if (!applyPendingSteers())
                     break;
                 payload = await requestCompletion("auto");
                 choice = payload.choices?.[0];