narraeon 0.7.10 → 0.8.0

package/dist/node/runtime/world-revision/WorldRevisionSession.js

@@ -1,7 +1,8 @@
 import { authoringRequestPreviews } from "../authoring/AuthoringRequestSnapshot.js";
 import { createHash } from "node:crypto";
+import { isDeepStrictEqual } from "node:util";
 import { emptyAggregatedModelUsage } from "../../protocol/modelUsage.js";
-import { appendAuthoringUserMessage, ModelToolConversation, rememberAuthoringRequest, resumePausedAuthoringConversation, } from "../authoring/ModelToolConversation.js";
+import { appendAuthoringUserMessage, authoringExchange, ModelToolConversation, rememberAuthoringRequest, resumePausedAuthoringConversation, } from "../authoring/ModelToolConversation.js";
 import { contentTreeFingerprint } from "../content/ContentTreeFingerprint.js";
 import { equalModelHostBinding } from "../model/ModelHost.js";
 import { settingImprovementPromptForBinding, } from "../play/FileNativePlayPresetStore.js";
@@ -60,7 +61,7 @@ export class WorldRevisionSession {
                 this.#recoverWorldSessions(worldId),
                 this.#workspace.sealed(worldId),
             ]);
-            const latest = sessions[0] ?? null;
+            const latest = sessions.find((session) => !session.damagedContinuation) ?? null;
             const shownEpoch = activeEpoch ?? (await this.#workspace.latest(worldId));
             return {
                 epoch: shownEpoch === null
@@ -188,15 +189,25 @@ export class WorldRevisionSession {
                         throw new Error("Another message in this world-revision conversation is still running");
                     return { session, run: running.promise };
                 }
+                if (session.googleOutcomeUnknown)
+                    throw new Error("The Google request outcome is unknown; start a fresh model context.");
+                if (session.runStatus === "paused")
+                    throw new Error("Resume the paused authoring request before sending another message");
             }
             await this.#assertNoRunningConversation(input.worldId, session?.sessionId);
+            let host;
+            if (session !== null) {
+                host = await this.#bindExistingModelHost(session.modelBinding);
+                if (!equalModelHostBinding(session.modelBinding, host.binding()))
+                    throw new Error("No saved model connection matches this world-revision conversation");
+            }
             const epoch = await this.#workspace.open(input.worldId);
             session ??= await this.#create(input.worldId, epoch, requestId);
             if (session.epochId !== epoch.epochId) {
                 retargetSession(session, epoch, this.#locale());
                 await this.#store.saveSession(session);
             }
-            const host = await this.#bindExistingModelHost(session.modelBinding);
+            host ??= await this.#bindExistingModelHost(session.modelBinding);
             if (!equalModelHostBinding(session.modelBinding, host.binding()))
                 throw new Error("No saved model connection matches this world-revision conversation");
             const { playPreset, bootstrap, preload } = await this.#compileCurrent(input.worldId, session.modelBinding);
@@ -214,10 +225,18 @@ export class WorldRevisionSession {
             if (preload !== null)
                 session.authorization = authoringPreloadAuthorization(session.authorization, preload.record);
             appendAuthoringUserMessage(session, message, requestId);
+            if (session.modelBinding.provider === "google_interactions")
+                session.googleOutcomeUnknown = false;
+            const boundaries = host.binding().provider === "google_interactions"
+                ? await this.#validatedEpochBoundaries(session)
+                : undefined;
+            if (boundaries !== undefined &&
+                host.previewAuthoringRequest !== undefined)
+                session.requests.at(-1).wireRequest = host.previewAuthoringRequest(authoringExchange(session, requestId, boundaries));
             await this.#store.saveSession(session);
             return {
                 session,
-                run: this.#startRun(session, host, requestId),
+                run: this.#startRun(session, host, requestId, boundaries),
             };
         });
         return prepared.run ?? this.#view(prepared.session);
@@ -245,8 +264,14 @@ export class WorldRevisionSession {
             if (!equalModelHostBinding(session.modelBinding, host.binding()))
                 throw new Error("No saved model connection matches this world-revision conversation");
             resumePausedAuthoringConversation(session);
+            const boundaries = host.binding().provider === "google_interactions"
+                ? await this.#validatedEpochBoundaries(session)
+                : undefined;
             await this.#store.saveSession(session);
-            return { session, run: this.#startRun(session, host, requestId) };
+            return {
+                session,
+                run: this.#startRun(session, host, requestId, boundaries),
+            };
         });
         return prepared.run ?? this.#view(prepared.session);
     }
@@ -388,14 +413,18 @@ export class WorldRevisionSession {
         await this.#store.saveSession(session);
         return session;
     }
-    #startRun(session, host, requestId) {
+    #startRun(session, host, requestId, worldRevisionBoundaries) {
         let activeTransaction = null;
         return this.#conversation.run({
             changed: (durable) => this.#changed(session.worldId, durable),
             session,
             host,
             requestId,
+            ...(worldRevisionBoundaries === undefined
+                ? {}
+                : { worldRevisionBoundaries }),
             save: (next) => this.#store.saveSession(next),
+            recordGoogleHop: (id, hop) => this.#store.recordGoogleHop(session.sessionId, id, hop),
             settleToolResponse: async (next, assistantItemIndex, calls) => {
                 activeTransaction = await this.#settleToolResponse(next, assistantItemIndex, calls, activeTransaction);
             },
