narraeon 0.3.1 → 0.5.0

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

@@ -1,14 +1,56 @@
+import { parseDisplayRegex, DisplayRegexError, } from "../../shared/display-regex.js";
+export { validatePlayPresetArtifactPayload } from "../../shared/artifact-payload-contract.js";
+import { defaultFollowupItems, } from "../../shared/ordered-followups.js";
+import { parseFollowupItems } from "./OrderedFollowups.js";
+import { builtinAuthorPrompts, defaultOrderedAuthorPrompts, } from "../../shared/ordered-author-prompts.js";
+import { parseOrderedPlayPrompts, migrateLegacyPlayPrompts, } from "./OrderedPlayPrompts.js";
+import { defaultOrderedPlayPrompts, } from "../../shared/ordered-play-prompts.js";
 import { createHash, randomUUID } from "node:crypto";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 import { isDeepStrictEqual } from "node:util";
-import { parseDocument } from "yaml";
+import { parseDocument, stringify, visit, isAlias } from "yaml";
 import { defaultPortableContentTreeLimits, portableContentTreePathKey, } from "../../protocol/contentTree.js";
 import { defaultAppLocale, } from "../../protocol/appPreferences.js";
 import { defaultNarrationPromptForLocale } from "../../shared/default-play-prompts.js";
 import { defaultPresetHostFilesForLocale } from "../../shared/default-preset-host.js";
 import { defaultSettingImprovementPromptForLocale, defaultSettingImprovementPromptPath, } from "../../shared/default-setting-improvement-prompt.js";
 import { isPlayPresetPromptRole, } from "../../shared/play-preset-prompt-roles.js";
