@musnows/scriverse 0.8.7 → 0.9.0

package/dist/store.js

@@ -13,6 +13,7 @@ import { countWords, documentShortSearchTerms, escapeSqlLikePattern, id, json, n
 import { buildWritingCalendar, writingDateKey } from "./writing-progress-time.js";
 import { resolveMaxAgentToolCallLimit } from "./ai-tool-results.js";
 import { DEFAULT_AI_STREAM_IDLE_TIMEOUT_SECONDS, normalizeAiStreamIdleTimeoutSeconds } from "./ai-stream-timeout.js";
+import { normalizeRoleplayScenePin, roleplayUserTurnDisplayText, roleplayUserTurnTitleSource } from "./roleplay-turn.js";
 const WORK_LIST_BATCH_SIZE = 500;
 const ENTITY_LIST_BATCH_SIZE = 400;
 export const RECYCLE_BIN_RETENTION_DAYS = 30;
@@ -211,7 +212,7 @@ export const versionedEntityTypes = [
 export const AI_CONVERSATION_STREAM_REQUEST_LEASE_MS = 3 * 60_000;
 export const aiConversationTaskTypes = ["chat", "roleplay", "continue", "polish"];
 export function defaultAiConversationTitle(prompt) {
-    const normalized = prompt.replace(/\s+/gu, " ").trim();
+    const normalized = roleplayUserTurnTitleSource(prompt).replace(/\s+/gu, " ").trim();
     return Array.from(normalized).slice(0, 15).join("") || "新对话";
 }
 function isRecord(value) {
@@ -571,8 +572,16 @@ export class Store {
         const versionNo = latest ? numberValue(latest, "version_no") + 1 : 1;
         this.db.run(`INSERT INTO entity_versions (id, work_id, entity_type, entity_id, version_no, snapshot_json, source, source_ref, change_note, created_at, created_by_user_id)
        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, id("entityVersion"), type === "work" ? entityId : String(entity.workId), type, entityId, versionNo, snapshotJson, source, sourceRef, changeNote.trim(), timestamp ?? now(), currentRequestActor()?.userId ?? null);
+        if (type === "setting") {
+            this.recordSyncChange(String(entity.workId), "setting", entityId, source === "delete" ? "delete" : "upsert", versionNo, timestamp);
+        }
         return versionNo;
     }
+    recordSyncChange(workId, entityType, entityId, operation, versionNo, timestamp) {
+        this.db.run(`INSERT INTO sync_changes (
+         work_id, entity_type, entity_id, operation, version_no, changed_by_user_id, changed_at
+       ) VALUES (?, ?, ?, ?, ?, ?, ?)`, workId, entityType, entityId, operation, versionNo, currentRequestActor()?.userId ?? null, timestamp ?? now());
+    }
     backfillEntityVersionBaselines() {
         const entities = [
             ...this.db.all("SELECT id, updated_at FROM works").map((row) => ["work", requiredString(row, "id"), requiredString(row, "updated_at")]),
@@ -787,7 +796,7 @@ export class Store {
     }
     listWorks() {
         const actor = currentRequestActor();
-        if (!actor || (actor.role === "admin" && actor.authentication !== "api-key")) {
+        if (!actor) {
             return this.mapWorks(this.db.all("SELECT * FROM works WHERE COALESCE(is_internal, 0) = 0 AND deleted_at IS NULL ORDER BY updated_at DESC"));
         }
         return this.mapWorks(this.db.all(`SELECT DISTINCT work.* FROM works work LEFT JOIN work_memberships membership ON membership.work_id = work.id
@@ -798,7 +807,7 @@ export class Store {
     listWorksPage(pagination) {
         const actor = currentRequestActor();
         const page = paginationSql(pagination);
-        const rows = !actor || (actor.role === "admin" && actor.authentication !== "api-key")
+        const rows = !actor
             ? this.db.all(`SELECT * FROM works WHERE COALESCE(is_internal, 0) = 0 AND deleted_at IS NULL ORDER BY updated_at DESC${page.sql}`, ...page.params)
             : this.db.all(`SELECT DISTINCT work.* FROM works work LEFT JOIN work_memberships membership ON membership.work_id = work.id
          WHERE COALESCE(work.is_internal, 0) = 0 AND work.deleted_at IS NULL
@@ -814,7 +823,7 @@ export class Store {
     }
     listDeletedWorks() {
         const actor = currentRequestActor();
-        const actorRestricted = Boolean(actor && !(actor.role === "admin" && actor.authentication !== "api-key"));
+        const actorRestricted = Boolean(actor);
         const rows = this.db.all(`SELECT work.*,
         (SELECT COUNT(*) FROM volumes volume WHERE volume.work_id = work.id) AS volume_count,
         (SELECT COUNT(*) FROM chapters chapter WHERE chapter.work_id = work.id) AS chapter_count,
@@ -1107,6 +1116,18 @@ export class Store {
         });
         return this.getWork(workId);
     }
+    setWorkOfflineAccess(workId, enabled) {
+        this.db.transaction(() => {
+            const current = this.getWork(workId);
+            if (Boolean(current.offlineAccessEnabled) === enabled)
+                return;
+            const timestamp = now();
+            this.db.run("UPDATE works SET offline_access_enabled = ?, version_no = version_no + 1, updated_at = ? WHERE id = ?", enabled ? 1 : 0, timestamp, workId);
+            this.recordEntityVersion("work", workId, "manual", null, enabled ? "允许 Desktop 离线访问" : "禁止 Desktop 离线访问", timestamp);
+            this.audit(workId, enabled ? "work.offline-access.enabled" : "work.offline-access.disabled", "work", workId, { enabled });
+        });
+        return this.getWork(workId);
+    }
     deleteWork(workId, expectedVersionNo) {
         return this.db.transaction(() => {
             const current = this.getWork(workId);
@@ -1902,10 +1923,12 @@ export class Store {
         };
     }
     insertChapterVersionRow(input) {
+        const timestamp = input.timestamp ?? now();
         this.db.run(`INSERT INTO chapter_versions (
          id, work_id, chapter_id, version_no, title, content, volume_id, sort_order, chapter_type,
          source, source_ref, change_note, created_at, created_by_user_id
-       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, id("chapterVersion"), input.workId, input.chapterId, input.versionNo, input.title, input.content, input.volumeId, input.sortOrder, input.chapterType, input.source, input.sourceRef, input.changeNote.trim(), input.timestamp ?? now(), currentRequestActor()?.userId ?? null);
+       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, id("chapterVersion"), input.workId, input.chapterId, input.versionNo, input.title, input.content, input.volumeId, input.sortOrder, input.chapterType, input.source, input.sourceRef, input.changeNote.trim(), timestamp, currentRequestActor()?.userId ?? null);
+        this.recordSyncChange(input.workId, "chapter", input.chapterId, input.source === "delete" ? "delete" : "upsert", input.versionNo, timestamp);
     }
     listChapterVersions(chapterId) {
         const rows = this.findChapterVersionRows(chapterId);
@@ -1997,7 +2020,7 @@ export class Store {
         if (!hasTextChange && !hasOtherChange)
             return current;
         const timestamp = now();
-        const versionNo = Number(current.versionNo) + (hasTextChange ? 1 : 0);
+        const versionNo = Number(current.versionNo) + (hasTextChange || hasTypeChange ? 1 : 0);
         this.db.transaction(() => {
             const lockedCurrent = this.getChapter(chapterId);
             this.assertExpectedRevision("chapter", chapterId, expectedVersionNo, "章节", Number(lockedCurrent.versionNo));
@@ -2005,7 +2028,9 @@ export class Store {
          excluded_from_analysis = ?, updated_at = ? WHERE id = ?`, nextTitle, nextContent, nextChapterType, countWords(nextContent), versionNo, hasTextChange || hasTypeChange ? "expired" : String(current.analysisStatus), nextExcluded ? 1 : 0, timestamp, chapterId);
             if (hasTextChange)
                 this.syncChapterParagraphSearch(String(current.workId), chapterId, nextContent);
-            if (hasTextChange) {
+            else if (hasTypeChange)
+                this.syncChapterParagraphSearchVersion(chapterId, versionNo);
+            if (hasTextChange || hasTypeChange) {
                 this.insertChapterVersionRow({
                     workId: String(current.workId),
                     chapterId,
@@ -2017,7 +2042,7 @@ export class Store {
                     chapterType: nextChapterType,
                     source,
                     sourceRef,
-                    changeNote: changeNote || "更新章节正文",
+                    changeNote: changeNote || (hasTextChange ? "更新章节正文" : "更新章节类型"),
                     timestamp
                 });
             }
@@ -2529,9 +2554,28 @@ export class Store {
             }
             else if (action.type === "setType") {
                 for (const chapter of currentChapters) {
-                    this.db.run("UPDATE chapters SET chapter_type = ?, analysis_status = 'expired', updated_at = ? WHERE id = ?", action.chapterType, timestamp, String(chapter.id));
-                    this.invalidateChapter(workId, String(chapter.id), Number(chapter.versionNo));
-                    this.audit(workId, "chapter.saved", "chapter", String(chapter.id), { chapterType: action.chapterType, batch: true });
+                    if (chapter.chapterType === action.chapterType)
+                        continue;
+                    const chapterId = String(chapter.id);
+                    const versionNo = Number(chapter.versionNo) + 1;
+                    this.db.run("UPDATE chapters SET chapter_type = ?, version_no = ?, analysis_status = 'expired', updated_at = ? WHERE id = ?", action.chapterType, versionNo, timestamp, chapterId);
+                    this.syncChapterParagraphSearchVersion(chapterId, versionNo);
+                    this.insertChapterVersionRow({
+                        workId,
+                        chapterId,
+                        versionNo,
+                        title: String(chapter.title),
+                        content: String(chapter.content),
+                        volumeId: String(chapter.volumeId),
+                        sortOrder: Number(chapter.sortOrder),
+                        chapterType: action.chapterType,
+                        source: "manual",
+                        sourceRef: null,
+                        changeNote: "批量更新章节类型",
+                        timestamp
+                    });
+                    this.invalidateChapter(workId, chapterId, versionNo);
+                    this.audit(workId, "chapter.saved", "chapter", chapterId, { chapterType: action.chapterType, versionNo, batch: true });
                 }
             }
             else if (action.type === "setAnalysisExclusion") {
@@ -2955,6 +2999,7 @@ export class Store {
                 ? `/api/works/${encodeURIComponent(workId)}/cover?v=${encodeURIComponent(requiredString(cover, "updated_at"))}`
                 : optionalString(row, "cover_url"),
             tags: json(requiredString(row, "tags_json"), []),
+            offlineAccessEnabled: numberValue(row, "offline_access_enabled") === 1,
             versionNo: numberValue(row, "version_no") || this.currentEntityVersionNo("work", workId),
             ownerUserId,
             accessRole,
@@ -3706,7 +3751,7 @@ export class Store {
         return this.db.all(`SELECT draft.*, volume.title AS volume_title FROM drafts draft
        LEFT JOIN volumes volume ON volume.id = draft.volume_id
        WHERE draft.work_id = ? AND (? IS NULL OR draft.draft_type = ?)
-       ORDER BY draft.updated_at DESC, draft.title`, workId, draftType ?? null, draftType ?? null).map((row) => this.mapDraft(row, includeContent));
+       ORDER BY draft.is_favorite DESC, draft.updated_at DESC, draft.title`, workId, draftType ?? null, draftType ?? null).map((row) => this.mapDraft(row, includeContent));
     }
     listDraftsPage(workId, pagination, draftType, includeContent = false) {
         this.getWork(workId);
@@ -3714,7 +3759,7 @@ export class Store {
         const rows = this.db.all(`SELECT draft.*, volume.title AS volume_title FROM drafts draft
        LEFT JOIN volumes volume ON volume.id = draft.volume_id
        WHERE draft.work_id = ? AND (? IS NULL OR draft.draft_type = ?)
-       ORDER BY draft.updated_at DESC, draft.title${page.sql}`, workId, draftType ?? null, draftType ?? null, ...page.params);
+       ORDER BY draft.is_favorite DESC, draft.updated_at DESC, draft.title${page.sql}`, workId, draftType ?? null, draftType ?? null, ...page.params);
         return paginated(rows.map((row) => this.mapDraft(row, includeContent)), pagination);
     }
     searchDrafts(workId, query, draftType, limit = 20) {
@@ -3743,6 +3788,21 @@ export class Store {
             throw notFound("想法");
         return this.mapDraft(row, true);
     }
+    setDraftFavorite(draftId, isFavorite) {
+        const draft = this.db.get("SELECT id, work_id, is_favorite FROM drafts WHERE id = ?", draftId);
+        if (!draft)
+            throw notFound("想法");
+        const workId = requiredString(draft, "work_id");
+        const previousFavorite = booleanValue(draft, "is_favorite");
+        this.db.transaction(() => {
+            this.db.run("UPDATE drafts SET is_favorite = ? WHERE id = ?", isFavorite ? 1 : 0, draftId);
+            this.audit(workId, "draft.favorite-updated", "draft", draftId, {
+                previousFavorite,
+                isFavorite
+            });
+        });
+        return this.getDraft(draftId);
+    }
     updateDraft(draftId, input, source = "manual", sourceRef = null, changeNote = "", expectedVersionNo) {
         const current = this.getDraft(draftId);
         const content = input.content ?? String(current.content);
@@ -3781,6 +3841,7 @@ export class Store {
             volumeTitle: optionalString(row, "volume_title"),
             settingModule: optionalString(row, "setting_module"),
             title: requiredString(row, "title"),
+            isFavorite: booleanValue(row, "is_favorite"),
             ...(includeContent ? { content } : { contentPreview: content.replace(/\s+/gu, " ").trim().slice(0, 320) }),
             versionNo: this.currentEntityVersionNo("draft", requiredString(row, "id")),
             createdAt: requiredString(row, "created_at"),
@@ -3844,12 +3905,12 @@ export class Store {
     }
     listSettings(workId, includeContent = true) {
         this.getWork(workId);
-        return this.db.all("SELECT * FROM settings WHERE work_id = ? ORDER BY locked DESC, category, title", workId).map((row) => this.mapSetting(row, includeContent));
+        return this.db.all("SELECT * FROM settings WHERE work_id = ? ORDER BY is_favorite DESC, locked DESC, category, title", workId).map((row) => this.mapSetting(row, includeContent));
     }
     listSettingsPage(workId, pagination, includeContent = true) {
         this.getWork(workId);
         const page = paginationSql(pagination);
-        const rows = this.db.all(`SELECT * FROM settings WHERE work_id = ? ORDER BY locked DESC, category, title${page.sql}`, workId, ...page.params);
+        const rows = this.db.all(`SELECT * FROM settings WHERE work_id = ? ORDER BY is_favorite DESC, locked DESC, category, title${page.sql}`, workId, ...page.params);
         return paginated(rows.map((row) => this.mapSetting(row, includeContent)), pagination);
     }
     getSetting(settingId) {
@@ -3858,6 +3919,21 @@ export class Store {
             throw notFound("设定");
         return this.mapSetting(row);
     }
+    setSettingFavorite(settingId, isFavorite) {
+        const setting = this.db.get("SELECT id, work_id, is_favorite FROM settings WHERE id = ?", settingId);
+        if (!setting)
+            throw notFound("设定");
+        const workId = requiredString(setting, "work_id");
+        const previousFavorite = booleanValue(setting, "is_favorite");
+        this.db.transaction(() => {
+            this.db.run("UPDATE settings SET is_favorite = ? WHERE id = ?", isFavorite ? 1 : 0, settingId);
+            this.audit(workId, "setting.favorite-updated", "setting", settingId, {
+                previousFavorite,
+                isFavorite
+            });
+        });
+        return this.getSetting(settingId);
+    }
     updateSetting(settingId, input, source = "manual", sourceRef = null, changeNote = "", expectedVersionNo) {
         const current = this.getSetting(settingId);
         const content = input.content ?? String(current.content);
@@ -3892,6 +3968,7 @@ export class Store {
             tags: json(requiredString(row, "tags_json"), []),
             status: requiredString(row, "status"),
             locked: booleanValue(row, "locked"),
+            isFavorite: booleanValue(row, "is_favorite"),
             evidence: json(requiredString(row, "evidence_json"), []),
             scope: json(requiredString(row, "scope_json"), {}),
             authorNote: requiredString(row, "author_note"),
@@ -4205,14 +4282,14 @@ export class Store {
     }
     listOrganizations(workId, includeMarkdown = true) {
         this.getWork(workId);
-        const rows = this.db.all("SELECT * FROM organizations WHERE work_id = ? ORDER BY name", workId);
+        const rows = this.db.all("SELECT * FROM organizations WHERE work_id = ? ORDER BY is_favorite DESC, name", workId);
         const batch = this.organizationListBatch(rows);
         return rows.map((row) => this.mapOrganization(row, includeMarkdown, batch));
     }
     listOrganizationsPage(workId, pagination, includeMarkdown = true) {
         this.getWork(workId);
         const page = paginationSql(pagination);
-        const rows = this.db.all(`SELECT * FROM organizations WHERE work_id = ? ORDER BY name${page.sql}`, workId, ...page.params);
+        const rows = this.db.all(`SELECT * FROM organizations WHERE work_id = ? ORDER BY is_favorite DESC, name${page.sql}`, workId, ...page.params);
         const batch = this.organizationListBatch(rows);
         return paginated(rows.map((row) => this.mapOrganization(row, includeMarkdown, batch)), pagination);
     }
@@ -4222,6 +4299,21 @@ export class Store {
             throw notFound("组织");
         return this.mapOrganization(row);
     }
+    setOrganizationFavorite(organizationId, isFavorite) {
+        const organization = this.db.get("SELECT id, work_id, is_favorite FROM organizations WHERE id = ?", organizationId);
+        if (!organization)
+            throw notFound("组织");
+        const workId = requiredString(organization, "work_id");
+        const previousFavorite = booleanValue(organization, "is_favorite");
+        this.db.transaction(() => {
+            this.db.run("UPDATE organizations SET is_favorite = ? WHERE id = ?", isFavorite ? 1 : 0, organizationId);
+            this.audit(workId, "organization.favorite-updated", "organization", organizationId, {
+                previousFavorite,
+                isFavorite
+            });
+        });
+        return this.getOrganization(organizationId);
+    }
     updateOrganization(organizationId, input, source = "manual", sourceRef = null, changeNote = "", expectedVersionNo) {
         const current = this.getOrganization(organizationId);
         const workId = String(current.workId);
@@ -4349,6 +4441,7 @@ export class Store {
             name: requiredString(row, "name"),
             description: requiredString(row, "description"),
             isDissolved: booleanValue(row, "is_dissolved"),
+            isFavorite: booleanValue(row, "is_favorite"),
             ...(includeMarkdown
                 ? { settings, settingsMarkdown: settingsMarkdownFromList(settings), settingsSections }
                 : { settings: [], settingsCount: settingsSections.length }),
@@ -4467,14 +4560,14 @@ export class Store {
     }
     listCharacters(workId, includeProfileSections = false, includeMerged = false, includeRaceMarkdown = true) {
         this.getWork(workId);
-        return this.db.all(`SELECT * FROM characters WHERE work_id = ?${includeMerged ? "" : " AND merged_into_character_id IS NULL"} ORDER BY name`, workId)
+        return this.db.all(`SELECT * FROM characters WHERE work_id = ?${includeMerged ? "" : " AND merged_into_character_id IS NULL"} ORDER BY is_favorite DESC, name`, workId)
             .map((row) => this.mapCharacter(row, includeProfileSections, includeRaceMarkdown));
     }
     listCharactersPage(workId, pagination, includeProfileSections = false, includeMerged = false, includeRaceMarkdown = true) {
         this.getWork(workId);
         const page = paginationSql(pagination);
         const count = this.db.get(`SELECT COUNT(*) AS count FROM characters WHERE work_id = ?${includeMerged ? "" : " AND merged_into_character_id IS NULL"}`, workId);
-        const rows = this.db.all(`SELECT * FROM characters WHERE work_id = ?${includeMerged ? "" : " AND merged_into_character_id IS NULL"} ORDER BY name${page.sql}`, workId, ...page.params);
+        const rows = this.db.all(`SELECT * FROM characters WHERE work_id = ?${includeMerged ? "" : " AND merged_into_character_id IS NULL"} ORDER BY is_favorite DESC, name${page.sql}`, workId, ...page.params);
         return paginated(rows.map((row) => this.mapCharacter(row, includeProfileSections, includeRaceMarkdown)), pagination, Number(count?.count ?? 0));
     }
     mapCharacterProfileSection(row) {
@@ -4955,6 +5048,26 @@ export class Store {
             throw notFound("角色");
         return this.mapCharacter(row);
     }
+    setCharacterFavorite(characterId, isFavorite) {
+        const character = this.db.get("SELECT id, work_id, is_favorite, merged_into_character_id FROM characters WHERE id = ?", characterId);
+        if (!character)
+            throw notFound("角色");
+        if (optionalString(character, "merged_into_character_id")) {
+            throw new AppError(409, "CHARACTER_ALREADY_MERGED", "已合并角色不能收藏");
+        }
+        const workId = requiredString(character, "work_id");
+        const previousFavorite = booleanValue(character, "is_favorite");
+        if (previousFavorite === isFavorite)
+            return this.getCharacter(characterId);
+        this.db.transaction(() => {
+            this.db.run("UPDATE characters SET is_favorite = ? WHERE id = ?", isFavorite ? 1 : 0, characterId);
+            this.audit(workId, "character.favorite-updated", "character", characterId, {
+                previousFavorite,
+                isFavorite
+            });
+        });
+        return this.getCharacter(characterId);
+    }
     getCharacterAvatar(characterId) {
         const character = this.db.get("SELECT id FROM characters WHERE id = ?", characterId);
         if (!character)
@@ -5229,6 +5342,7 @@ export class Store {
             profileSectionCount,
             currentState: json(requiredString(row, "current_state_json"), {}),
             isDead: booleanValue(row, "is_dead"),
+            isFavorite: booleanValue(row, "is_favorite"),
             avatarUrl: avatarSha256
                 ? `/api/characters/${encodeURIComponent(characterId)}/avatar?v=${encodeURIComponent(avatarSha256)}`
                 : null,
@@ -6053,6 +6167,7 @@ export class Store {
             totalMessageCount,
             warningPending: Boolean(optionalString(conversation, "context_warning_at")),
             injectedEntities: parseAiInjectedEntities(optionalString(conversation, "injected_entities_json") ?? EMPTY_AI_INJECTED_ENTITIES),
+            scenePin: normalizeRoleplayScenePin(json(optionalString(conversation, "scene_pin_json") ?? "{}", {})),
             messages: rows.filter((message) => requiredString(message, "id") !== excludeMessageId)
                 .map((message) => ({
                 id: requiredString(message, "id"),
@@ -6134,6 +6249,16 @@ export class Store {
         const refreshed = this.db.get("SELECT system_clock_text FROM ai_conversations WHERE id = ?", conversationId);
         return (optionalString(refreshed ?? {}, "system_clock_text") ?? clock).trim() || clock;
     }
+    setAiConversationScenePin(conversationId, workId, pin) {
+        const conversation = this.db.get("SELECT work_id FROM ai_conversations WHERE id = ?", conversationId);
+        if (!conversation)
+            throw notFound("AI 对话");
+        if (requiredString(conversation, "work_id") !== workId)
+            throw new AppError(400, "CONVERSATION_WORK_MISMATCH", "AI 对话不属于当前作品");
+        const normalized = normalizeRoleplayScenePin(pin);
+        this.db.run("UPDATE ai_conversations SET scene_pin_json = ?, updated_at = ? WHERE id = ?", JSON.stringify(normalized), now(), conversationId);
+        return normalized;
+    }
     listCharacterNameEntries(workId) {
         this.getWork(workId);
         return this.db.all(`SELECT character_id, normalized_name, display_name, kind FROM character_names
@@ -6577,10 +6702,11 @@ export class Store {
         const injectedEntitiesJson = optionalString(conversation, "injected_entities_json")
             ?? JSON.stringify(EMPTY_AI_INJECTED_ENTITIES);
         const systemClockText = optionalString(conversation, "system_clock_text") ?? "";
+        const scenePinJson = optionalString(conversation, "scene_pin_json") ?? "{}";
         this.db.transaction(() => {
-            this.db.run("INSERT INTO ai_conversations (id, work_id, roleplay_character_id, roleplay_user_character_id, task_type, context_scope_json, title, compacted_summary, compacted_message_count, agent_tools_json, injected_entities_json, system_clock_text, created_at, updated_at, created_by_user_id) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)", forkId, workId, optionalString(conversation, "roleplay_character_id"), optionalString(conversation, "roleplay_user_character_id"), optionalString(conversation, "task_type"), optionalString(conversation, "context_scope_json"), title.slice(0, 200), forkSummary, forkCompactedCount, conversation.agent_tools_json == null
+            this.db.run("INSERT INTO ai_conversations (id, work_id, roleplay_character_id, roleplay_user_character_id, task_type, context_scope_json, title, compacted_summary, compacted_message_count, agent_tools_json, injected_entities_json, system_clock_text, scene_pin_json, created_at, updated_at, created_by_user_id) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)", forkId, workId, optionalString(conversation, "roleplay_character_id"), optionalString(conversation, "roleplay_user_character_id"), optionalString(conversation, "task_type"), optionalString(conversation, "context_scope_json"), title.slice(0, 200), forkSummary, forkCompactedCount, conversation.agent_tools_json == null
                 ? JSON.stringify(normalizeWorkAgentTools(this.getWorkAiSettings(workId).agentTools))
-                : String(conversation.agent_tools_json), injectedEntitiesJson, systemClockText, timestamp, timestamp, currentRequestActor()?.userId ?? null);
+                : String(conversation.agent_tools_json), injectedEntitiesJson, systemClockText, scenePinJson, timestamp, timestamp, currentRequestActor()?.userId ?? null);
             for (const message of messages.slice(0, targetIndex + 1)) {
                 const role = requiredString(message, "role");
                 const inheritedMetadata = json(requiredString(message, "metadata_json"), {});
@@ -6647,7 +6773,7 @@ export class Store {
             title: requiredString(row, "title"),
             isFavorite: booleanValue(row, "is_favorite"),
             messageCount: numberValue(row, "message_count"),
-            preview: requiredString(row, "preview"),
+            preview: roleplayUserTurnDisplayText(requiredString(row, "preview")),
             compactedMessageCount: numberValue(row, "compacted_message_count"),
             hasCompactedSummary: Boolean(requiredString(row, "compacted_summary")),
             contextWarningPending: Boolean(optionalString(row, "context_warning_at")),
@@ -6655,6 +6781,7 @@ export class Store {
             ...(lockedModelId ? { modelId: lockedModelId } : {}),
             ...(hasImageAttachments ? { hasImageAttachments: true, modelLockedByImage: true } : {}),
             contextScope: json(optionalString(row, "context_scope_json") ?? "", { type: "none" }),
+            scenePin: normalizeRoleplayScenePin(json(optionalString(row, "scene_pin_json") ?? "{}", {})),
             roleplayCharacter: roleplayCharacter ? {
                 id: requiredString(roleplayCharacter, "id"),
                 name: requiredString(roleplayCharacter, "name"),
@@ -6884,8 +7011,9 @@ export class Store {
                 scope.targetCharacters = targetCharacters;
         }
         const sourceVersions = this.analysisTaskSourceVersions(workId, scope);
-        this.db.run(`INSERT INTO analysis_tasks (id, work_id, model_id, task_type, scope_json, status, source_versions_json, created_at, updated_at, created_by_user_id)
-       VALUES (?, ?, ?, ?, ?, 'pending', ?, ?, ?, ?)`, taskId, workId, input.modelId ?? null, input.taskType, JSON.stringify(scope), JSON.stringify(sourceVersions), timestamp, timestamp, currentRequestActor()?.userId ?? null);
+        const actor = currentRequestActor();
+        this.db.run(`INSERT INTO analysis_tasks (id, work_id, model_id, task_type, scope_json, status, source_versions_json, created_at, updated_at, created_by_user_id, created_via_api_key)
+       VALUES (?, ?, ?, ?, ?, 'pending', ?, ?, ?, ?, ?)`, taskId, workId, input.modelId ?? null, input.taskType, JSON.stringify(scope), JSON.stringify(sourceVersions), timestamp, timestamp, actor?.userId ?? null, actor?.authentication === "api-key" ? 1 : 0);
         this.audit(workId, "task.created", "analysis-task", taskId, {
             taskType: input.taskType,
             scope,