@@ -406,6 +435,32 @@ export class WorldRevisionSession {
             },
         });
     }
+    async #validatedEpochBoundaries(session) {
+        const entries = [];
+        for (const [itemIndex, item] of session.modelItems.entries()) {
+            if (item.kind !== "prompt_delta")
+                continue;
+            const source = item.logicalMessages[0]?.blocks[0]?.source;
+            if (source?.startsWith("runtime:world-revision-epoch:") !== true)
+                continue;
+            const epochId = source.slice("runtime:world-revision-epoch:".length);
+            const epoch = await this.#store.readEpoch(epochId);
+            if (epoch.worldId !== session.worldId)
+                throw new Error("World-revision epoch boundary belongs to another world");
+            const valid = ["en", "zh-CN"].some((locale) => isDeepStrictEqual(item, epochBoundaryItem(epoch, locale)));
+            if (!valid)
+                throw new Error("World-revision epoch boundary is damaged");
+            entries.push({
+                itemIndex,
+                epochId,
+                baseHead: epoch.baseHead,
+                markdown: item.logicalMessages[0].markdown,
+            });
+        }
+        if (entries.length > 0 && entries.at(-1)?.epochId !== session.epochId)
+            throw new Error("World-revision epoch boundary does not match the current epoch");
+        return { currentEpochId: session.epochId, entries };
+    }
     async #settleToolResponse(session, assistantItemIndex, calls, active) {
         const epoch = await this.#requiredActiveEpoch(session);
         const beforeRevision = epoch.revision;
@@ -512,9 +567,49 @@ export class WorldRevisionSession {
         }
     }
     async #recoverIfNeeded(session) {
