@riemannre3/dsh-roleplay 0.1.3

package/lib/lifecycle.js

@@ -0,0 +1,93 @@
+/**
+ * Owns the reversible RolePlay runtime lifecycle behind one small interface.
+ * Persistent roleplay data is deliberately outside this module: disabling the
+ * runtime detaches behavior and UI without deleting cards or sessions.
+ */
+export class RolePlayLifecycle {
+    options;
+    runtimeDispose = null;
+    enabled = false;
+    phase = "disabled";
+    error = null;
+    queue = Promise.resolve();
+    disposed = false;
+    constructor(options) {
+        this.options = options;
+    }
+    async initialize() {
+        const enabled = await this.options.loadEnabled();
+        if (enabled)
+            await this.activate(false);
+    }
+    snapshot() {
+        return { enabled: this.enabled, phase: this.phase, error: this.error };
+    }
+    setEnabled(enabled) {
+        const operation = this.queue.then(async () => {
+            if (this.disposed)
+                throw new Error("RolePlay 生命周期已经释放");
+            if (enabled === this.enabled && this.phase !== "failed")
+                return;
+            if (enabled)
+                await this.activate(true);
+            else
+                await this.deactivate(true);
+        });
+        this.queue = operation.then(() => undefined, () => undefined);
+        return operation.then(() => this.snapshot());
+    }
+    async dispose() {
+        this.disposed = true;
+        await this.queue;
+        await this.deactivate(false);
+    }
+    async activate(persist) {
+        this.phase = "transitioning";
+        this.error = null;
+        let dispose = null;
+        try {
+            dispose = await this.options.startRuntime();
+            if (typeof dispose !== "function")
+                throw new Error("RolePlay 运行时没有返回卸载函数");
+            if (persist)
+                await this.options.saveEnabled(true);
+            this.runtimeDispose = dispose;
+            this.enabled = true;
+            this.phase = "active";
+        }
+        catch (error) {
+            if (dispose !== null)
+                await dispose();
+            this.enabled = false;
+            this.phase = "failed";
+            this.error = error instanceof Error ? error.message : String(error);
+            throw error;
+        }
+    }
+    async deactivate(persist) {
+        if (this.runtimeDispose === null) {
+            this.enabled = false;
+            this.phase = "disabled";
+            this.error = null;
+            if (persist)
+                await this.options.saveEnabled(false);
+            return;
+        }
+        this.phase = "transitioning";
+        this.error = null;
+        const dispose = this.runtimeDispose;
+        try {
+            await dispose();
+            this.runtimeDispose = null;
+            this.enabled = false;
+            if (persist)
+                await this.options.saveEnabled(false);
+            this.phase = "disabled";
+        }
+        catch (error) {
+            this.phase = "failed";
+            this.error = error instanceof Error ? error.message : String(error);
+            throw error;
+        }
+    }
+}

package/lib/mvu-session-control.js