+export function isFrozenArtifactPresentation(value) {
+    if (!isRecord(value) ||
+        !hasExactKeys(value, ["declaration", "files", "mount"]) ||
+        !isRecord(value.declaration) ||
+        !isRecord(value.files) ||
+        !Object.values(value.files).every((body) => typeof body === "string"))
+        return false;
+    try {
+        const original = value.declaration;
+        const parsed = parseArtifacts([
+            {
+                ...original,
+                ...(original.channel === "builtin:summary" ||
+                    (typeof original.channel === "string" &&
+                        /^package:[a-z][a-z0-9._/-]{1,127}$/u.test(original.channel))
+                    ? { channel: "frozen.presentation" }
+                    : {}),
+            },
+        ], value.files, "frozen artifact")[0];
+        parsed.channel = String(original.channel);
+        return (isDeepStrictEqual(parsed, original) &&
+            typeof value.mount === "string" &&
+            [
+                "story",
+                "sidebar",
+                "composer_above",
+                "composer_below",
+                "overlay",
+                "debug",
+            ].includes(String(value.mount)));
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * The frame plus its block library, projected in the shape the prompt compiler
  * already consumes. A preset owns both halves now: `frame.yaml` decides which
@@ -55,7 +97,9 @@ export function isPlayPresetBinding(value) {
         value.revision === "builtin-default-v1" &&
         value.scriptsEnabled === true &&
         (isDeepStrictEqual(files, defaultPlayPresetFilesForLocale("en")) ||
-            isDeepStrictEqual(files, defaultPlayPresetFilesForLocale("zh-CN")));
+            isDeepStrictEqual(files, defaultPlayPresetFilesForLocale("zh-CN")) ||
+            isDeepStrictEqual(files, legacyDefaultPlayPresetFilesForLocale("en")) ||
+            isDeepStrictEqual(files, legacyDefaultPlayPresetFilesForLocale("zh-CN")));
     return (parsed.kind === "valid" &&
         isDeepStrictEqual(value.definition, parsed.definition) &&
         (builtInDefault || value.revision === revisionForPlayPresetFiles(files)));
@@ -68,7 +112,7 @@ export class FileNativePlayPresetError extends Error {
         this.name = "FileNativePlayPresetError";
     }
 }
-export function defaultPlayPresetFilesForLocale(locale) {
+export function legacyDefaultPlayPresetFilesForLocale(locale) {
     return {
         "preset.yaml": `format: narraeon.play-preset/v1
 name: ${locale === "zh-CN" ? "系统推荐" : "System recommended"}
@@ -88,6 +132,15 @@ followups: []
         [defaultSettingImprovementPromptPath]: defaultSettingImprovementPromptForLocale(locale),
     };
 }
+export function defaultPlayPresetFilesForLocale(locale) {
+    const files = legacyDefaultPlayPresetFilesForLocale(locale);
+    const preset = parseDocument(files["preset.yaml"]);
+    preset.set("format", "narraeon.play-preset/v2");
+    preset.set("playPrompts", defaultOrderedPlayPrompts());
+    preset.set("authorPrompts", defaultOrderedAuthorPrompts());
+    files["preset.yaml"] = stringify(preset.toJS());
+    return files;
+}
 export const defaultPlayPresetFiles = defaultPlayPresetFilesForLocale(defaultAppLocale);
 /**
  * Resolve the author-owned part of setting improvement from a frozen preset.
@@ -112,7 +165,7 @@ export function builtinDefaultPlayPresetBinding(locale = defaultAppLocale) {
     return {
         id: "builtin-default",
         name: "default",
-        revision: "builtin-default-v1",
+        revision: revisionForPlayPresetFiles(files),
         definition: parsed.definition,
         files,
         scriptsEnabled: true,
@@ -217,6 +270,42 @@ export class FileNativePlayPresetStore {
             if (input.structure !== undefined) {
                 files = applyPlayPresetStructuredEditor(input.files, parsePlayPresetStructuredEditor(input.structure));
             }
+            const previous = parsePlayPresetFiles(stored.revisions[stored.currentRevision]);
+            if (previous.kind === "valid" &&
+                previous.definition.followupItems !== undefined) {
+                const candidate = readYaml(files, "call-chain.yaml", "call-chain.yaml");
+                if (candidate.format !== "narraeon.play-call-chain/v2")
+                    throw new FileNativePlayPresetError("readonly_followup_removed", "Ordered followups cannot downgrade to v1");
+                parseFollowupItems(candidate.followupItems, parseFollowups(candidate.followups, files));
+            }
+            if (previous.kind === "valid" &&
+                previous.definition.playPrompts !== undefined) {
+                const candidate = readYaml(files, "preset.yaml", "preset.yaml");
+                if (candidate.format !== "narraeon.play-preset/v2")
+                    throw new FileNativePlayPresetError("readonly_prompt_removed", "Ordered presets cannot downgrade to v1");
+                const candidates = parseOrderedPlayPrompts(candidate.playPrompts);
+                for (const entry of previous.definition.playPrompts.filter((entry) => entry.kind !== "user")) {
+                    const retained = candidates.find((item) => item.id === entry.id);
+                    if (retained?.kind !== entry.kind ||
+                        (entry.kind === "builtin" &&
+                            retained.kind === "builtin" &&
+                            retained.builtin !== entry.builtin))
+                        throw new FileNativePlayPresetError("readonly_prompt_removed", "System prompts and the world placeholder cannot be deleted or replaced; disable optional prompts or clone them instead");
+                }
+            }
+            if (previous.kind === "valid" &&
+                previous.definition.authorPrompts !== undefined) {
+                const candidate = readYaml(files, "preset.yaml", "preset.yaml");
+                const entries = parseOrderedAuthorPrompts(candidate.authorPrompts);
+                for (const entry of previous.definition.authorPrompts) {
+                    if (entry.kind !== "builtin")
+                        continue;
+                    const retained = entries.find((item) => item.id === entry.id);
+                    if (retained?.kind !== "builtin" ||
+                        retained.builtin !== entry.builtin)
+                        throw new FileNativePlayPresetError("readonly_prompt_removed", "Authoring system prompts cannot be deleted or replaced; disable or clone optional prompts");
+                }
+            }
             const revision = revisionForFiles(files, this.#limits);
             stored.name = normalizeName(input.name);
             stored.revisions[revision] = cloneFiles(files);
@@ -363,6 +452,10 @@ export class FileNativePlayPresetStore {
     }
     async importPortable(input) {
         const files = toFileMap(input.files, this.#limits);
+        const parsed = parsePlayPresetFiles(files, this.#limits);
+        if (parsed.kind === "invalid")
+            throw parsed.error;
+        toPlayPresetStructuredEditor(parsed.definition);
         return this.#change(async () => {
             const document = await this.#read();
             const stored = this.#stored(randomUUID(), input.name, files);
@@ -460,7 +553,9 @@ export class FileNativePlayPresetStore {
         const files = preset.revisions[preset.currentRevision];
         if (files === undefined ||
             (!isDeepStrictEqual(files, defaultPlayPresetFilesForLocale("en")) &&
-                !isDeepStrictEqual(files, defaultPlayPresetFilesForLocale("zh-CN"))))
+                !isDeepStrictEqual(files, defaultPlayPresetFilesForLocale("zh-CN"))) ||
+            isDeepStrictEqual(files, legacyDefaultPlayPresetFilesForLocale("en")) ||
+            isDeepStrictEqual(files, legacyDefaultPlayPresetFilesForLocale("zh-CN")))
             return false;
         preset.builtinDefault = true;
         return true;
@@ -469,13 +564,10 @@ export class FileNativePlayPresetStore {
         const preset = document.presets.find(({ builtinDefault }) => builtinDefault === true);
         if (preset === undefined || preset.draftRevision !== undefined)
             return false;
-        const current = preset.revisions[preset.currentRevision];
-        if (current === undefined ||
-            (!isDeepStrictEqual(current, defaultPlayPresetFilesForLocale("en")) &&
-                !isDeepStrictEqual(current, defaultPlayPresetFilesForLocale("zh-CN")))) {
-            delete preset.builtinDefault;
-            return true;
-        }
+        // The marker, not equality with this build's defaults, identifies the
+        // Runtime-owned seed. A prior application version necessarily carries a
+        // different file revision after shipped prompts change. Every user edit or
+        // rename clears the marker before saving, so those presets remain intact.
         const desired = defaultPlayPresetFilesForLocale(this.#locale());
         const revision = revisionForFiles(desired, this.#limits);
         if (preset.currentRevision === revision)
@@ -501,21 +593,15 @@ export class FileNativePlayPresetStore {
         const files = stored.revisions[stored.currentRevision];
         if (files === undefined)
             throw new FileNativePlayPresetError("store_invalid", "The current play-preset revision does not exist");
-        const validation = validatePlayPresetFiles(files, this.#limits);
         const view = {
             id: stored.id,
             name: stored.name,
             revision: stored.currentRevision,
             files: cloneFiles(files),
-            validation,
+            ...editorProjection(files, this.#limits),
             enabled: stored.enabled,
             scriptsEnabled: stored.scriptsEnabled,
         };
-        if (validation.status === "valid") {
-            const parsed = parsePlayPresetFiles(files, this.#limits);
-            if (parsed.kind === "valid")
-                view.structure = toPlayPresetStructuredEditor(parsed.definition);
-        }
         if (stored.draftRevision !== undefined) {
             const draftFiles = stored.revisions[stored.draftRevision];
             if (draftFiles === undefined)
@@ -523,13 +609,8 @@ export class FileNativePlayPresetStore {
             view.draft = {
                 revision: stored.draftRevision,
                 files: cloneFiles(draftFiles),
-                validation: validatePlayPresetFiles(draftFiles, this.#limits),
+                ...editorProjection(draftFiles, this.#limits),
             };
-            if (view.draft.validation.status === "valid") {
-                const parsedDraft = parsePlayPresetFiles(draftFiles, this.#limits);
-                if (parsedDraft.kind === "valid")
-                    view.draft.structure = toPlayPresetStructuredEditor(parsedDraft.definition);
-            }
         }
         return view;
     }
@@ -566,9 +647,47 @@ export function validatePlayPresetFiles(files, limits = {}) {
         };
     }
 }
+function editorProjection(files, limits) {
+    const validation = validatePlayPresetFiles(files, limits);
+    if (validation.status === "invalid")
+        return { validation };
+    const parsed = parsePlayPresetFiles(files, limits);
+    if (parsed.kind === "invalid")
+        return { validation };
+    try {
+        return {
+            validation,
+            structure: toPlayPresetStructuredEditor(parsed.definition),
+        };
+    }
+    catch (error) {
+        return {
+            validation: {
+                status: "invalid",
+                code: "legacy_preset_migration_invalid",
+                location: "frame.yaml",
+                message: error instanceof Error
+                    ? error.message
+                    : "Legacy preset cannot be migrated",
+            },
+        };
+    }
+}
 export function toPlayPresetStructuredEditor(definition) {
     return {
         name: definition.name,
+        authorPrompts: structuredClone(definition.authorPrompts ?? legacyAuthorPrompts(definition)),
+        playPrompts: structuredClone(definition.playPrompts ??
+            migrateLegacyPlayPrompts(definition.files, definition.narrativePrompts, [
+                definition.settingImprovementPrompt?.path ??
+                    defaultSettingImprovementPromptPath,
+                ...definition.followups.map((followup) => followup.prompt.path),
+            ])),
+        ...(definition.playPrompts
+            ? {}
+            : {
+                migrationNotice: "旧世界指令与材料归并到首次世界位置，其他提示相对顺序及正文保留；历史请求不变。保存后采用统一编排。",
+            }),
         callChainPath: definition.callChainPath,
         ...(definition.settingImprovementPrompt === undefined
             ? {}
@@ -580,6 +699,7 @@ export function toPlayPresetStructuredEditor(definition) {
         extensionRefs: [...definition.extensionRefs],
         narrativePrompts: structuredClone(definition.narrativePrompts),
         followups: structuredClone(definition.followups),
+        followupItems: structuredClone(definition.followupItems ?? defaultFollowupItems(definition.followups)),
     };
 }
 /**
@@ -606,6 +726,12 @@ export function applyPlayPresetStructuredEditor(files, input) {
     if (preset.errors.length > 0 || callChain.errors.length > 0)
         throw new FileNativePlayPresetError("structured_editor_yaml_invalid", "Structured editing can be applied only to parseable preset/call-chain YAML");
     preset.set("name", input.name);
+    if (input.authorPrompts !== undefined)
+        preset.set("authorPrompts", parseOrderedAuthorPrompts(input.authorPrompts));
+    if (input.playPrompts !== undefined) {
+        preset.set("format", "narraeon.play-preset/v2");
+        preset.set("playPrompts", parseOrderedPlayPrompts(input.playPrompts));
+    }
     preset.set("callChain", input.callChainPath);
     if (input.settingImprovementPrompt === undefined)
         preset.delete("settingImprovement");
@@ -621,6 +747,10 @@ export function applyPlayPresetStructuredEditor(files, input) {
         role,
         markdown: path,
     })));
+    if (input.followupItems !== undefined) {
+        callChain.set("format", "narraeon.play-call-chain/v2");
+        callChain.set("followupItems", parseFollowupItems(input.followupItems, input.followups));
+    }
     callChain.set("followups", input.followups.map((followup) => ({
         id: followup.id,
         displayName: followup.displayName,
@@ -705,7 +835,16 @@ export function parsePlayPresetStructuredEditor(value) {
             value.playerViewPanels.some((panel) => !isRecord(panel))))
         throw new FileNativePlayPresetError("structured_editor_invalid", "Structured play playerViewPanels must be an array of maps");
     return {
+        ...(value.followupItems === undefined
+            ? {}
+            : { followupItems: parseFollowupItems(value.followupItems, followups) }),
         name: value.name,
+        ...(value.authorPrompts === undefined
+            ? {}
+            : { authorPrompts: parseOrderedAuthorPrompts(value.authorPrompts) }),
+        ...(value.playPrompts === undefined
+            ? {}
+            : { playPrompts: parseOrderedPlayPrompts(value.playPrompts) }),
         callChainPath: value.callChainPath,
         ...(settingImprovementPrompt === undefined
             ? {}
@@ -732,6 +871,8 @@ export function parsePlayPresetFiles(files, limits = {}) {
             "name",
             "callChain",
             "settingImprovement",
+            "playPrompts",
+            "authorPrompts",
             "mounts",
             "playerViewPanels",
             "extensions",
@@ -739,15 +880,20 @@ export function parsePlayPresetFiles(files, limits = {}) {
         const callChainPath = stringValue(preset.callChain);
         if (callChainPath !== "call-chain.yaml")
             invalid("call_chain_path_invalid", "Entry callChain must be call-chain.yaml", "preset.yaml");
-        if (preset.format !== "narraeon.play-preset/v1")
+        if (preset.format !== "narraeon.play-preset/v1" &&
+            preset.format !== "narraeon.play-preset/v2")
             invalid("preset_format_invalid", "preset.yaml format must be narraeon.play-preset/v1", "preset.yaml");
+        if (preset.format === "narraeon.play-preset/v1" &&
+            (preset.playPrompts !== undefined || preset.authorPrompts !== undefined))
+            invalid("preset_format_invalid", "Ordered prompts require v2", "preset.yaml");
         const name = stringValue(preset.name);
         if (!namePattern.test(name.trim()) || name.includes(String.fromCharCode(0)))
             invalid("invalid_name", "Play-preset name must contain 1 to 160 characters", "preset.yaml");
         const callChain = readYaml(files, callChainPath, "call-chain.yaml");
         assertNoEditableMechanics(callChain, callChainPath);
-        assertKnownKeys(callChain, ["format", "narrative", "followups"], callChainPath);
-        if (callChain.format !== "narraeon.play-call-chain/v1")
+        assertKnownKeys(callChain, ["format", "narrative", "followups", "followupItems"], callChainPath);
+        if (callChain.format !== "narraeon.play-call-chain/v1" &&
+            callChain.format !== "narraeon.play-call-chain/v2")
             invalid("call_chain_format_invalid", "call-chain.yaml format must be narraeon.play-call-chain/v1", callChainPath);
         // The host preset already carries the general narrative criteria, so a
         // preset that adds nothing of its own is legitimate.
@@ -756,6 +902,12 @@ export function parsePlayPresetFiles(files, limits = {}) {
             ? undefined
             : parsePromptBlocks([preset.settingImprovement], files, "preset.yaml#settingImprovement")[0];
         const followups = parseFollowups(callChain.followups, files);
+        if (callChain.format === "narraeon.play-call-chain/v1" &&
+            callChain.followupItems !== undefined)
+            invalid("followups_invalid", "Ordered followups require call-chain v2", callChainPath);
+        const followupItems = callChain.format === "narraeon.play-call-chain/v2"
+            ? parseFollowupItems(callChain.followupItems, followups)
+            : undefined;
         const mounts = parseMounts(preset.mounts);
         const playerViewPanels = parsePlayerViewPanels(preset.playerViewPanels, files);
         validatePanelChannels(followups, playerViewPanels);
@@ -764,7 +916,14 @@ export function parsePlayPresetFiles(files, limits = {}) {
         return {
             kind: "valid",
             definition: {
-                format: "narraeon.play-preset/v1",
+                ...(followupItems === undefined ? {} : { followupItems }),
+                format: preset.format,
+                ...(preset.format === "narraeon.play-preset/v2"
+                    ? { playPrompts: parseOrderedPlayPrompts(preset.playPrompts) }
+                    : {}),
+                ...(preset.authorPrompts === undefined
+                    ? {}
+                    : { authorPrompts: parseOrderedAuthorPrompts(preset.authorPrompts) }),
                 name: name.trim(),
                 callChainPath,
                 ...(settingImprovementPrompt === undefined
@@ -814,10 +973,10 @@ function parsePromptBlocks(value, files, location, allowEmpty = false) {
     });
 }
 /**
- * Follow-ups have no ordering contract. The parser needs only each request's
+ * User definitions retain their resources independently of order and enablement. The parser needs each request's
  * identity, its single author prompt, and the artifacts it may emit.
  */
-function parseFollowups(value, files) {
+export function parseFollowups(value, files) {
     if (value === undefined || value === null)
         return [];
     if (!Array.isArray(value))
@@ -855,7 +1014,7 @@ function parseFollowups(value, files) {
         invalid("duplicate_followup_id", "Follow-up request id is duplicated", "call-chain.yaml");
     // One channel has one projection meaning. Two followups writing the same
     // channel with different strategies would make the visible set depend on
-    // dispatch order, which followups deliberately do not have.
+    // dispatch order; ordering must not create a data dependency.
     const strategies = new Map();
     for (const { artifacts } of followups)
         for (const { channel, strategy } of artifacts) {
@@ -903,7 +1062,19 @@ function parseArtifacts(value, files, location) {
             "required",
             "maxEmits",
             "payloadContract",
+            "displayName",
+            "purpose",
         ], artifactLocation);
+        for (const [field, limit] of [
+            ["displayName", 160],
+            ["purpose", 16000],
+        ]) {
+            if (raw[field] !== undefined &&
+                (typeof raw[field] !== "string" ||
+                    raw[field].length > limit ||
+                    raw[field].includes("\0")))
+                invalid("artifact_metadata_invalid", `${field} must be text of at most ${limit} characters`, artifactLocation);
+        }
         const name = stringValue(raw.name).trim();
         if (!/^[a-z][a-z0-9._/-]{1,127}$/u.test(name))
             invalid("artifact_output_name_invalid", "An artifact must declare a stable lowercase output name", artifactLocation);
@@ -914,7 +1085,8 @@ function parseArtifacts(value, files, location) {
         if (!/^[a-z][a-z0-9._/-]{1,127}$/u.test(channel))
             invalid("channel_invalid", "Artifact channel must be a stable lowercase address", artifactLocation);
         const strategy = raw.strategy;
-        if (!["append", "replace", "upsert", "transient", "hidden"].includes(String(strategy)))
+        if (typeof strategy !== "string" ||
+            !["append", "replace", "upsert", "transient", "hidden"].includes(String(strategy)))
             invalid("channel_strategy_invalid", "Artifact channel policy is invalid", artifactLocation);
         const contentType = raw.contentType ?? "text/plain";
         if (typeof contentType !== "string" ||
@@ -984,6 +1156,10 @@ function parseArtifacts(value, files, location) {
             invalid("artifact_payload_contract_type_invalid", "A structured payload contract can be used only with an application/json artifact", artifactLocation);
         return {
             name,
+            ...(raw.displayName === undefined
+                ? {}
+                : { displayName: raw.displayName }),
+            ...(raw.purpose === undefined ? {} : { purpose: raw.purpose }),
             channel,
             strategy: strategy,
             ...(key === undefined ? {} : { key }),
@@ -1012,6 +1188,19 @@ function parseArtifactPayloadContract(value, location, state = { nodes: 0 }, dep
         invalid("artifact_payload_contract_too_complex", "payloadContract contains more than 512 nodes", location);
     if (!isRecord(value))
         invalid("artifact_payload_contract_invalid", "payloadContract must be a map", location);
+    assertKnownKeys(value, [
+        "type",
+        "properties",
+        "required",
+        "additionalProperties",
+        "items",
+        "minItems",
+        "maxItems",
+        "minLength",
+        "maxLength",
+        "uniqueBy",
+        "maxBytes",
+    ], location);
     const type = value.type;
     if (type !== "object" &&
         type !== "array" &&
@@ -1387,83 +1576,14 @@ function validatePresetReferences(preset, files) {
     return paths;
 }
 export function parsePlayPresetRegexAsset(source, path = "regex/inline.yaml") {
-    const document = parseDocument(source, {
-        schema: "core",
-        uniqueKeys: true,
-        strict: true,
-    });
-    if (document.errors.length > 0 || document.warnings.length > 0)
-        invalid("regex_asset_invalid", `Regex-resource YAML is invalid: ${path}`, path);
-    const value = document.toJS({ maxAliasCount: 0 });
-    const rules = Array.isArray(value)
-        ? value
-        : isRecord(value) && Array.isArray(value.rules)
-            ? value.rules
-            : null;
-    if (rules === null || rules.length > 256)
-        invalid("regex_rules_invalid", `A regex resource may contain at most 256 rules: ${path}`, path);
-    const orders = new Set();
-    const parsed = rules.map((raw, index) => {
-        const location = `${path}#rules[${index}]`;
-        if (!isRecord(raw))
-            invalid("regex_rule_invalid", "A regex rule must be a map", location);
-        assertKnownKeys(raw, [
-            "order",
-            "scope",
-            "pattern",
-            "flags",
-            "replace",
-            "maxMatches",
-            "errorPolicy",
-        ], location);
-        const order = raw.order;
-        if (!Number.isSafeInteger(order) || order < 0)
-            invalid("regex_order_invalid", "A regex rule must declare a non-negative integer order", location);
-        if (orders.has(order))
-            invalid("regex_order_duplicate", "Regex rule order cannot be duplicated", location);
-        orders.add(order);
-        const scope = raw.scope;
-        if (scope !== "raw_text" &&
-            scope !== "markdown_html" &&
-            scope !== "structured_payload")
-            invalid("regex_scope_invalid", "A regex rule must declare raw_text, markdown_html, or structured_payload scope", location);
-        const pattern = raw.pattern;
-        if (typeof pattern !== "string" ||
-            pattern.length === 0 ||
-            pattern.length > 4_096)
-            invalid("regex_pattern_invalid", "Regex pattern must be a bounded non-empty string", location);
-        const flags = raw.flags === undefined ? "" : raw.flags;
-        if (typeof flags !== "string" || flags.length > 16)
-            invalid("regex_flags_invalid", "Regex flags are invalid", location);
-        try {
-            new RegExp(pattern, flags);
-        }
-        catch {
-            invalid("regex_pattern_invalid", "Regex pattern could not be compiled", location);
-        }
-        if (typeof raw.replace !== "string")
-            invalid("regex_replace_invalid", "Regex replace must be text", location);
-        const maxMatches = raw.maxMatches ?? 1;
-        if (!Number.isSafeInteger(maxMatches) ||
-            maxMatches < 1 ||
-            maxMatches > 1_024)
-            invalid("regex_limit_invalid", "Regex replacement count must be a bounded positive integer", location);
-        const errorPolicy = raw.errorPolicy;
-        if (errorPolicy !== "fallback" &&
-            errorPolicy !== "skip" &&
-            errorPolicy !== "fail")
-            invalid("regex_error_policy_invalid", "A regex rule must declare fallback, skip, or fail errorPolicy", location);
-        return {
-            order: order,
-            scope,
-            pattern,
-            flags,
-            replace: raw.replace,
-            maxMatches: maxMatches,
-            errorPolicy,
-        };
-    });
-    return parsed.sort((left, right) => left.order - right.order);
+    try {
+        return parseDisplayRegex(source, path);
+    }
+    catch (error) {
+        if (error instanceof DisplayRegexError)
+            throw new FileNativePlayPresetError(error.code, error.message);
+        throw error;
+    }
 }
 function validateRegexAsset(source, path) {
     parsePlayPresetRegexAsset(source, path);
@@ -1562,11 +1682,6 @@ function readYaml(files, path, location) {
     const source = files[path];
     if (source === undefined || source.trim() === "")
         invalid("required_file_missing", `Play-preset file does not exist: ${path}`, location);
-    if (/(^|\s)[&*!][^\s,\]}]+/mu.test(source) ||
-        /^\s*<<\s*:/mu.test(source) ||
-        /^---\s*$/mu.test(source) ||
-        /^\.\.\.\s*$/mu.test(source))
-        invalid("unsafe_yaml", `Play-preset YAML uses syntax forbidden by the restricted codec: ${path}`, location);
     const document = parseDocument(source, {
         schema: "core",
         uniqueKeys: true,
@@ -1574,6 +1689,16 @@ function readYaml(files, path, location) {
     });
     if (document.errors.length > 0 || document.warnings.length > 0)
         invalid("unsafe_yaml", `Play-preset YAML is invalid: ${path}`, location);
+    visit(document, {
+        Node(_, node) {
+            if (isAlias(node) || ("anchor" in node && node.anchor) || node.tag)
+                invalid("unsafe_yaml", `Play-preset YAML uses forbidden anchors, aliases or tags: ${path}`, location);
+        },
+        Pair(_, pair) {
+            if (String(pair.key) === "<<")
+                invalid("unsafe_yaml", `Play-preset YAML uses forbidden merge keys: ${path}`, location);
+        },
+    });
     const value = document.toJS({ maxAliasCount: 0 });
     if (!isRecord(value))
         invalid("yaml_shape_invalid", `Top-level play-preset YAML must be a map: ${path}`, location);
@@ -1719,129 +1844,6 @@ function stringValue(value) {
 function cloneFiles(files) {
     return Object.fromEntries(Object.entries(files).map(([path, contents]) => [path, contents]));
 }
-export function validatePlayPresetArtifactPayload(contract, value) {
-    if (contract === undefined)
-        return { ok: true };
-    if (!isJsonValueValue(value))
-        return {
-            ok: false,
-            message: "JSON artifact payload must be a valid JSON value",
-        };
-    return validatePayloadNode(contract, value, "$", 0);
-}
-function validatePayloadNode(contract, value, path, depth) {
-    if (depth > 32)
-        return { ok: false, message: `${path} payload nesting exceeds 32 levels` };
-    const actual = value === null ? "null" : Array.isArray(value) ? "array" : typeof value;
-    const typeMatches = contract.type === actual ||
-        (contract.type === "number" && actual === "number") ||
-        (contract.type === "integer" &&
-            actual === "number" &&
-            Number.isInteger(value));
-    if (!typeMatches)
-        return {
-            ok: false,
-            message: `${path} payload type must be ${contract.type}; received ${actual}`,
-        };
-    if (contract.maxBytes !== undefined) {
-        const encoded = JSON.stringify(value);
-        if (encoded === undefined ||
-            Buffer.byteLength(encoded, "utf8") > contract.maxBytes)
-            return {
-                ok: false,
-                message: `${path} payload exceeds its declared ${contract.maxBytes}-byte limit`,
-            };
-    }
-    if (contract.type === "string") {
-        const text = value;
-        if (contract.minLength !== undefined &&
-            [...text].length < contract.minLength)
-            return {
-                ok: false,
-                message: `${path} text length is less than ${contract.minLength}`,
-            };
-        if (contract.maxLength !== undefined &&
-            [...text].length > contract.maxLength)
-            return {
-                ok: false,
-                message: `${path} text length exceeds ${contract.maxLength}`,
-            };
-    }
-    if (contract.type === "array") {
-        const entries = value;
-        if (contract.minItems !== undefined && entries.length < contract.minItems)
-            return {
-                ok: false,
-                message: `${path} has fewer than ${contract.minItems} items`,
-            };
-        if (contract.maxItems !== undefined && entries.length > contract.maxItems)
-            return {
-                ok: false,
-                message: `${path} has more than ${contract.maxItems} items`,
-            };
-        const seen = new Set();
-        for (const [index, entry] of entries.entries()) {
-            if (contract.items !== undefined) {
-                const result = validatePayloadNode(contract.items, entry, `${path}[${index}]`, depth + 1);
-                if (!result.ok)
-                    return result;
-            }
-            if (contract.uniqueBy !== undefined && isRecordValue(entry)) {
-                const unique = entry[contract.uniqueBy];
-                if (typeof unique !== "string" &&
-                    typeof unique !== "number" &&
-                    typeof unique !== "boolean")
-                    return {
-                        ok: false,
-                        message: `${path}[${index}].${contract.uniqueBy} must be a uniquely comparable scalar`,
-                    };
-                const key = JSON.stringify(unique);
-                if (seen.has(key))
-                    return {
-                        ok: false,
-                        message: `${path} ${contract.uniqueBy} values cannot be duplicated`,
-                    };
-                seen.add(key);
-            }
-        }
-    }
-    if (contract.type === "object") {
-        const object = value;
-        const properties = contract.properties ?? {};
-        for (const required of contract.required ?? [])
-            if (!(required in object))
-                return { ok: false, message: `${path}.${required} is required` };
-        if (contract.additionalProperties === false)
-            for (const key of Object.keys(object))
-                if (!(key in properties))
-                    return {
-                        ok: false,
-                        message: `${path}.${key} is not a declared field`,
-                    };
-        for (const [key, child] of Object.entries(properties)) {
-            if (!(key in object))
-                continue;
-            const result = validatePayloadNode(child, object[key], `${path}.${key}`, depth + 1);
-            if (!result.ok)
-                return result;
-        }
-    }
-    return { ok: true };
-}
-function isJsonValueValue(value) {
-    if (value === null || typeof value === "string" || typeof value === "boolean")
-        return true;
-    if (typeof value === "number")
-        return Number.isFinite(value);
-    if (Array.isArray(value))
-        return value.every(isJsonValueValue);
-    if (!isRecordValue(value))
-        return false;
-    return Object.values(value).every(isJsonValueValue);
-}
-function isRecordValue(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
 function invalid(code, message, location) {
     void location;
     throw new FileNativePlayPresetError(code, message);
@@ -1854,3 +1856,19 @@ function hasExactKeys(value, required, optional = []) {
     return (required.every((key) => Object.hasOwn(value, key)) &&
         Object.keys(value).every((key) => allowed.has(key)));
 }
+export function parseOrderedAuthorPrompts(value) {
+    return parseOrderedPlayPrompts(value, builtinAuthorPrompts("en"), false);
+}
+export function legacyAuthorPrompts(definition) {
+    const entries = defaultOrderedAuthorPrompts();
+    const path = definition.settingImprovementPrompt?.path;
+    if (path !== undefined)
+        entries[1] = {
+            id: "legacy-author",
+            kind: "user",
+            name: "Authoring",
+            body: definition.files[path],
+            enabled: true,
+        };
+    return entries;
+}