narraeon 0.7.2 → 0.7.5

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

@@ -1,89 +1,46 @@
 import { isPackageFollowupControlPath } from "../content/PackageFollowups.js";
-import { defaultAppLocale } from "../../protocol/appPreferences.js";
 import { assertSameGameplay, gameplayPath, readGameplay, } from "../../protocol/gameplay.js";
 import { inspectContentPackageCurrentTree } from "../content/FileNativeContentTree.js";
-import { SettingAuthoringTransaction, settingImprovementToolDefinitions, } from "../setting/SettingAuthoringTransaction.js";
+import { authoringToolDefinitions, SettingAuthoringTransaction, worldRevisionAuthoringSurface, } from "../setting/SettingAuthoringTransaction.js";
 import { WorldDocumentStore } from "../world/WorldDocumentStore.js";
-const syntheticOpening = {
-    path: "opening.md",
-    contents: "# Existing world\n\nThe genesis opening is immutable in a world revision.\n",
-};
-const settingToRevisionTool = new Map([
-    ["setting_list", "world_revision_list"],
-    ["setting_search", "world_revision_search"],
-    ["setting_read", "world_revision_read"],
-    ["setting_create", "world_revision_create"],
-    ["setting_write_file", "world_revision_write_file"],
-    ["setting_patch", "world_revision_patch"],
-    ["setting_move", "world_revision_move"],
-    ["setting_delete", "world_revision_delete"],
-]);
-const revisionToSettingTool = new Map([...settingToRevisionTool].map(([setting, revision]) => [revision, setting]));
 /**
- * Adapter that reuses the content-package authoring mechanics while exposing
- * the current world's state/control worktree as its own logical target.
+ * The authoring transaction over a playing world's state/control worktree.
+ * Its namespace, tool names and wording come from the world-revision surface,
+ * so nothing it returns is rewritten after the transaction renders it.
  */
 export class WorldRevisionAuthoringTransaction {
     #inner;
-    #locale;
     constructor(input) {
-        this.#locale = input.locale ?? defaultAppLocale;
         this.#inner = new SettingAuthoringTransaction({
-            baseFiles: toProjectedFiles(input.baseFiles),
-            locale: this.#locale,
+            baseFiles: input.baseFiles,
+            surface: worldRevisionAuthoringSurface,
+            ...(input.locale === undefined ? {} : { locale: input.locale }),
             ...(input.revision === undefined ? {} : { revision: input.revision }),
             ...(input.authorization === undefined
                 ? {}
                 : { authorization: input.authorization }),
-            validateFiles: (files) => {
-                const candidate = fromProjectedFiles(files);
-                assertUsableWorldRevisionFiles(candidate, input.immutableBaseFiles);
-            },
+            validateFiles: (files) => assertUsableWorldRevisionFiles(files, input.immutableBaseFiles),
             preview: (snapshot) => input.preview(WorldDocumentStore.open({
                 layout: "world_state",
-                files: fromProjectedFiles(snapshot.files),
+                files: [...snapshot.files].sort((left, right) => left.path.localeCompare(right.path)),
             })),
         });
     }
     files() {
-        return fromProjectedFiles(this.#inner.files());
+        return this.#inner.files();
     }
     review() {
-        return mapReview(this.#inner.review());
+        return this.#inner.review();
     }
     authorization(revision) {
         return this.#inner.authorization(revision);
     }
     execute(calls) {
-        const mapped = calls.map(mapToolCall);
-        const executed = this.#inner.execute(mapped.flatMap((item) => ("call" in item ? [item.call] : [])));
-        let executedIndex = 0;
-        return mapped.map((item, index) => {
-            if ("error" in item)
-                return rejectedToolResult(calls[index].id, item.error, this.#locale);
-            const result = executed[executedIndex++];
-            if (result === undefined)
-                throw new Error("World-revision authoring returned no tool result");
-            return {
-                ...result,
-                markdown: publicWorldRevisionMarkdown(result.markdown),
-                changes: result.changes.map(mapDiff),
-            };
-        });
+        return this.#inner.execute(calls);
     }
 }
 export function worldRevisionToolDefinitions(locale, gameplay) {
-    return settingImprovementToolDefinitions(locale, gameplay).map((definition) => {
-        const name = settingToRevisionTool.get(definition.name);
-        if (name === undefined)
-            throw new Error(`Unsupported setting authoring tool: ${definition.name}`);
-        return {
-            ...structuredClone(definition),
-            name,
-            description: publicWorldRevisionMarkdown(definition.description),
-            inputSchema: mapSchema(definition.inputSchema),
-        };
-    });
+    return authoringToolDefinitions(worldRevisionAuthoringSurface, locale, gameplay);
 }
 export function worldRevisionRuntimeContract(locale, gameplay) {
     // A world's mode and scheme are fixed, so only tabletop worlds mention the file.
@@ -170,21 +127,17 @@ export function inspectWorldRevisionFiles(files, immutableBaseFiles) {
                 message: "An existing world-state document must keep its document ID and short reference",
             });
     }
-    const projected = files.map((file) => ({
-        ...structuredClone(file),
-        path: file.path.startsWith("state/")
-            ? `world/${file.path.slice("state/".length)}`
-            : file.path,
-    }));
-    const inspection = inspectContentPackageCurrentTree(projected, {
+    const inspection = inspectContentPackageCurrentTree(files, {
         requireOpening: false,
+        worldDocumentSnapshot: WorldDocumentStore.open({
+            layout: "world_revision",
+            files,
+        }),
     });
     if (inspection.status !== "usable")
         diagnostics.push(...inspection.issues.map(({ code, path, message }) => ({
             code,
-            path: path.startsWith("world/")
-                ? `state/${path.slice("world/".length)}`
-                : path,
+            path,
             message,
         })));
     return {
@@ -223,178 +176,6 @@ export function assertUsableWorldRevisionFiles(files, immutableBaseFiles) {
             .map(({ path, message }) => `${path}: ${message}`)
             .join("; "));
 }
-function toProjectedFiles(files) {
-    return [
-        syntheticOpening,
-        ...files.map((file) => ({
-            ...structuredClone(file),
-            path: file.path.startsWith("state/")
-                ? `world/${file.path.slice("state/".length)}`
-                : file.path,
-        })),
-    ];
-}
-function fromProjectedFiles(files) {
-    const opening = files.find(({ path }) => path === "opening.md");
-    if (opening?.contents !== syntheticOpening.contents ||
-        opening.encoding !== undefined)
-        throw new Error("opening.md is immutable in a world revision");
-    return files
-        .filter(({ path }) => path !== "opening.md")
-        .map((file) => ({
-        ...structuredClone(file),
-        path: file.path.startsWith("world/")
-            ? `state/${file.path.slice("world/".length)}`
-            : file.path,
-    }))
-        .sort((left, right) => left.path.localeCompare(right.path));
-}
-function mapToolCall(call) {
-    const name = revisionToSettingTool.get(call.name);
-    if (name === undefined)
-        return {
-            call: { ...structuredClone(call), name: `unsupported:${call.name}` },
-        };
-    const args = isRecord(call.arguments)
-        ? structuredClone(call.arguments)
-        : call.arguments;
-    if (isRecord(args)) {
-        for (const field of [
-            "path",
-            "directory",
-            "within",
-            "from",
-            "to",
-            "document",
-        ])
-            if (typeof args[field] === "string") {
-                if (args[field] === "opening.md")
-                    return { error: "opening" };
-                if (args[field] === "world" || args[field].startsWith("world/"))
-                    return { error: "namespace" };
-                args[field] = toProjectedPath(args[field]);
-            }
-    }
-    return {
-        call: { ...structuredClone(call), name, arguments: args },
-    };
-}
-function toProjectedPath(path) {
-    if (path === "state")
-        return "world";
-    return path.startsWith("state/")
-        ? `world/${path.slice("state/".length)}`
-        : path;
-}
-function mapDiff(diff) {
-    return {
-        ...structuredClone(diff),
-        path: diff.path.startsWith("world/")
-            ? `state/${diff.path.slice("world/".length)}`
-            : diff.path,
-    };
-}
-function mapReview(review) {
-    return {
-        ...structuredClone(review),
-        diff: review.diff.filter(({ path }) => path !== "opening.md").map(mapDiff),
-        diagnostics: review.diagnostics.map((diagnostic) => ({
-            ...diagnostic,
-            path: diagnostic.path.startsWith("world/")
-                ? `state/${diagnostic.path.slice("world/".length)}`
-                : diagnostic.path,
-        })),
-        playCoverage: review.playCoverage === null
-            ? null
-            : {
-                ...structuredClone(review.playCoverage),
-                changed: review.playCoverage.changed
-                    .filter(({ path }) => path !== "opening.md")
-                    .map((item) => ({ ...item, path: mapPublicPath(item.path) })),
-            },
-    };
-}
-function mapPublicPath(path) {
-    return path.startsWith("world/")
-        ? `state/${path.slice("world/".length)}`
-        : path;
-}
-function publicWorldRevisionMarkdown(markdown) {
-    let fenced = false;
-    let documentBody = false;
-    let opaqueBody = false;
-    return markdown
-        .split("\n")
-        .flatMap((line) => {
-        if (line.trim() === "[body]") {
-            documentBody = true;
-            return [line];
-        }
-        if (line.trim() === "[/body]") {
-            documentBody = false;
-            return [line];
-        }
-        if (line.trimStart().startsWith("```")) {
-            fenced = !fenced;
-            return [line];
-        }
-        if (line.startsWith("# Special-file source ") ||
-            line.startsWith("# 专用文件原文 "))
-            opaqueBody = true;
-        else if (opaqueBody && line === "---")
-            opaqueBody = false;
-        if (fenced ||
-            documentBody ||
-            (opaqueBody &&
-                !line.startsWith("# Special-file source ") &&
-                !line.startsWith("# 专用文件原文 ")) ||
-            /^\s+"/u.test(line))
-            return [line];
-        const mapped = line
-            .replaceAll("setting_", "world_revision_")
-            .replaceAll("content package", "world revision")
-            .replaceAll("Content package", "World revision")
-            .replaceAll("内容包当前树", "世界修订工作树")
-            .replaceAll("内容包", "世界修订")
-            .replaceAll("opening and control", "control")
-            .replaceAll("opening/control", "control")
-            .replaceAll("opening.md, ", "")
-            .replaceAll("opening 和 control", "control")
-            .replaceAll("opening.md、", "")
-            .replaceAll("world/", "state/");
-        return /^- \[(?:special|binary)\] opening\.md$/u.test(mapped.trim())
-            ? []
-            : [mapped];
-    })
-        .join("\n");
-}
-function rejectedToolResult(toolCallId, error, locale) {
-    const message = error === "opening"
-        ? locale === "zh-CN"
-            ? "世界创建后 opening.md 已成为不可变创世叙事。请改写 state/* 或 control/*。"
-            : "opening.md is immutable after a world has been created. Edit state/* or control/* instead."
-        : locale === "zh-CN"
-            ? "世界修订只公开 state/* 与 control/* 逻辑路径；不能使用内容包的 world/* 命名空间。"
-            : "World revision exposes only state/* and control/* logical paths; the content-package world/* namespace is unavailable.";
-    return {
-        toolCallId,
-        markdown: `# Runtime tool rejected\n\n${message}`,
-        isError: true,
-        changes: [],
-    };
-}
-function mapSchema(schema) {
-    const map = (value) => {
-        if (typeof value === "string")
-            return value.replaceAll("world", "state");
-        if (Array.isArray(value))
-            return value.map(map);
-        if (!isRecord(value))
-            return value;
-        return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, map(child)]));
-    };
-    return map(schema);
-}
 function isWritableWorldRevisionPath(path) {
     if (/^state\/.+\.(?:ya?ml|md)$/u.test(path))
         return true;
@@ -404,6 +185,3 @@ function isWritableWorldRevisionPath(path) {
         path === "control/player-views.yaml" ||
         /^control\/blocks\/.+\.md$/u.test(path));
 }
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}

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