@@ -0,0 +1,70 @@
+import { applyVariableUpdate } from "./variable-runtime.js";
+export function supportsExtraModelParsing(updateFormats) {
+    return updateFormats.some((format) => typeof format === "string" && format.trim().length > 0);
+}
+function record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
+}
+function shortText(value, fallback) {
+    return typeof value === "string" && value.trim().length > 0 && value.trim().length <= 200 ? value.trim() : fallback;
+}
+export function defaultMvuSessionSettings(defaults) {
+    return {
+        updateMethod: defaults.supportsExtraModel ? "额外模型解析" : "随 AI 输出",
+        automaticRequest: true,
+        extraModel: {
+            source: "与插头相同",
+            provider: defaults.provider,
+            model: defaults.model,
+            maxTokens: 4096,
+        },
+    };
+}
+export function normalizeMvuSessionSettings(value, defaults) {
+    const base = defaultMvuSessionSettings(defaults);
+    const input = record(value);
+    const extra = record(input.extraModel);
+    const updateMethod = input.updateMethod === "随 AI 输出" || input.updateMethod === "额外模型解析"
+        ? input.updateMethod
+        : base.updateMethod;
+    if (updateMethod === "额外模型解析" && !defaults.supportsExtraModel) {
+        throw new Error("当前角色卡未声明可执行的额外模型解析条目");
+    }
+    const source = extra.source === "自定义" ? "自定义" : "与插头相同";
+    const maxTokens = typeof extra.maxTokens === "number" && Number.isInteger(extra.maxTokens) && extra.maxTokens >= 256 && extra.maxTokens <= 32_768
+        ? extra.maxTokens
+        : base.extraModel.maxTokens;
+    return {
+        updateMethod,
+        automaticRequest: typeof input.automaticRequest === "boolean" ? input.automaticRequest : base.automaticRequest,
+        extraModel: {
+            source,
+            provider: shortText(extra.provider, base.extraModel.provider),
+            model: shortText(extra.model, base.extraModel.model),
+            maxTokens,
+        },
+    };
+}
+export function resolveMvuExtraModel(settings, current) {
+    return settings.extraModel.source === "自定义"
+        ? { provider: settings.extraModel.provider, model: settings.extraModel.model, maxTokens: settings.extraModel.maxTokens }
+        : { provider: current.provider, model: current.model, maxTokens: settings.extraModel.maxTokens };
+}
+export function replayMvuReplies(initialState, replies) {
+    let state = structuredClone(initialState);
+    const events = [];
+    let committedReplies = 0;
+    let failedReplies = 0;
+    replies.forEach((reply, replayIndex) => {
+        const result = applyVariableUpdate(state, reply);
+        events.push(...result.events.map((event) => ({ ...event, replayIndex })));
+        if (result.status === "committed") {
+            state = result.state;
+            committedReplies += 1;
+        }
+        else if (result.status === "failed") {
+            failedReplies += 1;
+        }
+    });
+    return { state, events, committedReplies, failedReplies };
+}

package/lib/persona-runtime.js

@@ -0,0 +1,60 @@
+export const PERSONA_AVATARS = ["default", "traveler", "northern-ranger", "jianghu-wanderer"];
+export function personaBindingKey(scope, targetId = "") {
+    if (scope === "global")
+        return "global:default";
+    const normalizedTarget = targetId.trim();
+    if (normalizedTarget.length === 0)
+        throw new Error(scope === "card" ? "卡片 Persona 绑定缺少 revision" : "Session Persona 绑定缺少 Session ID");
+    return `${scope}:${normalizedTarget}`;
+}
+export function normalizePersonaAvatar(value, fallback = "default") {
+    return typeof value === "string" && PERSONA_AVATARS.includes(value) ? value : fallback;
+}
+export function validatePersonaDraft(input, fallbackAvatar = "default") {
+    const displayName = typeof input.displayName === "string" ? input.displayName.trim() : "";
+    const content = typeof input.content === "string" ? input.content.trim() : "";
+    if (displayName.length === 0)
+        throw new Error("Persona 名称不能为空");
+    if (displayName.length > 64)
+        throw new Error("Persona 名称不能超过 64 个字符");
+    if (content.length > 12_000)
+        throw new Error("Persona 描述不能超过 12000 个字符");
+    return { displayName, content, avatar: normalizePersonaAvatar(input.avatar, fallbackAvatar) };
+}
+export function personaBindingKeysToClearForSelection(scope, context) {
+    if (scope === "session")
+        return [];
+    const keys = [];
+    if ((context.sessionId ?? "").length > 0)
+        keys.push(personaBindingKey("session", context.sessionId));
+    if (scope === "global" && (context.revisionId ?? "").length > 0)
+        keys.push(personaBindingKey("card", context.revisionId));
+    return keys;
+}
+export function resolvePersona(personas, bindings, context) {
+    const keys = [
+        context.sessionId === undefined || context.sessionId.length === 0 ? null : personaBindingKey("session", context.sessionId),
+        context.revisionId === undefined || context.revisionId.length === 0 ? null : personaBindingKey("card", context.revisionId),
+        personaBindingKey("global"),
+    ];
+    for (const key of keys) {
+        if (key === null)
+            continue;
+        const binding = bindings.get(key);
+        if (binding === undefined)
+            continue;
+        const persona = personas.get(binding.personaId);
+        if (persona !== undefined)
+            return { persona, binding };
+    }
+    return null;
+}
+export function renderPersonaPrompt(displayName, content) {
+    const name = displayName.trim();
+    const detail = content.trim();
+    const lines = name.length === 0 ? [] : [`玩家在当前故事中的名字是 ${name}。`];
+    if (detail.length > 0) {
+        lines.push("玩家主动启用了以下兼容人设。若酒馆卡已经明确规定玩家身份，以卡片设定为准，不要用人设覆盖卡内约束：", detail);
+    }
+    return lines.join("\n\n");
+}

