narraeon 0.7.10 → 0.8.0

package/dist/node/shared/first-party-generic-panels.js

@@ -1,6 +1,4 @@
-import { defaultNarrationPromptForLocale } from "./default-play-prompts.js";
-import { defaultPresetHostFilesForLocale } from "./default-preset-host.js";
-import { defaultSettingImprovementPromptForLocale, defaultSettingImprovementPromptPath, } from "./default-setting-improvement-prompt.js";
+import { applicationPresetFilesForLocale } from "./application-preset-files.js";
 /**
  * Ordinary copyable examples for the generic artifact seam. Runtime does not
  * privilege these output names or channels; authors may replace every file.
@@ -9,11 +7,13 @@ export function firstPartyGenericPanelsPresetFilesForLocale(locale) {
     const displayName = locale === "zh-CN" ? "发布通用面板" : "Publish generic panels";
     const panelTitle = locale === "zh-CN" ? "通用 HTML 面板" : "Generic HTML panel";
     return {
-        "preset.yaml": `format: narraeon.play-preset/v1
+        ...applicationPresetFilesForLocale(locale),
+        "preset.yaml": `format: narraeon.play-preset/v3
 name: generic-panels-recommended
 callChain: call-chain.yaml
-settingImprovement:
-  markdown: prompts/setting-improvement.md
+playPrompts: {}
+authorPrompts: {}
+mergeConsecutiveMessages: false
 mounts:
   generic.markdown: story
   generic.html: sidebar
@@ -24,8 +24,7 @@ extensions:
   - assets/generic-html.css
 `,
         "call-chain.yaml": `format: narraeon.play-call-chain/v1
-narrative:
-  - markdown: prompts/narrate.md
+narrative: []
 followups:
   - id: publish_panels
     displayName: ${displayName}
@@ -66,9 +65,6 @@ followups:
         required: false
         maxEmits: 8
 `,
-        ...defaultPresetHostFilesForLocale(locale),
-        "prompts/narrate.md": defaultNarrationPromptForLocale(locale),
-        [defaultSettingImprovementPromptPath]: defaultSettingImprovementPromptForLocale(locale),
         "prompts/panels.md": locale === "zh-CN"
             ? `# 通用面板
 

package/dist/node/shared/first-party-player-view.js

@@ -1,6 +1,4 @@
-import { defaultNarrationPromptForLocale } from "./default-play-prompts.js";
-import { defaultPresetHostFilesForLocale } from "./default-preset-host.js";
-import { defaultSettingImprovementPromptForLocale, defaultSettingImprovementPromptPath, } from "./default-setting-improvement-prompt.js";
+import { applicationPresetFilesForLocale } from "./application-preset-files.js";
 /**
  * Ordinary, copyable player-view panel assets. Runtime understands only the
  * generic playerViewPanels contract; this is not a privileged status system.
@@ -12,11 +10,13 @@ export function firstPartyStatusPanelPresetFilesForLocale(locale) {
     const emptyPrefix = locale === "zh-CN" ? "暂无项目：" : "No items: ";
     const diagnosticsSuffix = locale === "zh-CN" ? " 项视图诊断" : " player-view diagnostics";
     return {
-        "preset.yaml": `format: narraeon.play-preset/v1
+        ...applicationPresetFilesForLocale(locale),
+        "preset.yaml": `format: narraeon.play-preset/v3
 name: status-panel-recommended
 callChain: call-chain.yaml
-settingImprovement:
-  markdown: prompts/setting-improvement.md
+playPrompts: {}
+authorPrompts: {}
+mergeConsecutiveMessages: false
 mounts: []
 playerViewPanels:
   - id: current_view
@@ -46,13 +46,9 @@ extensions:
   - assets/player-view-status.css
 `,
         "call-chain.yaml": `format: narraeon.play-call-chain/v1
-narrative:
-  - markdown: prompts/narrate.md
+narrative: []
 followups: []
 `,
-        ...defaultPresetHostFilesForLocale(locale),
-        "prompts/narrate.md": defaultNarrationPromptForLocale(locale),
-        [defaultSettingImprovementPromptPath]: defaultSettingImprovementPromptForLocale(locale),
         "renderers/player-view-status.html": `<!doctype html>
 <html><head><meta charset="utf-8"><title>${currentStatus}</title></head><body>
 <main id="player-view-panel-root" aria-label="${currentStatus}"></main>

package/dist/node/shared/ordered-author-prompts.js

@@ -1,5 +1,6 @@
 import { defaultSettingImprovementPromptForLocale, revisionSettingImprovementPromptForLocale, } from "./default-setting-improvement-prompt.js";
 import { tabletopAuthorBody } from "./tabletop-guidance.js";
+import { defaultEnabledBuiltin, } from "./ordered-play-prompts.js";
 /** Authoring uses the same permissions as play, with target-specific dynamic references. */
 export function builtinAuthorPrompts(locale, target = "setting") {
     const zh = locale === "zh-CN";
@@ -70,10 +71,11 @@ export function authoringMechanics(locale, target) {
     return `# ${zh ? "创作工具与结算" : "Authoring tools and settlement"}\n\n${common}\n\n${boundary}\n\n${views}`;
 }
 export function defaultOrderedAuthorPrompts() {
-    return builtinAuthorPrompts("en").map(({ id }) => ({
-        id,
+    const catalog = builtinAuthorPrompts("en");
+    return catalog.map((item) => ({
+        id: item.id,
         kind: "builtin",
-        builtin: id,
-        enabled: true,
+        builtin: item.id,
+        enabled: defaultEnabledBuiltin(item, catalog),
     }));
 }

package/dist/node/shared/ordered-play-prompts.js

@@ -102,7 +102,7 @@ export function builtinPlayPrompts(locale) {
 
 world_patch 的 YAML locator 可以包含 map key 和从零开始的数组下标；add 与 replace 是 upsert，无论目标是否存在都写入，下标达到或超过长度时追加；remove 删除一个精确位置，目标不存在时为无操作。每条 edit 独立结算：失败的 edit 被跳过，其余照常生效；回执列出失败项时，已生效的 edit 不要重发，只补发列出的 edit。未提供的元数据保持原值。world_retire 从目录注入中退役文档，文档仍可读取、引用和恢复。工具响应的成功状态变化与后续最终叙事分别提交，后续失败不回滚已提交变化。成功写入回执表示当前值已改变；以真实回执的结算状态为准，模型文字不能提交世界。
 
-包含工具调用的响应属于中间步，其中的文字尚未展示或提交为最终叙事。收到全部工具结果后，根据回执在最终正文中呈现本轮尚未展示的内容，并与已提交状态一致；没有工具调用的非空正文结束本次循环并由 Runtime 提交。world_checkpoint 登记历史重放边界并向玩家建议从此开始全新上下文；在随后非空且无工具调用的最终正文成功提交后生效，边界包含该正文；登记后仍可继续工具调用。登记不结束世界内事件，也不自动切换上下文，玩家自行选择。全新上下文补入边界后的已提交玩家原文与最终叙事，排除开场白、工具和推理。何时登记由检查点政策块规定。
+包含工具调用的响应属于中间步，其中的文字尚未展示或提交为最终叙事。收到全部工具结果后，根据回执在最终正文中呈现本轮尚未展示的内容，并与已提交状态一致；没有工具调用的非空正文结束本次循环并由 Runtime 提交。world_checkpoint 登记历史重放边界并向玩家建议从此开始全新上下文；在随后非空且无工具调用的最终正文成功提交后生效，边界包含该正文；登记后仍可继续工具调用。登记不结束世界内事件，也不自动切换上下文；界面预选下一次全新上下文，玩家可以取消预选。全新上下文完整补入边界后的已提交玩家原文与最终叙事，非空时替代 frame 的 recent；为空时沿用 frame 的 recent 声明，可以带入检查点所在正文。两种选择都排除开场白、工具和推理。何时登记由检查点政策块规定。
 
 ${historyUseGuidance(locale)}`
                 : `# Tools and response settlement
@@ -111,7 +111,7 @@ Use only attached tools. Directories use @dir-* handles from the preload or tool
 
 YAML world_patch locators accept map keys and zero-based array indexes; add and replace are upserts that write whether or not the target exists, and an index past the end appends; remove deletes one exact location and is a no-op when it is absent. Each edit settles on its own: a failed edit is skipped and the others still apply, so when a receipt lists failed edits, send again only those. Omitted metadata remains unchanged. world_retire removes a document from catalog injection while keeping it readable, referenceable and restorable. Successful tool-response state changes and later final narrative commit separately; later failure does not roll back committed changes. Successful write receipts change current values; the actual receipt determines settlement, not model prose.
 
-Responses containing tool calls are intermediate steps; their text has not yet been displayed or committed as final narrative. After all tool results, use the receipts to present this turn's still-unshown content in final prose consistent with committed state. A nonempty tool-free response ends this loop and Runtime commits it. world_checkpoint registers the history-replay boundary and suggests a fresh context from that point to the player; it takes effect after the subsequent nonempty tool-free final prose successfully commits, including that prose, and further tool calls may follow registration. Registration neither ends an in-world event nor switches context, which the player chooses. Fresh-context replay contains committed player originals and final narratives after the boundary, excluding the opening, tools and reasoning. The checkpoint policy block decides when to register.
+Responses containing tool calls are intermediate steps; their text has not yet been displayed or committed as final narrative. After all tool results, use the receipts to present this turn's still-unshown content in final prose consistent with committed state. A nonempty tool-free response ends this loop and Runtime commits it. world_checkpoint registers the history-replay boundary and suggests a fresh context from that point to the player; it takes effect after the subsequent nonempty tool-free final prose successfully commits, including that prose, and further tool calls may follow registration. Registration neither ends an in-world event nor switches context; the interface preselects a fresh context for the next send, and the player can cancel the preselection. A fresh context replays all committed player originals and final narratives after the boundary; nonempty replay replaces the frame's recent selection. When it is empty, the frame's recent declaration applies and may include the checkpoint narrative. Both selections exclude the opening, tools and reasoning. The checkpoint policy block decides when to register.
 
 ${historyUseGuidance(locale)}`,
         },
@@ -243,6 +243,8 @@ ${historyUseGuidance(locale)}`,
 }
 /** Ids of the builtins that ship enabled: each group's first member and every policy. */
 export function defaultEnabledBuiltin(item, catalog) {
+    if (item.defaultEnabled !== undefined)
+        return item.defaultEnabled;
     if (item.category === "style")
         return false;
     if (item.group === undefined)

package/dist/node/shared/prompt-arrangement.js

@@ -0,0 +1,205 @@
+import { defaultEnabledBuiltin, } from "./ordered-play-prompts.js";
+export const retiredBuiltinReplacements = {
+    "play.style": [{ builtin: "play.prose" }, { builtin: "play.scene" }],
+    "play.adjudication": [
+        { builtin: "play.agency-default" },
+        { builtin: "play.agency-strict", selected: false },
+        { builtin: "play.agency-open", selected: false },
+        { builtin: "play.facts" },
+        { builtin: "play.npc" },
+    ],
+    "play.narrative": [
+        { builtin: "play.stop-beat" },
+        { builtin: "play.stop-scene", selected: false },
+        { builtin: "play.ending" },
+        { builtin: "play.output" },
+    ],
+    "play.state": [
+        { builtin: "play.save-timing" },
+        { builtin: "play.ownership" },
+        { builtin: "play.situation" },
+        { builtin: "play.checkpoint-policy" },
+    ],
+};
+export function promptArrangementKey(entry) {
+    return entry.kind === "builtin"
+        ? `builtin:${entry.builtin}`
+        : `entry:${entry.id}`;
+}
+function reserveBuiltinPromptId(preferred, builtin, used) {
+    let id = preferred;
+    let suffix = 0;
+    while (used.has(id))
+        id = `builtin-${builtin}-${++suffix}`;
+    used.add(id);
+    return id;
+}
+/** Expand retired identities in place; an explicit successor always wins. */
+export function expandRetiredPrompts(entries) {
+    const explicit = new Set(entries.flatMap((e) => (e.kind === "builtin" ? [e.builtin] : [])));
+    const usedIds = new Set(entries
+        .filter((entry) => entry.kind !== "builtin" ||
+        !retiredBuiltinReplacements[entry.builtin])
+        .map((entry) => entry.id));
+    return entries.flatMap((entry) => {
+        if (entry.kind !== "builtin")
+            return [entry];
+        const replacements = retiredBuiltinReplacements[entry.builtin];
+        if (!replacements)
+            return [entry];
+        return replacements
+            .filter((r) => !explicit.has(r.builtin))
+            .map(({ builtin, selected }) => {
+            const id = reserveBuiltinPromptId(builtin, builtin, usedIds);
+            return {
+                ...entry,
+                id,
+                builtin,
+                enabled: selected === false ? false : entry.enabled,
+            };
+        });
+    });
+}
+/**
+ * Missing defaults follow the nearest preceding catalog neighbor, otherwise the
+ * nearest following neighbor. Existing entries never move relative to each other.
+ */
+export function resolvePromptArrangement(arrangement, catalog, worldRequired = true) {
+    const defaults = catalog.map((item) => ({
+        id: item.id,
+        kind: "builtin",
+        builtin: item.id,
+        enabled: defaultEnabledBuiltin(item, catalog),
+    }));
+    if (worldRequired)
+        defaults.push({ id: "world", kind: "world" });
+    const overrides = expandRetiredPrompts((arrangement.overrides ?? []).map((o) => ({
+        ...o,
+        id: o.id ?? o.builtin,
+        kind: "builtin",
+        enabled: o.enabled ??
+            (catalog.some((c) => c.id === o.builtin)
+                ? defaultEnabledBuiltin(catalog.find((c) => c.id === o.builtin), catalog)
+                : true),
+    })));
+    const values = defaults.map((entry) => {
+        if (entry.kind !== "builtin")
+            return entry;
+        const override = overrides.find((o) => o.kind === "builtin" && o.builtin === entry.builtin);
+        const item = catalog.find((c) => c.id === entry.builtin);
+        const selection = item.group === undefined ? undefined : arrangement.groups?.[item.group];
+        const selected = selection?.flatMap((id) => retiredBuiltinReplacements[id]
+            ?.filter((r) => r.selected !== false)
+            .map((r) => r.builtin) ?? [id]);
+        return {
+            ...entry,
+            ...override,
+            ...(selected === undefined
+                ? {}
+                : { enabled: selected.includes(item.id) }),
+        };
+    });
+    const custom = structuredClone(arrangement.entries ?? []);
+    const world = custom.find((e) => e.kind === "world");
+    if (world !== undefined)
+        values.splice(values.findIndex((e) => e.kind === "world"), 1, world);
+    values.push(...custom.filter((e) => e.kind !== "world"));
+    // A newly shipped identity must not collide with an existing user's identity.
+    const aliases = new Map((arrangement.overrides ?? []).flatMap((override) => override.id === undefined ||
+        !catalog.some((item) => item.id === override.builtin)
+        ? []
+        : [[override.builtin, override.id]]));
+    const usedIds = new Set([...custom.map((e) => e.id), ...aliases.values()]);
+    for (const entry of values) {
+        if (entry.kind !== "builtin")
+            continue;
+        entry.id =
+            aliases.get(entry.builtin) ??
+                reserveBuiltinPromptId(entry.id, entry.builtin, usedIds);
+    }
+    const byKey = new Map(values.map((e) => [promptArrangementKey(e), e]));
+    const explicitOrder = new Set(arrangement.order ?? []);
+    const order = (arrangement.order ?? []).flatMap((key) => {
+        const old = key.startsWith("builtin:")
+            ? retiredBuiltinReplacements[key.slice(8)]
+            : undefined;
+        return old
+            ? old
+                .filter((r) => !explicitOrder.has(`builtin:${r.builtin}`))
+                .map((r) => `builtin:${r.builtin}`)
+            : [key];
+    });
+    const result = [];
+    for (const key of order) {
+        const entry = byKey.get(key);
+        if (entry && !result.includes(entry))
+            result.push(entry);
+    }
+    const defaultKeys = defaults.map(promptArrangementKey);
+    for (const entry of values) {
+        if (result.includes(entry))
+            continue;
+        const position = defaultKeys.indexOf(promptArrangementKey(entry));
+        const previous = defaultKeys
+            .slice(0, position)
+            .reverse()
+            .map((key) => result.findIndex((e) => promptArrangementKey(e) === key))
+            .find((i) => i >= 0);
+        const following = defaultKeys
+            .slice(position + 1)
+            .map((key) => result.findIndex((e) => promptArrangementKey(e) === key))
+            .find((i) => i >= 0);
+        const at = position < 0
+            ? result.length
+            : previous !== undefined
+                ? previous + 1
+                : (following ?? result.length);
+        result.splice(at, 0, entry);
+    }
+    return result;
+}
+export function customizePromptArrangement(input, catalog, worldRequired = true) {
+    const entries = expandRetiredPrompts(input);
+    const arrangement = {};
+    const custom = entries.filter((e) => e.kind !== "builtin" &&
+        !(e.kind === "world" && e.id === "world" && e.messageRole === undefined));
+    if (custom.length)
+        arrangement.entries = structuredClone(custom);
+    const overrides = [];
+    for (const entry of entries) {
+        if (entry.kind !== "builtin")
+            continue;
+        const item = catalog.find((c) => c.id === entry.builtin);
+        if (!item)
+            throw new Error(`Unknown builtin: ${entry.builtin}`);
+        const override = {
+            builtin: entry.builtin,
+        };
+        if (entry.id !== entry.builtin)
+            override.id = entry.id;
+        if (item.group === undefined &&
+            (!entry.enabled || entry.enabled !== defaultEnabledBuiltin(item, catalog)))
+            override.enabled = entry.enabled;
+        if (entry.messageRole !== undefined)
+            override.messageRole = entry.messageRole;
+        if (entry.turnGuide !== undefined)
+            override.turnGuide = entry.turnGuide;
+        if (Object.keys(override).length > 1)
+            overrides.push(override);
+        if (item.group !== undefined) {
+            arrangement.groups ??= {};
+            arrangement.groups[item.group] ??= [];
+            if (entry.enabled)
+                arrangement.groups[item.group].push(item.id);
+        }
+    }
+    if (overrides.length)
+        arrangement.overrides = overrides;
+    const keys = entries.map(promptArrangementKey);
+    const effective = resolvePromptArrangement(arrangement, catalog, worldRequired);
+    const existing = new Set(keys);
+    if (JSON.stringify(keys) !==
+        JSON.stringify(effective.map(promptArrangementKey).filter((key) => existing.has(key))))
+        arrangement.order = keys;
+    return arrangement;
+}