@@ -190,25 +190,18 @@ export class WorldRevisionWorkspace {
                 layout: "world_state",
                 files: epoch.files,
             }));
-            const outcome = await this.#worlds.commitCorrection({
+            // state 与 control 的改动是同一轮 revision_apply：要么整轮成立，要么整轮不存在（#102 的账本恢复）。
+            const outcome = await this.#worlds.commitWorldRevisionApply({
                 ...(worldClock === undefined ? {} : { worldClock }),
                 operationId: epoch.apply.operationId,
                 worldId: epoch.worldId,
                 parentHead: epoch.baseHead,
                 nextMaterials: binding.additionalMaterials,
                 stateChanges: stateChanges(epoch.baseFiles, epoch.files),
+                control: controlFiles(epoch.files),
                 worldRevisionLock: handle,
-                validationControl: controlFiles(epoch.files),
             });
-            epoch = await this.#recordStateCommit(handle, outcome);
-        }
-        if (epoch.apply?.phase === "state_committed") {
-            await this.#worlds.replaceWorldRevisionControl({
-                handle,
-                expectedFingerprint: epoch.baseControlFingerprint,
-                files: controlFiles(epoch.files),
-            });
-            await this.#recordControlPublication(handle);
+            await this.#recordCommit(handle, outcome);
         }
         epoch = await this.#finishApply(handle);
         await this.#worlds.releaseWorldRevisionLock(handle);