package/lib/preset-runtime.js

@@ -0,0 +1,222 @@
+const MARKER_BY_IDENTIFIER = Object.freeze({
+    main: "main-prompt",
+    worldInfoBefore: "world-info-before",
+    personaDescription: "persona-description",
+    charDescription: "character-description",
+    charPersonality: "character-personality",
+    scenario: "scenario",
+    worldInfoAfter: "world-info-after",
+    dialogueExamples: "example-messages",
+    authorsNote: "authors-note",
+    chatHistory: "chat-history",
+    jailbreak: "post-history-instructions",
+});
+const IDENTIFIER_BY_MARKER = new Map(Object.entries(MARKER_BY_IDENTIFIER).map(([identifier, marker]) => [marker, identifier]));
+const VALID_MARKERS = new Set(Object.values(MARKER_BY_IDENTIFIER));
+const PINNED_PROMPTS = Object.freeze([
+    { identifier: "main", name: "Main Prompt", role: "system", content: "Write {{char}}'s next reply in a fictional chat between {{char}} and {{user}}.", marker: "main-prompt", systemPrompt: true, injectionPosition: "relative", injectionDepth: 4, injectionOrder: 100 },
+    { identifier: "worldInfoBefore", name: "World Info (before)", role: "system", content: "", marker: "world-info-before", systemPrompt: true, injectionPosition: "relative", injectionDepth: 4, injectionOrder: 100 },
+    { identifier: "personaDescription", name: "Persona Description", role: "system", content: "", marker: "persona-description", systemPrompt: true, injectionPosition: "relative", injectionDepth: 4, injectionOrder: 100 },
+    { identifier: "charDescription", name: "Char Description", role: "system", content: "", marker: "character-description", systemPrompt: true, injectionPosition: "relative", injectionDepth: 4, injectionOrder: 100 },
+    { identifier: "charPersonality", name: "Char Personality", role: "system", content: "", marker: "character-personality", systemPrompt: true, injectionPosition: "relative", injectionDepth: 4, injectionOrder: 100 },
+    { identifier: "scenario", name: "Scenario", role: "system", content: "", marker: "scenario", systemPrompt: true, injectionPosition: "relative", injectionDepth: 4, injectionOrder: 100 },
+    { identifier: "enhanceDefinitions", name: "Enhance Definitions", role: "system", content: "If you have more knowledge of {{char}}, add to the character's lore and personality to enhance them but keep the Character Sheet's definitions absolute.", systemPrompt: true, injectionPosition: "relative", injectionDepth: 4, injectionOrder: 100 },
+    { identifier: "nsfw", name: "Auxiliary Prompt", role: "system", content: "", systemPrompt: true, injectionPosition: "relative", injectionDepth: 4, injectionOrder: 100 },
+    { identifier: "worldInfoAfter", name: "World Info (after)", role: "system", content: "", marker: "world-info-after", systemPrompt: true, injectionPosition: "relative", injectionDepth: 4, injectionOrder: 100 },
+    { identifier: "dialogueExamples", name: "Chat Examples", role: "system", content: "", marker: "example-messages", systemPrompt: true, injectionPosition: "relative", injectionDepth: 4, injectionOrder: 100 },
+    { identifier: "chatHistory", name: "Chat History", role: "system", content: "", marker: "chat-history", systemPrompt: true, injectionPosition: "relative", injectionDepth: 4, injectionOrder: 100 },
+    { identifier: "jailbreak", name: "Post-History Instructions", role: "system", content: "", marker: "post-history-instructions", systemPrompt: true, injectionPosition: "relative", injectionDepth: 4, injectionOrder: 100 },
+]);
+const DEFAULT_ORDER = Object.freeze([
+    { identifier: "main", enabled: true },
+    { identifier: "worldInfoBefore", enabled: true },
+    { identifier: "personaDescription", enabled: true },
+    { identifier: "charDescription", enabled: true },
+    { identifier: "charPersonality", enabled: true },
+    { identifier: "scenario", enabled: true },
+    { identifier: "enhanceDefinitions", enabled: false },
+    { identifier: "nsfw", enabled: true },
+    { identifier: "worldInfoAfter", enabled: true },
+    { identifier: "dialogueExamples", enabled: true },
+    { identifier: "chatHistory", enabled: true },
+    { identifier: "jailbreak", enabled: true },
+]);
+const TOP_LEVEL_KEYS = new Set([
+    "temperature", "frequency_penalty", "presence_penalty", "top_p", "openai_max_context", "openai_max_tokens",
+    "max_context_unlocked", "wi_format", "worldInfoFormat", "stream_openai", "prompts", "prompt_order", "promptOrder", "settings", "extra", "name", "id", "source", "revision", "createdAt", "updatedAt",
+]);
+const PROMPT_KEYS = new Set(["identifier", "name", "role", "content", "marker", "system_prompt", "systemPrompt", "injection_position", "injectionPosition", "injection_depth", "injectionDepth", "injection_order", "injectionOrder", "position", "extra"]);
+function record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
+}
+function finite(value, fallback) {
+    const candidate = typeof value === "number" ? value : Number(value);
+    return Number.isFinite(candidate) ? candidate : fallback;
+}
+function integer(value, fallback, minimum, maximum = Number.MAX_SAFE_INTEGER) {
+    return Math.min(maximum, Math.max(minimum, Math.round(finite(value, fallback))));
+}
+function optionalInteger(value, minimum, maximum = Number.MAX_SAFE_INTEGER) {
+    if (value === undefined || value === null || value === "")
+        return null;
+    const candidate = typeof value === "number" ? value : Number(value);
+    return Number.isFinite(candidate) ? Math.min(maximum, Math.max(minimum, Math.round(candidate))) : null;
+}
+function role(value) {
+    return value === "user" ? "user" : value === "assistant" || value === "model" ? "assistant" : "system";
+}
+function extraFields(value, known) {
+    return Object.fromEntries(Object.entries(value).filter(([key]) => !known.has(key)));
+}
+function promptFrom(value, fallback) {
+    const input = record(value);
+    const identifier = typeof input.identifier === "string" && input.identifier.trim().length > 0 ? input.identifier.trim() : fallback?.identifier;
+    if (identifier === undefined)
+        return;
+    const explicitMarker = typeof input.marker === "string" && VALID_MARKERS.has(input.marker)
+        ? input.marker
+        : input.marker === true ? MARKER_BY_IDENTIFIER[identifier] : undefined;
+    const marker = fallback?.marker ?? explicitMarker;
+    return {
+        identifier,
+        name: typeof input.name === "string" && input.name.trim().length > 0 ? input.name.trim() : fallback?.name ?? identifier,
+        role: role(input.role ?? fallback?.role),
+        content: typeof input.content === "string" ? input.content : fallback?.content ?? "",
+        ...(marker === undefined ? {} : { marker }),
+        systemPrompt: typeof input.system_prompt === "boolean" ? input.system_prompt : typeof input.systemPrompt === "boolean" ? input.systemPrompt : fallback?.systemPrompt ?? false,
+        injectionPosition: input.injection_position === 1 || input.injectionPosition === "in-chat" || input.position === "in_chat" || input.position === "in-chat" ? "in-chat" : fallback?.injectionPosition ?? "relative",
+        injectionDepth: integer(input.injection_depth ?? input.injectionDepth, fallback?.injectionDepth ?? 4, 0, 10_000),
+        injectionOrder: integer(input.injection_order ?? input.injectionOrder, fallback?.injectionOrder ?? 100, -1_000_000, 1_000_000),
+        extra: { ...extraFields(input, PROMPT_KEYS), ...record(input.extra) },
+    };
+}
+function normalizePromptLibrary(value) {
+    const candidates = Array.isArray(value) ? value : [];
+    const byId = new Map();
+    for (const candidate of candidates) {
+        const parsed = promptFrom(candidate);
+        if (parsed !== undefined && !byId.has(parsed.identifier))
+            byId.set(parsed.identifier, parsed);
+    }
+    for (const pinned of PINNED_PROMPTS) {
+        const existing = byId.get(pinned.identifier);
+        byId.set(pinned.identifier, existing === undefined ? { ...pinned, extra: {} } : { ...existing, marker: pinned.marker });
+    }
+    return [...byId.values()];
+}
+function normalizePromptOrder(value, prompts) {
+    const groups = Array.isArray(value) ? value.map(record) : [];
+    const personaGroup = groups.find((group) => Number(group.character_id) === 100001);
+    const selected = personaGroup ?? groups[0];
+    const rawOrder = Array.isArray(selected?.order) ? selected.order : Array.isArray(value) && value.every((item) => "identifier" in record(item)) ? value : [];
+    const promptIds = new Set(prompts.map((prompt) => prompt.identifier));
+    const seen = new Set();
+    const order = rawOrder.flatMap((item) => {
+        const candidate = record(item);
+        const identifier = typeof candidate.identifier === "string" ? candidate.identifier.trim() : "";
+        if (identifier.length === 0 || seen.has(identifier) || !promptIds.has(identifier))
+            return [];
+        seen.add(identifier);
+        return [{ identifier, enabled: candidate.enabled !== false }];
+    });
+    if (order.length === 0) {
+        for (const item of DEFAULT_ORDER) {
+            if (promptIds.has(item.identifier)) {
+                order.push({ ...item });
+                seen.add(item.identifier);
+            }
+        }
+    }
+    return order;
+}
+function iso(value, fallback) {
+    if (typeof value !== "string")
+        return fallback;
+    const milliseconds = Date.parse(value);
+    return Number.isFinite(milliseconds) ? new Date(milliseconds).toISOString() : fallback;
+}
+export function normalizeTavernPreset(value, options = {}) {
+    const input = record(value);
+    const now = options.now ?? new Date().toISOString();
+    const prompts = normalizePromptLibrary(input.prompts);
+    const name = options.name?.trim() || (typeof input.name === "string" ? input.name.trim() : "") || "Imported preset";
+    return {
+        id: options.id?.trim() || (typeof input.id === "string" ? input.id.trim() : "") || crypto.randomUUID(),
+        name,
+        source: options.source ?? (input.source === "builtin" || input.source === "created" || input.source === "imported" ? input.source : "imported"),
+        revision: integer(input.revision, 1, 1),
+        createdAt: iso(input.createdAt, now),
+        updatedAt: iso(input.updatedAt, now),
+        worldInfoFormat: typeof input.wi_format === "string" ? input.wi_format : typeof input.worldInfoFormat === "string" ? input.worldInfoFormat : "{0}",
+        settings: {
+            contextTokens: optionalInteger(input.openai_max_context ?? record(input.settings).contextTokens, 256),
+            maxReplyTokens: optionalInteger(input.openai_max_tokens ?? record(input.settings).maxReplyTokens, 1),
+            stream: typeof input.stream_openai === "boolean" ? input.stream_openai : typeof record(input.settings).stream === "boolean" ? record(input.settings).stream : true,
+            temperature: Math.min(5, Math.max(0, finite(input.temperature ?? record(input.settings).temperature, 1))),
+            topP: Math.min(1, Math.max(0, finite(input.top_p ?? record(input.settings).topP, 1))),
+            frequencyPenalty: Math.min(2, Math.max(-2, finite(input.frequency_penalty ?? record(input.settings).frequencyPenalty, 0))),
+            presencePenalty: Math.min(2, Math.max(-2, finite(input.presence_penalty ?? record(input.settings).presencePenalty, 0))),
+            maxContextUnlocked: input.max_context_unlocked === true || record(input.settings).maxContextUnlocked === true,
+        },
+        prompts,
+        promptOrder: normalizePromptOrder(input.prompt_order ?? input.promptOrder, prompts),
+        extra: { ...extraFields(input, TOP_LEVEL_KEYS), ...record(input.extra) },
+    };
+}
+export function createDefaultTavernPreset(now = "2026-08-26T00:00:00.000Z") {
+    return normalizeTavernPreset({
+        name: "DSH RolePlay Default",
+        temperature: 1,
+        frequency_penalty: 0,
+        presence_penalty: 0,
+        top_p: 1,
+        max_context_unlocked: false,
+        wi_format: "{0}",
+        stream_openai: true,
+        prompts: PINNED_PROMPTS.map((prompt) => ({
+            identifier: prompt.identifier,
+            name: prompt.name,
+            role: prompt.role,
+            content: prompt.content,
+            system_prompt: prompt.systemPrompt,
+            ...(prompt.marker === undefined ? {} : { marker: true }),
+        })),
+        prompt_order: [{ character_id: 100001, order: DEFAULT_ORDER }],
+        chat_completion_source: "openai",
+    }, { id: "dsh-roleplay-default-1", source: "builtin", now });
+}
+export const DEFAULT_TAVERN_PRESET = createDefaultTavernPreset();
+export function exportSillyTavernPreset(preset) {
+    return {
+        ...preset.extra,
+        chat_completion_source: typeof preset.extra.chat_completion_source === "string" ? preset.extra.chat_completion_source : "openai",
+        temperature: preset.settings.temperature,
+        frequency_penalty: preset.settings.frequencyPenalty,
+        presence_penalty: preset.settings.presencePenalty,
+        top_p: preset.settings.topP,
+        ...(preset.settings.contextTokens === null ? {} : { openai_max_context: preset.settings.contextTokens }),
+        ...(preset.settings.maxReplyTokens === null ? {} : { openai_max_tokens: preset.settings.maxReplyTokens }),
+        max_context_unlocked: preset.settings.maxContextUnlocked,
+        wi_format: preset.worldInfoFormat,
+        stream_openai: preset.settings.stream,
+        prompts: preset.prompts.map((prompt) => ({
+            ...prompt.extra,
+            identifier: prompt.identifier,
+            name: prompt.name,
+            role: prompt.role,
+            content: prompt.content,
+            system_prompt: prompt.systemPrompt,
+            ...(prompt.marker === undefined ? { marker: false } : { marker: true }),
+            injection_position: prompt.injectionPosition === "in-chat" ? 1 : 0,
+            injection_depth: prompt.injectionDepth,
+            injection_order: prompt.injectionOrder,
+        })),
+        prompt_order: [100000, 100001].map((character_id) => ({ character_id, order: preset.promptOrder.map((item) => ({ ...item })) })),
+    };
+}
+export function isPinnedPrompt(identifier) {
+    return MARKER_BY_IDENTIFIER[identifier] !== undefined || identifier === "enhanceDefinitions" || identifier === "nsfw";
+}
+export function promptIdentifierForMarker(marker) {
+    return IDENTIFIER_BY_MARKER.get(marker) ?? marker;
+}