narraeon 0.7.9 → 0.8.0

package/dist/node/runtime/setting/SettingImprovementSession.js

@@ -5,7 +5,7 @@ import { contentTreeFingerprint } from "../content/ContentTreeFingerprint.js";
 import { equalModelHostBinding } from "../model/ModelHost.js";
 import { settingImprovementPromptForBinding, } from "../play/FileNativePlayPresetStore.js";
 import { WorldDocumentStore } from "../world/WorldDocumentStore.js";
-import { appendAuthoringUserMessage, ModelToolConversation, rememberAuthoringRequest, resumePausedAuthoringConversation, } from "../authoring/ModelToolConversation.js";
+import { appendAuthoringUserMessage, authoringExchange, ModelToolConversation, rememberAuthoringRequest, resumePausedAuthoringConversation, } from "../authoring/ModelToolConversation.js";
 import { summarizeStoredSettingImprovementSession, } from "./FileNativeSettingImprovementStore.js";
 import { SettingAuthoringTransaction, settingImprovementRuntimeContract, settingImprovementToolDefinitions, authoringPreloadAuthorization, buildAuthoringPreload, contentPackageAuthoringSurface, } from "./SettingAuthoringTransaction.js";
 class RecoveryWriteConflictError extends Error {
@@ -62,7 +62,7 @@ export class SettingImprovementSession {
     async overview(packageId) {
         return this.#mutate(async () => {
             let summaries = await this.#store.listSummariesByPackage(packageId);
-            const latestSummary = summaries[0];
+            const latestSummary = summaries.find((summary) => !summary.damagedContinuation);
             const latest = latestSummary === undefined
                 ? null
                 : await this.#recoverIfNeeded(await this.#store.read(latestSummary.sessionId));
@@ -187,6 +187,8 @@ export class SettingImprovementSession {
                 assertPackage(session, input.packageId);
             }
             return this.#startRequest(session, requestId, async (next) => {
+                if (next.runStatus === "paused")
+                    throw new Error("Resume the paused authoring request before sending another message");
                 const { playPreset, bootstrap, preload } = await this.#compileCurrent(input.packageId, next.modelBinding);
                 next.schemaVersion = 3;
                 next.requests ??= [];
@@ -199,6 +201,8 @@ export class SettingImprovementSession {
                 });
                 next.authorization = authoringPreloadAuthorization(next.authorization, preload.record);
                 appendAuthoringUserMessage(next, message, requestId);
+                if (next.modelBinding.provider === "google_interactions")
+                    next.googleOutcomeUnknown = false;
             });
         });
         return prepared.run ?? this.#view(prepared.session);
@@ -223,10 +227,16 @@ export class SettingImprovementSession {
                 throw new Error("Another message in this setting-improvement 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.");
         const host = await this.#bindExistingModelHost(session.modelBinding);
         if (!equalModelHostBinding(session.modelBinding, host.binding()))
             throw new Error("No saved model connection matches this setting-improvement conversation");
         await prepare(session);
+        if (session.modelBinding.provider === "google_interactions" &&
+            host.previewAuthoringRequest !== undefined &&
+            session.requests?.at(-1)?.requestId === requestId)
+            session.requests.at(-1).wireRequest = host.previewAuthoringRequest(authoringExchange(session, requestId));
         await this.#store.save(session);
         return { session, run: this.#startRun(session, host, requestId) };
     }
@@ -317,9 +327,10 @@ export class SettingImprovementSession {
             tools,
         });
         const now = Date.now();
