narraeon 0.5.5 → 0.5.7

package/dist/node/runtime/history/HistoryBackground.js

@@ -0,0 +1,84 @@
+import { parseDocument } from "yaml";
+import { renderWorldYamlSource } from "../world/WorldYamlRendering.js";
+export function captureNarrativeOrigin(snapshot, firstEventId) {
+    const source = snapshot.files.find(({ path }) => path === "control/frame.yaml")?.contents;
+    if (source === undefined)
+        throw new Error("Current situation frame is missing");
+    const parsed = parseDocument(source, { schema: "core", uniqueKeys: true });
+    if (parsed.errors.length > 0)
+        throw new Error("Current situation frame is invalid");
+    const frame = parsed.toJS({ maxAliasCount: 0 });
+    const binding = record(frame) && record(frame.bindings)
+        ? frame.bindings.currentSituation
+        : undefined;
+    if (typeof binding !== "string" || binding.length === 0)
+        throw new Error("Current situation binding is invalid");
+    const read = snapshot.query({
+        kind: "read_document",
+        document: binding.startsWith("@")
+            ? { shortRef: binding.slice(1) }
+            : { documentId: binding },
+    });
+    if (read.kind !== "read_document")
+        throw new Error("Bound current situation cannot be read");
+    const documentId = read.document.documentId;
+    return {
+        firstEventId,
+        documentId,
+        value: readBackground(snapshot, documentId),
+    };
+}
+export function readBackground(snapshot, documentId) {
+    const selected = snapshot.query({
+        kind: "select_node",
+        document: { documentId },
+        locator: { yaml: ["背景"] },
+    });
+    if (selected.kind !== "select_node" || selected.node.codec !== "yaml")
+        return null;
+    const value = selected.node.value;
+    if (value === null ||
+        (typeof value === "string" && value.trim() === "") ||
+        (typeof value === "object" && Object.keys(value).length === 0))
+        return null;
+    // Quoted multiline scalars retain trailing newlines when display framing trims.
+    return renderWorldYamlSource(value, { blockQuote: false });
+}
+export function snapshotBackground(value) {
+    return value === null ? undefined : { kind: "snapshot", value };
+}
+export function narrativeBackground(origin, snapshot) {
+    // A released frozen request without an origin stays unrecorded on recovery.
+    if (origin === undefined)
+        return undefined;
+    const after = readBackground(snapshot, origin.documentId);
+    return origin.value === null && after === null
+        ? undefined
+        : { kind: "narrative", before: origin.value, after };
+}
+export function isHistoryBackground(value) {
+    if (!record(value))
+        return false;
+    if (value.kind === "snapshot")
+        return Object.keys(value).length === 2 && nonempty(value.value);
+    return (value.kind === "narrative" &&
+        Object.keys(value).length === 3 &&
+        (value.before === null || nonempty(value.before)) &&
+        (value.after === null || nonempty(value.after)) &&
+        (value.before !== null || value.after !== null));
+}
+export function isNarrativeOrigin(value) {
+    return (record(value) &&
+        Object.keys(value).length === 3 &&
+        Number.isSafeInteger(value.firstEventId) &&
+        Number(value.firstEventId) > 0 &&
+        typeof value.documentId === "string" &&
+        value.documentId.length > 0 &&
+        (value.value === null || nonempty(value.value)));
+}
+function nonempty(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}

package/dist/node/runtime/history/HistoryQuery.js