@@ -309,7 +302,7 @@ export class WorldRevisionWorkspace {
             if (epoch.lifecycle !== "applying" || epoch.apply === null)
                 throw new WorldRevisionWorkspaceError("Apply recovery state is damaged");
             epoch.lifecycle = "applied";
-            epoch.apply.phase = "control_published";
+            epoch.apply.phase = "committed";
             epoch.apply.committedHead = epoch.baseHead;
             epoch.finishedAt = Date.now();
             epoch.updatedAt = epoch.finishedAt;
@@ -317,34 +310,22 @@ export class WorldRevisionWorkspace {
             return epoch;
         });
     }
-    async #recordStateCommit(handle, outcome) {
+    async #recordCommit(handle, outcome) {
         return this.#withRevisionOwnership(handle, async () => {
             const epoch = await this.#store.readEpoch(handle.epochId);
             if (epoch.lifecycle !== "applying" || epoch.apply === null)
                 throw new WorldRevisionWorkspaceError("Apply recovery state is damaged");
-            epoch.apply.phase = "state_committed";
+            epoch.apply.phase = "committed";
             epoch.apply.committedHead = outcome.head;
             epoch.updatedAt = Date.now();
             await this.#store.saveEpoch(epoch);
             return epoch;
         });
     }
-    async #recordControlPublication(handle) {
-        return this.#withRevisionOwnership(handle, async () => {
-            const epoch = await this.#store.readEpoch(handle.epochId);
-            if (epoch.lifecycle !== "applying" || epoch.apply === null)
-                throw new WorldRevisionWorkspaceError("Apply recovery state is damaged");
-            epoch.apply.phase = "control_published";
-            epoch.updatedAt = Date.now();
-            await this.#store.saveEpoch(epoch);
-            return epoch;
-        });
-    }
     async #finishApply(handle) {
         return this.#withRevisionOwnership(handle, async () => {
             const epoch = await this.#store.readEpoch(handle.epochId);
