narraeon 0.4.0 → 0.5.0

package/dist/node/runtime/play/PlayContinuity.js

@@ -0,0 +1,88 @@
+/** Narrative history contains only committed original inputs and final prose. */
+export function completedPlayerRounds(history) {
+    let pending = false;
+    let completed = 0;
+    for (const [id, text] of Object.entries(history)) {
+        if (id.includes("message.genesis"))
+            continue;
+        if (id.endsWith(".player"))
+            pending = text.trim().length > 0;
+        else if (id.endsWith(".narrator") && pending) {
+            completed += 1;
+            pending = false;
+        }
+    }
+    return completed;
+}
+export function checkpointHistory(history, checkpoint) {
+    const entries = Object.entries(history);
+    const cutoff = checkpoint === undefined
+        ? -1
+        : entries.findIndex(([id]) => id === checkpoint.historyMessageId ||
+            id.endsWith(`.${checkpoint.historyMessageId}`));
+    if (checkpoint !== undefined && cutoff < 0)
+        throw new Error("The narrative checkpoint is not reachable in this history.");
+    return entries
+        .slice(cutoff + 1)
+        .filter(([id]) => !id.includes("message.genesis"));
+}
+export function playerRoundMarker(rounds, hasCheckpoint, locale) {
+    const markdown = locale === "zh-CN"
+        ? `距上次检查点已完成 ${rounds} 回合。${hasCheckpoint ? "" : "当前尚无检查点，以世界起点计数。"}必要状态整理完成时，可调用 world_checkpoint 建议在此开启全新上下文。`
+        : `Completed player rounds since the last checkpoint: ${rounds}. ${hasCheckpoint ? "" : "No checkpoint yet; counting from the world origin. "}When necessary state maintenance is complete, world_checkpoint can suggest starting a fresh context here.`;
+    return {
+        kind: "runtime_notice",
+        notice: "checkpoint_rounds",
+        text: `${locale === "zh-CN" ? "[Runtime 回合提示]" : "[Runtime round marker]"}\n${markdown}`,
+    };
+}
+export function isPlayerRoundMarker(item) {
+    return item?.kind === "runtime_notice" && item.notice === "checkpoint_rounds";
+}
+export function continuationNotice(locale) {
+    return {
+        kind: "runtime_notice",
+        notice: "continuation",
+        text: locale === "zh-CN"
+            ? "[Runtime 续写提示]\n本次发送没有追加新的玩家原文。请从当前对话继续生成；已有的最终主持正文是已经完成的历史。"
+            : "[Runtime continuation]\nThis send adds no new player input. Continue generation from the current conversation; existing final narrator messages are already completed history.",
+    };
+}
+export function toolStepNotice(locale) {
+    return {
+        kind: "runtime_notice",
+        notice: "tool_step",
+        text: locale === "zh-CN"
+            ? "[Runtime 结算提示]\n上一响应同时调用了工具，其中的文字没有作为最终故事展示或提交。工具已按回执结算；请从已提交结果继续，最终用无工具调用的非空叙事完成本次发送。"
+            : "[Runtime settlement]\nThe previous response called tools, so its text was not displayed or committed as final story. The tools have settled as their receipts state. Continue from committed results, then finish this send with nonempty narrative and no tool calls.",
+    };
+}
+export function playerInputAppend(input) {
+    return [
+        ...(input.text.trim().length > 0 && input.checkpointAvailable
+            ? [
+                playerRoundMarker(completedPlayerRounds(input.history) -
+                    (input.checkpoint?.completedPlayerRounds ?? 0), input.checkpoint !== undefined, input.locale),
+            ]
+            : []),
+        { kind: "player", text: input.text },
+    ];
+}
+export function checkpointReplayBlocks(history, checkpoint, locale) {
+    const entries = checkpointHistory(history, checkpoint);
+    if (entries.length === 0)
+        return [];
+    const zh = locale === "zh-CN";
+    return [
+        {
+            source: "runtime:checkpoint-history:notice",
+            markdown: zh
+                ? "# 检查点后的已提交原文\n\n以下是当前时间线上最近一次已生效检查点之后的玩家原文与最终主持叙事；尚无检查点时从世界起点选取，开场白除外。部分结果可能已写入当前文档；这些记录用于核对连续性，不代表需要再次执行其中的事件。当前明确的世界修订优先，不能用旧叙事推翻修订。"
+                : "# Committed history after the checkpoint\n\nThese are the current timeline’s original player inputs and final narratives after its last effective checkpoint (or the world origin if none, excluding the opening). Some results may already be in current documents. These records support continuity, not repeated execution. Explicit current world corrections take precedence over old narrative.",
+        },
+        ...entries.map(([id, text]) => ({
+            source: `runtime:checkpoint-history:${id}`,
+            markdown: `## ${id.endsWith(".player") ? (zh ? "玩家原文" : "Player input") : zh ? "主持叙事" : "Host narrative"}\n\n${text}`,
+        })),
+    ];
+}