@@ -12,6 +12,9 @@ export class HistoryQuery {
         const refs = inputs.map(({ id }) => historyMessageRef(id));
         this.messages = inputs.map((message, index) => Object.freeze({
             ...message,
+            ...(message.background === undefined
+                ? {}
+                : { background: Object.freeze(structuredClone(message.background)) }),
             ref: refs[index],
             position: index + 1,
             isOpening: message.isOpening === true,
@@ -20,11 +23,12 @@ export class HistoryQuery {
             length: Array.from(message.text).length,
         }));
         this.snapshotId = createHash("sha256")
-            .update(JSON.stringify(inputs.map(({ id, role, isOpening, text }) => [
+            .update(JSON.stringify(inputs.map(({ id, role, isOpening, text, background }) => [
             id,
             role,
             isOpening === true,
             text,
+            background ?? null,
         ])))
             .digest("hex");
     }
@@ -380,11 +384,12 @@ export function historyMessageRef(id) {
 }
 /** Decode storage identity once at the boundary; never infer order from it. */
 export function historyInputs(entries) {
-    return entries.map(({ path, contents }) => {
+    return entries.map(({ path, contents, background }) => {
         const id = path.replace(/\.md$/u, "");
         return {
             id,
             text: contents,
+            ...(background === undefined ? {} : { background }),
             role: /(?:\.|-)player(?:-|$)/u.test(id) ? "player" : "narrator",
             isOpening: id.endsWith("message.genesis.narrator"),
         };

package/dist/node/runtime/history/HistoryRendering.js

@@ -1,3 +1,5 @@
+import { isDeepStrictEqual } from "node:util";
+import { parseDocument } from "yaml";
 /** Shared metadata keeps injected refs and tool results directly navigable. */
 export function historyMessageLabel(message, locale) {
     const zh = locale === "zh-CN";
@@ -12,7 +14,7 @@ export function historyRoleLabel(message, locale) {
     return locale === "zh-CN" ? "主持叙事" : "Host narrative";
 }
 export function renderHistoryMessage(message, locale) {
-    return `## ${historyMessageLabel(message, locale)}\n\n${locale === "zh-CN" ? "[原文开始]" : "[Original text begins]"}\n${message.text}\n${locale === "zh-CN" ? "[原文结束；正文完整]" : "[Original text ends; body complete]"}`;
+    return `## ${historyMessageLabel(message, locale)}\n${renderHistoryBackground(message.background, locale)}\n${locale === "zh-CN" ? "[原文开始]" : "[Original text begins]"}\n${message.text}\n${locale === "zh-CN" ? "[原文结束；正文完整]" : "[Original text ends; body complete]"}`;
 }
 export function renderHistoryInjectionNotice(total, selected, kind, locale) {
     const zh = locale === "zh-CN";
@@ -51,7 +53,7 @@ export function renderHistoryResult(result, locale = "en", legacyRead = false) {
     if (result.kind === "legacy_list")
         return {
             ok: true,
-            markdown: `# Directory listing\n\n${header}\nOrder: ${result.order}\n${result.messages.map((message) => `- ${message.ref}, position ${message.position}, role=${message.role}${message.isOpening ? ", isOpening=true" : ""}, ${message.length} Unicode code points`).join("\n") || "(empty)"}\n\n---\nThis page: ${result.offset}..${result.offset + result.messages.length} / ${result.total} items\nComplete: ${result.nextCursor === null ? "yes" : "no"}${result.nextCursor === null ? "" : `\nNext-page cursor: ${result.nextCursor}`}`,
+            markdown: `# Directory listing\n\n${header}\nOrder: ${result.order}\n${result.messages.map((message) => `- ${message.ref}, position ${message.position}, role=${message.role}${message.isOpening ? ", isOpening=true" : ""}, ${message.length} Unicode code points${message.background === undefined ? "" : `\n${renderHistoryBackground(message.background, locale)}`}`).join("\n") || "(empty)"}\n\n---\nThis page: ${result.offset}..${result.offset + result.messages.length} / ${result.total} items\nComplete: ${result.nextCursor === null ? "yes" : "no"}${result.nextCursor === null ? "" : `\nNext-page cursor: ${result.nextCursor}`}`,
         };
     if (result.kind === "list")
         return {
@@ -59,7 +61,7 @@ export function renderHistoryResult(result, locale = "en", legacyRead = false) {
             markdown: `# ${zh ? "已提交历史列表" : "Committed history listing"}\n\n${header}\nOrder: oldest_first (${zh ? "页内始终由旧到新" : "every page oldest to newest"})\n${result.messages
                 .map((message) => {
                 const preview = Array.from(message.text).slice(0, 120).join("");
-                return `### ${historyMessageLabel(message, locale)}\n${message.length} Unicode code points\n[${zh ? "部分原文预览" : "Partial original preview"}]\n${preview}\n[${message.length > 120 ? (zh ? "预览有省略" : "preview omitted remaining text") : zh ? "预览结束" : "preview ends"}]`;
+                return `### ${historyMessageLabel(message, locale)}\n${message.length} Unicode code points\n${renderHistoryBackground(message.background, locale)}[${zh ? "部分原文预览" : "Partial original preview"}]\n${preview}\n[${message.length > 120 ? (zh ? "预览有省略" : "preview omitted remaining text") : zh ? "预览结束" : "preview ends"}]`;
             })
                 .join("\n\n") || (zh ? "（空页）" : "(empty page)")}\n\n---\n${zh ? "本页位置／条数" : "Page positions / count"}: ${range(result.messages)} / ${result.messages.length}\n${cursorLine("earlierCursor", result.earlierCursor)}\n${cursorLine("laterCursor", result.laterCursor)}\n${zh ? "续页只传 {cursor}。" : "Continue with only {cursor}."}${result.messages.length === 0 && result.anchor !== null ? `\n${zh ? "可从锚点转向浏览" : "Browse from the anchor in the other direction"}: {before:"${result.anchor}"} / {after:"${result.anchor}"}` : ""}`,
         };
@@ -70,7 +72,7 @@ export function renderHistoryResult(result, locale = "en", legacyRead = false) {
         };
     return {
         ok: true,
-        markdown: `# ${zh ? "历史字面搜索" : "History literal search"}\n\n${header}${result.within === null ? "" : `\nLegacy selected scope: ${result.within}`}\n${zh ? "搜索位置范围（排除边界）" : "Search position range (boundaries excluded)"}: ${result.range.start === null ? "empty" : `${result.range.start}..${result.range.end}`}\nOrder: ${result.order}\nMatch: ${result.match} (${zh ? "同一消息内" : "within one message"})\nNormalization: NFKC${result.caseSensitive ? " (case sensitive)" : " + case folding (locale und)"}\n${zh ? "查询词" : "Queries"}: ${JSON.stringify(result.queries)}\n${zh ? "命中消息总数" : "Total matching messages"}: ${result.matches}\n\n${result.messages.map(({ message, hits, fragments, omittedMatches }) => `### ${historyMessageLabel(message, locale)}\n${message.length} Unicode code points\n${zh ? "逐词命中次数" : "Matches per query"}: ${hits.map(({ query, count }) => `${JSON.stringify(query)}: ${count}`).join("; ")}\n${fragments.map((fragment) => `[${zh ? "部分原文片段" : "Partial original fragment"}: ${fragment.start}..${fragment.end}${fragment.omittedBefore ? "; prefix omitted" : ""}${fragment.omittedAfter ? "; suffix omitted" : ""}]\n${fragment.text}\n[${zh ? "片段结束" : "fragment ends"}]`).join("\n")}\n${omittedMatches ? (zh ? "另有命中未展示；可完整读取核实。" : "Additional matches omitted; read the complete original to verify.") : zh ? "全部命中均在所示片段内。" : "All matches are covered by these fragments."}`).join("\n\n") || (result.legacy ? (zh ? "零字面命中不证明事件没有发生；可改用其他 query 或读取相邻原文。" : "Zero literal matches do not prove an event never happened. Try another query or read adjacent originals.") : zh ? "零字面命中不证明事件没有发生；可改词、从 all 放宽为 any 或读取相邻上下文。" : "Zero literal matches do not prove an event never happened. Try other words, relax all to any, or read nearby context.")}\n\n---\n${cursorLine(result.legacy ? "Next-page cursor" : "nextCursor", result.nextCursor)}\n${result.legacy ? (zh ? "续页保留原source=history、query、caseSensitive、within与limit并使用返回cursor。" : "Legacy continuation keeps the original source=history, query, caseSensitive, within and limit with the returned cursor.") : zh ? "续页只传 {cursor}；已有原文足以判断时停止检索。all 仅限同一消息；相邻消息可改用 any 后读前后文。" : "Continue with only {cursor}; stop when the originals suffice. all applies to one message; use any then read context for terms in adjacent messages."}`,
+        markdown: `# ${zh ? "历史字面搜索" : "History literal search"}\n\n${header}${result.within === null ? "" : `\nLegacy selected scope: ${result.within}`}\n${zh ? "搜索位置范围（排除边界）" : "Search position range (boundaries excluded)"}: ${result.range.start === null ? "empty" : `${result.range.start}..${result.range.end}`}\nOrder: ${result.order}\nMatch: ${result.match} (${zh ? "同一消息内" : "within one message"})\nNormalization: NFKC${result.caseSensitive ? " (case sensitive)" : " + case folding (locale und)"}\n${zh ? "查询词" : "Queries"}: ${JSON.stringify(result.queries)}\n${zh ? "命中消息总数" : "Total matching messages"}: ${result.matches}\n\n${result.messages.map(({ message, hits, fragments, omittedMatches }) => `### ${historyMessageLabel(message, locale)}\n${message.length} Unicode code points\n${renderHistoryBackground(message.background, locale)}${zh ? "逐词命中次数" : "Matches per query"}: ${hits.map(({ query, count }) => `${JSON.stringify(query)}: ${count}`).join("; ")}\n${fragments.map((fragment) => `[${zh ? "部分原文片段" : "Partial original fragment"}: ${fragment.start}..${fragment.end}${fragment.omittedBefore ? "; prefix omitted" : ""}${fragment.omittedAfter ? "; suffix omitted" : ""}]\n${fragment.text}\n[${zh ? "片段结束" : "fragment ends"}]`).join("\n")}\n${omittedMatches ? (zh ? "另有命中未展示；可完整读取核实。" : "Additional matches omitted; read the complete original to verify.") : zh ? "全部命中均在所示片段内。" : "All matches are covered by these fragments."}`).join("\n\n") || (result.legacy ? (zh ? "零字面命中不证明事件没有发生；可改用其他 query 或读取相邻原文。" : "Zero literal matches do not prove an event never happened. Try another query or read adjacent originals.") : zh ? "零字面命中不证明事件没有发生；可改词、从 all 放宽为 any 或读取相邻上下文。" : "Zero literal matches do not prove an event never happened. Try other words, relax all to any, or read nearby context.")}\n\n---\n${cursorLine(result.legacy ? "Next-page cursor" : "nextCursor", result.nextCursor)}\n${result.legacy ? (zh ? "续页保留原source=history、query、caseSensitive、within与limit并使用返回cursor。" : "Legacy continuation keeps the original source=history, query, caseSensitive, within and limit with the returned cursor.") : zh ? "续页只传 {cursor}；已有原文足以判断时停止检索。all 仅限同一消息；相邻消息可改用 any 后读前后文。" : "Continue with only {cursor}; stop when the originals suffice. all applies to one message; use any then read context for terms in adjacent messages."}`,
     };
 }
 function localizedRecovery(result, zh) {
@@ -84,3 +86,28 @@ function localizedRecovery(result, zh) {
         return "该 ref 不在当前时间线中，可能仍保存在旧端点；请重新查询当前历史。";
     return `参数不符合要求，请按工具定义修正。${result.recovery}`;
 }
+/** Every result carries its own annotation; no implicit neighboring inheritance. */
+export function renderHistoryBackground(background, locale) {
+    if (background === undefined)
+        return "";
+    const zh = locale === "zh-CN";
+    const node = (value) => value === null
+        ? zh
+            ? "未记录"
+            : "not recorded"
+        : `\n[${zh ? "背景值开始" : "Background value begins"}]\n${value}\n[${zh ? "背景值结束" : "Background value ends"}]`;
+    const notice = zh
+        ? "历史背景仅说明采集位置的状态，不是当前世界状态；回忆、梦境或段内局部时间结合原文解释，不认证事实或授予角色知识。"
+        : "Historical background describes the captured state, not current world state; interpret memories, dreams and local times with the original text. It does not certify facts or grant character knowledge.";
+    if (background.kind === "snapshot" ||
+        equalBackground(background.before, background.after))
+        return `\n${zh ? "历史背景" : "Historical background"}:${node(background.kind === "snapshot" ? background.value : background.before)}\n${notice}\n`;
+    return `\n${zh ? "推进前背景" : "Background before advancement"}:${node(background.before)}\n${zh ? "推进后背景" : "Background after advancement"}:${node(background.after)}\n${notice}\n`;
+}
+function equalBackground(before, after) {
+    if (before === after)
+        return true;
+    if (before === null || after === null)
+        return false;
+    return isDeepStrictEqual(parseDocument(before).toJS({ maxAliasCount: 0 }), parseDocument(after).toJS({ maxAliasCount: 0 }));
+}

package/dist/node/runtime/history/StoryExport.js

@@ -0,0 +1,33 @@
+export function exportStory(title, messages, format, locale) {
+    const player = locale === "zh-CN" ? "我" : "Me";
+    const separator = locale === "zh-CN" ? "：" : ": ";
+    const blocks = messages.map(({ role, text }) => {
+        if (role === "narrator")
+            return text;
+        if (format === "text")
+            return `${player}${separator}${text}`;
+        return text
+            .split("\n")
+            .map((line, index) => index === 0 ? `> **${player}**${separator}${line}` : `> ${line}`)
+            .join("\n");
+    });
+    return {
+        fileName: storyFileName(title, format),
+        content: [format === "markdown" ? `# ${title}` : title, ...blocks].join("\n\n"),
+    };
+}
+function storyFileName(title, format) {
+    const extension = format === "markdown" ? ".md" : ".txt";
+    let stem = title
+        .replace(/[<>:"/\\|?*\p{Cc}]/gu, "")
+        .trim()
+        .replace(/[. ]+$/u, "");
+    if (/^(con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\.|$)/iu.test(stem))
+        stem = `_${stem}`;
+    const characters = Array.from(stem).slice(0, 80 - extension.length);
+    // Also fit filesystems that limit a filename to 255 UTF-8 bytes.
+    while (Buffer.byteLength(characters.join("") + extension, "utf8") > 255)
+        characters.pop();
+    stem = characters.join("").replace(/[. ]+$/u, "");
+    return `${stem || "story"}${extension}`;
+}

package/dist/node/runtime/model/FileNativeModelAdapters.js

@@ -1,8 +1,9 @@
+var _a;
 import { createHash } from "node:crypto";
 import { appendFile, chmod, mkdir, stat } from "node:fs/promises";
 import { dirname } from "node:path";
 import { hasCLIProxyThinkingSuffix, modelReasoningPolicyIssue, } from "../../protocol/modelConnections.js";
-import { ModelHostBindingMismatchError, ModelHostCancelledError, ModelHostContinuationError, ModelHostFailureError, ModelHostOutcomeUnknownError, } from "./ModelHost.js";
+import { assertModelOutputComplete, ModelHostBindingMismatchError, ModelHostCancelledError, ModelHostContinuationError, ModelHostFailureError, ModelHostOutcomeUnknownError, } from "./ModelHost.js";
 import { renderPromptDeltaMessage, } from "../prompt/FileNativePromptCompiler.js";
 import { aggregateAnthropicModelStream, aggregateChatModelStream, aggregateResponsesModelStream, } from "./ModelHostStream.js";
 import { defaultRuntimeToolDefinitionStrategy, portableRuntimeToolInputSchema, } from "../prompt/FileNativeToolRegistry.js";
@@ -77,7 +78,31 @@ export class FileNativeModelHost {
                 .digest("hex"),
         };
     }
-    async exchange(request, observer) {
+    freezeRequest(request) {
+        const frozen = structuredClone(request);
+        if (frozen.modelConfig === undefined) {
+            const { baseUrl: _baseUrl, apiKey: _apiKey, ...config } = this.#connection;
+            void _baseUrl;
+            void _apiKey;
+            frozen.modelConfig = config;
+        }
+        return frozen;
+    }
+    #requestHost(request) {
+        if (request.modelConfig === undefined)
+            return this;
+        if (request.modelConfig.provider !== this.#connection.provider)
+            throw new ModelHostBindingMismatchError("The request protocol does not match the selected model host");
+        return new _a({
+            ...request.modelConfig,
+            baseUrl: this.#connection.baseUrl,
+            apiKey: this.#connection.apiKey,
+        }, this.#fetch, this.#failureLog);
+    }
+    exchange(request, observer) {
+        return this.#requestHost(request).#exchange(request, observer);
+    }
+    async #exchange(request, observer) {
         assertExchangeCompatibility(this.#connection, request);
         await trace("model_host_exchange", modelHostTrace(request));
         const signal = observer?.signal;
@@ -99,6 +124,9 @@ export class FileNativeModelHost {
     }
     /** Uses the production encoders and deliberately omits credentials. */
     previewRequest(request) {
+        return this.#requestHost(request).#previewRequest(request);
+    }
+    #previewRequest(request) {
         assertExchangeCompatibility(this.#connection, request);
         const provider = this.#connection.provider;
         const body = provider === "chat_completions"
@@ -183,6 +211,7 @@ export class FileNativeModelHost {
             await trace("chat_response", payload);
             const message = payload.choices?.[0]?.message;
             const finishReason = payload.choices?.[0]?.finish_reason;
+            assertModelOutputComplete(finishReason);
             if (message === undefined)
                 throw unknownProviderResponse("Chat Completions");
             if (finishReason !== undefined &&
@@ -271,6 +300,7 @@ export class FileNativeModelHost {
             if (!isRecord(rawPayload) || !Array.isArray(rawPayload.content))
                 throw unknownProviderResponse("Anthropic Messages");
             const payload = rawPayload;
+            assertModelOutputComplete(payload.stop_reason);
             const content = payload.content;
             if (!validAnthropicContent(content))
                 throw unknownProviderResponse("Anthropic Messages");
@@ -310,6 +340,7 @@ export class FileNativeModelHost {
         });
     }
 }
+_a = FileNativeModelHost;
 function assertExchangeCompatibility(connection, request) {
     if (request.bootstrap.provider.protocol !== connection.provider)
         throw new ModelHostBindingMismatchError("The compiled prompt protocol does not match the selected model host");
@@ -1048,6 +1079,7 @@ async function openAIResponsesRequest(input) {
         await trace(`${input.tracePrefix}_response`, payload);
         if (!isRecord(payload) || !Array.isArray(payload.output))
             throw unknownProviderResponse("Responses API");
+        assertModelOutputComplete(responsesStopReason(payload));
         const output = cloneResponseOutput(payload.output);
         if (!validResponsesOutput(output))
             throw unknownProviderResponse("Responses API");

package/dist/node/runtime/model/ModelHost.js

@@ -33,10 +33,21 @@ export class ModelHostFailureError extends Error {
             this.details = options.details;
     }
 }
-/** A Provider has rejected the complete request because its context is full. */
+/** Reject provider-confirmed truncation before accepting text or tool calls. */
+export function assertModelOutputComplete(stopReason) {
+    if (stopReason === "length" ||
+        stopReason === "max_tokens" ||
+        stopReason === "max_output_tokens" ||
+        stopReason === "incomplete:max_output_tokens") {
+        throw new ModelHostFailureError("The model response reached the output token limit before completion. Increase maxOutputTokens and start a fresh context; reasoning may also consume the output budget.", { details: { code: "model_output_limit", stopReason } });
+    }
+}
+/** Replaying the frozen request cannot recover a context or output limit. */
 export function modelHostFailureRequiresFreshContext(error) {
     if (!(error instanceof ModelHostFailureError))
         return false;
+    if (failureDetailStrings(error.details).includes("model_output_limit"))
+        return true;
     const evidence = [error.message, ...failureDetailStrings(error.details)]
         .join("\n")
         .toLocaleLowerCase("und");

package/dist/node/runtime/model/ModelHostStream.js

@@ -1,4 +1,4 @@
-import { ModelHostFailureError } from "./ModelHost.js";
+import { assertModelOutputComplete, ModelHostFailureError, } from "./ModelHost.js";
 import { providerStreamEvents } from "./ProviderStream.js";
 export async function aggregateChatModelStream(body, onDelta) {
     let content = "";
@@ -110,6 +110,7 @@ export async function aggregateChatModelStream(body, onDelta) {
     }
     if (!completed || !sawPayload)
         throw new Error("Chat SSE ended before a complete response");
+    assertModelOutputComplete(stopReason);
     const toolCalls = [...calls.entries()]
         .sort(([left], [right]) => left - right)
         .map(([, call]) => {
@@ -259,8 +260,6 @@ export async function aggregateAnthropicModelStream(body, onDelta) {
                 if (block === undefined || block.stopped)
                     throw new Error("Anthropic SSE content block stop is invalid");
                 block.stopped = true;
-                if (block.value.type === "tool_use" && block.partialJson !== "")
-                    block.value.input = parseStreamJson(block.partialJson);
                 break;
             }
             case "message_delta": {
@@ -289,11 +288,14 @@ export async function aggregateAnthropicModelStream(body, onDelta) {
     }
     if (!started || !stopped)
         throw new Error("Anthropic SSE ended before a complete response");
+    assertModelOutputComplete(stopReason);
     const content = [...blocks.entries()]
         .sort(([left], [right]) => left - right)
         .map(([, block]) => {
         if (!block.stopped)
             throw new Error("Anthropic SSE content block did not end");
+        if (block.value.type === "tool_use" && block.partialJson !== "")
+            block.value.input = parseStreamJson(block.partialJson);
         return block.value;
     });
     const text = content
@@ -364,6 +366,12 @@ export async function aggregateResponsesModelStream(body, onDelta) {
             payload.type === "response.incomplete" ||
             payload.type === "response.cancelled" ||
             payload.type === "error") {
+            if (payload.type === "response.incomplete" &&
+                isRecord(payload.response)) {
+                const details = payload.response.incomplete_details;
+                if (isRecord(details))
+                    assertModelOutputComplete(details.reason);
+            }
             throw new ModelHostFailureError("Responses SSE returned an explicit failure");
         }
     }

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

@@ -83,6 +83,7 @@ export class FileNativeContinuityCorrection {
                 materials: structuredClone(binding.additionalMaterials),
                 originalMaterials: structuredClone(binding.additionalMaterials),
                 history: structuredClone(binding.history),
+                historyBackgrounds: structuredClone(binding.historyBackgrounds ?? {}),
                 reads: new Map(),
                 previewedVersion: null,
                 stateOperationClaim: claimed.handle,
@@ -236,6 +237,7 @@ export class FileNativeContinuityCorrection {
                 documentSnapshot: candidate.snapshot,
                 additionalMaterials: materials,
                 history: candidate.history,
+                historyBackgrounds: candidate.historyBackgrounds,
                 documentMaintenance: candidate.documentMaintenance,
                 documentMaintenanceUnavailableReason: candidate.documentMaintenanceUnavailableReason,
                 narrativeCheckpoint: candidate.narrativeCheckpoint,

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

@@ -1,3 +1,4 @@
+import { isNarrativeOrigin, isHistoryBackground, } from "../history/HistoryBackground.js";
 import { createHash, randomUUID } from "node:crypto";
 import { link, mkdir, open, readFile, rename, rm, writeFile, } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
@@ -119,6 +120,8 @@ function assertBase(value) {
         value.schemaVersion !== 1 ||
         value.kind !== "play_advance" ||
         (value.advanceKind !== "player" && value.advanceKind !== "response") ||
+        (value.narrativeOrigin !== undefined &&
+            !isNarrativeOrigin(value.narrativeOrigin)) ||
         typeof value.worldId !== "string" ||
         typeof value.chainId !== "string" ||
         typeof value.advanceId !== "string" ||
@@ -170,6 +173,8 @@ function assertSettlementPrepared(value) {
         (value.schemaVersion !== 1 ||
             value.stage !== "settlement_prepared" ||
             !isRecord(value.settlement) ||
+            (value.settlement.background !== undefined &&
+                !isHistoryBackground(value.settlement.background)) ||
             typeof value.recordedAt !== "number"))
         throw new Error("Settlement-prepared play fact has an invalid shape");
 }

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

@@ -1,3 +1,6 @@
+import { legacyModelBindingFailure, projectLegacyModelBindingFailure, } from "./LegacyModelBindingFailure.js";
+import { isPlayFailureKind, } from "../../protocol/playFailure.js";
+import { isNarrativeOrigin, } from "../history/HistoryBackground.js";
 import { encodePlayPromptRun, decodePlayPromptRun, } from "./PlayPromptRun.js";
 import { createHash, randomUUID } from "node:crypto";
 import { link, mkdir, open, readFile, rename, rm, writeFile, } from "node:fs/promises";
@@ -70,7 +73,8 @@ export class FileNativePlayTimelineStore {
         const eventCount = prefixLength(input.source.events, input.target.events);
         const completedToolCount = prefixLength(input.source.completedTools, input.target.completedTools);
         const authorizationCheckpointCount = prefixLength(input.source.documentAuthorizationCheckpoints ?? [], input.target.documentAuthorizationCheckpoints ?? []);
-        if (input.target.events.some((event) => event.kind === "assistant" && event.status === "completed")) {
+        if (input.retainCompleteContext ||
+            input.target.events.some((event) => event.kind === "assistant" && event.status === "completed")) {
             const encoding = await this.readInitialEncoding(input.sourceWorldId, input.source.chainId).catch(() => null);
             if (encoding !== null)
                 await publishImmutableJson(join(targetRoot, "initial-request-encoding.json"), encoding);
@@ -162,6 +166,9 @@ export class FileNativePlayTimelineStore {
             chainId: value.chainId,
             nextMaterials: structuredClone(value.nextMaterials),
             lastRequestDigest,
+            ...(value.narrativeOrigin === undefined
+                ? {}
+                : { narrativeOrigin: structuredClone(value.narrativeOrigin) }),
         };
         const continuationDigest = createHash("sha256")
             .update(JSON.stringify(continuation))
@@ -203,6 +210,9 @@ export class FileNativePlayTimelineStore {
             continuationDigest,
             lastRequestAttempt: value.lastRequestAttempt,
             lastFailure: value.lastFailure,
+            ...(value.lastFailureKind === undefined
+                ? {}
+                : { lastFailureKind: value.lastFailureKind }),
             updatedAt: value.updatedAt,
         };
         await publishJson(join(root, "state.json"), state);
@@ -231,6 +241,20 @@ export class FileNativePlayTimelineStore {
             throw new Error("Play timeline head generation is inconsistent");
         return loaded;
     }
+    /** Read only the small active context index, never its transcript or bootstrap. */
+    async currentContextRequiresFreshContext(worldId) {
+        assertIdentity(worldId, "World ID");
+        const head = await this.#readTimelineHead(worldId);
+        if (head === null)
+            return false;
+        const index = await readJson(join(this.#contextRoot(worldId, head.chainId), "index.json"));
+        assertContextIndex(index);
+        if (index.worldId !== worldId ||
+            index.chainId !== head.chainId ||
+            index.timelineGeneration !== head.generation)
+            throw new Error("Play context durable identity is inconsistent");
+        return index.importedFromArchive === true;
+    }
     async readContext(worldId, chainId) {
         assertIdentity(worldId, "World ID");
         assertIdentity(chainId, "Call-chain ID");
@@ -273,6 +297,7 @@ export class FileNativePlayTimelineStore {
             chainId,
             previousChainId: indexValue.previousChainId,
             timelineGeneration: indexValue.timelineGeneration,
+            ...(indexValue.importedFromArchive ? { importedFromArchive: true } : {}),
             ...(baseValue.continuityContextId === undefined
                 ? {}
                 : { continuityContextId: baseValue.continuityContextId }),
@@ -313,11 +338,19 @@ export class FileNativePlayTimelineStore {
             promptRuns,
             changedDocuments: structuredClone(stateValue.changedDocuments),
             nextMaterials: structuredClone(continuationValue.nextMaterials),
+            ...(continuationValue.narrativeOrigin === undefined
+                ? {}
+                : {
+                    narrativeOrigin: structuredClone(continuationValue.narrativeOrigin),
+                }),
             nextEventId: stateValue.nextEventId,
             exchange: stateValue.exchange,
             lastRequest,
             lastRequestAttempt: stateValue.lastRequestAttempt,
             lastFailure: stateValue.lastFailure,
+            ...(stateValue.lastFailureKind === undefined
+                ? {}
+                : { lastFailureKind: stateValue.lastFailureKind }),
             updatedAt: stateValue.updatedAt,
         };
         return {
@@ -436,7 +469,10 @@ export class FileNativePlayTimelineStore {
                     kind: "event",
                     chainId: pointer.chainId,
                     current: pointer.chainId === head?.chainId,
-                    event: summary,
+                    ...(context.index.importedFromArchive
+                        ? { requiresFreshContext: true }
+                        : {}),
+                    event: projectLegacyModelBindingFailure(summary),
                 });
                 pointer = { ...pointer, eventId: pointer.eventId - 1 };
                 continue;
@@ -489,6 +525,9 @@ export class FileNativePlayTimelineStore {
             activeStatus: active?.state.status ?? null,
             activeCanRetry: active?.state.canRetry ?? false,
             activeLastFailure: active?.state.lastFailure ?? null,
+            ...(active?.state.lastFailureKind === undefined
+                ? {}
+                : { activeLastFailureKind: active.state.lastFailureKind }),
             items: reverse.reverse(),
             nextCursor: pointer.chainId === null && pointer.genesisIndex < 0
                 ? null
@@ -507,7 +546,7 @@ export class FileNativePlayTimelineStore {
         assertPlayEvent(event);
         if (event.id !== eventId)
             throw new Error("Play timeline event identity is inconsistent");
-        return normalizePlayEvent(event);
+        return projectLegacyModelBindingFailure(normalizePlayEvent(event));
     }
     newGeneration() {
         return `timeline:${randomUUID()}`;
@@ -588,11 +627,48 @@ export class FileNativePlayTimelineStore {
             indexValue.chainId !== chainId ||
             stateValue.chainId !== chainId)
             throw new Error("Play context durable identity is inconsistent");
+        // Old versions persisted a configuration preflight failure as a terminal
+        // context failure. Recover only the disposition proven by its event prefix.
+        // Archive contexts and genuine provider failures retain their restrictions.
+        if (!indexValue.importedFromArchive &&
+            stateValue.status === "interrupted" &&
+            stateValue.lastFailure === legacyModelBindingFailure &&
+            (stateValue.lastFailureKind === undefined ||
+                stateValue.lastFailureKind === "context_unavailable")) {
+            for (let id = stateValue.eventCount; id > 0; id -= 1) {
+                const event = await readJson(join(root, "events", numbered(id)));
+                assertPlayEvent(event);
+                if (event.kind === "followup" ||
+                    (event.kind === "failure" &&
+                        event.message === legacyModelBindingFailure))
+                    continue;
+                if (event.kind === "assistant" &&
+                    event.status === "completed" &&
+                    event.responseKind === "narrative" &&
+                    event.continuation === "available" &&
+                    event.committedHead === stateValue.parentHead) {
+                    stateValue.status = "ready";
+                    stateValue.canRetry = false;
+                    stateValue.lastFailure = null;
+                    delete stateValue.lastFailureKind;
+                }
+                else if (event.kind === "failure") {
+                    stateValue.canRetry = event.failureKind === "retryable";
+                    stateValue.lastFailure = event.message;
+                    if (event.failureKind === undefined)
+                        delete stateValue.lastFailureKind;
+                    else
+                        stateValue.lastFailureKind = event.failureKind;
+                }
+                break;
+            }
+        }
         return { root, index: indexValue, state: stateValue };
     }
 }
 function contextIndex(value) {
     return {
+        ...(value.importedFromArchive ? { importedFromArchive: true } : {}),
         schemaVersion: 3,
         kind: "play_context_index",
         worldId: value.worldId,
@@ -715,6 +791,8 @@ function assertContextIndex(value) {
     if (!isRecord(value) ||
         value.schemaVersion !== 3 ||
         value.kind !== "play_context_index" ||
+        (value.importedFromArchive !== undefined &&
+            value.importedFromArchive !== true) ||
         typeof value.worldId !== "string" ||
         typeof value.chainId !== "string" ||
         (value.previousChainId !== null &&
@@ -760,6 +838,8 @@ function assertContextState(value) {
         !/^[a-f0-9]{64}$/u.test(value.continuationDigest) ||
         !validCount(value.lastRequestAttempt) ||
         (value.lastFailure !== null && typeof value.lastFailure !== "string") ||
+        (value.lastFailureKind !== undefined &&
+            !isPlayFailureKind(value.lastFailureKind)) ||
         typeof value.updatedAt !== "number")
         throw new Error("Play context state has an invalid shape");
 }
@@ -767,6 +847,8 @@ function assertContextContinuation(value) {
     if (!isRecord(value) ||
         value.schemaVersion !== 3 ||
         value.kind !== "play_context_continuation" ||
+        (value.narrativeOrigin !== undefined &&
+            !isNarrativeOrigin(value.narrativeOrigin)) ||
         typeof value.chainId !== "string" ||
         !Array.isArray(value.nextMaterials) ||
         (value.lastRequestDigest !== null &&
@@ -828,6 +910,8 @@ function isReleasedPlayContext(value) {
         (value.lastRequest !== null && !isRecord(value.lastRequest)) ||
         !validCount(value.lastRequestAttempt) ||
         (value.lastFailure !== null && typeof value.lastFailure !== "string") ||
+        (value.lastFailureKind !== undefined &&
+            !isPlayFailureKind(value.lastFailureKind)) ||
         typeof value.updatedAt !== "number")
         return false;
     try {
@@ -965,7 +1049,10 @@ function assertPlayEvent(value) {
         return;
     }
     if ((value.kind !== "failure" && value.kind !== "cancellation") ||
-        typeof value.message !== "string")
+        typeof value.message !== "string" ||
+        (value.kind === "failure" &&
+            value.failureKind !== undefined &&
+            !isPlayFailureKind(value.failureKind)))
         throw new Error("Play timeline event has an invalid kind");
 }
 function assertTimelineEventSummary(value) {