+        const sessionId = this.#store.createId();
         const session = {
             schemaVersion: 2,
-            sessionId: this.#store.createId(),
+            sessionId,
             packageId,
             contentPackageTitle: package_.title,
             locale,
@@ -327,6 +338,9 @@ export class SettingImprovementSession {
             createdAt: now,
             updatedAt: now,
             creationRequestId,
+            ...(modelBinding.provider === "google_interactions"
+                ? { googleIdentity: { sessionId, packageId, creationRequestId } }
+                : {}),
             bootstrap,
             modelBinding,
             playPreset: structuredClone(playPreset),
@@ -353,6 +367,7 @@ export class SettingImprovementSession {
             host,
             requestId,
             save: (next) => this.#store.save(next),
+            recordGoogleHop: (id, hop) => this.#store.recordGoogleHop(session.sessionId, id, hop),
             settleToolResponse: async (next, assistantItemIndex, toolCalls) => {
                 activeTransaction = await this.#settleToolResponse(next, assistantItemIndex, toolCalls, activeTransaction);
             },
@@ -451,6 +466,8 @@ export class SettingImprovementSession {
             return this.#recoverIfNeeded(await this.#store.read(session.sessionId));
         }
         if (session.pendingSettlement !== null) {
+            if (session.modelBinding.provider === "google_interactions")
+                session.googleOutcomeUnknown = false;
             const lease = await this.#content.beginCurrentTreeContentPackageOperation(session.packageId);
             let retry = false;
             try {
@@ -510,7 +527,21 @@ export class SettingImprovementSession {
                 return this.#recoverIfNeeded(await this.#store.read(session.sessionId));
             return session;
         }
-        if (session.runStatus === "running") {
+        const lastItem = session.modelItems.at(-1);
+        const legacyUnknown = session.modelBinding.provider === "google_interactions" &&
+            session.runStatus === "interrupted" &&
+            session.googleOutcomeUnknown === undefined &&
+            (lastItem?.kind === "user" || lastItem?.kind === "tool");
+        if (legacyUnknown) {
+            session.googleOutcomeUnknown = true;
+            session.lastFailure =
+                "The Google request outcome is unknown; start a fresh model context.";
+            session.updatedAt = Date.now();
+        }
+        else if (session.runStatus === "running") {
+            if (session.modelBinding.provider === "google_interactions" &&
+                session.googleOutcomeUnknown !== false)
+                session.googleOutcomeUnknown = true;
             markInterruptedAfterRestart(session);
             session.updatedAt = Date.now();
         }
@@ -606,12 +637,17 @@ function lastPendingAssistant(session) {
 }
 function markInterruptedAfterRestart(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 before its next complete response. Every settled current-tree change and complete tool result was retained; 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 before its next complete response. Every settled current-tree change and complete tool result was retained; continue this conversation when ready.";
 }
 function requiredMessage(message) {
     if (message.trim().length === 0)
@@ -750,6 +786,11 @@ function diffForRollback(files, change) {
 function settingImprovementHistoryItem(summary) {
     return {
         sessionId: summary.sessionId,
+        ...(summary.damagedContinuation
+            ? {
+                unavailableReason: "Google continuation is damaged; start a fresh model context.",
+            }
+            : {}),
         runStatus: summary.runStatus,
         createdAt: summary.createdAt,
         updatedAt: summary.updatedAt,

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

@@ -3,9 +3,12 @@ import { upgradeLegacyEpochs } from "./LegacyWorldRevisionEpochUpgrade.js";
 import { isPackageFollowupControlPath } from "../content/PackageFollowups.js";
 import { validAuthoringRequests, } from "../authoring/AuthoringRequestSnapshot.js";
 import { createHash, randomUUID } from "node:crypto";
-import { mkdir, open, readFile, readdir, rename, rm } from "node:fs/promises";
+import { readGoogleHops, writeGoogleHop } from "../model/GoogleHopJournal.js";
+import { mkdir, open, readFile, readdir, rename, rm, stat, } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
 import { gameplayPath } from "../../protocol/gameplay.js";
+import { validGoogleInteractionsSteps } from "../model/ProviderExchangeState.js";
+import { hasDamagedGoogleSteps, withoutDamagedGoogleSteps, } from "../authoring/DamagedGoogleContinuation.js";
 import { contentTreeFingerprint } from "../content/ContentTreeFingerprint.js";
 import { isPlayPresetBinding, } from "../play/FileNativePlayPresetStore.js";
 const uuidV4Pattern = "[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}";
@@ -46,6 +49,10 @@ export class FileNativeWorldRevisionStore {
     createSessionId() {
         return `world-session-${randomUUID()}`;
     }
+    recordGoogleHop(sessionId, requestId, hop) {
+        assertSessionId(sessionId);
+        return writeGoogleHop(join(this.#sessionsRoot, ".google-hops", sessionId), requestId, hop, () => stat(this.#sessionPath(sessionId)).then(() => true, () => false));
+    }
     createChangeSetId() {
         return `change-set:${randomUUID()}`;
     }
@@ -89,7 +96,20 @@ export class FileNativeWorldRevisionStore {
         });
     }
     readSession(sessionId) {
-        return this.#afterMutations(() => this.#readSession(sessionId));
+        return this.#afterMutations(async () => {
+            try {
+                const session = await this.#readSession(sessionId);
+                if (hasDamagedGoogleSteps(session) &&
+                    (await this.#damagedSession(sessionId)))
+                    throw new Error("The historical conversation has damaged Google continuation; start a fresh model context");
+                return session;
+            }
+            catch (error) {
+                if (await this.#damagedSession(sessionId))
+                    throw new Error("The historical conversation has damaged Google continuation; start a fresh model context", { cause: error });
+                throw error;
+            }
+        });
     }
     saveSession(session) {
         return this.#mutate(async () => {
@@ -110,7 +130,19 @@ export class FileNativeWorldRevisionStore {
             for (const entry of entries) {
                 if (!entry.isFile() || !sessionName.test(entry.name))
                     continue;
-                const session = await this.#readSession(entry.name.slice(0, -5));
+                const sessionId = entry.name.slice(0, -5);
+                let session;
+                try {
+                    session = await this.#readSession(sessionId);
+                    if (hasDamagedGoogleSteps(session))
+                        session = (await this.#damagedSession(sessionId)) ?? session;
+                }
+                catch (error) {
+                    const damaged = await this.#damagedSession(sessionId);
+                    if (damaged === null)
+                        throw error;
+                    session = damaged;
+                }
                 if (session.worldId === worldId)
                     sessions.push(session);
             }
@@ -118,7 +150,10 @@ export class FileNativeWorldRevisionStore {
         });
     }
     async findByCreationRequest(worldId, requestId) {
-        return ((await this.listSessions(worldId)).find(({ creationRequestId }) => creationRequestId === requestId) ?? null);
+        const match = (await this.listSessions(worldId)).find(({ creationRequestId }) => creationRequestId === requestId);
+        if (match?.damagedContinuation)
+            throw new Error("The historical conversation has damaged Google continuation; start a fresh model context with a new request ID");
+        return match ?? null;
     }
     deleteSession(worldId, sessionId) {
         return this.#mutate(async () => {
@@ -126,6 +161,10 @@ export class FileNativeWorldRevisionStore {
             if (session.worldId !== worldId)
                 throw new Error("World-revision conversation belongs to another world");
             await rm(this.#sessionPath(sessionId));
+            await rm(join(this.#sessionsRoot, ".google-hops", sessionId), {
+                recursive: true,
+                force: true,
+            });
         });
     }
     async #readEpoch(epochId) {
@@ -155,8 +194,34 @@ export class FileNativeWorldRevisionStore {
         const session = validateSession(value);
         if (session.sessionId !== sessionId)
             throw new Error("World-revision conversation identity does not match its file");
+        for (const request of session.requests ?? [])
+            if (request.wireRequest !== undefined)
+                request.wireRequest = await readGoogleHops(join(this.#sessionsRoot, ".google-hops", sessionId), request.requestId, request.wireRequest);
         return session;
     }
+    async #damagedSession(sessionId) {
+        const raw = JSON.parse(await readFile(this.#sessionPath(sessionId), "utf8"));
+        const copy = withoutDamagedGoogleSteps(raw);
+        if (copy === null) {
+            if (hasDamagedGoogleSteps(raw))
+                throw new Error("Cannot safely identify the damaged historical conversation; settlement or identity is unverified");
+            return null;
+        }
+        const session = validateSession(copy);
+        if (session.sessionId !== sessionId ||
+            session.requests?.[0]?.requestId !== session.creationRequestId ||
+            !/^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$/u.test(session.creationRequestId))
+            throw new Error("Cannot safely identify the damaged historical conversation; its creation identity is unverified");
+        const epoch = await this.#readEpoch(session.epochId);
+        if (epoch.worldId !== session.worldId)
+            throw new Error("Cannot safely identify the damaged historical conversation; its world is inconsistent");
+        return {
+            ...session,
+            damagedContinuation: true,
+            runStatus: "interrupted",
+            lastFailure: "Google continuation is damaged; start a fresh model context.",
+        };
+    }
     async #afterMutations(read) {
         await this.#mutationTail;
         return read();
@@ -274,7 +339,7 @@ function validateSession(value) {
             "lastFailure",
             "authorization",
             "pendingSettlement",
-        ], ["requests"]) ||
+        ], ["requests", "googleOutcomeUnknown"]) ||
         (value.schemaVersion !== 1 && value.schemaVersion !== 2) ||
         (value.schemaVersion === 1
             ? value.requests !== undefined
@@ -311,6 +376,10 @@ function validateSession(value) {
         !Array.isArray(value.completedRequestIds) ||
         !value.completedRequestIds.every((item) => typeof item === "string") ||
         (value.lastFailure !== null && typeof value.lastFailure !== "string") ||
+        (value.googleOutcomeUnknown !== undefined &&
+            (typeof value.googleOutcomeUnknown !== "boolean" ||
+                !isRecord(value.modelBinding) ||
+                value.modelBinding.provider !== "google_interactions")) ||
         !validAuthorization(value.authorization) ||
         !validPendingSettlement(value.pendingSettlement) ||
         !validPendingForSession(value.pendingSettlement, value.epochId, value.runStatus) ||
@@ -452,6 +521,9 @@ function validModelToolCall(value) {
 function validProviderState(value) {
     if (!isRecord(value))
         return false;
+    if (value.protocol === "google_interactions")
+        return (hasExactKeys(value, ["protocol", "steps"]) &&
+            validGoogleInteractionsSteps(value.steps));
     if (value.protocol === "chat_completions")
         return hasExactKeys(value, ["protocol", "assistantMessage"]);
     if (value.protocol === "openai_responses")
@@ -509,7 +581,8 @@ function validModelBinding(value) {
         ], ["cacheStrategy"]) &&
         (value.provider === "chat_completions" ||
             value.provider === "openai_responses" ||
-            value.provider === "anthropic_messages") &&
+            value.provider === "anthropic_messages" ||
+            value.provider === "google_interactions") &&
         typeof value.endpointFingerprint === "string" &&
         typeof value.modelId === "string" &&
         count(value.contextWindowTokens) &&
@@ -531,7 +604,10 @@ function validModelUsage(value) {
         "totalTokens",
     ];
     if (!isRecord(value) ||
-        !hasExactKeys(value, [...fields, "provenance"]) ||
+        !hasExactKeys(value, [...fields, "provenance"], ["providerRaw", "accounting"]) ||
+        (value.providerRaw !== undefined && !isRecord(value.providerRaw)) ||
+        (value.accounting !== undefined &&
+            value.accounting !== "google_interactions") ||
         !fields.every((field) => value[field] === null || count(value[field])) ||
         !isRecord(value.provenance) ||
         !hasExactKeys(value.provenance, fields))
@@ -594,7 +670,7 @@ function validPendingSettlement(value) {
 function validPendingForSession(pending, epochId, runStatus) {
     return (pending === null ||
         (isRecord(pending) &&
-            runStatus === "running" &&
+            (runStatus === "running" || runStatus === "interrupted") &&
             pending.epochId === epochId));
 }
 function validToolResult(value) {

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
+`,
+    };
+}