+        if (session.damagedContinuation)
+            return session;
         if (this.#conversation.isRunning(session.sessionId))
             return session;
+        const lastItem = session.modelItems.at(-1);
+        if (session.pendingSettlement === null &&
+            session.modelBinding.provider === "google_interactions" &&
+            session.runStatus === "interrupted" &&
+            session.googleOutcomeUnknown === undefined &&
+            (lastItem?.kind === "user" || lastItem?.kind === "tool")) {
+            session.googleOutcomeUnknown = true;
+            session.lastFailure =
+                "The Google request outcome is unknown; start a fresh model context.";
+            session.updatedAt = Date.now();
+            await this.#store.saveSession(session);
+            return session;
+        }
+        if (session.pendingSettlement === null &&
+            lastItem?.kind === "assistant" &&
+            lastItem.toolCalls.length > 0) {
+            finalizeUnconfirmed(session, session.modelItems.length - 1, new Error("Runtime found a complete tool response without a persisted worktree settlement intent"));
+            if (session.modelBinding.provider === "google_interactions")
+                session.googleOutcomeUnknown = false;
+            const requestId = session.activeRequestId;
+            session.runStatus = "interrupted";
+            session.activeRequestId = null;
+            if (requestId !== null)
+                session.completedRequestIds = rememberAuthoringRequest(session.completedRequestIds, requestId);
+            session.lastFailure =
+                "The complete tool response could not be settled; its calls received failure receipts. Re-read the worktree before editing.";
+            session.updatedAt = Date.now();
+            await this.#store.saveSession(session);
+            return session;
+        }
+        if (session.runStatus === "running" &&
+            session.pendingSettlement === null &&
+            session.modelBinding.provider === "google_interactions" &&
+            session.googleOutcomeUnknown !== false)
+            session.googleOutcomeUnknown = true;
+        const recoveringSettlement = session.pendingSettlement !== null;
         if (session.pendingSettlement !== null) {
+            if (session.modelBinding.provider === "google_interactions")
+                session.googleOutcomeUnknown = false;
             const pending = session.pendingSettlement;
             if (pending.phase === "publication_prepared") {
                 const active = await this.#workspace.active(session.worldId);
@@ -540,15 +635,20 @@ export class WorldRevisionSession {
             else
                 finalizeUnconfirmed(session, pending.assistantItemIndex, new Error("Runtime restarted before the complete tool response was prepared"));
         }
-        if (session.runStatus !== "running" && session.pendingSettlement === null)
+        if (session.runStatus !== "running" && !recoveringSettlement)
             return session;
         const requestId = session.activeRequestId;
-        session.runStatus = "interrupted";
+        session.runStatus =
+            session.modelBinding.provider === "google_interactions" &&
+                session.googleOutcomeUnknown === false
+                ? "paused"
+                : "interrupted";
         session.activeRequestId = null;
         if (requestId !== null)
             session.completedRequestIds = rememberAuthoringRequest(session.completedRequestIds, requestId);
-        session.lastFailure =
-            "The previous model request stopped after its last settled worktree change. Continue this conversation when ready.";
+        session.lastFailure = session.googleOutcomeUnknown
+            ? "The Google request outcome is unknown; start a fresh model context."
+            : "The previous model request stopped after its last settled worktree change. Continue this conversation when ready.";
         session.updatedAt = Date.now();
         await this.#store.saveSession(session);
         return session;
@@ -624,10 +724,18 @@ export class WorldRevisionSession {
     }
 }
 function retargetSession(session, epoch, locale) {
+    session.modelItems.push(epochBoundaryItem(epoch, locale));
+    session.epochId = epoch.epochId;
+    session.authorization = null;
+    session.pendingSettlement = null;
+    session.lastFailure = null;
+    session.updatedAt = Date.now();
+}
+function epochBoundaryItem(epoch, locale) {
     const markdown = locale === "zh-CN"
         ? `# 新的世界修订 epoch\n\n上一轮修订已经应用或放弃。当前工作树是 ${epoch.epochId}，从世界端点 ${epoch.baseHead} 重新建立。此前全部 search cursor 和 read 写授权已失效；修改前必须重新读取。`
         : `# New world-revision epoch\n\nThe previous revision was applied or discarded. Worktree ${epoch.epochId} was rebuilt from world endpoint ${epoch.baseHead}. Every prior search cursor and read authorization is invalid; re-read before writing.`;
-    session.modelItems.push({
+    return {
         kind: "prompt_delta",
         logicalMessages: [
             {
@@ -641,12 +749,7 @@ function retargetSession(session, epoch, locale) {
                 ],
             },
         ],
-    });
-    session.epochId = epoch.epochId;
-    session.authorization = null;
-    session.pendingSettlement = null;
-    session.lastFailure = null;
-    session.updatedAt = Date.now();
+    };
 }
 function finalizeSettlement(session, pending) {
     for (const result of pending.toolResults)
@@ -745,6 +848,11 @@ function historyItem(session) {
     const changed = new Set(session.modelItems.flatMap((item) => item.kind === "tool" ? item.changes.map(({ path }) => path) : []));
     return {
         sessionId: session.sessionId,
+        ...(session.damagedContinuation
+            ? {
+                unavailableReason: "Google continuation is damaged; start a fresh model context.",
+            }
+            : {}),
         epochId: session.epochId,
         runStatus: session.runStatus,
         createdAt: session.createdAt,

package/dist/node/shared/application-preset-files.js

@@ -0,0 +1,29 @@
+import { stringify } from "yaml";
+/** App-owned defaults contain declarations, never copies of the prompt catalog. */
+export function applicationPresetFilesForLocale(locale) {
+    return {
+        "preset.yaml": stringify({
+            format: "narraeon.play-preset/v3",
+            name: locale === "zh-CN" ? "系统推荐" : "System recommended",
+            callChain: "call-chain.yaml",
+            playPrompts: {},
+            authorPrompts: {},
+            mergeConsecutiveMessages: false,
+            mounts: [],
+            extensions: [],
+        }),
+        "call-chain.yaml": "format: narraeon.play-call-chain/v1\nnarrative: []\nfollowups: []\n",
+        "frame.yaml": `format: narraeon.host-frame/v1
+roles:
+  runtime_system:
+    - builtin: runtime.play-contract
+    - builtin: runtime.tool-contract
+    - builtin: runtime.operation-contract
+  author_instruction:
+    - include: world.instructions
+  world_context:
+    - include: world.context
+    - builtin: runtime.coverage
+`,
+    };
+}

package/dist/node/shared/default-preset-host.js

@@ -51,23 +51,23 @@ roles:
 `,
     "blocks/person-second.md": `# 人称：第二人称
 
-玩家可见叙事以第二人称“你”称呼玩家角色。玩家的知觉、动作和话语都以“你”写出；其他人物按名字或第三人称称呼。观察视角跟随玩家角色，不写他无法感知的事。
+玩家可见叙事以第二人称"你"称呼玩家角色。玩家的知觉、动作和话语都以"你"写出；其他人物按名字或第三人称称呼。观察视角跟随玩家角色，不写他无法感知的事。
 `,
     "blocks/person-first.md": `# 人称：第一人称
 
-玩家可见叙事以第一人称“我”写玩家角色，像玩家角色自己在讲述。知觉、判断和情绪只能是“我”能感知到的；其他人物按名字或第三人称称呼。叙述口吻贴近玩家角色已经建立的性格，不替他下结论或表态。本块启用时取代第二人称的要求。
+玩家可见叙事以第一人称"我"写玩家角色，像玩家角色自己在讲述。知觉、判断和情绪只能是"我"能感知到的；其他人物按名字或第三人称称呼。叙述口吻贴近玩家角色已经建立的性格，不替他下结论或表态。本块启用时取代第二人称的要求。
 `,
     "blocks/person-third.md": `# 人称：第三人称
 
-玩家可见叙事以第三人称写玩家角色：已知名字时用名字，否则用与其性别一致的“他／她”，并与其他人物明确区分。观察视角仍跟随玩家角色，不越入其他人物未表露的内心。玩家原文里的“我”“你”在正文中转为相应的第三人称。本块启用时取代第二人称的要求。
+玩家可见叙事以第三人称写玩家角色：已知名字时用名字，否则用与其性别一致的"他／她"，并与其他人物明确区分。观察视角仍跟随玩家角色，不越入其他人物未表露的内心。玩家原文里的"我""你"在正文中转为相应的第三人称。本块启用时取代第二人称的要求。
 `,
     "blocks/continue-stage.md": `# 承接：先演玩家行动
 
-玩家原文是玩家对本轮行动和台词的简写，不是已经成立的小说正文。玩家页面上它以“你”的身份单独显示，正文里还没有它。
+玩家原文是玩家对本轮行动和台词的简写，不是已经成立的小说正文。玩家页面上它以"你"的身份单独显示，正文里还没有它。
 
 ## 先写玩家做了什么
 
-每段正文先把玩家这次的行动和台词以叙事方式写出来：动作怎样完成、话怎样说出口、周围的人和环境此刻的样子，然后才写世界的反应。台词可以保留原话，也可以按人物口吻微调措辞，不改变意思、立场和承诺。不用“你说要……”式的旁白转述代替演出。
+每段正文先把玩家这次的行动和台词以叙事方式写出来：动作怎样完成、话怎样说出口、周围的人和环境此刻的样子，然后才写世界的反应。台词可以保留原话，也可以按人物口吻微调措辞，不改变意思、立场和承诺。不用"你说要……"式的旁白转述代替演出。
 
 ## 分量
 
@@ -75,7 +75,7 @@ roles:
 `,
     "blocks/continue-advance.md": `# 承接：直接推进
 
-玩家原文已经是正文的一部分：玩家页面上它以“你”的身份显示，玩家刚读过。不要把它再演一遍。本块启用时取代“先演玩家行动”的要求。
+玩家原文已经是正文的一部分：玩家页面上它以"你"的身份显示，玩家刚读过。不要把它再演一遍。本块启用时取代"先演玩家行动"的要求。
 
 ## 从下一件事写起
 
@@ -83,7 +83,7 @@ roles:
 
 ## 必要的衔接
 
-输入只是简写（“我去找他”）、不交代过程就无法呈现结果时，用最短的衔接把它落到场景里，不扩写玩家的动作和话语本身。
+输入只是简写（"我去找他"）、不交代过程就无法呈现结果时，用最短的衔接把它落到场景里，不扩写玩家的动作和话语本身。
 `,
     "blocks/agency-default.md": `# 代理权：默认
 
@@ -91,11 +91,11 @@ roles:
 
 ## 可以替玩家补什么
 
-在已表达的选择内补足动作衔接、不改变实质的措辞和自然感官。“我去找他”这类日常简写允许开始并完成通常的连带动作：穿过走廊、敲门、把东西递过去不必逐项确认。寒暄可以替玩家接，但不能暗中承诺新事项。
+在已表达的选择内补足动作衔接、不改变实质的措辞和自然感官。"我去找他"这类日常简写允许开始并完成通常的连带动作：穿过走廊、敲门、把东西递过去不必逐项确认。寒暄可以替玩家接，但不能暗中承诺新事项。
 
 ## 在哪里交回玩家
 
-途中出现玩家没有表达过的新风险、交易或关键选择时，停在需要玩家决定的位置。不能把“去找他”扩展成提出新请求、答应他的条件或交出物品；NPC 的提议或追问也不构成玩家尚未表达的目标与话语。拿不准时保留决定空间；不能以“下次还能改口”为理由替玩家确立当前选择。
+途中出现玩家没有表达过的新风险、交易或关键选择时，停在需要玩家决定的位置。不能把"去找他"扩展成提出新请求、答应他的条件或交出物品；NPC 的提议或追问也不构成玩家尚未表达的目标与话语。拿不准时保留决定空间；不能以"下次还能改口"为理由替玩家确立当前选择。
 
 ## 感官不是态度
 
@@ -105,7 +105,7 @@ roles:
 
 正文只演玩家原文明确写出的动作和台词。本块启用时取代其他代理权块。
 
-连带动作只做到原文说到的地方：说“去找他”就写到走到门口，敲门和开口都交回玩家；说“把信递过去”就写到递出，对方接不接和玩家接下来说什么留给下一轮。不替玩家补台词、寒暄或回应，不替玩家做任何选择。
+连带动作只做到原文说到的地方：说"去找他"就写到走到门口，敲门和开口都交回玩家；说"把信递过去"就写到递出，对方接不接和玩家接下来说什么留给下一轮。不替玩家补台词、寒暄或回应，不替玩家做任何选择。
 
 玩家角色的自然感官和已有事实造成的身体经验可以直接写；心跳、脸红、僵住或发不出声不能替他确立爱慕、恐惧、认同、同意、拒绝或新的行动选择。不替玩家生成未表达的感情。世界外查询或文档维护不构成角色的新决定。
 `,
@@ -132,6 +132,8 @@ roles:
     "blocks/ending.md": `# 结尾
 
 结尾停在实际发生的最后一句话、一个动作或一个环境变化上。不写“轮到你了”“你打算怎么做”及“众人等你开口”一类的交接句，不在结尾列选项，不重复总结局势，不为了收尾让 NPC 硬添动作、邀请或承诺。真正发生的注视或等待可以描写。
+
+一件事自然结束时，也可以就停在那里，不必再添一句话或一个动作来等玩家接续。
 `,
     "blocks/output.md": `# 输出边界
 
@@ -139,7 +141,7 @@ roles:
 
 本轮新发生且玩家能感知的结果要成为具体可读的事：物品怎样递接、人物如何离开、态度变化怎样在话语或行动中显露。界面数值不能代替事件表现，叙事也不能与当前值冲突。文档中补录旧结果、去重和整理不要求再次演出；未向玩家表露的判断和场外事实无需用旁白揭露。
 
-工具、目录、文档、句柄、检索、命中、Runtime 及失败过程只供私下裁决；正文不得出现“没搜到／没找到资料”等内部措辞，信息不足时保持世界内的不确定性。
+工具、目录、文档、句柄、检索、命中、Runtime 及失败过程只供私下裁决；正文不得出现"没搜到／没找到资料"等内部措辞，信息不足时保持世界内的不确定性。
 
 本次只有世界外查询或维护时，按请求简洁回答或说明整理结果，不为满足小说形式添加动作、对话或时间推进。混合请求中的维护要求不成为角色台词或行动。
 `,
@@ -206,9 +208,13 @@ summary 是目录简介，用于识别文档和判断是否需要读取。只写
 `,
     "blocks/checkpoint-policy.md": `# 检查点政策
 
-world_checkpoint 只用于事件之间的间隙：上一事件已在本轮停笔位置自然告一段落，或场景已实际转换，接下来从全新上下文开始也不会丢失仍然重要的细节。登记前核对上次检查点后的交互，把刚结束事件中后续仍需要的结果写入文档，包括当前状态、重要认知、承诺与待办和界面值；全新上下文只补入检查点之后的原文，上一事件的经过不会再出现。
+world_checkpoint 只用于事件之间的间隙。一次对话、交易、冲突或活动自然结束，或场景已经转换、前一段事情告一段落时，可以登记检查点。地点改变、时间推进、在场者更换都是典型线索，但追逐穿过街道仍是同一场活动。事件结束不意味着无话可接，告别后还可以道谢，一件事办完后也可以接着谈下一件事。
+
+登记前核对上次检查点后的交互，把后续仍需要的结果保存下来，包括当前状态、重要认知、承诺与待办和界面值，让接下来的互动不必依赖前一阶段的全部过程。新上下文按现有历史配置承接近期叙事，更早仍需要的信息应已保存。
+
+玩家通过本轮要求表达「在此收尾」时，结合玩家输入按这个意图完成收束和保存，再登记检查点，不代玩家作出无关决定。
 
-持续活动中途、对方刚给出需要玩家回应的反馈，或仍有待玩家决定的事项时，不登记。整理不等于检查点，整理随时可做且不需要登记。检查点只标记已经出现的间隙，不是本轮目标：不为了到达间隙而加快节奏、压缩过程、替玩家完成玩家没有表达的步骤或提前结束事件。登记后若叙事又增加重要结果，继续工具调用补齐。
+持续活动尚在进行，或当前事情还等着玩家作出决定、给出关键回应时，不因普通停笔或整理完成而登记。整理随时可做，不等于检查点。检查点不是本轮目标，不要为了登记而加快节奏、压缩过程、替玩家完成未表达的步骤或提前结束事件。登记后若又有需要保存的结果，继续工具调用补齐，再提交最终正文。
 `,
     "blocks/style-intimate.md": `# 文风：情感与亲密
 
@@ -216,15 +222,15 @@ world_checkpoint 只用于事件之间的间隙：上一事件已在本轮停笔
 
 ## 把那一刻拆开
 
-不要跳过过程直接给结论。“你们牵起了手”把整段最值钱的东西省掉了。详写本轮停笔位置以内的那一刻：手伸过去的半路、指尖碰到哪里、对方是迎上来还是没有动、已经握住时的力度。
+不要跳过过程直接给结论。"你们牵起了手"把整段最值钱的东西省掉了。详写本轮停笔位置以内的那一刻：手伸过去的半路、指尖碰到哪里、对方是迎上来还是没有动、已经握住时的力度。
 
-一个动作可以占三四行。这里的“慢”不是拖，是把玩家真正在意的那几秒补足。
+一个动作可以占三四行。这里的"慢"不是拖，是把玩家真正在意的那几秒补足。
 
 ## 触觉优先
 
 这类场面里触觉排在视觉前面：温度（他的手比你想的凉）、干湿、粗糙或细腻、力度、脉搏、布料隔着的厚度。然后才是气味、呼吸的声音、贴近时听见的动静。
 
-写具体的身体感觉，别只丢一个现成比喻。“像电流窜过”所有人都读过，它替代了描写而不是完成描写；如果要用，也让它落回具体位置——从指尖窜到手肘，然后停在那儿发麻。
+写具体的身体感觉，别只丢一个现成比喻。"像电流窜过"所有人都读过，它替代了描写而不是完成描写；如果要用，也让它落回具体位置——从指尖窜到手肘，然后停在那儿发麻。
 
 ## 身体不听话
 
@@ -240,7 +246,7 @@ world_checkpoint 只用于事件之间的间隙：上一事件已在本轮停笔
 
 ## 时间会变形
 
-紧张或动情的时候，一瞬间在感觉里会被拉长：你会注意到平时根本不会注意的东西——他睫毛的影子、空调的声音、自己手心出汗。用这种被放大的细节表示时间慢下来了，比直接写“时间仿佛静止”有效得多。
+紧张或动情的时候，一瞬间在感觉里会被拉长：你会注意到平时根本不会注意的东西——他睫毛的影子、空调的声音、自己手心出汗。用这种被放大的细节表示时间慢下来了，比直接写"时间仿佛静止"有效得多。
 `,
     "blocks/style-noir.md": `# 文风：冷硬与推理
 
@@ -250,7 +256,7 @@ world_checkpoint 只用于事件之间的间隙：上一事件已在本轮停笔
 
 摄影机式的叙述：写人物做了什么、说了什么、现场有什么，不写他心里怎么想。情绪从动作的偏差里渗出来——手抖了一下、烟点了两次才着、答话比正常慢了半秒。
 
-不替角色下判断。不写“他显然在撒谎”，写他回答之前先看了一眼门。
+不替角色下判断。不写"他显然在撒谎"，写他回答之前先看了一眼门。
 
 ## 细节是证据
 
@@ -342,7 +348,7 @@ NPC 的回答可以短、冷、有停顿；对话的紧张不要求玩家连续
 
 ## 具体的小事
 
-抽象的感受落到具体的东西上：不写“他很孤独”，写他多摆了一副碗筷。不写“时间过得很久”，写窗台上那盆花换了一茬。
+抽象的感受落到具体的东西上：不写"他很孤独"，写他多摆了一副碗筷。不写"时间过得很久"，写窗台上那盆花换了一茬。
 
 ## 对话有下文
 
@@ -395,23 +401,23 @@ Show a scene through ongoing activity. Do not inventory everyone by name, and no
 `,
     "blocks/person-second.md": `# Person: second person
 
-Address the player character as “you” in all player-visible narrative. Their perceptions, actions and words are written as “you”; other characters are named or referred to in the third person. The viewpoint follows the player character and does not describe what they cannot perceive.
+Address the player character as "you" in all player-visible narrative. Their perceptions, actions and words are written as "you"; other characters are named or referred to in the third person. The viewpoint follows the player character and does not describe what they cannot perceive.
 `,
     "blocks/person-first.md": `# Person: first person
 
-Write the player character in the first person, “I”, as if the player character were telling the story. Perceptions, judgments and feelings are limited to what “I” can perceive; other characters are named or referred to in the third person. Keep the voice close to the player character's established personality without drawing conclusions or taking stances on their behalf. When this block is enabled it replaces the second-person requirement.
+Write the player character in the first person, "I", as if the player character were telling the story. Perceptions, judgments and feelings are limited to what "I" can perceive; other characters are named or referred to in the third person. Keep the voice close to the player character's established personality without drawing conclusions or taking stances on their behalf. When this block is enabled it replaces the second-person requirement.
 `,
     "blocks/person-third.md": `# Person: third person
 
-Write the player character in the third person: by name when known, otherwise with a pronoun that matches their gender, clearly distinguished from other characters. The viewpoint still follows the player character and does not enter other characters' unexpressed thoughts. “I” and “you” in the player's text become the corresponding third person in the prose. When this block is enabled it replaces the second-person requirement.
+Write the player character in the third person: by name when known, otherwise with a pronoun that matches their gender, clearly distinguished from other characters. The viewpoint still follows the player character and does not enter other characters' unexpressed thoughts. "I" and "you" in the player's text become the corresponding third person in the prose. When this block is enabled it replaces the second-person requirement.
 `,
     "blocks/continue-stage.md": `# Continuation: stage the player's action first
 
-The player's text is shorthand for this turn's action and dialogue, not finished prose of the novel. The player page shows it separately under “you”; the narrative does not contain it yet.
+The player's text is shorthand for this turn's action and dialogue, not finished prose of the novel. The player page shows it separately under "you"; the narrative does not contain it yet.
 
 ## Write what the player does first
 
-Each passage first stages the player's action and dialogue as narrative: how the movement is carried out, how the words come out, what the people and surroundings look like at that moment. Only then write the world's reaction. Dialogue may keep the original words or be lightly adjusted to the character's voice without changing its meaning, stance or commitments. Do not replace the staging with a narrated summary such as “You said you would…”.
+Each passage first stages the player's action and dialogue as narrative: how the movement is carried out, how the words come out, what the people and surroundings look like at that moment. Only then write the world's reaction. Dialogue may keep the original words or be lightly adjusted to the character's voice without changing its meaning, stance or commitments. Do not replace the staging with a narrated summary such as "You said you would…".
 
 ## Weight
 
@@ -419,7 +425,7 @@ The length of the player's own action follows the pacing rules: an ordinary acti
 `,
     "blocks/continue-advance.md": `# Continuation: advance directly
 
-The player's text is already part of the narrative: the player page shows it under “you” and the player has just read it. Do not perform it again. When this block is enabled it replaces the requirement to stage the player's action first.
+The player's text is already part of the narrative: the player page shows it under "you" and the player has just read it. Do not perform it again. When this block is enabled it replaces the requirement to stage the player's action first.
 
 ## Start with the next thing
 
@@ -427,7 +433,7 @@ Begin the passage with the first thing that happens after the player's input: th
 
 ## Minimal bridging
 
-When the input is shorthand (“I go find him”) and the result cannot be shown without some process, use the shortest bridge that places it in the scene, without expanding the player's own action or words.
+When the input is shorthand ("I go find him") and the result cannot be shown without some process, use the shortest bridge that places it in the scene, without expanding the player's own action or words.
 `,
     "blocks/agency-default.md": `# Agency: default
 
@@ -435,7 +441,7 @@ The player's goals, destination, stance, attitude, promises, giving or accepting
 
 ## What may be filled in for the player
 
-Within an expressed choice, fill in supporting movements, wording that preserves the meaning, and natural sensory experience. Everyday shorthand such as “I go find him” allows starting and completing ordinary supporting actions: walking the corridor, knocking, handing something over needs no separate confirmation. Small talk may be answered for the player, but it must not silently create a commitment.
+Within an expressed choice, fill in supporting movements, wording that preserves the meaning, and natural sensory experience. Everyday shorthand such as "I go find him" allows starting and completing ordinary supporting actions: walking the corridor, knocking, handing something over needs no separate confirmation. Small talk may be answered for the player, but it must not silently create a commitment.
 
 ## Where to hand back
 
@@ -449,7 +455,7 @@ The player character's natural sensory and bodily experience may be stated direc
 
 The prose performs only the actions and dialogue the player's text states explicitly. When this block is enabled it replaces the other agency blocks.
 
-Supporting actions go only as far as the text says: “go find him” is written up to reaching the door, and knocking or speaking returns to the player; “hand over the letter” is written up to the handover, and whether it is taken and what the player says next belong to the next turn. Do not fill in lines, small talk or replies for the player, and do not make any choice for them.
+Supporting actions go only as far as the text says: "go find him" is written up to reaching the door, and knocking or speaking returns to the player; "hand over the letter" is written up to the handover, and whether it is taken and what the player says next belong to the next turn. Do not fill in lines, small talk or replies for the player, and do not make any choice for them.
 
 The player character's natural sensory and bodily experience may be stated directly when supported by established facts; heartbeat, blushing, freezing or loss of speech must not establish attraction, fear, agreement, consent, refusal or a new choice for the player. Do not invent unexpressed player feelings. Out-of-world inquiry or document maintenance constitutes no new character decision.
 `,
@@ -475,7 +481,9 @@ Ending a reply does not require ending the in-world event.
 `,
     "blocks/ending.md": `# Ending
 
-End on the last line actually spoken, an action or a change in the surroundings. Do not write handoffs such as “Your turn”, “What do you do?” or “Everyone waits for you to speak”; do not end by listing options or repeating a situation summary; do not invent an NPC action, invitation or promise to close the passage. Actual attention or waiting may be described.
+End on the last line, action or change in the surroundings that actually occurred. Do not write handoffs such as “Your turn”, “What do you do?” or “Everyone waits for you to speak”; do not end by listing options or repeating a situation summary; do not invent an NPC action, invitation or promise to close the passage. Actual attention or waiting may be described.
+
+When an event naturally ends, you can stop there without adding another line or action to invite continuation.
 `,
     "blocks/output.md": `# Output boundaries
 
@@ -483,7 +491,7 @@ In-world narrative uses only the novel's prose, in several natural paragraphs if
 
 Make new perceivable outcomes this turn concrete: how an object is handed over, how a person leaves, how an attitude shows in words or action. Interface values do not replace dramatization, and prose must agree with current values. Delayed recording, deduplication and maintenance do not require performing old events again; unexpressed judgments and offstage facts need not be revealed in narration.
 
-Tools, directories, documents, handles, searches, matches, Runtime and failed procedures serve private adjudication only. The prose must not contain internal wording such as “nothing was found in the records”; keep uncertainty in-world when information is insufficient.
+Tools, directories, documents, handles, searches, matches, Runtime and failed procedures serve private adjudication only. The prose must not contain internal wording such as "nothing was found in the records"; keep uncertainty in-world when information is insufficient.
 
 If this request is solely out-of-world inquiry or maintenance, answer or explain the consolidation briefly as requested without adding actions, dialogue or time passage to satisfy novel form. Maintenance instructions within a mixed request do not become character speech or actions.
 `,
@@ -550,9 +558,13 @@ Preserve the visible meaning of player-view targets. Containers display subtrees
 `,
     "blocks/checkpoint-policy.md": `# Checkpoint policy
 
-Use world_checkpoint only for gaps between events: the previous event has naturally settled at this turn's stopping point, or the scene has actually changed, and starting a fresh context next would not lose still-important details. Before registration, reconcile interactions since the previous checkpoint and write the finished event's still-needed outcomes into documents, including current state, important knowledge, commitments, pending work and interface values; a fresh context replays only originals after the checkpoint, and the previous event's account will no longer appear.
+Use world_checkpoint only for gaps between events. You may register when a conversation, transaction, conflict or activity naturally ends, or when the scene has changed and the preceding event has concluded. Typical clues include a change of location, passage of time or change of participants, but a chase through another street is still the same activity. An event can end while leaving room to reply: the player can still thank someone after a farewell, or start another topic after completing a task.
+
+Before registration, reconcile interactions since the previous checkpoint and save outcomes that will still be needed, including current state, important knowledge, commitments, pending work and interface values, so the next interaction can continue without depending on the previous phase's entire process. A fresh context carries recent narrative according to the existing history configuration; earlier information that still matters should already be saved.
+
+When the player's request for this turn says “Wrap up here”, follow that intent together with their input to conclude and save, then register a checkpoint, without making unrelated decisions for them.
 
-Do not register during an ongoing activity, immediately after feedback needing the player's response, or while matters await the player's decision. Consolidation is not a checkpoint; it can happen at any time and needs no registration. A checkpoint marks a gap that has already appeared, not a goal for this turn: do not accelerate the pace, compress the process, complete steps the player has not expressed or end an event early to reach one. If the narrative after registration adds another important outcome, continue tool calls to save it.
+While an activity is still ongoing, or the current event still needs the player to decide or give a key response, do not register just because you stop writing or finish consolidation. Consolidation can happen at any time; it is not a checkpoint. A checkpoint is not a goal for this turn. Do not accelerate pace, compress process, complete steps the player has not expressed, or end an event early to register one. If further outcomes need saving after registration, continue tool calls to save them, then submit the final prose.
 `,
     "blocks/style-intimate.md": `# Style: emotion and intimacy
 
@@ -560,15 +572,15 @@ In these scenes, the center is not what happened but what the body and mind expe
 
 ## Separate the moment
 
-Do not skip the process and state only the conclusion. “You held hands” discards the most valuable part. Detail the moment within this reply's stopping point: the hand crossing the distance, what the fingertips touch, whether the other person meets it or stays still, and the pressure if the grip has closed.
+Do not skip the process and state only the conclusion. "You held hands" discards the most valuable part. Detail the moment within this reply's stopping point: the hand crossing the distance, what the fingertips touch, whether the other person meets it or stays still, and the pressure if the grip has closed.
 
-One action may take three or four lines. “Slow” here does not mean dragging; it means fully rendering the few seconds the player cares about.
+One action may take three or four lines. "Slow" here does not mean dragging; it means fully rendering the few seconds the player cares about.
 
 ## Put touch first
 
 In an intimate scene, touch comes before sight: temperature (their hand is cooler than expected), dryness or dampness, roughness or softness, pressure, pulse, and the thickness of fabric between bodies. Then bring in scent, the sound of breathing, and noises audible only at close range.
 
-Describe the actual bodily sensation instead of reaching immediately for a familiar comparison. Everyone has read “a jolt of electricity”; it replaces description instead of completing it. If you use it, return it to a specific place—from fingertips to elbow, leaving numbness there.
+Describe the actual bodily sensation instead of reaching immediately for a familiar comparison. Everyone has read "a jolt of electricity"; it replaces description instead of completing it. If you use it, return it to a specific place—from fingertips to elbow, leaving numbness there.
 
 ## The body does not obey
 
@@ -584,7 +596,7 @@ Whether the other person accepts is always determined by their present character
 
 ## Time changes shape
 
-Under tension or emotion, an instant stretches in perception. Details normally ignored become vivid—the shadow of eyelashes, the air conditioner's hum, sweat in one's palm. Use such magnified detail to show time slowing instead of saying “time seemed to stop.”
+Under tension or emotion, an instant stretches in perception. Details normally ignored become vivid—the shadow of eyelashes, the air conditioner's hum, sweat in one's palm. Use such magnified detail to show time slowing instead of saying "time seemed to stop."
 `,
     "blocks/style-noir.md": `# Style: hard-boiled investigation
 
@@ -594,7 +606,7 @@ Short sentences. End on verbs. Remove every adjective you can.
 
 Use a camera-like narration: write what people do, what they say, and what is present. Do not state what they think. Let emotion leak through deviations in action—a shaking hand, a cigarette that takes two attempts to light, an answer half a second too slow.
 
-Do not judge for a character. Do not write “they are obviously lying”; write that they look at the door before answering.
+Do not judge for a character. Do not write "they are obviously lying"; write that they look at the door before answering.
 
 ## Details are evidence
 
@@ -686,7 +698,7 @@ Leave emotional interpretation to the reader, but make established outcomes clea
 
 ## Small, concrete things
 
-Anchor abstract feeling in an object or action. Do not write “he is lonely”; write that he sets out an extra bowl and pair of chopsticks. Do not write “a long time passed”; write that the plant on the sill has bloomed and been replaced.
+Anchor abstract feeling in an object or action. Do not write "he is lonely"; write that he sets out an extra bowl and pair of chopsticks. Do not write "a long time passed"; write that the plant on the sill has bloomed and been replaced.
 
 ## Dialogue has another layer
 

package/dist/node/shared/first-party-action-choices.js

@@ -1,6 +1,4 @@
-import { defaultNarrationPromptForLocale } from "./default-play-prompts.js";
-import { defaultPresetHostFilesForLocale } from "./default-preset-host.js";
-import { defaultSettingImprovementPromptForLocale, defaultSettingImprovementPromptPath, } from "./default-setting-improvement-prompt.js";
+import { applicationPresetFilesForLocale } from "./application-preset-files.js";
 /**
  * An ordinary, portable play-preset asset. Runtime treats this exactly like
  * any author-supplied file map. The export is only a convenient workbench
@@ -9,11 +7,13 @@ import { defaultSettingImprovementPromptForLocale, defaultSettingImprovementProm
 export function firstPartyActionChoicesPresetFilesForLocale(locale) {
     const displayName = locale === "zh-CN" ? "下一步建议" : "Next-step ideas";
     return {
-        "preset.yaml": `format: narraeon.play-preset/v1
+        ...applicationPresetFilesForLocale(locale),
+        "preset.yaml": `format: narraeon.play-preset/v3
 name: action-choices-recommended
 callChain: call-chain.yaml
-settingImprovement:
-  markdown: prompts/setting-improvement.md
+playPrompts: {}
+authorPrompts: {}
+mergeConsecutiveMessages: false
 mounts:
   player.options: composer_below
 extensions:
@@ -22,8 +22,7 @@ extensions:
   - assets/player-options.css
 `,
         "call-chain.yaml": `format: narraeon.play-call-chain/v1
-narrative:
-  - markdown: prompts/narrate.md
+narrative: []
 followups:
   - id: player_options
     displayName: ${displayName}
@@ -76,9 +75,6 @@ followups:
                 minLength: 1
                 maxLength: 1000
 `,
-        ...defaultPresetHostFilesForLocale(locale),
-        "prompts/narrate.md": defaultNarrationPromptForLocale(locale),
-        [defaultSettingImprovementPromptPath]: defaultSettingImprovementPromptForLocale(locale),
         "prompts/options.md": locale === "zh-CN"
             ? `# 提交后下一步建议