-            if (epoch.lifecycle !== "applying" ||
-                epoch.apply?.phase !== "control_published")
+            if (epoch.lifecycle !== "applying" || epoch.apply?.phase !== "committed")
                 throw new WorldRevisionWorkspaceError("Apply recovery state is damaged");
             epoch.lifecycle = "applied";
             epoch.finishedAt = Date.now();

package/dist/node/server/createServer.js

@@ -91,6 +91,7 @@ export async function createServer(input) {
                 return await input.runtime.worldArchives.upload(request.body);
             }
             catch (error) {
+                await input.runtime.recordArchiveFailure({ type: "world.archive.upload" }, error);
                 if (error instanceof WorldArchiveError)
                     return reply
                         .status(error.code === "limit_exceeded" ? 413 : 400)
@@ -98,6 +99,21 @@ export async function createServer(input) {
                 throw error;
             }
         });
+        // The browser checks this before it starts the one-time download, so a
+        // missing or failing export is reported on the page instead of a blank file.
+        archives.get("/api/runtime/v1/world-archives/:archiveId/check", async (request, reply) => {
+            try {
+                await input.runtime.worldArchives.checkDownload(request.params.archiveId);
+                return reply.status(204).send();
+            }
+            catch (error) {
+                await input.runtime.recordArchiveFailure({
+                    type: "world.archive.download",
+                    archiveId: request.params.archiveId,
+                }, error);
+                return archiveDownloadFailure(reply, error);
+            }
+        });
         archives.get("/api/runtime/v1/world-archives/:archiveId", async (request, reply) => {
             try {
                 const archive = await input.runtime.worldArchives.download(request.params.archiveId);
@@ -111,20 +127,11 @@ export async function createServer(input) {
                     .send(archive.stream);
             }
             catch (error) {
-                if (error instanceof WorldArchiveError)
-                    return reply
-                        .status(400)
-                        .send({ error: { code: error.code, message: error.message } });
-                if (error instanceof Error &&
-                    "code" in error &&
-                    error.code === "ENOENT")
-                    return reply.status(404).send({
-                        error: {
-                            code: "invalid_archive",
-                            message: "The archive download is unavailable",
-                        },
-                    });
-                throw error;
+                await input.runtime.recordArchiveFailure({
+                    type: "world.archive.download",
+                    archiveId: request.params.archiveId,
+                }, error);
+                return archiveDownloadFailure(reply, error);
             }
         });
         done();
@@ -160,13 +167,19 @@ export async function createServer(input) {
         }
         catch (error) {
             if (error instanceof V1ProtocolError) {
-                // 端点已被回退丢弃：客户端应重新读取当前世界，不是服务端错误。
-                const status = error.code === "endpoint_discarded" ? 409 : 400;
+                // 端点已被回退丢弃或内容包已被其他操作修改：客户端应重新读取，不是服务端错误。
+                const status = error.code === "endpoint_discarded" ||
+                    error.code === "content_conflict"
+                    ? 409
+                    : 400;
                 return reply.status(status).send({
                     protocol: "narraeon.runtime/v1",
                     error: {
                         code: error.code,
                         message: error.message,
+                        ...(error.details === undefined
+                            ? {}
+                            : { details: error.details }),
                     },
                 });
             }
@@ -182,6 +195,20 @@ export async function createServer(input) {
     server.get("/index.html", index);
     return server;
 }
+function archiveDownloadFailure(reply, error) {
+    if (error instanceof WorldArchiveError)
+        return reply
+            .status(400)
+            .send({ error: { code: error.code, message: error.message } });
+    if (error instanceof Error && "code" in error && error.code === "ENOENT")
+        return reply.status(404).send({
+            error: {
+                code: "invalid_archive",
+                message: "The archive download is unavailable",
+            },
+        });
+    throw error;
+}
 function acceptsPlayCallChainStream(request) {
     const accept = request.headers.accept;
     return (typeof accept === "string" &&
@@ -246,8 +273,5 @@ function isPlayCallChainView(value) {
             value.status === "interrupted"));
 }
 function hasPlayCancellation(value) {
-    if (!isRecord(value) || !Array.isArray(value.events))
-        return false;
-    const last = value.events.at(-1);
-    return isRecord(last) && last.kind === "cancellation";
+    return isRecord(value) && value.lastCancelled === true;
 }