@senguoyun/dsh-arkme 0.1.41 → 0.1.42

package/lib/{persistent-runtime-B1gJH2Nx.js → persistent-runtime-LJ4nj7os.js}

@@ -4,7 +4,7 @@ import { basename, dirname, isAbsolute, join, posix, relative, resolve, sep } fr
 import { fileURLToPath } from "node:url";
 import * as fs from "node:fs/promises";
 import { chmod as chmod$1, copyFile, link, mkdir, open, readFile, rename, rm, stat, unlink, writeFile } from "node:fs/promises";
-import { Resolver } from "node:dns/promises";
+import { Resolver, lookup } from "node:dns/promises";
 import { request } from "node:http";
 import { request as request$1 } from "node:https";
 import { BlockList, isIP } from "node:net";
@@ -11324,6 +11324,9 @@ var Id3V2Reader = class {
 //#endregion
 //#region src/recording-import-shared.ts
 const MAX_RECORDING_IMPORT_BYTES = 1024 * 1024 * 1024;
+function recordingImportFileNameKey(fileName) {
+	return fileName.trim().toLowerCase();
+}
 //#endregion
 //#region src/recording-import-contract.ts
 function sameRecordingImportIdentity(left, right) {
@@ -11405,7 +11408,10 @@ function advanceRecordingImportJob(current, input) {
 }
 function toPublicRecordingImportJob(job, importRef) {
 	const progress = job.fileSize <= 0 ? 0 : Math.min(1, Math.max(0, job.uploadedBytes / job.fileSize));
+	const status = job.phase === "prepared" ? "preparing" : job.phase === "uploading" ? "uploading" : job.phase === "finalizing" ? "processing" : job.phase === "accepted" ? "accepted" : job.phase === "failed" ? "failed" : "cancelled";
+	const statusDetail = job.phase === "prepared" ? "准备中" : job.phase === "uploading" ? "上传中" : job.phase === "finalizing" ? "处理中" : job.phase === "accepted" ? "Audio 已接收" : job.phase === "failed" ? job.errorMessage?.trim() || "导入失败" : "已取消";
 	return {
+		kind: "local",
 		importRef,
 		revision: job.revision,
 		phase: job.phase,
@@ -11413,7 +11419,11 @@ function toPublicRecordingImportJob(job, importRef) {
 		fileName: job.fileName,
 		fileSize: job.fileSize,
 		durationMillis: job.durationMillis,
+		startAtMillis: job.startAtMillis,
+		endAtMillis: job.startAtMillis + job.durationMillis,
 		progress,
+		status,
+		statusDetail,
 		createdAtMillis: job.createdAtMillis,
 		updatedAtMillis: job.updatedAtMillis,
 		...job.errorCode === void 0 ? {} : { errorCode: job.errorCode },
@@ -11422,18 +11432,115 @@ function toPublicRecordingImportJob(job, importRef) {
 	};
 }
 //#endregion
+//#region src/recording-wave-probe.ts
+const MAX_WAVE_CHUNK_COUNT = 1024;
+function ascii$1(bytes, offset, length) {
+	return String.fromCharCode(...bytes.subarray(offset, offset + length));
+}
+function uint16(bytes, offset) {
+	return new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength).getUint16(offset, true);
+}
+function uint32(bytes, offset) {
+	return new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength).getUint32(offset, true);
+}
+async function readExact(source, offset, length) {
+	const bytes = await source.read(offset, length);
+	if (bytes.byteLength !== length) throw new TypeError("WAV 文件内容不完整");
+	return bytes;
+}
+async function probeImaAdpcmWave(source) {
+	if (!Number.isSafeInteger(source.size) || source.size < 12) return void 0;
+	const header = await readExact(source, 0, 12);
+	if (ascii$1(header, 0, 4) !== "RIFF" || ascii$1(header, 8, 4) !== "WAVE") return void 0;
+	const riffEnd = uint32(header, 4) + 8;
+	if (riffEnd < 12 || riffEnd > source.size) throw new TypeError("WAV RIFF 长度无效");
+	let offset = 12;
+	let format;
+	let dataSize;
+	let chunkCount = 0;
+	while (offset + 8 <= riffEnd) {
+		chunkCount += 1;
+		if (chunkCount > MAX_WAVE_CHUNK_COUNT) throw new TypeError("WAV chunk 数量过多");
+		const chunkHeader = await readExact(source, offset, 8);
+		const chunkId = ascii$1(chunkHeader, 0, 4);
+		const chunkSize = uint32(chunkHeader, 4);
+		const chunkOffset = offset + 8;
+		const nextOffset = chunkOffset + chunkSize + chunkSize % 2;
+		if (!Number.isSafeInteger(nextOffset) || nextOffset > riffEnd) throw new TypeError("WAV chunk 长度无效");
+		if (chunkId === "fmt ") {
+			if (chunkSize < 2) throw new TypeError("WAV fmt chunk 无效");
+			const bytes = await readExact(source, chunkOffset, Math.min(chunkSize, 20));
+			if (uint16(bytes, 0) !== 17) return void 0;
+			if (bytes.byteLength < 20 || uint16(bytes, 16) < 2) throw new TypeError("IMA ADPCM fmt chunk 无效");
+			format = {
+				channels: uint16(bytes, 2),
+				sampleRate: uint32(bytes, 4),
+				blockAlign: uint16(bytes, 12),
+				bitsPerSample: uint16(bytes, 14),
+				samplesPerBlock: uint16(bytes, 18)
+			};
+		} else if (chunkId === "data") dataSize = chunkSize;
+		if (format !== void 0 && dataSize !== void 0) break;
+		offset = nextOffset;
+	}
+	if (format === void 0) throw new TypeError("IMA ADPCM WAV 缺少 fmt chunk");
+	if (dataSize === void 0 || dataSize <= 0) throw new TypeError("IMA ADPCM WAV 缺少音频数据");
+	const { channels, sampleRate, blockAlign, bitsPerSample, samplesPerBlock } = format;
+	if (channels <= 0 || sampleRate <= 0 || bitsPerSample !== 4) throw new TypeError("IMA ADPCM WAV 编码参数无效");
+	const blockHeaderSize = channels * 4;
+	const encodedGroupSize = channels * 4;
+	const blockPayloadSize = blockAlign - blockHeaderSize;
+	if (blockPayloadSize < 0 || blockPayloadSize % encodedGroupSize !== 0) throw new TypeError("IMA ADPCM WAV 编码参数无效");
+	const expectedSamplesPerBlock = 1 + blockPayloadSize / encodedGroupSize * 8;
+	if (samplesPerBlock <= 0 || samplesPerBlock !== expectedSamplesPerBlock) throw new TypeError("IMA ADPCM WAV 编码参数无效");
+	const completeBlocks = Math.floor(dataSize / blockAlign);
+	const remainder = dataSize % blockAlign;
+	if (remainder !== 0 && (remainder < blockHeaderSize || (remainder - blockHeaderSize) % encodedGroupSize !== 0)) throw new TypeError("IMA ADPCM WAV 音频数据无效");
+	const partialBlockSamples = remainder === 0 ? 0 : 1 + (remainder - blockHeaderSize) / encodedGroupSize * 8;
+	const totalSamples = completeBlocks * samplesPerBlock + partialBlockSamples;
+	const durationMillis = Math.round(totalSamples * 1e3 / sampleRate);
+	if (!Number.isSafeInteger(durationMillis) || durationMillis <= 0) throw new TypeError("IMA ADPCM WAV 时长无效");
+	return { durationMillis };
+}
+//#endregion
 //#region src/recording-import-probe.ts
 async function probeRecordingImportFile(filePath, metadata) {
-	if ((await stat(filePath)).size !== metadata.fileSize) throw new RecordingImportContractError("recording-import-size-mismatch", "录音文件大小与声明不一致");
-	const input = new Input({
-		source: new FilePathSource(filePath),
-		formats: [
-			WAVE,
-			MP3,
-			MP4
-		]
-	});
+	const actualSize = (await stat(filePath)).size;
+	if (actualSize !== metadata.fileSize) throw new RecordingImportContractError("recording-import-size-mismatch", "录音文件大小与声明不一致");
+	let input;
 	try {
+		const handle = await open(filePath, "r");
+		let imaAdpcm;
+		try {
+			imaAdpcm = await probeImaAdpcmWave({
+				size: actualSize,
+				read: async (offset, length) => {
+					const bytes = new Uint8Array(length);
+					const { bytesRead } = await handle.read(bytes, 0, length, offset);
+					return bytes.subarray(0, bytesRead);
+				}
+			});
+		} finally {
+			await handle.close();
+		}
+		if (imaAdpcm !== void 0) {
+			if (recordingImportFileKind({
+				...metadata,
+				durationMillis: imaAdpcm.durationMillis
+			}) !== "wav") throw new RecordingImportContractError("recording-import-format-mismatch", "录音格式与文件内容不一致");
+			return {
+				kind: "wav",
+				durationMillis: imaAdpcm.durationMillis
+			};
+		}
+		input = new Input({
+			source: new FilePathSource(filePath),
+			formats: [
+				WAVE,
+				MP3,
+				MP4
+			]
+		});
 		if (!await input.canRead()) throw new RecordingImportContractError("recording-import-format-invalid", "无法识别录音文件内容");
 		const actualFormat = await input.getFormat();
 		const actualKind = actualFormat === WAVE ? "wav" : actualFormat === MP3 ? "mp3" : actualFormat === MP4 ? "m4a" : void 0;
@@ -11455,7 +11562,7 @@ async function probeRecordingImportFile(filePath, metadata) {
 		if (error instanceof RecordingImportContractError) throw error;
 		throw new RecordingImportContractError("recording-import-probe-failed", "录音文件校验失败");
 	} finally {
-		input.dispose();
+		input?.dispose();
 	}
 }
 var LocalRecordingImportSource = class {
@@ -11808,7 +11915,7 @@ function bestMatchingCategory(text) {
 }
 //#endregion
 //#region src/services/ai-video-service.ts
-function numberValue$29(value) {
+function numberValue$30(value) {
 	return typeof value === "number" && Number.isFinite(value) ? value : 0;
 }
 function booleanValue$15(value) {
@@ -11828,9 +11935,9 @@ var AiVideoService = class {
 		return {
 			allowed: booleanValue$15(data.allowed),
 			message: stringValue$1(data.message).trim() || "AI 视频内容检查已完成",
-			selectedDurationMillis: Math.max(0, numberValue$29(data.selected_duration_millis)),
-			minimumDurationMillis: Math.max(0, numberValue$29(data.minimum_duration_millis)),
-			selectedSegmentCount: Math.max(0, numberValue$29(data.selected_segment_count)),
+			selectedDurationMillis: Math.max(0, numberValue$30(data.selected_duration_millis)),
+			minimumDurationMillis: Math.max(0, numberValue$30(data.minimum_duration_millis)),
+			selectedSegmentCount: Math.max(0, numberValue$30(data.selected_segment_count)),
 			retryable: booleanValue$15(data.retryable),
 			...stringValue$1(data.reason_code).trim() === "" ? {} : { reasonCode: stringValue$1(data.reason_code).trim() },
 			...stringValue$1(data.proof).trim() === "" ? {} : { proof: stringValue$1(data.proof).trim() }
@@ -11880,10 +11987,10 @@ var AiVideoService = class {
 		return {
 			allowed: booleanValue$15(data.allowed),
 			message: stringValue$1(data.message).trim() || "AI 视频内容检查已完成",
-			selectedDurationMillis: Math.max(0, numberValue$29(data.selected_duration_millis)),
-			minimumDurationMillis: Math.max(0, numberValue$29(data.minimum_duration_millis)),
-			selectedSegmentCount: Math.max(0, numberValue$29(data.selected_segment_count)),
-			selectedTextCount: Math.max(0, numberValue$29(data.selected_text_count)),
+			selectedDurationMillis: Math.max(0, numberValue$30(data.selected_duration_millis)),
+			minimumDurationMillis: Math.max(0, numberValue$30(data.minimum_duration_millis)),
+			selectedSegmentCount: Math.max(0, numberValue$30(data.selected_segment_count)),
+			selectedTextCount: Math.max(0, numberValue$30(data.selected_text_count)),
 			retryable: booleanValue$15(data.retryable),
 			...stringValue$1(data.reason_code).trim() === "" ? {} : { reasonCode: stringValue$1(data.reason_code).trim() },
 			...stringValue$1(data.proof).trim() === "" ? {} : { proof: stringValue$1(data.proof).trim() }
@@ -11929,13 +12036,13 @@ var AiVideoService = class {
 			jobId,
 			status,
 			stage: stringValue$1(data.stage).trim() || status,
-			progress: Math.min(100, Math.max(0, Math.trunc(numberValue$29(data.progress)))),
+			progress: Math.min(100, Math.max(0, Math.trunc(numberValue$30(data.progress)))),
 			selectedSegmentCount: segmentCount,
 			...textCount === 0 ? {} : { selectedTextCount: textCount },
 			retryable: booleanValue$15(data.retryable),
 			...stringValue$1(data.video_asset_uid).trim() === "" ? {} : { videoAssetUid: stringValue$1(data.video_asset_uid).trim() },
 			...stringValue$1(data.cover_asset_uid).trim() === "" ? {} : { coverAssetUid: stringValue$1(data.cover_asset_uid).trim() },
-			...numberValue$29(data.video_duration_millis) <= 0 ? {} : { videoDurationMillis: numberValue$29(data.video_duration_millis) },
+			...numberValue$30(data.video_duration_millis) <= 0 ? {} : { videoDurationMillis: numberValue$30(data.video_duration_millis) },
 			...stringValue$1(data.error_code).trim() === "" ? {} : { errorCode: stringValue$1(data.error_code).trim() },
 			...stringValue$1(data.error_message).trim() === "" ? {} : { errorMessage: stringValue$1(data.error_message).trim() },
 			...stringValue$1(data.failure_stage).trim() === "" ? {} : { failureStage: stringValue$1(data.failure_stage).trim() }
@@ -11958,17 +12065,17 @@ var AiVideoService = class {
 			sessionId: stringValue$1(item.session_id).trim(),
 			status,
 			stage: stringValue$1(item.stage).trim() || status,
-			progress: Math.min(100, Math.max(0, Math.trunc(numberValue$29(item.progress)))),
+			progress: Math.min(100, Math.max(0, Math.trunc(numberValue$30(item.progress)))),
 			title: stringValue$1(source.title).trim() || "长录音 AI 视频",
-			sourceStartedAtMillis: numberValue$29(source.started_at),
-			selectedDurationMillis: Math.max(0, numberValue$29(source.selected_duration_millis)),
-			selectedSegmentCount: Math.max(0, Math.trunc(numberValue$29(item.selected_segment_count))),
+			sourceStartedAtMillis: numberValue$30(source.started_at),
+			selectedDurationMillis: Math.max(0, numberValue$30(source.selected_duration_millis)),
+			selectedSegmentCount: Math.max(0, Math.trunc(numberValue$30(item.selected_segment_count))),
 			retryable: booleanValue$15(item.retryable),
-			createdAtMillis: numberValue$29(item.created_at),
-			updatedAtMillis: numberValue$29(item.updated_at),
+			createdAtMillis: numberValue$30(item.created_at),
+			updatedAtMillis: numberValue$30(item.updated_at),
 			...stringValue$1(item.cover_asset_uid).trim() === "" ? {} : { coverAssetUid: stringValue$1(item.cover_asset_uid).trim() },
 			...stringValue$1(item.video_asset_uid).trim() === "" ? {} : { videoAssetUid: stringValue$1(item.video_asset_uid).trim() },
-			...numberValue$29(item.video_duration_millis) <= 0 ? {} : { videoDurationMillis: numberValue$29(item.video_duration_millis) },
+			...numberValue$30(item.video_duration_millis) <= 0 ? {} : { videoDurationMillis: numberValue$30(item.video_duration_millis) },
 			...stringValue$1(item.error_code).trim() === "" ? {} : { errorCode: stringValue$1(item.error_code).trim() },
 			...stringValue$1(item.error_message).trim() === "" ? {} : { errorMessage: clippedText(item.error_message, 500) }
 		};
@@ -11994,7 +12101,7 @@ const ARKO_RUN_STATUSES = /* @__PURE__ */ new Set([
 	"expired"
 ]);
 const ARKO_PROFILE_DISPLAY_NAME_CACHE_TTL_MS = 10 * 6e4;
-function numberValue$28(value) {
+function numberValue$29(value) {
 	return typeof value === "number" && Number.isFinite(value) ? value : 0;
 }
 function booleanValue$14(value) {
@@ -12029,7 +12136,7 @@ function joinUrlWithQuery(baseUrl, path, query) {
 }
 function arkoProfileFromData(data) {
 	const displayName = stringValue$1(data.display_name).trim();
-	const version = numberValue$28(data.version);
+	const version = numberValue$29(data.version);
 	if (displayName === "" || !Number.isSafeInteger(version) || version < 0) throw new ArkmePluginError("arko-profile-contract-invalid", "Arko 资料响应不完整", true, 502);
 	return {
 		displayName,
@@ -12082,9 +12189,9 @@ function parsedJsonRecord(value) {
 }
 function arkoHistoryItemFromData(value) {
 	const data = objectValue$1(value);
-	const messageId = numberValue$28(data.id ?? data.msg_id ?? data.msgId);
-	const sessionId = numberValue$28(data.session_id ?? data.sessionId);
-	const roleCode = numberValue$28(data.role ?? data.sender_role ?? data.senderRole);
+	const messageId = numberValue$29(data.id ?? data.msg_id ?? data.msgId);
+	const sessionId = numberValue$29(data.session_id ?? data.sessionId);
+	const roleCode = numberValue$29(data.role ?? data.sender_role ?? data.senderRole);
 	if (!Number.isSafeInteger(messageId) || messageId <= 0 || !Number.isSafeInteger(sessionId) || sessionId <= 0 || roleCode !== 2 && roleCode !== 3) return void 0;
 	const extra = parsedJsonRecord(data.extra ?? data.metadata ?? data.meta);
 	const extraData = parsedJsonRecord(extra.data);
@@ -12105,7 +12212,7 @@ function arkoHistoryItemFromData(value) {
 		extraData.updateAt,
 		data.updated_at,
 		data.updatedAt
-	].map(numberValue$28).find((candidate) => candidate > 0) ?? 0;
+	].map(numberValue$29).find((candidate) => candidate > 0) ?? 0;
 	const runUid = optionalString$3(extra.agent_run_uid);
 	const runStatus = optionalString$3(extra.agent_run_status);
 	const retryable = optionalBooleanValue$1(extra.agent_run_retryable);
@@ -12119,7 +12226,7 @@ function arkoHistoryItemFromData(value) {
 		text: stringValue$1(data.content ?? data.text_content ?? data.textContent),
 		reasoning: stringValue$1(data.reason_content ?? data.reason_text ?? data.reasonText),
 		createdAtMillis: activityAt > 0 && activityAt < 1e11 ? activityAt * 1e3 : activityAt,
-		status: numberValue$28(data.status ?? data.msg_status),
+		status: numberValue$29(data.status ?? data.msg_status),
 		...runUid === void 0 ? {} : { runUid },
 		...runStatus === void 0 ? {} : { runStatus },
 		...retryable === void 0 ? {} : { retryable },
@@ -12177,7 +12284,7 @@ var ArkoService = class {
 	async arkoEnsureSession(signal) {
 		const session = await this.runtime.requireSession();
 		const latest = await this.runtime.authenticatedIntelligentPost("/api/v1/qa/latest-session", { type: ARKO_AGENT_DIRECT_SESSION_TYPE }, session, signal);
-		const latestSessionId = numberValue$28(latest.id);
+		const latestSessionId = numberValue$29(latest.id);
 		if (Number.isSafeInteger(latestSessionId) && latestSessionId > 0) return {
 			sessionId: latestSessionId,
 			created: false,
@@ -12187,7 +12294,7 @@ var ArkoService = class {
 	}
 	async arkoCreateSession(signal) {
 		const session = await this.runtime.requireSession();
-		const createdSessionId = numberValue$28((await this.runtime.authenticatedIntelligentPost("/api/v1/qa/new-session", {
+		const createdSessionId = numberValue$29((await this.runtime.authenticatedIntelligentPost("/api/v1/qa/new-session", {
 			name: ARKO_DEFAULT_SESSION_NAME,
 			type: ARKO_AGENT_DIRECT_SESSION_TYPE
 		}, session, signal)).session_id);
@@ -12270,9 +12377,9 @@ var ArkoService = class {
 		};
 		if (modelRouteKey !== "") body.model_route_key = modelRouteKey;
 		const accepted = await this.runtime.authenticatedIntelligentPost("/api/v1/qa/new-msg-v2", body, session, options.signal);
-		const userMsgId = numberValue$28(accepted.user_msg_id);
-		const assistantMsgId = numberValue$28(accepted.assistant_msg_id);
-		const acceptedSessionId = numberValue$28(accepted.session_id) || sessionId;
+		const userMsgId = numberValue$29(accepted.user_msg_id);
+		const assistantMsgId = numberValue$29(accepted.assistant_msg_id);
+		const acceptedSessionId = numberValue$29(accepted.session_id) || sessionId;
 		if (!Number.isSafeInteger(acceptedSessionId) || acceptedSessionId <= 0 || !Number.isSafeInteger(userMsgId) || userMsgId <= 0 || !Number.isSafeInteger(assistantMsgId) || assistantMsgId <= 0) throw new ArkmePluginError("arko-ask-contract-invalid", "Arko 消息响应不完整", true, 502);
 		const runUid = stringValue$1(accepted.run_uid).trim();
 		if (runUid === "") throw new ArkmePluginError("arko-ask-contract-invalid", "Arko 消息响应缺少运行标识", true, 502);
@@ -12308,8 +12415,8 @@ var ArkoService = class {
 		}, session, signal);
 		const status = stringValue$1(data.status).trim();
 		const normalizedRunUid = stringValue$1(data.run_uid).trim() || runUid.trim();
-		const sequence = numberValue$28(data.sequence);
-		const surfaceAssistantMsgId = numberValue$28(data.surface_assistant_msg_id);
+		const sequence = numberValue$29(data.sequence);
+		const surfaceAssistantMsgId = numberValue$29(data.surface_assistant_msg_id);
 		const clientAction = optionalRecord$1(data.client_action);
 		if (normalizedRunUid !== runUid.trim() || !ARKO_RUN_STATUSES.has(status) || !Number.isSafeInteger(sequence) || sequence < 0 || !Number.isSafeInteger(surfaceAssistantMsgId) || surfaceAssistantMsgId <= 0) throw new ArkmePluginError("arko-run-status-contract-invalid", "Arko 运行状态响应不完整", true, 502);
 		return {
@@ -12547,7 +12654,7 @@ const ARKME_ARRANGEMENT_REF_TTL_MILLIS = 900 * 1e3;
 const MAX_ARKME_ARRANGEMENT_REFS = 4096;
 const ARKME_ARRANGEMENT_REMINDER_REF_TTL_MILLIS = 900 * 1e3;
 const MAX_ARKME_ARRANGEMENT_REMINDER_REFS = 4096;
-function numberValue$27(value) {
+function numberValue$28(value) {
 	return typeof value === "number" && Number.isFinite(value) ? value : 0;
 }
 function booleanValue$13(value) {
@@ -12563,7 +12670,7 @@ function arrangementStatusCode(status) {
 	return -1;
 }
 function arrangementStatus(value) {
-	const code = Math.trunc(numberValue$27(value));
+	const code = Math.trunc(numberValue$28(value));
 	if (code === 1) return "identified";
 	if (code === 2) return "following";
 	if (code === 3) return "completed";
@@ -12614,7 +12721,7 @@ var ArrangementService = class {
 		}, session, options.signal, { lane: "interactive-read" });
 		const rawItems = listValue$25(data.list);
 		const items = await Promise.all(rawItems.map(async (raw) => await this.arrangementItem(raw, session.userId)));
-		const total = Math.max(0, Math.trunc(numberValue$27(data.total)));
+		const total = Math.max(0, Math.trunc(numberValue$28(data.total)));
 		const nextOffset = offset + rawItems.length;
 		const hasMore = rawItems.length > 0 && nextOffset < total;
 		return {
@@ -12640,7 +12747,7 @@ var ArrangementService = class {
 		}, session, options.signal, { lane: "interactive-read" });
 		const rawItems = listValue$25(data.list);
 		const items = await Promise.all(rawItems.map(async (raw) => await this.arrangementReminderEvent(raw, session.userId)));
-		const total = Math.max(0, Math.trunc(numberValue$27(data.total)));
+		const total = Math.max(0, Math.trunc(numberValue$28(data.total)));
 		const nextOffset = offset + rawItems.length;
 		const hasMore = rawItems.length > 0 && nextOffset < total;
 		return {
@@ -12663,7 +12770,7 @@ var ArrangementService = class {
 			project(data.next_reminder)
 		]);
 		return {
-			unreadCount: Math.max(0, Math.trunc(numberValue$27(data.unread_count))),
+			unreadCount: Math.max(0, Math.trunc(numberValue$28(data.unread_count))),
 			...latestUnread === void 0 ? {} : { latestUnread },
 			...latestEvent === void 0 ? {} : { latestEvent },
 			...nextReminder === void 0 ? {} : { nextReminder }
@@ -12767,7 +12874,7 @@ var ArrangementService = class {
 				}, session, signal);
 				return {
 					outcome: "confirmed",
-					updatedCount: Math.max(0, Math.trunc(numberValue$27(data.updated_count)))
+					updatedCount: Math.max(0, Math.trunc(numberValue$28(data.updated_count)))
 				};
 			} catch (error) {
 				if (!isAmbiguousArrangementWriteError(error)) throw error;
@@ -12785,7 +12892,7 @@ var ArrangementService = class {
 				}, session, signal);
 				return {
 					outcome: "confirmed",
-					updatedCount: Math.max(0, Math.trunc(numberValue$27(data.updated_count)))
+					updatedCount: Math.max(0, Math.trunc(numberValue$28(data.updated_count)))
 				};
 			} catch (error) {
 				if (!isAmbiguousArrangementWriteError(error)) throw error;
@@ -12800,7 +12907,7 @@ var ArrangementService = class {
 				const data = await this.runtime.authenticatedIntelligentPost("/api/v1/arrangements/reminders/clear", {}, session, signal);
 				return {
 					outcome: "confirmed",
-					updatedCount: Math.max(0, Math.trunc(numberValue$27(data.updated_count)))
+					updatedCount: Math.max(0, Math.trunc(numberValue$28(data.updated_count)))
 				};
 			} catch (error) {
 				if (!isAmbiguousArrangementWriteError(error)) throw error;
@@ -12864,8 +12971,8 @@ var ArrangementService = class {
 		const item = objectValue$1(raw);
 		const arrangementUid = stringValue$1(item.uid).trim();
 		if (arrangementUid === "") throw new ArkmePluginError("arrangement-contract-invalid", "安排响应缺少业务身份", true, 502);
-		const dueAtMillis = Math.trunc(numberValue$27(item.due_at));
-		const remindAtMillis = Math.trunc(numberValue$27(item.remind_at));
+		const dueAtMillis = Math.trunc(numberValue$28(item.due_at));
+		const remindAtMillis = Math.trunc(numberValue$28(item.remind_at));
 		return {
 			arrangementRef: await this.arrangementRef(viewerUserId, arrangementUid),
 			title: stringValue$1(item.title),
@@ -12873,8 +12980,8 @@ var ArrangementService = class {
 			status: arrangementStatus(item.status),
 			reminderEnabled: booleanValue$13(item.reminder_enabled),
 			reminderState: stringValue$1(item.reminder_state),
-			createdAtMillis: Math.trunc(numberValue$27(item.create_at)),
-			updatedAtMillis: Math.trunc(numberValue$27(item.update_at)),
+			createdAtMillis: Math.trunc(numberValue$28(item.create_at)),
+			updatedAtMillis: Math.trunc(numberValue$28(item.update_at)),
 			...dueAtMillis > 0 ? { dueAtMillis } : {},
 			...remindAtMillis > 0 ? { remindAtMillis } : {}
 		};
@@ -12895,20 +13002,20 @@ var ArrangementService = class {
 		const eventUid = stringValue$1(item.uid).trim();
 		const arrangementUid = stringValue$1(item.arrangement_uid).trim();
 		if (eventUid === "" || arrangementUid === "") throw new ArkmePluginError("arrangement-reminder-contract-invalid", "安排提醒响应缺少有效身份", true, 502);
-		const dueAtMillis = Math.trunc(numberValue$27(item.due_at));
-		const remindAtMillis = Math.trunc(numberValue$27(item.remind_at));
-		const readAtMillis = Math.trunc(numberValue$27(item.read_at));
+		const dueAtMillis = Math.trunc(numberValue$28(item.due_at));
+		const remindAtMillis = Math.trunc(numberValue$28(item.remind_at));
+		const readAtMillis = Math.trunc(numberValue$28(item.read_at));
 		return {
 			eventRef: await this.arrangementReminderRef(viewerUserId, eventUid),
 			arrangementRef: await this.arrangementRef(viewerUserId, arrangementUid),
 			title: stringValue$1(item.title),
 			description: stringValue$1(item.description),
 			eventKind: stringValue$1(item.event_kind),
-			eventAtMillis: Math.trunc(numberValue$27(item.event_at)),
+			eventAtMillis: Math.trunc(numberValue$28(item.event_at)),
 			read: readAtMillis > 0,
 			reminderState: stringValue$1(item.reminder_state),
-			createdAtMillis: Math.trunc(numberValue$27(item.create_at)),
-			updatedAtMillis: Math.trunc(numberValue$27(item.update_at)),
+			createdAtMillis: Math.trunc(numberValue$28(item.create_at)),
+			updatedAtMillis: Math.trunc(numberValue$28(item.update_at)),
 			...dueAtMillis > 0 ? { dueAtMillis } : {},
 			...remindAtMillis > 0 ? { remindAtMillis } : {},
 			...readAtMillis > 0 ? { readAtMillis } : {}
@@ -12965,7 +13072,7 @@ var ArrangementService = class {
 const ARKME_PHONE_BIND_SUCCESS = 1;
 const ARKME_PHONE_BIND_REPEAT = 2;
 const ARKME_PHONE_BIND_CODE_ERR = 3;
-function numberValue$26(value) {
+function numberValue$27(value) {
 	return typeof value === "number" && Number.isFinite(value) ? value : 0;
 }
 function jiwoScanLoginAvailable(config) {
@@ -13050,7 +13157,7 @@ var AuthService = class {
 		const sceneStr = stringValue$1(data.scene_str).trim();
 		const pollToken = stringValue$1(data.poll_token).trim();
 		const qrContent = stringValue$1(data.url).trim();
-		const expireSeconds = Math.max(30, numberValue$26(data.expire_seconds) || 300);
+		const expireSeconds = Math.max(30, numberValue$27(data.expire_seconds) || 300);
 		if (qrContent === "" && sceneStr !== "") throw new ArkmePluginError("wechat-qr-unavailable", "测试环境当前未返回可用微信二维码，请使用手机号登录", true, 503);
 		if (sceneStr === "" || pollToken === "" || qrContent === "") throw new ArkmePluginError("login-contract-invalid", "Arkme 登录二维码响应不完整", true, 502);
 		const attemptId = crypto.randomUUID();
@@ -13089,7 +13196,7 @@ var AuthService = class {
 			ref: 0,
 			keep_cancel: true
 		}, void 0, [200]);
-		const userId = numberValue$26(data.user_id);
+		const userId = numberValue$27(data.user_id);
 		if (userId <= 0) return {
 			status: "pending",
 			environment: this.runtime.config.environment,
@@ -13119,7 +13226,7 @@ var AuthService = class {
 		}, void 0, [200]);
 		const ticket = stringValue$1(data.ticket).trim();
 		const pollSecret = stringValue$1(data.poll_secret).trim();
-		const expiresAtMillis = numberValue$26(data.expires_at);
+		const expiresAtMillis = numberValue$27(data.expires_at);
 		if (!/^[A-Za-z0-9_-]{43}$/.test(ticket) || !/^[A-Za-z0-9_-]{43}$/.test(pollSecret) || expiresAtMillis <= Date.now()) throw new ArkmePluginError("jiwo-login-contract-invalid", "即我登录二维码响应不完整", true, 502);
 		if (attemptGeneration !== this.jiwoAttemptGeneration) {
 			await this.cancelJiwoCredentials(ticket, pollSecret);
@@ -13169,7 +13276,7 @@ var AuthService = class {
 			};
 		}
 		if (status !== "authenticated") throw new ArkmePluginError("jiwo-login-contract-invalid", "即我扫码登录状态无效", true, 502);
-		const userId = numberValue$26(data.user_id);
+		const userId = numberValue$27(data.user_id);
 		const accessToken = stringValue$1(data.access_token);
 		const refreshToken = stringValue$1(data.refresh_token);
 		if (userId <= 0 || accessToken === "" || refreshToken === "") throw new ArkmePluginError("login-contract-invalid", "Arkme 登录成功响应缺少凭据", false, 502);
@@ -13238,7 +13345,7 @@ var AuthService = class {
 		const normalizedCaptcha = this.normalizedCaptcha(captcha);
 		const session = await this.runtime.sessionStore.read() ?? await this.runtime.readPendingBindingSession();
 		if (session !== void 0) {
-			if (numberValue$26((await this.runtime.post(this.runtime.config.authBaseUrl, "/api/v1/auth/bind-phone-send-code", {
+			if (numberValue$27((await this.runtime.post(this.runtime.config.authBaseUrl, "/api/v1/auth/bind-phone-send-code", {
 				phone: normalizedPhone,
 				pre: "86",
 				is_test: this.runtime.config.environment === "test",
@@ -13260,7 +13367,7 @@ var AuthService = class {
 		if (!/^[0-9]{6}$/.test(normalizedCode)) throw new ArkmePluginError("phone-code-invalid", "请输入有效的短信验证码", false);
 		const session = await this.runtime.sessionStore.read() ?? await this.runtime.readPendingBindingSession();
 		if (session !== void 0) {
-			const result = numberValue$26((await this.runtime.post(this.runtime.config.authBaseUrl, "/api/v1/auth/verify-bind-phone", {
+			const result = numberValue$27((await this.runtime.post(this.runtime.config.authBaseUrl, "/api/v1/auth/verify-bind-phone", {
 				phone: normalizedPhone,
 				pre: "86",
 				code: normalizedCode,
@@ -13281,7 +13388,7 @@ var AuthService = class {
 			keep_cancel: true
 		}, void 0, [200]);
 		if (data.ok === false) throw new ArkmePluginError("phone-code-rejected", "手机号或验证码错误", false, 401);
-		const userId = numberValue$26(data.user_id);
+		const userId = numberValue$27(data.user_id);
 		const accessToken = stringValue$1(data.access_token);
 		const refreshToken = stringValue$1(data.refresh_token);
 		if (userId <= 0 || accessToken === "" || refreshToken === "") throw new ArkmePluginError("login-contract-invalid", "Arkme手机号登录响应不完整", false, 502);
@@ -13541,6 +13648,194 @@ var ArkmePrivacyVisibilityService = class {
 		return immutable;
 	}
 };
+const UPDATED_OUTCOME = 1;
+const IDEMPOTENT_OUTCOME = 2;
+const MAX_BATCH_SIZE = 200;
+const MAX_QUERY_REFS = 1e3;
+const MAX_ENTITY_UID_BYTES = 128;
+/** HTTP/CAS adapter. Only revision hints are cached; owner snapshots stay server-owned. */
+var ConversationListPreferenceService = class {
+	runtime;
+	revisionOwnerUserId;
+	revisionHints = /* @__PURE__ */ new Map();
+	constructor(runtime) {
+		this.runtime = runtime;
+	}
+	async query(refs, operation) {
+		const normalized = normalizeRefs(refs);
+		if (normalized.length === 0) return [];
+		const session = await this.requireOwnerSession(operation.ownerUserId);
+		return await this.queryWithSession(normalized, session, operation.signal);
+	}
+	async dismiss(rawRef, rawEvidence, operation) {
+		const ref = normalizeRef(rawRef);
+		const evidence = normalizeEvidence(rawEvidence);
+		if (evidence.sequence === 0 && evidence.activityAtMillis === 0) throw new ArkmePluginError("conversation-list-preference-evidence-unavailable", "当前会话活动信息不完整，请刷新后重试", true, 409);
+		if (ref.entityKind === 2 && evidence.sequence !== 0) throw new ArkmePluginError("conversation-list-preference-evidence-invalid", "Bot 会话活动信息无效，请刷新后重试", false, 400);
+		const session = await this.requireOwnerSession(operation.ownerUserId);
+		const key = conversationListPreferenceRefKey(ref);
+		const expectedRevision = this.revisionHints.get(key) ?? (await this.queryWithSession([ref], session, operation.signal))[0].revision;
+		const result = (await this.set([{
+			ref,
+			expectedRevision,
+			targetVisibilityState: 2,
+			evidence
+		}], session, operation.signal))[0];
+		if (result.outcome !== UPDATED_OUTCOME && result.outcome !== IDEMPOTENT_OUTCOME || result.snapshot.visibilityState !== 2 || !conversationListPreferenceIsDismissed(result.snapshot, evidence)) throw new ArkmePluginError("conversation-list-preference-conflict", "会话状态已变化，已保留在列表中", false, 409);
+		return result.snapshot;
+	}
+	async restore(refs, operation) {
+		const normalized = normalizeRefs(refs);
+		if (normalized.length === 0) return;
+		const session = await this.requireOwnerSession(operation.ownerUserId);
+		const writes = (await this.queryWithSession(normalized, session, operation.signal)).filter((snapshot) => snapshot.visibilityState === 2).map((snapshot) => ({
+			ref: snapshot.ref,
+			expectedRevision: snapshot.revision,
+			targetVisibilityState: 1,
+			evidence: {
+				sequence: 0,
+				activityAtMillis: 0
+			}
+		}));
+		for (let offset = 0; offset < writes.length; offset += MAX_BATCH_SIZE) await this.set(writes.slice(offset, offset + MAX_BATCH_SIZE), session, operation.signal);
+	}
+	async restoreIfUnchanged(snapshots, operation) {
+		if (snapshots.length === 0) return;
+		const session = await this.requireOwnerSession(operation.ownerUserId);
+		const writes = snapshots.map((snapshot) => {
+			if (snapshot.visibilityState !== 2 || !Number.isSafeInteger(snapshot.revision) || snapshot.revision <= 0) throw contractError$1("restore-snapshot");
+			return {
+				ref: normalizeRef(snapshot.ref),
+				expectedRevision: snapshot.revision,
+				targetVisibilityState: 1,
+				evidence: {
+					sequence: 0,
+					activityAtMillis: 0
+				}
+			};
+		});
+		for (let offset = 0; offset < writes.length; offset += MAX_BATCH_SIZE) await this.set(writes.slice(offset, offset + MAX_BATCH_SIZE), session, operation.signal);
+	}
+	async queryWithSession(refs, session, signal) {
+		const snapshots = [];
+		for (let offset = 0; offset < refs.length; offset += MAX_BATCH_SIZE) {
+			const chunk = refs.slice(offset, offset + MAX_BATCH_SIZE);
+			const items = requiredList((await this.runtime.authenticatedChatPost("/api/v1/conversation-list/preferences/query", { entry_refs: chunk.map(refBody) }, session, signal)).items, "query-items");
+			if (items.length !== chunk.length) throw contractError$1("query-shape");
+			items.forEach((value, index) => {
+				const snapshot = parseSnapshot(objectValue$1(value));
+				if (!sameRef(snapshot.ref, chunk[index])) throw contractError$1("query-identity");
+				snapshots.push(snapshot);
+			});
+		}
+		this.rememberRevisions(snapshots, session.userId);
+		return snapshots;
+	}
+	async set(writes, session, signal) {
+		if (writes.length === 0 || writes.length > MAX_BATCH_SIZE) throw contractError$1("set-batch");
+		const items = requiredList((await this.runtime.authenticatedChatPost("/api/v1/conversation-list/preferences/set", { items: writes.map((write) => ({
+			...refBody(write.ref),
+			target_visibility_state: write.targetVisibilityState,
+			expected_revision: write.expectedRevision,
+			observed_seq: write.evidence.sequence,
+			observed_activity_at: write.evidence.activityAtMillis
+		})) }, session, signal)).items, "set-items");
+		if (items.length !== writes.length) throw contractError$1("set-shape");
+		const results = items.map((value, index) => {
+			const raw = objectValue$1(value);
+			const outcome = requiredInteger$1(raw.outcome, "outcome");
+			const snapshot = parseSnapshot(raw);
+			if (outcome < 1 || outcome > 3) throw contractError$1("outcome");
+			if (!sameRef(snapshot.ref, writes[index].ref)) throw contractError$1("set-identity");
+			return {
+				outcome,
+				snapshot
+			};
+		});
+		this.rememberRevisions(results.map((result) => result.snapshot), session.userId);
+		return results;
+	}
+	async requireOwnerSession(ownerUserId) {
+		const session = await this.runtime.requireSession();
+		if (!Number.isSafeInteger(ownerUserId) || ownerUserId <= 0 || session.userId !== ownerUserId) throw new ArkmePluginError("login-context-changed", "登录账号已切换，请重试当前操作", false, 409);
+		if (this.revisionOwnerUserId !== ownerUserId) {
+			this.revisionOwnerUserId = ownerUserId;
+			this.revisionHints.clear();
+		}
+		return session;
+	}
+	rememberRevisions(snapshots, ownerUserId) {
+		if (this.revisionOwnerUserId !== ownerUserId) return;
+		for (const snapshot of snapshots) {
+			const key = conversationListPreferenceRefKey(snapshot.ref);
+			this.revisionHints.set(key, Math.max(this.revisionHints.get(key) ?? 0, snapshot.revision));
+		}
+	}
+};
+function conversationListPreferenceIsDismissed(snapshot, evidence) {
+	return snapshot.visibilityState === 2 && evidence.sequence <= snapshot.dismissedThroughSequence && evidence.activityAtMillis <= snapshot.dismissedThroughActivityAtMillis;
+}
+function conversationListPreferenceRefKey(ref) {
+	return `${String(ref.entityKind)}:${ref.entityUid}`;
+}
+function parseSnapshot(raw) {
+	const ref = normalizeRef({
+		entityKind: requiredInteger$1(raw.entity_kind, "entity-kind"),
+		entityUid: stringValue$1(raw.entity_uid)
+	});
+	const visibilityState = requiredInteger$1(raw.visibility_state, "visibility-state");
+	if (visibilityState !== 1 && visibilityState !== 2) throw contractError$1("visibility-state");
+	const snapshot = {
+		ref,
+		visibilityState,
+		dismissedThroughSequence: requiredInteger$1(raw.dismissed_through_seq, "dismissed-sequence"),
+		dismissedThroughActivityAtMillis: requiredInteger$1(raw.dismissed_through_activity_at, "dismissed-activity"),
+		revision: requiredInteger$1(raw.revision, "revision"),
+		updatedAtMillis: requiredInteger$1(raw.updated_at, "updated-at")
+	};
+	if (snapshot.visibilityState === 1 && (snapshot.dismissedThroughSequence !== 0 || snapshot.dismissedThroughActivityAtMillis !== 0)) throw contractError$1("visible-anchor");
+	if (snapshot.visibilityState === 2 && snapshot.dismissedThroughSequence === 0 && snapshot.dismissedThroughActivityAtMillis === 0) throw contractError$1("dismissed-anchor");
+	if (snapshot.ref.entityKind === 2 && snapshot.dismissedThroughSequence !== 0) throw contractError$1("bot-sequence");
+	if (snapshot.revision === 0 !== (snapshot.updatedAtMillis === 0) || snapshot.visibilityState === 2 && snapshot.revision === 0) throw contractError$1("revision");
+	return snapshot;
+}
+function normalizeRefs(refs) {
+	if (refs.length > MAX_QUERY_REFS) throw contractError$1("query-too-large");
+	const unique = /* @__PURE__ */ new Map();
+	for (const value of refs) {
+		const ref = normalizeRef(value);
+		unique.set(conversationListPreferenceRefKey(ref), ref);
+	}
+	return [...unique.values()];
+}
+function normalizeRef(ref) {
+	if (ref.entityKind !== 1 && ref.entityKind !== 2 || ref.entityUid === "" || ref.entityUid !== ref.entityUid.trim() || Buffer.byteLength(ref.entityUid, "utf8") > MAX_ENTITY_UID_BYTES) throw contractError$1("identity");
+	return { ...ref };
+}
+function normalizeEvidence(evidence) {
+	if (!Number.isSafeInteger(evidence.sequence) || evidence.sequence < 0 || !Number.isSafeInteger(evidence.activityAtMillis) || evidence.activityAtMillis < 0) throw contractError$1("evidence");
+	return { ...evidence };
+}
+function refBody(ref) {
+	return {
+		entity_kind: ref.entityKind,
+		entity_uid: ref.entityUid
+	};
+}
+function sameRef(left, right) {
+	return left.entityKind === right.entityKind && left.entityUid === right.entityUid;
+}
+function requiredList(value, field) {
+	if (!Array.isArray(value)) throw contractError$1(field);
+	return value;
+}
+function requiredInteger$1(value, field) {
+	if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) throw contractError$1(field);
+	return value;
+}
+function contractError$1(field) {
+	return new ArkmePluginError(`conversation-list-preference-${field}-invalid`, "会话列表偏好响应不完整，请刷新后重试", true, 502);
+}
 //#endregion
 //#region src/mention-metadata.ts
 function listValue$24(value) {
@@ -13862,7 +14157,7 @@ const GROUP_AVATAR_NEGATIVE_CACHE_TTL_MS = 6e4;
 const TOPIC_DISSOLVE_RECORD_CONCURRENCY = 6;
 const PRIVATE_REMARK_PAGE_LIMIT = 50;
 const PRIVATE_REMARK_MAX_PAGES = 20;
-function numberValue$25(value) {
+function numberValue$26(value) {
 	return typeof value === "number" && Number.isFinite(value) ? value : 0;
 }
 function integerIdentifierValue(value) {
@@ -13908,15 +14203,20 @@ function arkmeGroupBotBindingBody(source) {
 	if (target?.subjectUid !== void 0 && target.subjectUid.trim() !== "") return { subject_uid: target.subjectUid.trim() };
 	return { subject_uid: source.ownerRef };
 }
-function arkmeChatSidebarTargetFromBundle(bundle, fallbackSubjectUid = "") {
+function arkmeChatDirectoryMetadataFromBundle(bundle, fallbackSubjectUid = "") {
 	const chatSession = objectValue$1(bundle.session);
+	const unread = objectValue$1(bundle.unread_snapshot);
 	const subjectUid = stringValue$1(bundle.subject_uid ?? bundle.subjectUid ?? bundle.topic_uid ?? bundle.topicUid ?? chatSession.subject_uid ?? chatSession.subjectUid ?? chatSession.topic_uid ?? chatSession.topicUid ?? fallbackSubjectUid).trim();
-	if (subjectUid === "") return void 0;
 	return {
-		subjectUid,
-		hiddenAnchorTimestamp: Math.max(0, numberValue$25(bundle.sort_active_at ?? bundle.last_active_at ?? chatSession.last_active_at))
+		...subjectUid === "" ? {} : { subjectUid },
+		activityAtMillis: arkmeChatSortActiveAt(bundle, chatSession),
+		latestSequence: Math.max(0, numberValue$26(unread.session_last_seq ?? chatSession.last_seq))
 	};
 }
+function arkmeChatSortActiveAt(bundle, chatSession) {
+	const projected = numberValue$26(bundle.sort_active_at);
+	return Math.max(0, projected > 0 ? projected : numberValue$26(bundle.last_active_at ?? chatSession.last_active_at));
+}
 function backendBooleanValue(value) {
 	if (value === null || value === void 0) return void 0;
 	if (typeof value === "boolean") return value;
@@ -14160,9 +14460,17 @@ var SourceService = class {
 	* the resolved label into their own viewer-bound response.
 	*/
 	async privateDisplayNamesByUserIds(userIds, options = {}) {
+		const labels = await this.privateChatViewerLabelsByUserIds(userIds, options);
+		return new Map([...labels].map(([userId, label]) => [userId, label.displayName]));
+	}
+	/**
+	* Resolve the current viewer's private-chat display label and its exact
+	* remark source without compressing fallback snapshots into remark facts.
+	*/
+	async privateChatViewerLabelsByUserIds(userIds, options = {}) {
 		const session = await this.runtime.requireSession();
 		const remaining = new Set(userIds.filter((userId) => Number.isSafeInteger(userId) && userId > 0 && userId !== session.userId));
-		const displayNames = /* @__PURE__ */ new Map();
+		const labels = /* @__PURE__ */ new Map();
 		let pageCursor;
 		for (let page = 0; page < 20 && remaining.size > 0; page += 1) {
 			const data = await this.runtime.authenticatedChatPost("/api/v1/chats/list", {
@@ -14170,18 +14478,22 @@ var SourceService = class {
 				...pageCursor === void 0 ? {} : { page_cursor: pageCursor }
 			}, session, options.signal, {
 				lane: "background-read",
-				key: `world-author-labels:${pageCursor === void 0 ? "first" : String(page)}`
+				key: `private-chat-viewer-labels:${pageCursor === void 0 ? "first" : String(page)}`
 			});
 			for (const raw of listValue$23(data.items)) {
 				const bundle = objectValue$1(raw);
-				const sessionKind = numberValue$25(objectValue$1(bundle.session).session_kind);
+				const sessionKind = numberValue$26(objectValue$1(bundle.session).session_kind);
 				if (sessionKind !== 1 && sessionKind !== 3) continue;
-				const targetUserId = numberValue$25(objectValue$1(bundle.private_counterpart).user_id);
+				const targetUserId = numberValue$26(objectValue$1(bundle.private_counterpart).user_id);
 				if (!remaining.has(targetUserId)) continue;
 				const supplement = objectValue$1(bundle.private_supplement);
 				const counterpart = objectValue$1(bundle.private_counterpart);
-				const displayName = stringValue$1(supplement.remark).trim() || stringValue$1(supplement.counterpart_name_snapshot).trim() || stringValue$1(counterpart.display_name_snapshot).trim() || stringValue$1(supplement.pending_name).trim() || stringValue$1(counterpart.visible_phone).trim();
-				if (displayName !== "") displayNames.set(targetUserId, displayName);
+				const remark = stringValue$1(supplement.remark).trim();
+				const displayName = remark || stringValue$1(supplement.counterpart_name_snapshot).trim() || stringValue$1(counterpart.display_name_snapshot).trim() || stringValue$1(supplement.pending_name).trim() || stringValue$1(counterpart.visible_phone).trim();
+				if (displayName !== "") labels.set(targetUserId, {
+					displayName,
+					remark
+				});
 				remaining.delete(targetUserId);
 			}
 			if (data.has_more !== true) break;
@@ -14189,7 +14501,7 @@ var SourceService = class {
 			if (Object.keys(next).length === 0) break;
 			pageCursor = next;
 		}
-		return displayNames;
+		return labels;
 	}
 	/**
 	* Resolve only viewer-owned contact remarks for the supplied people.
@@ -14237,7 +14549,7 @@ var SourceService = class {
 			});
 			for (const value of listValue$23(data.items)) {
 				const bundle = objectValue$1(value);
-				const sessionKind = numberValue$25(objectValue$1(bundle.session).session_kind);
+				const sessionKind = numberValue$26(objectValue$1(bundle.session).session_kind);
 				if (sessionKind !== 1 && sessionKind !== 3) continue;
 				const targetUserId = integerIdentifierValue(objectValue$1(bundle.private_counterpart).user_id);
 				if (!remaining.has(targetUserId)) continue;
@@ -14280,10 +14592,10 @@ var SourceService = class {
 			extra: { source: "dsh-arkme" }
 		}, session);
 		const topicUid = stringValue$1(created.topic_uid).trim();
-		if (topicUid === "" || numberValue$25(created.status) !== 1) throw new ArkmePluginError("topic-create-contract-invalid", "主题创建响应不完整", true, 502);
+		if (topicUid === "" || numberValue$26(created.status) !== 1) throw new ArkmePluginError("topic-create-contract-invalid", "主题创建响应不完整", true, 502);
 		const sourceRef = await this.sealSourceRef(session.userId, "topic", topicUid, title);
 		if (parentTopicUid !== void 0) try {
-			if (numberValue$25(objectValue$1((await this.runtime.authenticatedPost("/api/v1/topics/hierarchy/bind", {
+			if (numberValue$26(objectValue$1((await this.runtime.authenticatedPost("/api/v1/topics/hierarchy/bind", {
 				parent_topic_uid: parentTopicUid,
 				child_topic_uid: topicUid
 			}, session)).relation).status) !== 1) throw new ArkmePluginError("topic-hierarchy-bind-contract-invalid", "子主题层级响应不完整", true, 502);
@@ -14459,7 +14771,7 @@ var SourceService = class {
 			}
 			onProgress?.(recordUids.size);
 			if (data.has_more !== true) return [...recordUids];
-			const nextSendAt = numberValue$25(data.next_cursor_send_at);
+			const nextSendAt = numberValue$26(data.next_cursor_send_at);
 			const nextRecordUid = stringValue$1(data.next_cursor_record_uid).trim();
 			const cursorKey = `${String(nextSendAt)}:${nextRecordUid}`;
 			if (nextSendAt <= 0 || nextRecordUid === "" || seenCursors.has(cursorKey)) throw new ArkmePluginError("topic-dissolve-record-page-invalid", "主题快记加载不完整，未解散主题，请刷新后重试", true, 502);
@@ -14542,7 +14854,7 @@ var SourceService = class {
 			parent_topic_uid: nextParentTopicUid ?? "",
 			insert_before_topic_uid: ""
 		}, session);
-		return stringValue$1(moved.topic_uid).trim() === topicUid && stringValue$1(moved.parent_topic_uid).trim() === (nextParentTopicUid ?? "") && numberValue$25(moved.sibling_order) > 0;
+		return stringValue$1(moved.topic_uid).trim() === topicUid && stringValue$1(moved.parent_topic_uid).trim() === (nextParentTopicUid ?? "") && numberValue$26(moved.sibling_order) > 0;
 	}
 	async rollbackDissolvedTopicChildren(children, topicUid, parentTopicUid, session) {
 		for (const child of [...children].reverse()) await this.moveTopicHierarchyForDissolve(child.topic.ownerRef, parentTopicUid ?? "", topicUid, session).catch(() => false);
@@ -14571,7 +14883,7 @@ var SourceService = class {
 		}, session);
 		const movedTopicUid = stringValue$1(moved.topic_uid).trim();
 		const movedParentUid = stringValue$1(moved.parent_topic_uid).trim();
-		const siblingOrder = numberValue$25(moved.sibling_order);
+		const siblingOrder = numberValue$26(moved.sibling_order);
 		if (movedTopicUid !== topic.ownerRef || movedParentUid !== (nextParentUid ?? "") || siblingOrder <= 0) throw new ArkmePluginError("topic-hierarchy-move-contract-invalid", "主题移动响应不完整，请刷新后重试", true, 502);
 		this.sourceListCache.clear();
 		return {
@@ -14610,36 +14922,27 @@ var SourceService = class {
 			if (this.sourceListInFlight.get(cacheKey) === pending) this.sourceListInFlight.delete(cacheKey);
 		}
 	}
-	async setChatDirectoryPolicy(sourceRef, options = {}) {
+	async setChatDirectoryPin(sourceRef, pinned, signal) {
 		const session = await this.runtime.requireSession();
 		const source = await this.openSourceRef(sourceRef, session.userId);
 		if (source.kind !== "private_chat" && source.kind !== "group_chat") throw new ArkmePluginError("chat-directory-policy-invalid", "仅支持更新私聊或群聊的会话列表状态", false);
-		const sidebarTarget = await this.resolveChatSidebarTarget(source, session, options.signal);
-		const current = await this.runtime.authenticatedChatPost("/api/v1/chats/policy/get", { chat_session_uid: source.ownerRef }, session, options.signal);
-		const pinned = options.pinned ?? numberValue$25(current.pin_state) === 2;
-		const hidden = options.hidden ?? numberValue$25(current.show_in_home_state) === 2;
+		const pinTarget = await this.resolveChatPinTarget(source, session, signal);
+		const current = await this.runtime.authenticatedChatPost("/api/v1/chats/policy/get", { chat_session_uid: source.ownerRef }, session, signal);
 		const updatedAt = Date.now();
-		const writes = [this.runtime.authenticatedChatPost("/api/v1/chats/policy/update", {
+		await Promise.all([this.runtime.authenticatedChatPost("/api/v1/chats/policy/update", {
 			chat_session_uid: source.ownerRef,
-			show_in_home_state: hidden ? 2 : 1,
-			privacy_state: numberValue$25(current.privacy_state) || 1,
-			mute_state: numberValue$25(current.mute_state) || 1,
+			show_in_home_state: numberValue$26(current.show_in_home_state) || 1,
+			privacy_state: numberValue$26(current.privacy_state) || 1,
+			mute_state: numberValue$26(current.mute_state) || 1,
 			pin_state: pinned ? 2 : 1,
-			notify_state: numberValue$25(current.notify_state) || 1,
-			status: numberValue$25(current.status) || 1,
+			notify_state: numberValue$26(current.notify_state) || 1,
+			status: numberValue$26(current.status) || 1,
 			update_at: updatedAt
-		}, session, options.signal)];
-		if (options.hidden !== void 0) writes.push(this.runtime.authenticatedSubjectPost("/api/v1/subject/batch-set-sidebar-hidden-status", { items: [{
-			subject_uid: sidebarTarget.subjectUid,
-			hidden,
-			hidden_anchor_timestamp: hidden ? Math.max(1, sidebarTarget.hiddenAnchorTimestamp || updatedAt) : 0
-		}] }, session, options.signal));
-		if (options.pinned !== void 0) writes.push(this.runtime.authenticatedPost("/api/v1/topics/pin/set", {
-			topic_uid: sidebarTarget.subjectUid,
+		}, session, signal), this.runtime.authenticatedPost("/api/v1/topics/pin/set", {
+			topic_uid: pinTarget.subjectUid,
 			pin_state: pinned ? 1 : 2,
 			...pinned ? { pinned_at: updatedAt } : {}
-		}, session, options.signal));
-		await Promise.all(writes);
+		}, session, signal)]);
 		const cacheKey = `${String(session.userId)}:${source.ownerRef}`;
 		const cached = this.chatSourceCache.get(cacheKey);
 		if (cached !== void 0) this.storeChatSourceByKey(cacheKey, {
@@ -14649,22 +14952,54 @@ var SourceService = class {
 		this.sourceListCache.clear();
 		return {
 			sourceRef,
-			pinned,
-			hidden
+			pinned
 		};
 	}
-	async resolveChatSidebarTarget(source, session, signal) {
-		if (source.sidebarSubjectUid !== void 0 && source.sidebarSubjectUid.trim() !== "") return {
-			subjectUid: source.sidebarSubjectUid.trim(),
-			hiddenAnchorTimestamp: Math.max(0, source.sidebarHiddenAnchorTimestamp ?? 0)
+	async chatConversationListPreferenceEntry(sourceRef, signal) {
+		const session = await this.runtime.requireSession();
+		const source = await this.openSourceRef(sourceRef, session.userId);
+		if (source.kind !== "private_chat" && source.kind !== "group_chat") throw new ArkmePluginError("chat-directory-policy-invalid", "仅支持读取私聊或群聊的会话列表状态", false);
+		if (signal?.aborted === true) throw new DOMException("The operation was aborted", "AbortError");
+		const cached = this.chatSourceCache.get(`${String(session.userId)}:${source.ownerRef}`);
+		return {
+			ownerUserId: session.userId,
+			ref: {
+				entityKind: 1,
+				entityUid: source.ownerRef
+			},
+			evidence: {
+				sequence: Math.max(source.conversationListLatestSequence ?? 0, cached?.latestSequence ?? 0),
+				activityAtMillis: Math.max(source.conversationListActivityAtMillis ?? 0, cached?.activeAtMillis ?? 0)
+			}
 		};
-		const target = arkmeChatSidebarTargetFromBundle(await this.runtime.authenticatedChatPost("/api/v1/chats/detail", { chat_session_uid: source.ownerRef }, session, signal, {
+	}
+	async chatConversationListPreferenceEntryBySessionUid(chatSessionUid, expectedOwnerUserId) {
+		const session = await this.runtime.requireSession();
+		const entityUid = chatSessionUid.trim();
+		if (session.userId !== expectedOwnerUserId) throw new ArkmePluginError("login-context-changed", "登录账号已切换，请重试当前操作", false, 409);
+		if (entityUid === "") throw new ArkmePluginError("chat-directory-preference-identity-invalid", "会话列表身份无效", false, 400);
+		const cached = this.chatSourceCache.get(`${String(session.userId)}:${entityUid}`);
+		return {
+			ownerUserId: session.userId,
+			ref: {
+				entityKind: 1,
+				entityUid
+			},
+			evidence: {
+				sequence: cached?.latestSequence ?? 0,
+				activityAtMillis: cached?.activeAtMillis ?? 0
+			}
+		};
+	}
+	async resolveChatPinTarget(source, session, signal) {
+		if (source.sidebarSubjectUid !== void 0 && source.sidebarSubjectUid.trim() !== "") return { subjectUid: source.sidebarSubjectUid.trim() };
+		const target = arkmeChatDirectoryMetadataFromBundle(await this.runtime.authenticatedChatPost("/api/v1/chats/detail", { chat_session_uid: source.ownerRef }, session, signal, {
 			lane: "interactive-read",
 			key: `chat-sidebar-target:${source.ownerRef}`,
 			failureCooldownMs: 2e3
 		}), source.kind === "group_chat" ? source.ownerRef : "");
-		if (target === void 0) throw new ArkmePluginError("chat-sidebar-target-unavailable", "未能定位该会话的跨端侧边栏数据，请刷新后重试", true, 502);
-		return target;
+		if (target.subjectUid === void 0) throw new ArkmePluginError("chat-sidebar-target-unavailable", "未能定位该会话的跨端侧边栏数据，请刷新后重试", true, 502);
+		return { subjectUid: target.subjectUid };
 	}
 	async listGroupSources(options = {}) {
 		const session = await this.runtime.requireSession();
@@ -14685,7 +15020,7 @@ var SourceService = class {
 			key: "directory:groups:count",
 			failureCooldownMs: 2e3
 		});
-		return Math.max(0, numberValue$25(data.total ?? data.total_count));
+		return Math.max(0, numberValue$26(data.total ?? data.total_count));
 	}
 	async listSourcesUncached(session, directory, options, limit, sessionKind) {
 		if (directory === "send_to_self") {
@@ -14721,12 +15056,12 @@ var SourceService = class {
 			const childTopicUidsByParent = /* @__PURE__ */ new Map();
 			for (const raw of listValue$23(hierarchyData?.relations)) {
 				const relation = objectValue$1(raw);
-				if (numberValue$25(relation.rel_kind) !== 1 || numberValue$25(relation.status) !== 1) continue;
+				if (numberValue$26(relation.rel_kind) !== 1 || numberValue$26(relation.status) !== 1) continue;
 				const parentTopicUid = stringValue$1(relation.parent_topic_uid).trim();
 				const childTopicUid = stringValue$1(relation.child_topic_uid).trim();
 				if (parentTopicUid === "" || childTopicUid === "" || parentTopicUid === childTopicUid) continue;
 				parentTopicUidByChild.set(childTopicUid, parentTopicUid);
-				siblingOrderByChild.set(childTopicUid, numberValue$25(relation.sibling_order));
+				siblingOrderByChild.set(childTopicUid, numberValue$26(relation.sibling_order));
 				const children = childTopicUidsByParent.get(parentTopicUid) ?? /* @__PURE__ */ new Set();
 				children.add(childTopicUid);
 				childTopicUidsByParent.set(parentTopicUid, children);
@@ -14736,7 +15071,7 @@ var SourceService = class {
 				if (arkmePrivacyLockedTopic(item)) continue;
 				const core = objectValue$1(item.topic_core);
 				const status = core.status ?? item.status;
-				if (status !== void 0 && numberValue$25(status) !== 1) continue;
+				if (status !== void 0 && numberValue$26(status) !== 1) continue;
 				const summary = objectValue$1(item.summary);
 				const latest = objectValue$1(item.latest_record_core);
 				const parent = objectValue$1(core.parent_topic_core ?? core.parent_topic ?? item.parent_topic_core ?? item.parent_topic);
@@ -14748,12 +15083,12 @@ var SourceService = class {
 				topicDescriptors.push({
 					topicUid,
 					...parentTopicUid === "" || parentTopicUid === topicUid ? {} : { parentTopicUid },
-					siblingOrder: numberValue$25(siblingOrderByChild.get(topicUid) ?? core.sibling_order ?? item.sibling_order),
+					siblingOrder: numberValue$26(siblingOrderByChild.get(topicUid) ?? core.sibling_order ?? item.sibling_order),
 					title,
 					latestPreview: arkmeChatConversationPreview(latest),
-					latestMessageAtMillis: numberValue$25(latest.send_at ?? summary.latest_send_at),
-					activeAtMillis: numberValue$25(latest.send_at ?? summary.latest_send_at ?? core.update_at),
-					recordCount: numberValue$25(summary.record_count)
+					latestMessageAtMillis: numberValue$26(latest.send_at ?? summary.latest_send_at),
+					activeAtMillis: numberValue$26(latest.send_at ?? summary.latest_send_at ?? core.update_at),
+					recordCount: numberValue$26(summary.record_count)
 				});
 			}
 			const sourceRefByTopicUid = /* @__PURE__ */ new Map();
@@ -14795,12 +15130,12 @@ var SourceService = class {
 				unreadCount: 0
 			};
 			const nextPageCursor = objectValue$1(data.next_page_cursor ?? data.next_cursor);
-			const nextOffset = numberValue$25(data.next_offset);
+			const nextOffset = numberValue$26(data.next_offset);
 			const preferredPageCursor = Object.keys(nextPageCursor).length > 0 ? nextPageCursor : void 0;
 			const preferredOffset = preferredPageCursor === void 0 && nextOffset > 0 ? nextOffset : void 0;
 			const hasMore = data.has_more === true && (preferredPageCursor !== void 0 || preferredOffset !== void 0);
 			const totalValue = data.total ?? data.total_count;
-			const total = totalValue === void 0 ? void 0 : Math.max(0, numberValue$25(totalValue));
+			const total = totalValue === void 0 ? void 0 : Math.max(0, numberValue$26(totalValue));
 			return {
 				directory,
 				items: [
@@ -14843,9 +15178,9 @@ var SourceService = class {
 			const unread = objectValue$1(bundle.unread_snapshot);
 			const currentPolicy = objectValue$1(bundle.current_policy);
 			const attention = projectArkmeChatAttention(unread.unread_count, currentPolicy);
-			const isPinned = numberValue$25(currentPolicy.pin_state) === 2;
+			const isPinned = numberValue$26(currentPolicy.pin_state) === 2;
 			const uid = stringValue$1(chatSession.chat_session_uid).trim();
-			const sessionKind = numberValue$25(chatSession.session_kind);
+			const sessionKind = numberValue$26(chatSession.session_kind);
 			const kind = sessionKind === 2 ? "group_chat" : sessionKind === 1 || sessionKind === 3 ? "private_chat" : void 0;
 			if (uid === "" || kind === void 0) continue;
 			const displayName = (kind === "private_chat" ? stringValue$1(supplement.remark ?? supplement.counterpart_name_snapshot ?? counterpart.display_name_snapshot ?? supplement.pending_name ?? counterpart.visible_phone) : stringValue$1(chatSession.title)).trim() || "未命名会话";
@@ -14856,12 +15191,12 @@ var SourceService = class {
 			const backendMentionState = chatUnreadMentionState(unread);
 			const hasUnreadMention = kind !== "group_chat" ? void 0 : unreadCount <= 0 ? false : backendMentionState === void 0 && !latestPreviewMentionsViewer ? void 0 : backendMentionState === true || latestPreviewMentionsViewer;
 			const botGroupTarget = kind === "group_chat" ? arkmeGroupBotBindingTargetFromBundle(bundle) : void 0;
-			const sidebarTarget = arkmeChatSidebarTargetFromBundle(bundle, kind === "group_chat" ? uid : "");
 			const cached = this.chatSourceCache.get(`${String(session.userId)}:${uid}`);
+			const chatDirectoryMetadata = arkmeChatDirectoryMetadataFromBundle(bundle, kind === "group_chat" ? uid : "");
 			const item = {
 				sourceRef: await this.sealSourceRef(session.userId, kind, uid, displayName, {
 					...botGroupTarget === void 0 ? {} : { botGroupTarget },
-					...sidebarTarget === void 0 ? {} : { sidebarTarget }
+					chatDirectoryMetadata
 				}),
 				sourceKey: await this.chatDirectorySourceKey(session.userId, uid),
 				kind,
@@ -14870,16 +15205,16 @@ var SourceService = class {
 				...kind === "group_chat" && cached?.avatarRefs !== void 0 ? { avatarRefs: [...cached.avatarRefs] } : {},
 				...kind === "group_chat" && cached?.groupAvatar !== void 0 ? { groupAvatar: cloneSourceItem(cached).groupAvatar } : {},
 				...preview === "" ? {} : { latestPreview: preview },
-				activeAtMillis: numberValue$25(bundle.sort_active_at ?? chatSession.last_active_at),
+				activeAtMillis: arkmeChatSortActiveAt(bundle, chatSession),
 				...attention,
 				...hasUnreadMention === void 0 ? {} : { hasUnreadMention },
 				isPinned,
-				...numberValue$25(unread.session_last_seq ?? chatSession.last_seq) > 0 ? { latestSequence: numberValue$25(unread.session_last_seq ?? chatSession.last_seq) } : {}
+				...numberValue$26(unread.session_last_seq ?? chatSession.last_seq) > 0 ? { latestSequence: numberValue$26(unread.session_last_seq ?? chatSession.last_seq) } : {}
 			};
 			const itemIndex = items.push(item) - 1;
 			chatSessionUidByIndex.set(itemIndex, uid);
 			if (kind === "private_chat") {
-				const counterpartUserId = numberValue$25(counterpart.user_id);
+				const counterpartUserId = numberValue$26(counterpart.user_id);
 				if (Number.isSafeInteger(counterpartUserId) && counterpartUserId > 0) {
 					item.peerUserId = counterpartUserId;
 					privateUserIdByIndex.set(itemIndex, counterpartUserId);
@@ -14897,7 +15232,7 @@ var SourceService = class {
 		}
 		const hasMore = data.has_more === true;
 		const totalValue = data.total ?? data.total_count;
-		const total = totalValue === void 0 ? void 0 : Math.max(0, numberValue$25(totalValue));
+		const total = totalValue === void 0 ? void 0 : Math.max(0, numberValue$26(totalValue));
 		const nextPageCursor = objectValue$1(data.next_page_cursor);
 		return {
 			directory,
@@ -14964,11 +15299,11 @@ var SourceService = class {
 				const uid = stringValue$1(snapshot.chat_session_uid).trim();
 				const index = indexByGroupUid.get(uid);
 				if (index === void 0 || !groupUids.includes(uid)) continue;
-				const memberIds = listValue$23(snapshot.members).map((member) => numberValue$25(objectValue$1(member).user_id)).filter((userId) => Number.isSafeInteger(userId) && userId > 0).slice(0, 5);
+				const memberIds = listValue$23(snapshot.members).map((member) => numberValue$26(objectValue$1(member).user_id)).filter((userId) => Number.isSafeInteger(userId) && userId > 0).slice(0, 5);
 				const projection = {
-					memberCount: Math.max(0, Math.trunc(numberValue$25(snapshot.member_count))),
+					memberCount: Math.max(0, Math.trunc(numberValue$26(snapshot.member_count))),
 					strategy: stringValue$1(snapshot.strategy).trim(),
-					computedAtMillis: numberValue$25(snapshot.computed_at),
+					computedAtMillis: numberValue$26(snapshot.computed_at),
 					memberIds
 				};
 				snapshotsByUid.set(uid, projection);
@@ -15035,12 +15370,15 @@ var SourceService = class {
 	async chatDirectorySourceKey(userId, chatSessionUid) {
 		return `arkme-chat-source-v1.${createHmac("sha256", await this.runtime.stateStore.uniqueCode()).update(`chat-source-key-v1:${String(userId)}:${chatSessionUid.trim()}`).digest("base64url")}`;
 	}
+	async chatTimelineItemKey(userId, chatSessionUid, relationUid) {
+		return `arkme-chat-timeline-item-v1.${createHmac("sha256", await this.runtime.stateStore.uniqueCode()).update(`chat-timeline-item-key-v1:${String(userId)}:${chatSessionUid.trim()}:${relationUid.trim()}`).digest("base64url")}`;
+	}
 	async topicHierarchyKey(userId, topicUid) {
 		return `arkme-topic-hierarchy-v1.${createHmac("sha256", await this.runtime.stateStore.uniqueCode()).update(`topic-hierarchy-key-v1:${String(userId)}:${topicUid.trim()}`).digest("base64url")}`;
 	}
 	async sealSourceRef(userId, kind, ownerRef, displayName, options = {}) {
 		const botGroupTarget = kind === "group_chat" ? sanitizeGroupBotBindingTarget(options.botGroupTarget) : void 0;
-		const sidebarTarget = kind === "private_chat" || kind === "group_chat" ? options.sidebarTarget : void 0;
+		const chatDirectoryMetadata = kind === "private_chat" || kind === "group_chat" ? options.chatDirectoryMetadata : void 0;
 		const payload = encodeOpaqueJson$7({
 			version: 1,
 			userId,
@@ -15048,9 +15386,10 @@ var SourceService = class {
 			ownerRef,
 			displayName,
 			...botGroupTarget === void 0 ? {} : { botGroupTarget },
-			...sidebarTarget === void 0 ? {} : {
-				sidebarSubjectUid: sidebarTarget.subjectUid,
-				sidebarHiddenAnchorTimestamp: sidebarTarget.hiddenAnchorTimestamp
+			...chatDirectoryMetadata === void 0 ? {} : {
+				...chatDirectoryMetadata.subjectUid === void 0 ? {} : { sidebarSubjectUid: chatDirectoryMetadata.subjectUid },
+				conversationListActivityAtMillis: chatDirectoryMetadata.activityAtMillis,
+				conversationListLatestSequence: chatDirectoryMetadata.latestSequence
 			}
 		});
 		return `arkme-source-v1.${payload}.${createHmac("sha256", await this.runtime.stateStore.uniqueCode()).update(payload).digest("base64url")}`;
@@ -15071,7 +15410,7 @@ var SourceService = class {
 		const kind = parsed.kind;
 		const result = {
 			version: 1,
-			userId: numberValue$25(parsed.userId),
+			userId: numberValue$26(parsed.userId),
 			kind: isSourceKind(kind) ? kind : "default_category",
 			ownerRef: stringValue$1(parsed.ownerRef).trim(),
 			displayName: isSourceKind(kind) && kind === "default_category" ? "未分类" : stringValue$1(parsed.displayName).trim(),
@@ -15081,10 +15420,10 @@ var SourceService = class {
 			})() : {},
 			...kind === "private_chat" || kind === "group_chat" ? (() => {
 				const sidebarSubjectUid = stringValue$1(parsed.sidebarSubjectUid).trim();
-				const sidebarHiddenAnchorTimestamp = Math.max(0, numberValue$25(parsed.sidebarHiddenAnchorTimestamp));
-				return sidebarSubjectUid === "" ? {} : {
-					sidebarSubjectUid,
-					sidebarHiddenAnchorTimestamp
+				return {
+					...sidebarSubjectUid === "" ? {} : { sidebarSubjectUid },
+					conversationListActivityAtMillis: Math.max(0, numberValue$26(parsed.conversationListActivityAtMillis)),
+					conversationListLatestSequence: Math.max(0, numberValue$26(parsed.conversationListLatestSequence))
 				};
 			})() : {}
 		};
@@ -15096,16 +15435,18 @@ var SourceService = class {
 		return {
 			sourceRef: await this.sealSourceRef(source.userId, source.kind, source.ownerRef, source.displayName, {
 				...source.botGroupTarget === void 0 ? {} : { botGroupTarget: source.botGroupTarget },
-				...source.sidebarSubjectUid === void 0 ? {} : { sidebarTarget: {
-					subjectUid: source.sidebarSubjectUid,
-					hiddenAnchorTimestamp: source.sidebarHiddenAnchorTimestamp ?? 0
-				} }
+				chatDirectoryMetadata: {
+					...source.sidebarSubjectUid === void 0 ? {} : { subjectUid: source.sidebarSubjectUid },
+					activityAtMillis: source.conversationListActivityAtMillis ?? 0,
+					latestSequence: source.conversationListLatestSequence ?? 0
+				}
 			}),
 			...sourceKey === void 0 ? {} : { sourceKey },
 			kind: source.kind,
 			displayName: source.displayName,
-			activeAtMillis: 0,
-			unreadCount: 0
+			activeAtMillis: source.conversationListActivityAtMillis ?? 0,
+			unreadCount: 0,
+			...(source.conversationListLatestSequence ?? 0) > 0 ? { latestSequence: source.conversationListLatestSequence } : {}
 		};
 	}
 	async chatSourceFromBundle(bundle, session, cached, timelineItems) {
@@ -15115,25 +15456,25 @@ var SourceService = class {
 		const unread = objectValue$1(bundle.unread_snapshot);
 		const currentPolicy = objectValue$1(bundle.current_policy);
 		const attention = projectArkmeChatAttention(unread.unread_count, currentPolicy, cached?.isMuted ?? false);
-		const isPinned = numberValue$25(currentPolicy.pin_state) === 2;
+		const isPinned = numberValue$26(currentPolicy.pin_state) === 2;
 		const uid = stringValue$1(chatSession.chat_session_uid).trim();
-		const sessionKind = numberValue$25(chatSession.session_kind);
+		const sessionKind = numberValue$26(chatSession.session_kind);
 		const kind = sessionKind === 2 ? "group_chat" : sessionKind === 1 || sessionKind === 3 ? "private_chat" : void 0;
 		if (uid === "" || kind === void 0) throw new Error("invalid chat display snapshot");
 		const displayName = (kind === "private_chat" ? stringValue$1(supplement.remark ?? supplement.counterpart_name_snapshot ?? counterpart.display_name_snapshot ?? supplement.pending_name ?? counterpart.visible_phone) : stringValue$1(chatSession.title)).trim() || cached?.displayName || "未命名会话";
 		const latestItem = [...timelineItems].sort((left, right) => (right.sequence ?? 0) - (left.sequence ?? 0))[0];
 		const latestPreview = latestItem === void 0 ? cached?.latestPreview : latestItem.forwardRecords === void 0 ? arkmeTimelineConversationPreview(latestItem) : `[转发] ${latestItem.forwardRecords.title}`;
-		const latestSequence = Math.max(numberValue$25(unread.session_last_seq ?? chatSession.last_seq), latestItem?.sequence ?? 0, cached?.latestSequence ?? 0);
+		const latestSequence = Math.max(numberValue$26(unread.session_last_seq ?? chatSession.last_seq), latestItem?.sequence ?? 0, cached?.latestSequence ?? 0);
 		const unreadCount = attention.unreadCount;
 		const latestMentionsViewer = latestItem?.isMe === false && latestItem.mentionsViewer === true;
 		const backendMentionState = chatUnreadMentionState(unread);
 		const hasUnreadMention = kind !== "group_chat" ? void 0 : unreadCount <= 0 ? false : backendMentionState === void 0 && !latestMentionsViewer ? cached?.hasUnreadMention : backendMentionState === true || latestMentionsViewer;
 		const botGroupTarget = kind === "group_chat" ? arkmeGroupBotBindingTargetFromBundle(bundle) : void 0;
-		const sidebarTarget = arkmeChatSidebarTargetFromBundle(bundle, kind === "group_chat" ? uid : "");
+		const chatDirectoryMetadata = arkmeChatDirectoryMetadataFromBundle(bundle, kind === "group_chat" ? uid : "");
 		return {
 			sourceRef: await this.sealSourceRef(session.userId, kind, uid, displayName, {
 				...botGroupTarget === void 0 ? {} : { botGroupTarget },
-				...sidebarTarget === void 0 ? {} : { sidebarTarget }
+				chatDirectoryMetadata
 			}),
 			sourceKey: await this.chatDirectorySourceKey(session.userId, uid),
 			kind,
@@ -15142,7 +15483,7 @@ var SourceService = class {
 			...cached?.avatarRefs === void 0 ? {} : { avatarRefs: cached.avatarRefs },
 			...cached?.groupAvatar === void 0 ? {} : { groupAvatar: cached.groupAvatar },
 			...latestPreview === void 0 || latestPreview === "" ? {} : { latestPreview },
-			activeAtMillis: Math.max(numberValue$25(bundle.sort_active_at ?? chatSession.last_active_at), latestItem?.sendAtMillis ?? 0),
+			activeAtMillis: Math.max(arkmeChatSortActiveAt(bundle, chatSession), latestItem?.sendAtMillis ?? 0),
 			...attention,
 			...hasUnreadMention === void 0 ? {} : { hasUnreadMention },
 			isPinned,
@@ -15173,7 +15514,7 @@ var SourceService = class {
 		const value = this.decodeCursor(cursor);
 		if (value.directory !== "send_to_self") throw new ArkmePluginError("source-cursor-invalid", "发给自己的主题分页游标无效", false);
 		const pageCursor = objectValue$1(value.pageCursor);
-		const offset = numberValue$25(value.offset);
+		const offset = numberValue$26(value.offset);
 		if (Object.keys(pageCursor).length === 0 && offset <= 0) throw new ArkmePluginError("source-cursor-invalid", "发给自己的主题分页游标无效", false);
 		return {
 			...Object.keys(pageCursor).length === 0 ? {} : { pageCursor },
@@ -15191,7 +15532,7 @@ const BOT_REF_TTL_MILLIS = 30 * 6e4;
 const BOT_REF_CAP = 2e3;
 const BOT_REF_PATTERN = /^arkme-bot-v2\.[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 const BOT_IMAGE_REF_PATTERN = /^arkme-bot-image-v1\.[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-function numberValue$24(value) {
+function numberValue$25(value) {
 	return typeof value === "number" && Number.isFinite(value) ? value : 0;
 }
 function booleanValue$11(value) {
@@ -15205,7 +15546,7 @@ function arkmeNormalizeBotProvider(value) {
 	if (normalized === "openclaw" || normalized === "webhook") return normalized;
 }
 function botPrivateChatTimestamp(value) {
-	const numeric = numberValue$24(value);
+	const numeric = numberValue$25(value);
 	if (numeric <= 0) return 0;
 	if (numeric < 1e10) return numeric * 1e3;
 	let millis = numeric;
@@ -15324,7 +15665,7 @@ var BotService = class {
 	async countBots(options = {}) {
 		const session = await this.runtime.requireSession();
 		const data = await this.runtime.authenticatedBotPost("/api/v1/bot/list", { limit: 0 }, session, options.signal);
-		return Math.max(0, numberValue$24(data.total ?? data.total_count));
+		return Math.max(0, numberValue$25(data.total ?? data.total_count));
 	}
 	async createBot(input, options = {}) {
 		const name = input.name.trim();
@@ -15545,14 +15886,18 @@ var BotService = class {
 		const rawStatus = stringValue$1(raw.status).trim();
 		const status = rawStatus === "online" || rawStatus === "offline" ? rawStatus : "unknown";
 		const createdAtMillis = botPrivateChatTimestamp(raw.created_at ?? raw.createdAt);
+		const conversationListActivityAtMillis = botPrivateChatTimestamp(raw.latest_activity_at ?? raw.latestActivityAt);
+		const latestMessageAtMillis = botPrivateChatTimestamp(raw.latest_message_at ?? raw.latestMessageAt ?? raw.last_message_at ?? raw.lastMessageAt);
 		return {
-			botRef: this.sealBotRef(userId, botId, provider, target),
+			botRef: this.sealBotRef(userId, botId, provider, target, Math.max(createdAtMillis, conversationListActivityAtMillis, latestMessageAtMillis)),
 			directoryKey: await this.botDirectoryKey(userId, botId),
 			name,
 			provider,
 			description: stringValue$1(raw.description).trim(),
 			status,
 			...createdAtMillis === 0 ? {} : { createdAtMillis },
+			...conversationListActivityAtMillis === 0 ? {} : { conversationListActivityAtMillis },
+			...latestMessageAtMillis === 0 ? {} : { latestMessageAtMillis },
 			...this.botAvatarProjection(raw, userId, botId)
 		};
 	}
@@ -15584,7 +15929,7 @@ var BotService = class {
 			tokenRevealEnabled: data.token_reveal_enabled !== false,
 			gatewayUrl: stringValue$1(data.gateway_url).trim(),
 			webhookUrl: stringValue$1(data.webhook_url).trim(),
-			recordCount: Math.max(-1, Math.trunc(numberValue$24(raw.record_count))),
+			recordCount: Math.max(-1, Math.trunc(numberValue$25(raw.record_count))),
 			webhookSecurity: botWebhookSecurity(data.webhook_security ?? raw.webhook_security),
 			joinedGroups
 		};
@@ -15644,7 +15989,7 @@ var BotService = class {
 			expiresAtMillis: entry.expiresAtMillis
 		};
 	}
-	sealBotRef(userId, botId, provider, target) {
+	sealBotRef(userId, botId, provider, target, conversationListActivityAtMillis = 0) {
 		this.pruneBotRefs();
 		const key = `${String(userId)}\u0000${provider}\u0000${botId}`;
 		const existingRef = this.botRefByKey.get(key);
@@ -15653,6 +15998,7 @@ var BotService = class {
 			this.botRefs.set(existingRef, {
 				...existing,
 				...target === void 0 ? {} : { target },
+				conversationListActivityAtMillis: Math.max(existing.conversationListActivityAtMillis, conversationListActivityAtMillis),
 				expiresAtMillis: this.now() + (this.refOptions.ttlMillis ?? BOT_REF_TTL_MILLIS)
 			});
 			return existingRef;
@@ -15667,6 +16013,7 @@ var BotService = class {
 				kind: "unavailable",
 				reason: "missing"
 			},
+			conversationListActivityAtMillis: Math.max(0, conversationListActivityAtMillis),
 			key,
 			expiresAtMillis: this.now() + (this.refOptions.ttlMillis ?? BOT_REF_TTL_MILLIS)
 		});
@@ -15690,6 +16037,23 @@ var BotService = class {
 		const { expiresAtMillis: _expiresAtMillis, key: _key, ...reference } = entry;
 		return { ...reference };
 	}
+	async botConversationListPreferenceEntry(botRef) {
+		const session = await this.runtime.requireSession();
+		const bot = await this.openBotRef(botRef, session.userId);
+		if (bot.target.kind === "chat") return await this.source.chatConversationListPreferenceEntryBySessionUid(bot.target.chatSessionUid, session.userId);
+		if (bot.target.kind === "unavailable" && bot.target.reason !== "missing") throw new ArkmePluginError("bot-conversation-preference-identity-unavailable", "当前 Bot 会话归属不明确，请刷新后重试", false, 409);
+		return {
+			ownerUserId: session.userId,
+			ref: {
+				entityKind: 2,
+				entityUid: bot.botId
+			},
+			evidence: {
+				sequence: 0,
+				activityAtMillis: bot.conversationListActivityAtMillis
+			}
+		};
+	}
 	pruneBotRefs() {
 		const now = this.now();
 		for (const [ref, entry] of this.botRefs) if (entry.expiresAtMillis <= now) this.deleteBotRef(ref, entry);
@@ -15711,14 +16075,14 @@ var BotService = class {
 };
 //#endregion
 //#region src/services/bot-conversation-service.ts
-function numberValue$23(value) {
+function numberValue$24(value) {
 	return typeof value === "number" && Number.isFinite(value) ? value : 0;
 }
 function listValue$21(value) {
 	return Array.isArray(value) ? value : [];
 }
 function botConversationTimestamp(value) {
-	const numeric = numberValue$23(value);
+	const numeric = numberValue$24(value);
 	if (numeric <= 0) return 0;
 	if (numeric < 1e10) return numeric * 1e3;
 	let millis = numeric;
@@ -15736,11 +16100,11 @@ function subjectAttachments(value) {
 			kind: kind || "file",
 			fileName,
 			mimeType,
-			size: Math.max(0, Math.trunc(numberValue$23(raw.size))),
-			durationMillis: Math.max(0, Math.trunc(numberValue$23(raw.duration_ms ?? raw.durationMillis))),
-			width: Math.max(0, Math.trunc(numberValue$23(raw.width))),
-			height: Math.max(0, Math.trunc(numberValue$23(raw.height))),
-			sortOrder: Math.max(0, Math.trunc(numberValue$23(raw.order ?? raw.sort_order ?? raw.sortOrder)))
+			size: Math.max(0, Math.trunc(numberValue$24(raw.size))),
+			durationMillis: Math.max(0, Math.trunc(numberValue$24(raw.duration_ms ?? raw.durationMillis))),
+			width: Math.max(0, Math.trunc(numberValue$24(raw.width))),
+			height: Math.max(0, Math.trunc(numberValue$24(raw.height))),
+			sortOrder: Math.max(0, Math.trunc(numberValue$24(raw.order ?? raw.sort_order ?? raw.sortOrder)))
 		}];
 	});
 }
@@ -15984,7 +16348,7 @@ var BotConversationService = class {
 //#region src/services/calendar-service.ts
 const MAX_CALENDAR_RANGE_DAYS = 62;
 const MAX_DAY_RECORD_LIMIT = 50;
-function numberValue$22(value) {
+function numberValue$23(value) {
 	return typeof value === "number" && Number.isFinite(value) ? value : 0;
 }
 function booleanValue$10(value) {
@@ -16024,7 +16388,7 @@ function boundedLimit$2(value) {
 	return limit;
 }
 function contentAccessState(value) {
-	const code = Math.trunc(numberValue$22(value));
+	const code = Math.trunc(numberValue$23(value));
 	if (code === 1) return "available";
 	if (code === 2) return "protected";
 	return "unknown";
@@ -16097,7 +16461,7 @@ var CalendarService = class {
 			cacheMs: 1e4,
 			failureCooldownMs: 2e3
 		});
-		const nextSendAt = Math.trunc(numberValue$22(data.next_cursor_send_at));
+		const nextSendAt = Math.trunc(numberValue$23(data.next_cursor_send_at));
 		const nextUid = stringValue$1(data.next_cursor_record_uid).trim();
 		return {
 			scope: "self",
@@ -16116,21 +16480,21 @@ var CalendarService = class {
 		const item = objectValue$1(raw);
 		const bucketDate = stringValue$1(item.bucket_date).trim();
 		if (bucketDate === "") return void 0;
-		const protectedCount = Math.max(0, Math.trunc(numberValue$22(item.protected_count)));
-		const count = Math.max(0, Math.trunc(numberValue$22(item.count)) - protectedCount);
+		const protectedCount = Math.max(0, Math.trunc(numberValue$23(item.protected_count)));
+		const count = Math.max(0, Math.trunc(numberValue$23(item.count)) - protectedCount);
 		return {
 			bucketDate,
 			count,
 			protectedCount: 0,
 			hasRecords: count > 0,
-			...numberValue$22(item.first_send_at) > 0 ? { firstSendAtMillis: Math.trunc(numberValue$22(item.first_send_at)) } : {}
+			...numberValue$23(item.first_send_at) > 0 ? { firstSendAtMillis: Math.trunc(numberValue$23(item.first_send_at)) } : {}
 		};
 	}
 	dayRecord(raw) {
 		const item = objectValue$1(raw);
 		const core = objectValue$1(item.record_core);
 		const recordUid = stringValue$1(item.record_uid ?? core.record_uid).trim();
-		const sendAtMillis = Math.trunc(numberValue$22(item.send_at ?? core.send_at));
+		const sendAtMillis = Math.trunc(numberValue$23(item.send_at ?? core.send_at));
 		if (recordUid === "" || sendAtMillis <= 0) return void 0;
 		const accessState = contentAccessState(core.content_access_state);
 		if (accessState === "protected" || arkmePrivacyLockedRecord(item)) return void 0;
@@ -16151,9 +16515,9 @@ var CalendarService = class {
 			preview,
 			...stringValue$1(topic.title).trim() === "" ? {} : { topicTitle: stringValue$1(topic.title).trim() },
 			sourceKind: sourceKind(item),
-			creationSource: Math.trunc(numberValue$22(core.creation_source)),
-			templateKind: Math.trunc(numberValue$22(core.template_kind)),
-			displayKind: Math.trunc(numberValue$22(core.display_kind)),
+			creationSource: Math.trunc(numberValue$23(core.creation_source)),
+			templateKind: Math.trunc(numberValue$23(core.template_kind)),
+			displayKind: Math.trunc(numberValue$23(core.display_kind)),
 			protected: false,
 			...isUncategorized === void 0 ? {} : { isUncategorized },
 			...hasManualEdit === void 0 ? {} : { hasManualEdit },
@@ -16166,7 +16530,7 @@ var CalendarService = class {
 function listValue$19(value) {
 	return Array.isArray(value) ? value : [];
 }
-function numberValue$21(value) {
+function numberValue$22(value) {
 	if (typeof value === "number" && Number.isFinite(value)) return value;
 	if (typeof value === "string" && value.trim() !== "") {
 		const parsed = Number(value.trim());
@@ -16189,13 +16553,13 @@ function firstString$1(source, keys) {
 }
 function firstNumber(source, keys) {
 	for (const key of keys) {
-		const value = numberValue$21(source[key]);
+		const value = numberValue$22(source[key]);
 		if (value !== 0) return value;
 	}
 	return 0;
 }
 function epochMillis$1(value) {
-	const raw = numberValue$21(value);
+	const raw = numberValue$22(value);
 	if (raw <= 0) return 0;
 	return raw < 1e10 ? Math.trunc(raw * 1e3) : Math.trunc(raw);
 }
@@ -16207,7 +16571,7 @@ function firstEpochMillis(source, keys) {
 	return 0;
 }
 function numberList(value) {
-	return listValue$19(value).map((item) => Math.trunc(numberValue$21(item))).filter((item) => Number.isSafeInteger(item) && item > 0);
+	return listValue$19(value).map((item) => Math.trunc(numberValue$22(item))).filter((item) => Number.isSafeInteger(item) && item > 0);
 }
 function callMediaType(value) {
 	if (value === 0 || value === "0") return "audio";
@@ -16972,11 +17336,11 @@ var CallHistoryService = class {
 		}
 		const value = objectValue$1(payload);
 		const parsed = {
-			version: numberValue$21(value.version),
-			userId: numberValue$21(value.userId),
+			version: numberValue$22(value.version),
+			userId: numberValue$22(value.userId),
 			roomId: stringValue$1(value.roomId).trim(),
 			stableId: stringValue$1(value.stableId).trim(),
-			issuedAtMillis: numberValue$21(value.issuedAtMillis)
+			issuedAtMillis: numberValue$22(value.issuedAtMillis)
 		};
 		if (parsed.version !== 1 || parsed.userId !== expectedUserId || parsed.roomId === "" || parsed.stableId === "") throw new ArkmePluginError("call-ref-invalid", "通话记录引用无效，请重新查询通话记录", false, 400);
 		return parsed;
@@ -17099,6 +17463,49 @@ function decodeArkmeChatReadCursorAdvancedDataLine(line) {
 		eventAtMillis
 	};
 }
+const TIMELINE_CHANGED_ALLOWED_FIELDS = /* @__PURE__ */ new Set([
+	"t",
+	"event_uid",
+	"chat_session_uid",
+	"rel_uid",
+	"latest_seq",
+	"actor_user_id",
+	"change_kind",
+	"change_version",
+	"relation_terminal",
+	"event_at",
+	"source_client_id"
+]);
+/** Decode one metadata-only timeline invalidation. Record content remains owned by Chat reads. */
+function decodeArkmeChatTimelineChangedDataLine(line) {
+	const source = decodeDataLine(line);
+	if (source === void 0 || positiveInteger(source.t) !== 20) return void 0;
+	if (Object.keys(source).some((field) => !TIMELINE_CHANGED_ALLOWED_FIELDS.has(field))) return void 0;
+	const eventUid = nonEmptyString(source.event_uid);
+	const chatSessionUid = nonEmptyString(source.chat_session_uid);
+	const relationUid = nonEmptyString(source.rel_uid);
+	const latestSequence = positiveInteger(source.latest_seq);
+	const actorUserId = positiveInteger(source.actor_user_id);
+	const changeVersion = positiveInteger(source.change_version);
+	const relationTerminal = source.relation_terminal === void 0 ? false : typeof source.relation_terminal === "boolean" ? source.relation_terminal : void 0;
+	const eventAtMillis = positiveInteger(source.event_at);
+	const sourceClientId = source.source_client_id === void 0 ? 0 : nonNegativeInteger(source.source_client_id);
+	const changeKindValue = positiveInteger(source.change_kind);
+	const changeKind = changeKindValue === 1 ? "deleted" : changeKindValue === 2 ? "recovered" : changeKindValue === 3 ? "reedited" : changeKindValue === 4 ? "extended" : void 0;
+	if (eventUid === void 0 || chatSessionUid === void 0 || relationUid === void 0 || latestSequence === void 0 || actorUserId === void 0 || changeKind === void 0 || changeVersion === void 0 || relationTerminal === void 0 || eventAtMillis === void 0 || sourceClientId === void 0) return void 0;
+	if (relationTerminal && changeKind !== "deleted") return void 0;
+	return {
+		eventUid,
+		chatSessionUid,
+		relationUid,
+		latestSequence,
+		actorUserId,
+		changeKind,
+		changeVersion,
+		relationTerminal,
+		eventAtMillis
+	};
+}
 const PROJECTION_NAME_PATTERN = /^[a-z][a-z0-9._-]{0,63}$/;
 const PROJECTION_INVALIDATION_FORBIDDEN_FIELDS = [
 	"receiver_user_ids",
@@ -17125,6 +17532,58 @@ function decodeArkmeProjectionInvalidatedDataLine(line) {
 		eventAtMillis
 	};
 }
+const CONVERSATION_LIST_PREFERENCE_ALLOWED_ITEM_FIELDS = /* @__PURE__ */ new Set([
+	"entity_kind",
+	"entity_uid",
+	"revision"
+]);
+const CONVERSATION_LIST_PREFERENCE_FORBIDDEN_FIELDS = [
+	"visibility_state",
+	"dismissed_through_seq",
+	"dismissed_through_activity_at",
+	"chat_session_uid",
+	"pin_state",
+	"unread_count",
+	"payload",
+	"receiver_user_ids"
+];
+/** Decode a metadata-only invalidation. The Browser must query the Chat owner for current state. */
+function decodeArkmeConversationListPreferenceUpdatedDataLine(line) {
+	const source = decodeDataLine(line);
+	if (source === void 0 || positiveInteger(source.t) !== 26 || CONVERSATION_LIST_PREFERENCE_FORBIDDEN_FIELDS.some((field) => Object.hasOwn(source, field))) return void 0;
+	const eventUid = nonEmptyString(source.event_uid);
+	const userId = positiveInteger(source.user_id);
+	const acceptedAtMillis = positiveInteger(source.accepted_at);
+	const sourceClientId = source.source_client_id === void 0 ? 0 : nonNegativeInteger(source.source_client_id);
+	const rawItems = Array.isArray(source.items) ? source.items : [];
+	if (eventUid === void 0 || userId === void 0 || acceptedAtMillis === void 0 || sourceClientId === void 0 || rawItems.length === 0 || rawItems.length > 200) return void 0;
+	const seen = /* @__PURE__ */ new Set();
+	const items = [];
+	for (const value of rawItems) {
+		if (value === null || typeof value !== "object" || Array.isArray(value)) return void 0;
+		const item = value;
+		if (Object.keys(item).some((field) => !CONVERSATION_LIST_PREFERENCE_ALLOWED_ITEM_FIELDS.has(field))) return void 0;
+		const entityKind = positiveInteger(item.entity_kind);
+		const entityUid = typeof item.entity_uid === "string" && item.entity_uid !== "" && item.entity_uid.trim() === item.entity_uid ? item.entity_uid : void 0;
+		const revision = positiveInteger(item.revision);
+		if (entityKind !== 1 && entityKind !== 2 || entityUid === void 0 || revision === void 0 || Buffer.byteLength(entityUid, "utf8") > 128) return void 0;
+		const identity = `${String(entityKind)}:${String(Buffer.byteLength(entityUid, "utf8"))}:${entityUid}`;
+		if (seen.has(identity)) return void 0;
+		seen.add(identity);
+		items.push({
+			entityKind,
+			entityUid,
+			revision
+		});
+	}
+	return {
+		eventUid,
+		userId,
+		items,
+		acceptedAtMillis,
+		sourceClientId
+	};
+}
 function waitFor(milliseconds, signal) {
 	if (signal.aborted) return Promise.resolve();
 	return new Promise((resolve) => {
@@ -17404,28 +17863,36 @@ var ArkmeChatRealtimeRuntime = class {
 		}
 	}
 	acceptLine(line) {
-		const projectionInvalidation = decodeArkmeProjectionInvalidatedDataLine(line);
-		const readCursorAdvanced = projectionInvalidation === void 0 ? decodeArkmeChatReadCursorAdvancedDataLine(line) : void 0;
-		const hint = projectionInvalidation === void 0 && readCursorAdvanced === void 0 ? decodeArkmeChatReceiveDataLine(line) : void 0;
-		const eventUid = projectionInvalidation?.eventUid ?? readCursorAdvanced?.eventUid ?? hint?.eventUid;
+		const conversationListPreferenceUpdated = decodeArkmeConversationListPreferenceUpdatedDataLine(line);
+		const projectionInvalidation = conversationListPreferenceUpdated === void 0 ? decodeArkmeProjectionInvalidatedDataLine(line) : void 0;
+		const readCursorAdvanced = conversationListPreferenceUpdated === void 0 && projectionInvalidation === void 0 ? decodeArkmeChatReadCursorAdvancedDataLine(line) : void 0;
+		const timelineChanged = conversationListPreferenceUpdated === void 0 && projectionInvalidation === void 0 && readCursorAdvanced === void 0 ? decodeArkmeChatTimelineChangedDataLine(line) : void 0;
+		const hint = conversationListPreferenceUpdated === void 0 && projectionInvalidation === void 0 && readCursorAdvanced === void 0 && timelineChanged === void 0 ? decodeArkmeChatReceiveDataLine(line) : void 0;
+		const eventUid = conversationListPreferenceUpdated?.eventUid ?? projectionInvalidation?.eventUid ?? readCursorAdvanced?.eventUid ?? timelineChanged?.eventUid ?? hint?.eventUid;
 		if (eventUid === void 0 || this.seenEventUids.has(eventUid)) return;
 		this.seenEventUids.add(eventUid);
 		if (this.seenEventUids.size > MAX_SEEN_EVENTS) {
 			const oldest = this.seenEventUids.values().next().value;
 			if (oldest !== void 0) this.seenEventUids.delete(oldest);
 		}
-		this.lastEventAtMillis = projectionInvalidation?.eventAtMillis ?? readCursorAdvanced?.eventAtMillis ?? hint?.eventAtMillis;
-		if (projectionInvalidation !== void 0) this.advanceRevision("projection-invalidation", void 0, void 0, projectionInvalidation);
-		else this.advanceRevision("chat-hint", hint, readCursorAdvanced);
+		this.lastEventAtMillis = conversationListPreferenceUpdated?.acceptedAtMillis ?? projectionInvalidation?.eventAtMillis ?? readCursorAdvanced?.eventAtMillis ?? timelineChanged?.eventAtMillis ?? hint?.eventAtMillis;
+		if (conversationListPreferenceUpdated !== void 0) this.advanceRevision("conversation-list-preference-invalidation", { conversationListPreferenceUpdated });
+		else if (projectionInvalidation !== void 0) this.advanceRevision("projection-invalidation", { projectionInvalidation });
+		else if (timelineChanged !== void 0) this.advanceRevision("chat-hint", { timelineChanged });
+		else if (readCursorAdvanced !== void 0) this.advanceRevision("chat-hint", { readCursorAdvanced });
+		else if (hint !== void 0) this.advanceRevision("chat-hint", { hint });
 	}
-	advanceRevision(cause, hint, readCursorAdvanced, projectionInvalidation) {
+	advanceRevision(cause, evidence = {}) {
+		const { hint, readCursorAdvanced, projectionInvalidation, timelineChanged, conversationListPreferenceUpdated } = evidence;
 		this.revision += 1;
 		const notice = {
 			state: this.state(),
 			cause,
+			...timelineChanged === void 0 ? {} : { timelineChanged },
 			...hint === void 0 ? {} : { hint },
 			...readCursorAdvanced === void 0 ? {} : { readCursorAdvanced },
-			...projectionInvalidation === void 0 ? {} : { projectionInvalidation }
+			...projectionInvalidation === void 0 ? {} : { projectionInvalidation },
+			...conversationListPreferenceUpdated === void 0 ? {} : { conversationListPreferenceUpdated }
 		};
 		for (const listener of [...this.listeners]) listener(notice);
 	}
@@ -17435,6 +17902,9 @@ var ArkmeChatRealtimeRuntime = class {
 const MAX_PROJECTION_RETRIES = 5;
 const MAX_ATTENTION_SUMMARY_RETRIES = 5;
 const MAX_NATIVE_NOTIFICATION_DELIVERY_CONCURRENCY = 3;
+function numberValue$21(value) {
+	return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
 function listValue$18(value) {
 	return Array.isArray(value) ? value : [];
 }
@@ -17576,16 +18046,46 @@ var ChatRealtimeService = class {
 			this.invalidateRecordProjection();
 			return;
 		}
+		if (notice.cause === "conversation-list-preference-invalidation" && notice.conversationListPreferenceUpdated !== void 0) {
+			this.invalidateConversationListPreferenceForCurrentSession(notice.conversationListPreferenceUpdated.userId);
+			return;
+		}
 		if (notice.cause === "chat-hint" && notice.readCursorAdvanced !== void 0) {
 			this.handleReadCursorAdvanced(notice.readCursorAdvanced);
 			return;
 		}
+		if (notice.cause === "chat-hint" && notice.timelineChanged !== void 0) {
+			this.handleTimelineChanged(notice.timelineChanged);
+			return;
+		}
 		if (notice.cause === "chat-hint" && notice.hint !== void 0) this.scheduleChatSessionProjection(notice.hint.chatSessionUid, notice.hint.latestSequence, {
 			hint: notice.hint,
 			connectionGeneration: notice.state.connectionGeneration,
 			attempts: 0
 		});
 	}
+	async handleTimelineChanged(hint) {
+		try {
+			const session = await this.runtime.sessionStore.read();
+			if (session === void 0) return;
+			const [sourceKey, timelineItemKey] = await Promise.all([this.source.chatDirectorySourceKey(session.userId, hint.chatSessionUid), this.source.chatTimelineItemKey(session.userId, hint.chatSessionUid, hint.relationUid)]);
+			if ((await this.runtime.sessionStore.read())?.userId !== session.userId) return;
+			this.emitChatClientEvent({
+				type: "timeline-changed",
+				revision: this.nextChatClientRevision(),
+				sourceKey,
+				timelineItemKey,
+				changeKind: hint.changeKind,
+				changeVersion: hint.changeVersion,
+				relationTerminal: hint.relationTerminal,
+				throughSequence: hint.latestSequence
+			});
+			this.scheduleChatSessionProjection(hint.chatSessionUid, hint.latestSequence);
+			this.refreshAttentionSummary();
+		} catch (error) {
+			console.warn("dsh-arkme: Chat timeline invalidation failed:", safeFailureMessage$5(error));
+		}
+	}
 	async handleReadCursorAdvanced(hint) {
 		try {
 			const session = await this.runtime.sessionStore.read();
@@ -17753,6 +18253,19 @@ var ChatRealtimeService = class {
 		this.attentionSummaryFingerprint = "";
 		this.latestAttentionSummary = void 0;
 	}
+	/** Browser invalidation only; raw source/Bot caches belong to different projections. */
+	async invalidateConversationListPreferenceForCurrentSession(expectedUserId) {
+		try {
+			const session = await this.runtime.sessionStore.read();
+			if (session === void 0 || expectedUserId !== void 0 && session.userId !== expectedUserId) return;
+			this.emitChatClientEvent({
+				type: "conversation-list-preference-invalidated",
+				revision: this.nextChatClientRevision()
+			});
+		} catch (error) {
+			console.warn("dsh-arkme: Conversation-list preference invalidation failed:", safeFailureMessage$5(error));
+		}
+	}
 	async reconcileChatNotificationBaseline(connectionGeneration) {
 		try {
 			const session = await this.runtime.requireSession();
@@ -17908,7 +18421,8 @@ var ChatRealtimeService = class {
 					lane: "background-read",
 					key: `projection:tail:${uid}:${String(afterSequence)}:${String(notificationAttempt)}`
 				});
-				return [uid, await this.projectionReader.chatTimelineItems(data, session, uid)];
+				const sessionKind = numberValue$21(objectValue$1(bundles.get(uid)).session_kind ?? objectValue$1(objectValue$1(bundles.get(uid)).session).session_kind);
+				return [uid, await this.projectionReader.chatTimelineItems(data, session, uid, sessionKind === 2 ? "group_chat" : sessionKind === 1 || sessionKind === 3 ? "private_chat" : void 0)];
 			}))).forEach((result, index) => {
 				const uid = chunk[index]?.[0];
 				if (uid === void 0) return;
@@ -18050,6 +18564,54 @@ const ARKME_VOICEPRINT_ENROLLMENT_MAX_AUDIO_BYTES = 10 * 1024 * 1024;
 const ARKME_WORLD_PUBLISH_MAX_IMAGES = 27;
 const ARKME_WORLD_PUBLISH_MAX_IMAGE_BYTES = 20 * 1024 * 1024;
 //#endregion
+//#region src/hashtag.ts
+/** Flutter-compatible tag terminators. Keep this list in sync with chat_input_rich_support.dart. */
+const ARKME_HASH_TAG_TERMINATORS = /* @__PURE__ */ new Set([..." \n#＃，。！？；：、\"（）【】《》,.!?;:'()[]<>"]);
+function isHashTagAnchor(value) {
+	return value === "#" || value === "＃";
+}
+/** Normalizes either rendered tag form to the key accepted by the tag projection API. */
+function arkmeNormalizedHashTag(value) {
+	return value.trim().replace(/^[#＃]+/u, "").trim();
+}
+/** Finds all non-empty tags. An unterminated final tag is complete enough to send. */
+function arkmeHashTagRanges(text) {
+	const ranges = [];
+	let index = 0;
+	while (index < text.length) {
+		if (!isHashTagAnchor(text[index])) {
+			index += 1;
+			continue;
+		}
+		const contentStart = index + 1;
+		let contentEnd = contentStart;
+		while (contentEnd < text.length && !ARKME_HASH_TAG_TERMINATORS.has(text[contentEnd])) contentEnd += 1;
+		if (contentEnd > contentStart) ranges.push({
+			tag: text.slice(contentStart, contentEnd),
+			startIndex: index,
+			length: contentEnd - index
+		});
+		index = contentEnd > index ? contentEnd : index + 1;
+	}
+	return ranges;
+}
+function arkmeHashTagPayload(text) {
+	return arkmeHashTagRanges(text).map((item) => ({
+		tag: item.tag,
+		start_index: item.startIndex,
+		length: item.length
+	}));
+}
+function arkmeHashTagContentPayload(text) {
+	const hashTags = arkmeHashTagPayload(text);
+	return hashTags.length === 0 ? void 0 : {
+		payload_kind: 1,
+		schema_version: 1,
+		text_state: 1,
+		hash_tags: hashTags
+	};
+}
+//#endregion
 //#region src/services/record-service.ts
 function numberValue$20(value) {
 	return typeof value === "number" && Number.isFinite(value) ? value : 0;
@@ -18207,6 +18769,45 @@ var RecordService = class {
 	async refreshLatest() {
 		await Promise.all([this.summary(), this.list(50)]);
 	}
+	async listTags(limit = 100, signal) {
+		const session = await this.runtime.requireSession();
+		return { items: listValue$17((await this.runtime.authenticatedPost("/api/v1/records/tags/list", { limit: Math.max(1, Math.min(200, Math.trunc(limit))) }, session, signal)).items).flatMap((raw) => {
+			const item = objectValue$1(raw);
+			const tagText = stringValue$1(item.tag_text ?? item.tagText).trim();
+			if (tagText === "") return [];
+			return [{
+				normalizedTag: stringValue$1(item.normalized_tag ?? item.normalizedTag).trim() || tagText.toLowerCase(),
+				tagText,
+				recordCount: Math.max(0, Math.trunc(numberValue$20(item.record_count ?? item.recordCount))),
+				latestRecordUid: stringValue$1(item.latest_record_uid ?? item.latestRecordUid).trim(),
+				latestSendAtMillis: Math.max(0, Math.trunc(numberValue$20(item.latest_send_at ?? item.latestSendAtMillis)))
+			}];
+		}) };
+	}
+	/**
+	* Mirrors Flutter's post-commit tag sync. Record creation is already the
+	* commit boundary, so a projection-side failure is diagnostic only and must
+	* never turn an accepted message into a retryable send.
+	*/
+	async syncCreatedRecordTags(recordUid, textContent, expectedUserId, signal) {
+		const tags = arkmeHashTagPayload(textContent);
+		if (tags.length === 0) return;
+		try {
+			const session = await this.runtime.requireSession();
+			if (expectedUserId !== void 0 && session.userId !== expectedUserId) return;
+			await this.runtime.authenticatedPost("/api/v1/records/tags/set", {
+				record_uid: recordUid.trim(),
+				expected_record_version: 1,
+				tags: tags.map((tag) => ({
+					tag_text: tag.tag,
+					start_index: tag.start_index,
+					length: tag.length
+				}))
+			}, session, signal);
+		} catch (error) {
+			if (signal?.aborted !== true) console.warn("dsh-arkme: record tag post-commit sync failed", safeFailureMessage$4(error));
+		}
+	}
 	async refreshSnapshot() {
 		await this.refreshLatest();
 		return await this.cachedSnapshot();
@@ -18356,6 +18957,7 @@ var RecordService = class {
 			3,
 			4
 		].includes(asset.fileKind)) throw new ArkmePluginError("record-file-asset-invalid", "附件资产参数无效", false);
+		const hashTags = arkmeHashTagPayload(normalizedText);
 		const data = await this.runtime.authenticatedPost("/api/v1/records/create", {
 			record_uid: normalizedUid,
 			template_kind: 2,
@@ -18366,6 +18968,7 @@ var RecordService = class {
 				payload_kind: 2,
 				schema_version: 1,
 				text_state: normalizedText === "" ? 3 : 1,
+				...hashTags.length === 0 ? {} : { hash_tags: hashTags },
 				media_refs: assets.map((asset, index) => ({
 					file_asset_uid: asset.fileAssetUid,
 					content_file_role: 1,
@@ -18376,10 +18979,12 @@ var RecordService = class {
 			},
 			send_at: Date.now()
 		}, session);
-		return {
+		const result = {
 			recordUid: stringValue$1(data.record_uid).trim() || normalizedUid,
 			status: numberValue$20(data.status)
 		};
+		await this.syncCreatedRecordTags(result.recordUid, normalizedText, session.userId);
+		return result;
 	}
 	async createExtensionForConversation(parentRecordUid, recordUid, textContent, assets = []) {
 		const session = await this.runtime.requireSession();
@@ -18394,6 +18999,7 @@ var RecordService = class {
 			3,
 			4
 		].includes(asset.fileKind)) throw new ArkmePluginError("record-file-asset-invalid", "附件资产参数无效", false);
+		const hashTags = arkmeHashTagPayload(normalizedText);
 		const data = await this.runtime.authenticatedPost("/api/v1/records/extensions/create", {
 			parent_record_uid: normalizedParentUid,
 			record_uid: normalizedUid,
@@ -18404,6 +19010,7 @@ var RecordService = class {
 				payload_kind: assets.length === 0 ? 1 : 2,
 				schema_version: 1,
 				text_state: normalizedText === "" ? 3 : 1,
+				...hashTags.length === 0 ? {} : { hash_tags: hashTags },
 				...assets.length === 0 ? {} : { media_refs: assets.map((asset, index) => ({
 					file_asset_uid: asset.fileAssetUid,
 					content_file_role: 1,
@@ -18421,6 +19028,7 @@ var RecordService = class {
 		const createdParentUid = stringValue$1(data.parent_record_uid).trim();
 		const edgeUid = stringValue$1(data.edge_uid).trim();
 		if (createdRecordUid !== normalizedUid || createdParentUid !== normalizedParentUid || edgeUid === "") throw new ArkmePluginError("record-extension-response-invalid", "延展写入结果无效，请刷新后重试", true, 502);
+		await this.syncCreatedRecordTags(createdRecordUid, normalizedText, session.userId);
 		return {
 			recordUid: createdRecordUid,
 			status: numberValue$20(data.record_status ?? data.status),
@@ -18440,6 +19048,7 @@ var RecordService = class {
 	async sendPending(session, pending) {
 		try {
 			const captureContext = pending.captureContext === void 0 ? void 0 : arkmeRecordCaptureContextPayload(pending.captureContext);
+			const hashTags = arkmeHashTagPayload(pending.textContent);
 			const data = await this.runtime.authenticatedPost("/api/v1/records/create", {
 				record_uid: pending.recordUid,
 				template_kind: 1,
@@ -18447,12 +19056,19 @@ var RecordService = class {
 				text_content: pending.textContent,
 				...Math.max(0, Math.trunc(pending.recordDurationMillis ?? 0)) === 0 ? {} : { record_duration_millis: Math.max(0, Math.trunc(pending.recordDurationMillis ?? 0)) },
 				...captureContext === void 0 || Object.keys(captureContext).length === 0 ? {} : { capture_context: captureContext },
+				...hashTags.length === 0 ? {} : { content_payload: {
+					payload_kind: 1,
+					schema_version: 1,
+					text_state: 1,
+					hash_tags: hashTags
+				} },
 				send_at: pending.sendAtMillis
 			}, session);
 			const result = {
 				recordUid: stringValue$1(data.record_uid) || pending.recordUid,
 				status: numberValue$20(data.status)
 			};
+			await this.syncCreatedRecordTags(result.recordUid, pending.textContent, session.userId);
 			await this.runtime.stateStore.markSynced(session.userId, pending.recordUid, result.status);
 			return result;
 		} catch (error) {
@@ -18640,7 +19256,8 @@ function arkmeRichContentPayload(input, normalizedTextContent, mentionPayload) {
 	const assets = input.assets ?? [];
 	const backgroundSound = arkmeRichBackgroundSound(input.backgroundSound);
 	const mentionMetadata = mentionPayload?.mention_metadata;
-	if (assets.length === 0 && backgroundSound === void 0 && mentionMetadata === void 0) return void 0;
+	const hashTags = arkmeHashTagPayload(normalizedTextContent);
+	if (assets.length === 0 && backgroundSound === void 0 && mentionMetadata === void 0 && hashTags.length === 0) return void 0;
 	const mediaRefs = [...assets.map((asset, index) => ({
 		file_asset_uid: asset.fileAssetUid,
 		content_file_role: 1,
@@ -18661,7 +19278,8 @@ function arkmeRichContentPayload(input, normalizedTextContent, mentionPayload) {
 		text_state: normalizedTextContent === "" ? 3 : 1,
 		...mediaRefs.length === 0 ? {} : { media_refs: mediaRefs },
 		...backgroundSound === void 0 || backgroundSound.amplitudes.length === 0 ? {} : { background_sound_amplitudes: backgroundSound.amplitudes },
-		...mentionMetadata === void 0 ? {} : { mention_metadata: mentionMetadata }
+		...mentionMetadata === void 0 ? {} : { mention_metadata: mentionMetadata },
+		...hashTags.length === 0 ? {} : { hash_tags: hashTags }
 	};
 }
 const OFFICIAL_AUTHOR_USER_ID = 11;
@@ -18669,6 +19287,8 @@ const OFFICIAL_AUTHOR_FALLBACK_DISPLAY_NAME = "即我作者";
 const MAX_MESSAGE_COPY_LINK_ITEMS = 100;
 const RECORD_UID_PATTERN$1 = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 const CHAT_MEMBER_REF_PREFIX = "arkme-chat-member-v1";
+const MESSAGE_WITHDRAWAL_REF_PREFIX = "arkme-message-withdrawal-v1";
+const JOIN_RESTRICTION_CURSOR_PREFIX = "arkme-join-restriction-cursor-v1";
 const CHAT_HUMAN_MENTION_REF_PREFIX = "arkme-chat-human-mention-v1";
 function numberValue$19(value) {
 	return typeof value === "number" && Number.isFinite(value) ? value : 0;
@@ -19494,25 +20114,30 @@ function firstJoinDisplayName(source, keys) {
 	}
 	return "";
 }
+function isUsableChatMemberName(value, userId) {
+	return value !== "" && value !== "成员" && value !== "群成员" && value !== `用户 ${String(userId)}`;
+}
+function firstUsableChatMemberName(values, userId) {
+	return values.map(normalizedJoinDisplayName).find((value) => isUsableChatMemberName(value, userId)) ?? "";
+}
 function resolveChatMemberDisplayNames(input) {
-	const isUsable = (value) => value !== "" && value !== "成员" && value !== "群成员" && value !== `用户 ${String(input.userId)}`;
-	const firstUsable = (values) => values.map(normalizedJoinDisplayName).find(isUsable) ?? "";
-	const remarkName = firstUsable(input.remarkCandidates ?? []);
-	const memberName = firstUsable(input.memberNameCandidates ?? []);
-	const userName = firstUsable(input.userNameCandidates ?? []);
+	const remarkName = firstUsableChatMemberName(input.remarkCandidates ?? [], input.userId);
+	const memberName = firstUsableChatMemberName(input.memberNameCandidates ?? [], input.userId);
+	const userName = firstUsableChatMemberName(input.userNameCandidates ?? [], input.userId);
 	const displayName = [
 		remarkName,
 		memberName,
 		userName
-	].find(isUsable) ?? "群成员";
+	].find((value) => isUsableChatMemberName(value, input.userId)) ?? "群成员";
 	return {
 		displayName,
 		memberName,
+		userName,
 		secondaryName: [
 			memberName,
 			userName,
 			remarkName
-		].find((value) => isUsable(value) && value !== displayName) ?? ""
+		].find((value) => isUsableChatMemberName(value, input.userId) && value !== displayName) ?? ""
 	};
 }
 function projectChatMemberDisplayNames(item, userId, viewerLabel, publicDisplayName) {
@@ -19523,11 +20148,13 @@ function projectChatMemberDisplayNames(item, userId, viewerLabel, publicDisplayN
 		userNameCandidates: [item.display_name, publicDisplayName]
 	});
 }
-function projectChatMemberMentionDisplayName(item, userId, publicDisplayName) {
-	return resolveChatMemberDisplayNames({
-		userId,
-		userNameCandidates: [item.display_name, publicDisplayName]
-	}).displayName;
+function projectChatMemberMentionDisplayNames(names, remarkCandidates, userId) {
+	const mentionDisplayName = names.memberName || names.userName || "群成员";
+	const remarkName = firstUsableChatMemberName(remarkCandidates, userId);
+	return {
+		mentionDisplayName,
+		mentionSecondaryName: remarkName !== mentionDisplayName ? remarkName : ""
+	};
 }
 function normalizedJoinTimestamp(value) {
 	const raw = integerLikeValue(value);
@@ -20347,6 +20974,127 @@ var ChatService = class {
 			status: numberValue$19(report.status)
 		};
 	}
+	async withdrawGroupMessage(messageWithdrawalRef, options = {}) {
+		const session = await this.runtime.requireSession();
+		const normalizedMessageWithdrawalRef = messageWithdrawalRef.trim();
+		const reference = await this.openMessageWithdrawalRef(normalizedMessageWithdrawalRef, session.userId);
+		const data = await this.runtime.authenticatedChatPost("/api/v1/chats/messages/withdraw", {
+			chat_session_uid: reference.chatSessionUid,
+			rel_uid: reference.relationUid
+		}, session, options.signal);
+		const withdrawnAtMillis = numberValue$19(data.withdrawn_at);
+		if (stringValue$1(data.chat_session_uid).trim() !== reference.chatSessionUid || stringValue$1(data.rel_uid).trim() !== reference.relationUid || !Number.isSafeInteger(withdrawnAtMillis) || withdrawnAtMillis <= 0 || typeof data.already_withdrawn !== "boolean") throw new ArkmePluginError("message-withdraw-invalid-response", "撤回服务返回无效", true, 502);
+		return {
+			messageWithdrawalRef: normalizedMessageWithdrawalRef,
+			timelineItemKey: await this.source.chatTimelineItemKey(session.userId, reference.chatSessionUid, reference.relationUid),
+			withdrawnAtMillis,
+			alreadyWithdrawn: data.already_withdrawn
+		};
+	}
+	async removeGroupMember(sourceRef, memberRef, options = {}) {
+		const session = await this.runtime.requireSession();
+		const normalizedSourceRef = sourceRef.trim();
+		const normalizedMemberRef = memberRef.trim();
+		const source = await this.source.openSourceRef(normalizedSourceRef, session.userId);
+		if (source.kind !== "group_chat") throw new ArkmePluginError("group-source-invalid", "仅支持移除群聊成员", false);
+		const member = await this.openChatMemberRef(normalizedMemberRef, session.userId, source.ownerRef);
+		const data = await this.runtime.authenticatedChatPost("/api/v1/chats/members/update", {
+			chat_session_uid: source.ownerRef,
+			target_user_id: member.targetUserId,
+			action: 2,
+			prevent_rejoin: options.preventRejoin === true
+		}, session, options.signal);
+		const item = objectValue$1(data.item);
+		if (stringValue$1(data.chat_session_uid).trim() !== source.ownerRef || !Number.isSafeInteger(numberValue$19(item.user_id)) || numberValue$19(item.user_id) !== member.targetUserId || !Number.isSafeInteger(numberValue$19(item.status)) || numberValue$19(item.status) !== 3 || typeof item.join_restricted !== "boolean" || options.preventRejoin === true && item.join_restricted !== true) throw new ArkmePluginError("group-member-remove-invalid-response", "移除成员服务返回无效", true, 502);
+		return {
+			sourceRef: normalizedSourceRef,
+			memberRef: normalizedMemberRef,
+			status: "removed",
+			joinRestricted: item.join_restricted
+		};
+	}
+	async listGroupJoinRestrictions(sourceRef, options = {}) {
+		const session = await this.runtime.requireSession();
+		const normalizedSourceRef = sourceRef.trim();
+		const source = await this.source.openSourceRef(normalizedSourceRef, session.userId);
+		if (source.kind !== "group_chat") throw new ArkmePluginError("group-source-invalid", "仅支持查看群聊限制名单", false);
+		const cursor = options.cursor === void 0 ? void 0 : await this.openJoinRestrictionCursor(options.cursor, session.userId, source.ownerRef);
+		const limit = Math.min(100, Math.max(1, Math.trunc(options.limit ?? 30)));
+		const data = await this.runtime.authenticatedChatPost("/api/v1/chats/governance/join-restriction/page", {
+			chat_session_uid: source.ownerRef,
+			limit,
+			...cursor === void 0 ? {} : { cursor: {
+				updated_at: cursor.updatedAt,
+				user_id: cursor.targetUserId
+			} }
+		}, session, options.signal);
+		if (stringValue$1(data.chat_session_uid).trim() !== source.ownerRef || !Array.isArray(data.items)) throw new ArkmePluginError("join-restrictions-invalid-response", "限制名单服务返回无效", true, 502);
+		const rawItems = listValue$16(data.items).map(objectValue$1);
+		for (const raw of rawItems) {
+			const userId = numberValue$19(raw.user_id);
+			const restrictedAtMillis = numberValue$19(objectValue$1(raw.restriction).updated_at);
+			if (!Number.isSafeInteger(userId) || userId <= 0 || !Number.isSafeInteger(restrictedAtMillis) || restrictedAtMillis <= 0) throw new ArkmePluginError("join-restrictions-invalid-response", "限制名单服务返回无效", true, 502);
+		}
+		const projected = await this.projectChatMembers(source.ownerRef, rawItems, session, {
+			includeViewerLabels: true,
+			includeHumanMentionRefs: false,
+			...options.signal === void 0 ? {} : { signal: options.signal }
+		});
+		const projectedByRef = new Map(projected.map((item) => [item.memberRef, item]));
+		const items = [];
+		for (const raw of rawItems) {
+			const userId = numberValue$19(raw.user_id);
+			const memberRef = await this.sealChatMemberRef(session.userId, source.ownerRef, userId);
+			const member = projectedByRef.get(memberRef);
+			const restrictedAtMillis = numberValue$19(objectValue$1(raw.restriction).updated_at);
+			if (member === void 0) throw new ArkmePluginError("join-restrictions-invalid-response", "限制名单服务返回无效", true, 502);
+			items.push({
+				memberRef,
+				displayName: member.displayName,
+				...member.memberName === void 0 ? {} : { memberName: member.memberName },
+				...member.secondaryName === void 0 ? {} : { secondaryName: member.secondaryName },
+				...member.avatarRef === void 0 ? {} : { avatarRef: member.avatarRef },
+				restrictedAtMillis
+			});
+		}
+		const hasNextCursor = data.next_cursor !== void 0 && data.next_cursor !== null;
+		const rawNextCursor = objectValue$1(data.next_cursor);
+		const nextUpdatedAt = numberValue$19(rawNextCursor.updated_at);
+		const nextUserId = numberValue$19(rawNextCursor.user_id);
+		if (hasNextCursor && (!Number.isSafeInteger(nextUpdatedAt) || nextUpdatedAt <= 0 || !Number.isSafeInteger(nextUserId) || nextUserId <= 0)) throw new ArkmePluginError("join-restrictions-invalid-response", "限制名单服务返回无效", true, 502);
+		return {
+			sourceRef: normalizedSourceRef,
+			items,
+			...!hasNextCursor ? {} : { nextCursor: await this.sealJoinRestrictionCursor({
+				version: 1,
+				userId: session.userId,
+				chatSessionUid: source.ownerRef,
+				updatedAt: nextUpdatedAt,
+				targetUserId: nextUserId
+			}) }
+		};
+	}
+	async setGroupJoinRestriction(sourceRef, memberRef, restricted, options = {}) {
+		const session = await this.runtime.requireSession();
+		const normalizedSourceRef = sourceRef.trim();
+		const normalizedMemberRef = memberRef.trim();
+		const source = await this.source.openSourceRef(normalizedSourceRef, session.userId);
+		if (source.kind !== "group_chat") throw new ArkmePluginError("group-source-invalid", "仅支持设置群聊加入限制", false);
+		const member = await this.openChatMemberRef(normalizedMemberRef, session.userId, source.ownerRef);
+		const data = await this.runtime.authenticatedChatPost("/api/v1/chats/governance/join-restriction/set", {
+			chat_session_uid: source.ownerRef,
+			target_user_id: member.targetUserId,
+			restricted
+		}, session, options.signal);
+		const updatedAtMillis = numberValue$19(data.updated_at);
+		if (stringValue$1(data.chat_session_uid).trim() !== source.ownerRef || !Number.isSafeInteger(numberValue$19(data.user_id)) || numberValue$19(data.user_id) !== member.targetUserId || data.restricted !== restricted || !Number.isSafeInteger(updatedAtMillis) || (restricted ? updatedAtMillis <= 0 : updatedAtMillis !== 0)) throw new ArkmePluginError("join-restriction-invalid-response", "加入限制服务返回无效", true, 502);
+		return {
+			sourceRef: normalizedSourceRef,
+			memberRef: normalizedMemberRef,
+			restricted,
+			...updatedAtMillis <= 0 ? {} : { updatedAtMillis }
+		};
+	}
 	async messageReadReceiptSummaries(sourceRef, rawItems, options = {}) {
 		const session = await this.runtime.requireSession();
 		const source = await this.requireReadReceiptChatSource(sourceRef, session.userId);
@@ -20673,11 +21421,13 @@ var ChatService = class {
 			const profile = (await this.profile.refreshProfile()).profile;
 			if (profile === null) throw new ArkmePluginError("profile-unavailable", "无法读取当前 Arkme 账号资料", true);
 			const sendAtMillis = Date.now();
-			const contentPayload = assets.length === 0 ? void 0 : {
-				payload_kind: 2,
+			const hashTags = arkmeHashTagPayload(normalizedText);
+			const contentPayload = assets.length === 0 && hashTags.length === 0 ? void 0 : {
+				payload_kind: assets.length === 0 ? 1 : 2,
 				schema_version: 1,
 				text_state: normalizedText === "" ? 3 : 1,
-				media_refs: assets.map((asset, index) => ({
+				...hashTags.length === 0 ? {} : { hash_tags: hashTags },
+				...assets.length === 0 ? {} : { media_refs: assets.map((asset, index) => ({
 					file_asset_uid: asset.fileAssetUid,
 					content_file_role: 1,
 					render_role: 1,
@@ -20686,7 +21436,7 @@ var ChatService = class {
 					file_kind: asset.fileKind,
 					mime_type: asset.mimeType,
 					size: asset.size
-				}))
+				})) }
 			};
 			const data = await this.runtime.authenticatedChatPost("/api/v1/chats/extensions/children/create", {
 				chat_session_uid: reference.chatSessionUid,
@@ -20737,11 +21487,13 @@ var ChatService = class {
 			const profile = (await this.profile.refreshProfile()).profile;
 			if (profile === null) throw new ArkmePluginError("profile-unavailable", "无法读取当前 Arkme 账号资料", true);
 			const sendAtMillis = Date.now();
-			const contentPayload = assets.length === 0 ? void 0 : {
-				payload_kind: 2,
+			const hashTags = arkmeHashTagPayload(normalizedText);
+			const contentPayload = assets.length === 0 && hashTags.length === 0 ? void 0 : {
+				payload_kind: assets.length === 0 ? 1 : 2,
 				schema_version: 1,
 				text_state: normalizedText === "" ? 3 : 1,
-				media_refs: assets.map((asset, index) => ({
+				...hashTags.length === 0 ? {} : { hash_tags: hashTags },
+				...assets.length === 0 ? {} : { media_refs: assets.map((asset, index) => ({
 					file_asset_uid: asset.fileAssetUid,
 					content_file_role: 1,
 					render_role: 1,
@@ -20750,7 +21502,7 @@ var ChatService = class {
 					file_kind: asset.fileKind,
 					mime_type: asset.mimeType,
 					size: asset.size
-				}))
+				})) }
 			};
 			const data = await this.runtime.authenticatedPost("/api/v1/topics/records/extensions/create", {
 				topic_uid: source.ownerRef,
@@ -20767,6 +21519,7 @@ var ChatService = class {
 			const createdTopicUid = stringValue$1(data.topic_uid).trim();
 			const edgeUid = stringValue$1(data.edge_uid).trim();
 			if (createdRecordUid !== normalizedUid || createdParentUid !== reference.recordUid || createdTopicUid !== source.ownerRef || edgeUid === "") throw new ArkmePluginError("record-extension-response-invalid", "主题延展写入结果无效，请刷新后重试", true, 502);
+			await this.record.syncCreatedRecordTags?.(createdRecordUid, normalizedText, session.userId);
 			const relationUid = stringValue$1(data.rel_uid).trim();
 			this.source.invalidateSourceListCache(session.userId, "send_to_self");
 			this.realtime.emitChatClientEvent({
@@ -21109,6 +21862,7 @@ var ChatService = class {
 		const text = textContent.trim();
 		if (text === "" || text.length > this.runtime.config.maxTextLength) throw new ArkmePluginError("source-text-invalid", "发送内容为空或超过长度限制", false);
 		const recordUid = options.recordUid?.trim() || randomUUID();
+		const hashTagContentPayload = arkmeHashTagContentPayload(text);
 		if (source.kind === "send_to_self" || source.kind === "default_category") {
 			const sendAtMillis = Date.now();
 			const result = await this.record.createTextForConversation(recordUid, text, {
@@ -21145,8 +21899,10 @@ var ChatService = class {
 				text_content: text,
 				...Math.max(0, Math.trunc(options.recordDurationMillis ?? 0)) === 0 ? {} : { record_duration_millis: Math.max(0, Math.trunc(options.recordDurationMillis ?? 0)) },
 				...captureContext === void 0 || Object.keys(captureContext).length === 0 ? {} : { capture_context: captureContext },
+				...hashTagContentPayload === void 0 ? {} : { content_payload: hashTagContentPayload },
 				send_at: sendAtMillis
 			}, session);
+			await this.record.syncCreatedRecordTags?.(stringValue$1(result.record_uid).trim() || recordUid, text, session.userId);
 			await this.realtime.invalidateRecordProjection();
 			return await this.withSentMessageActionRef({
 				sourceRef,
@@ -21185,6 +21941,7 @@ var ChatService = class {
 				agentAuthored,
 				...options.recordDurationMillis === void 0 ? {} : { recordDurationMillis: options.recordDurationMillis },
 				...options.captureContext === void 0 ? {} : { captureContext: options.captureContext },
+				...hashTagContentPayload === void 0 ? {} : { contentPayload: hashTagContentPayload },
 				...options.signal === void 0 ? {} : { signal: options.signal }
 			});
 		} else if ((options.humanMentions?.length ?? 0) > 0) throw new ArkmePluginError("mention-group-required", "真人 mention 只能发送到群聊", false);
@@ -21196,7 +21953,7 @@ var ChatService = class {
 				...options.recordDurationMillis === void 0 ? {} : { recordDurationMillis: options.recordDurationMillis },
 				...options.captureContext === void 0 ? {} : { captureContext: options.captureContext }
 			});
-		} else sent = await this.sendChatSourceTextRaw(sourceRef, source.ownerRef, text, recordUid, relationUid, session, void 0, void 0, options.signal, {
+		} else sent = await this.sendChatSourceTextRaw(sourceRef, source.ownerRef, text, recordUid, relationUid, session, void 0, hashTagContentPayload, options.signal, {
 			agentAuthored,
 			...options.recordDurationMillis === void 0 ? {} : { recordDurationMillis: options.recordDurationMillis },
 			...options.captureContext === void 0 ? {} : { captureContext: options.captureContext }
@@ -21237,6 +21994,7 @@ var ChatService = class {
 			payload_kind: 1,
 			schema_version: 1,
 			text_state: 1,
+			...arkmeHashTagPayload(normalizedText).length === 0 ? {} : { hash_tags: arkmeHashTagPayload(normalizedText) },
 			mention_metadata: {
 				schema_version: 1,
 				source_checksum: createHash("sha256").update(JSON.stringify(checksumInput)).digest("hex"),
@@ -21376,6 +22134,7 @@ var ChatService = class {
 			payload_kind: 1,
 			schema_version: 1,
 			text_state: 1,
+			...arkmeHashTagPayload(visibleText).length === 0 ? {} : { hash_tags: arkmeHashTagPayload(visibleText) },
 			mention_metadata: {
 				schema_version: 1,
 				source_checksum: createHash("sha256").update(JSON.stringify(checksumInput)).digest("hex"),
@@ -21479,6 +22238,7 @@ var ChatService = class {
 		};
 		if (source.kind === "send_to_self" || source.kind === "default_category") {
 			const result = await this.runtime.authenticatedPost("/api/v1/records/create", commonBody, session, options.signal, { trackWriteOutcome: true });
+			await this.record.syncCreatedRecordTags?.(stringValue$1(result.record_uid).trim() || recordUid, textContent, session.userId);
 			await this.realtime.invalidateRecordProjection();
 			return await this.withSentMessageActionRef({
 				sourceRef,
@@ -21502,6 +22262,7 @@ var ChatService = class {
 				topic_uid: source.ownerRef,
 				...commonBody
 			}, session, options.signal, { trackWriteOutcome: true });
+			await this.record.syncCreatedRecordTags?.(stringValue$1(result.record_uid).trim() || recordUid, textContent, session.userId);
 			await this.realtime.invalidateRecordProjection();
 			return await this.withSentMessageActionRef({
 				sourceRef,
@@ -21765,9 +22526,10 @@ var ChatService = class {
 	async chatSourceFromBundle(bundle, session, cached, timelineItems) {
 		return await this.source.chatSourceFromBundle(bundle, session, cached, timelineItems);
 	}
-	async chatTimelineItems(data, session, chatSessionUid) {
+	async chatTimelineItems(data, session, chatSessionUid, projectedSourceKind) {
 		const items = [];
 		const signingKey = await this.runtime.stateStore.uniqueCode();
+		const sourceKind = projectedSourceKind;
 		for (const raw of listValue$16(data.items)) {
 			const item = objectValue$1(raw);
 			const relation = objectValue$1(item.relation);
@@ -21799,6 +22561,11 @@ var ChatService = class {
 			const mentionsViewer = senderUserId !== session.userId && arkmeMentionMetadataMentionsViewer(record, payload, session.userId);
 			items.push({
 				itemUid: uid,
+				...relationUid === "" ? {} : { timelineItemKey: await this.source.chatTimelineItemKey(session.userId, chatSessionUid, relationUid) },
+				...sourceKind !== "group_chat" || relationUid === "" || senderUserId === session.userId ? {} : {
+					messageRef: this.sealMessageRef(session.userId, chatSessionUid, relationUid, signingKey),
+					messageWithdrawalRef: this.sealMessageWithdrawalRef(session.userId, chatSessionUid, relationUid, signingKey)
+				},
 				...relationUid === "" ? {} : { messageActionRef: this.sealMessageActionRef(this.messageActionRefPayload({
 					sourceKind: "chat_relation",
 					userId: session.userId,
@@ -22344,14 +23111,16 @@ var ChatService = class {
 	}
 	async projectChatMembers(chatSessionUid, rawItems, session, options) {
 		const userIds = rawItems.map((item) => Math.trunc(numberValue$19(item.user_id))).filter((userId) => Number.isSafeInteger(userId) && userId > 0);
-		const [profiles, viewerLabels] = await Promise.all([this.profile.publicProfileSummariesByUserIds(userIds, session, options.signal).catch(() => /* @__PURE__ */ new Map()), options.includeViewerLabels ? this.source.privateDisplayNamesByUserIds(userIds, { ...options.signal === void 0 ? {} : { signal: options.signal } }).catch(() => /* @__PURE__ */ new Map()) : Promise.resolve(/* @__PURE__ */ new Map())]);
+		const [profiles, viewerLabels] = await Promise.all([this.profile.publicProfileSummariesByUserIds(userIds, session, options.signal).catch(() => /* @__PURE__ */ new Map()), options.includeViewerLabels ? this.source.privateChatViewerLabelsByUserIds(userIds, { ...options.signal === void 0 ? {} : { signal: options.signal } }).catch(() => /* @__PURE__ */ new Map()) : Promise.resolve(/* @__PURE__ */ new Map())]);
 		const members = [];
 		for (const item of rawItems) {
 			const userId = Math.trunc(numberValue$19(item.user_id));
 			if (!Number.isSafeInteger(userId) || userId <= 0) continue;
 			const profile = profiles.get(userId);
-			const { displayName, memberName, secondaryName } = projectChatMemberDisplayNames(item, userId, viewerLabels.get(userId), profile?.displayName);
-			const mentionDisplayName = projectChatMemberMentionDisplayName(item, userId, profile?.displayName);
+			const viewerLabel = viewerLabels.get(userId);
+			const names = projectChatMemberDisplayNames(item, userId, viewerLabel?.displayName, profile?.displayName);
+			const { displayName, memberName, secondaryName } = names;
+			const { mentionDisplayName, mentionSecondaryName } = projectChatMemberMentionDisplayNames(names, [viewerLabel?.remark, item.remark], userId);
 			const role = chatMemberRole$1(item.role);
 			const status = chatMemberStatus$1(item.status);
 			const extra = parsedObject(item.extra);
@@ -22359,7 +23128,8 @@ var ChatService = class {
 				memberRef: await this.sealChatMemberRef(session.userId, chatSessionUid, userId),
 				...options.includeHumanMentionRefs && status === "active" && userId !== session.userId ? {
 					mentionRef: await this.sealChatHumanMentionRef(session.userId, chatSessionUid, userId, mentionDisplayName),
-					mentionDisplayName
+					mentionDisplayName,
+					...mentionSecondaryName === "" ? {} : { mentionSecondaryName }
 				} : {},
 				displayName,
 				...memberName === "" ? {} : { memberName },
@@ -22420,7 +23190,11 @@ var ChatService = class {
 			const editDurationMillis = positiveNumberValue$1(payload.edit_duration_millis, record.edit_duration_millis, payload.editDurationMillis, record.editDurationMillis, payload.incr_cost_mill_sec, record.incr_cost_mill_sec, payload.incrCostMillSec, record.incrCostMillSec);
 			const itemIndex = items.push({
 				itemUid: uid,
-				...source.kind !== "group_chat" || relationUid === "" || senderUserId === session.userId ? {} : { messageRef: this.sealMessageRef(session.userId, source.ownerRef, relationUid, signingKey) },
+				...relationUid === "" ? {} : { timelineItemKey: await this.source.chatTimelineItemKey(session.userId, source.ownerRef, relationUid) },
+				...source.kind !== "group_chat" || relationUid === "" || senderUserId === session.userId ? {} : {
+					messageRef: this.sealMessageRef(session.userId, source.ownerRef, relationUid, signingKey),
+					messageWithdrawalRef: this.sealMessageWithdrawalRef(session.userId, source.ownerRef, relationUid, signingKey)
+				},
 				...relationUid === "" ? {} : { messageActionRef: this.sealMessageActionRef(this.messageActionRefPayload({
 					sourceKind: "chat_relation",
 					userId: session.userId,
@@ -22811,6 +23585,57 @@ var ChatService = class {
 		});
 		return `arkme-message-v1.${payload}.${createHmac("sha256", signingKey).update(payload).digest("base64url")}`;
 	}
+	sealMessageWithdrawalRef(userId, chatSessionUid, relationUid, signingKey) {
+		const payload = encodeOpaqueJson$6({
+			version: 1,
+			userId,
+			chatSessionUid,
+			relationUid
+		});
+		const signature = createHmac("sha256", signingKey).update(payload).digest("base64url");
+		return `${MESSAGE_WITHDRAWAL_REF_PREFIX}.${payload}.${signature}`;
+	}
+	async openMessageWithdrawalRef(messageWithdrawalRef, expectedUserId) {
+		const parsed = await this.openSignedOpaquePayload(messageWithdrawalRef, MESSAGE_WITHDRAWAL_REF_PREFIX, "message-withdrawal-ref-invalid", "消息撤回引用无效，请刷新后重试");
+		const result = {
+			version: 1,
+			userId: Math.trunc(numberValue$19(parsed.userId)),
+			chatSessionUid: stringValue$1(parsed.chatSessionUid).trim(),
+			relationUid: stringValue$1(parsed.relationUid).trim()
+		};
+		if (parsed.version !== 1 || result.userId !== expectedUserId || result.chatSessionUid === "" || result.relationUid === "") throw new ArkmePluginError("message-withdrawal-ref-invalid", "消息撤回引用与当前账号不匹配", false, 403);
+		return result;
+	}
+	async sealJoinRestrictionCursor(payload) {
+		const encoded = encodeOpaqueJson$6(payload);
+		const signature = createHmac("sha256", await this.runtime.stateStore.uniqueCode()).update(encoded).digest("base64url");
+		return `${JOIN_RESTRICTION_CURSOR_PREFIX}.${encoded}.${signature}`;
+	}
+	async openJoinRestrictionCursor(cursor, expectedUserId, expectedChatSessionUid) {
+		const parsed = await this.openSignedOpaquePayload(cursor, JOIN_RESTRICTION_CURSOR_PREFIX, "join-restriction-cursor-invalid", "限制名单游标无效，请重新打开");
+		const result = {
+			version: 1,
+			userId: Math.trunc(numberValue$19(parsed.userId)),
+			chatSessionUid: stringValue$1(parsed.chatSessionUid).trim(),
+			updatedAt: Math.trunc(numberValue$19(parsed.updatedAt)),
+			targetUserId: Math.trunc(numberValue$19(parsed.targetUserId))
+		};
+		if (parsed.version !== 1 || result.userId !== expectedUserId || result.chatSessionUid !== expectedChatSessionUid || result.updatedAt <= 0 || result.targetUserId <= 0) throw new ArkmePluginError("join-restriction-cursor-invalid", "限制名单游标与当前账号或群聊不匹配", false, 403);
+		return result;
+	}
+	async openSignedOpaquePayload(reference, prefix, code, message) {
+		const parts = reference.trim().split(".");
+		if (parts.length !== 3 || parts[0] !== prefix) throw new ArkmePluginError(code, message, false);
+		const encoded = parts[1] ?? "";
+		const supplied = Buffer.from(parts[2] ?? "", "base64url");
+		const expected = createHmac("sha256", await this.runtime.stateStore.uniqueCode()).update(encoded).digest();
+		if (supplied.length !== expected.length || !timingSafeEqual(supplied, expected)) throw new ArkmePluginError(code, message, false);
+		try {
+			return objectValue$1(decodeOpaqueJson$5(encoded));
+		} catch (error) {
+			throw new ArkmePluginError(code, message, false, 400, { cause: error });
+		}
+	}
 	async openMessageRef(messageRef, expectedUserId) {
 		const parts = messageRef.trim().split(".");
 		if (parts.length !== 3 || parts[0] !== "arkme-message-v1") throw new ArkmePluginError("message-ref-invalid", "Arkme 消息引用无效", false);
@@ -22835,6 +23660,130 @@ var ChatService = class {
 	}
 };
 //#endregion
+//#region src/services/conversation-directory-visibility-service.ts
+const MAX_DIRECTORY_VISIBILITY_REFS = 1e3;
+/** Sidebar application service; raw source and Bot APIs remain unfiltered owner projections. */
+var ConversationDirectoryVisibilityService = class {
+	preference;
+	source;
+	bot;
+	invalidation;
+	constructor(preference, source, bot, invalidation) {
+		this.preference = preference;
+		this.source = source;
+		this.bot = bot;
+		this.invalidation = invalidation;
+	}
+	async query(sourceRefs, botRefs, signal) {
+		if (sourceRefs.length + botRefs.length > MAX_DIRECTORY_VISIBILITY_REFS) throw new ArkmePluginError("conversation-directory-visibility-too-large", "会话列表状态查询数量过多", false, 400);
+		const handles = [...sourceRefs.map((entryRef) => ({
+			entryKind: "source",
+			entryRef
+		})), ...botRefs.map((entryRef) => ({
+			entryKind: "bot",
+			entryRef
+		}))];
+		const resolved = await Promise.allSettled(handles.map(async (handle) => ({
+			...handle,
+			...handle.entryKind === "source" ? await this.source.chatConversationListPreferenceEntry(handle.entryRef, signal) : await this.bot.botConversationListPreferenceEntry(handle.entryRef)
+		})));
+		const fatal = resolved.find((result) => result.status === "rejected" && isFatalResolutionError(result.reason));
+		if (fatal?.status === "rejected") throw fatal.reason;
+		const entries = resolved.flatMap((result) => result.status === "fulfilled" ? [result.value] : []);
+		if (entries.length === 0) return { items: handles.map((handle) => ({
+			...handle,
+			hidden: false
+		})) };
+		const ownerUserId = entries[0].ownerUserId;
+		if (entries.some((entry) => entry.ownerUserId !== ownerUserId)) throw new ArkmePluginError("login-context-changed", "登录账号已切换，请重试当前操作", false, 409);
+		const owner = await this.preference.query(entries.map((entry) => entry.ref), {
+			ownerUserId,
+			...signal === void 0 ? {} : { signal }
+		});
+		const snapshots = new Map(owner.map((item) => [conversationListPreferenceRefKey(item.ref), item]));
+		const evidenceByOwnerRef = /* @__PURE__ */ new Map();
+		for (const entry of entries) {
+			const key = conversationListPreferenceRefKey(entry.ref);
+			const current = evidenceByOwnerRef.get(key);
+			evidenceByOwnerRef.set(key, {
+				sequence: Math.max(current?.sequence ?? 0, entry.evidence.sequence),
+				activityAtMillis: Math.max(current?.activityAtMillis ?? 0, entry.evidence.activityAtMillis)
+			});
+		}
+		const staleSnapshots = [...evidenceByOwnerRef.entries()].flatMap(([key, evidence]) => {
+			const snapshot = snapshots.get(key);
+			const evidenceAvailable = evidence.sequence > 0 || evidence.activityAtMillis > 0;
+			return snapshot?.visibilityState === 2 && evidenceAvailable && !conversationListPreferenceIsDismissed(snapshot, evidence) ? [snapshot] : [];
+		});
+		if (staleSnapshots.length > 0) this.preference.restoreIfUnchanged(staleSnapshots, { ownerUserId }).catch(() => void 0);
+		return { items: resolved.map((result, index) => {
+			if (result.status === "rejected") return {
+				...handles[index],
+				hidden: false
+			};
+			const entry = result.value;
+			const key = conversationListPreferenceRefKey(entry.ref);
+			const snapshot = snapshots.get(key);
+			const evidence = evidenceByOwnerRef.get(key) ?? entry.evidence;
+			const hidden = (evidence.sequence > 0 || evidence.activityAtMillis > 0) && snapshot !== void 0 && conversationListPreferenceIsDismissed(snapshot, evidence);
+			return {
+				entryKind: entry.entryKind,
+				entryRef: entry.entryRef,
+				hidden
+			};
+		}) };
+	}
+	async setVisibility(entryKind, entryRef, hidden, signal) {
+		const entry = await this.resolveEntry(entryKind, entryRef, signal);
+		const operation = {
+			ownerUserId: entry.ownerUserId,
+			...signal === void 0 ? {} : { signal }
+		};
+		if (hidden) await this.preference.dismiss(entry.ref, entry.evidence, operation);
+		else await this.preference.restore([entry.ref], operation);
+		await this.invalidateBestEffort();
+	}
+	async restoreSource(source, signal) {
+		const entry = await this.source.chatConversationListPreferenceEntry(source.sourceRef, signal);
+		await this.restoreEntries([entry], signal);
+	}
+	async openBotContactConversation(botRef, options = {}) {
+		const previous = await this.bot.botConversationListPreferenceEntry(botRef).catch(() => void 0);
+		const source = await this.bot.openBotChat(botRef, options);
+		(previous === void 0 ? this.restoreSource(source) : this.restoreBotConversation(previous, source)).catch(() => void 0);
+		return source;
+	}
+	/** Restores the exact owner identities when a Bot directory entry resolves from direct Bot to Chat. */
+	async restoreBotConversation(previous, source, signal) {
+		const current = await this.source.chatConversationListPreferenceEntry(source.sourceRef, signal);
+		if (previous.ownerUserId !== current.ownerUserId) throw new ArkmePluginError("login-context-changed", "登录账号已切换，请重试当前操作", false, 409);
+		const previousIsCurrentChat = previous.ref.entityKind === 1 && previous.ref.entityUid === current.ref.entityUid;
+		if (current.ref.entityKind !== 1 || previous.ref.entityKind !== 2 && !previousIsCurrentChat) throw new ArkmePluginError("bot-conversation-preference-identity-changed", "Bot 会话归属已变化，请刷新后重试", false, 409);
+		await this.restoreEntries([previous, current], signal);
+	}
+	async restoreEntries(entries, signal) {
+		const ownerUserId = entries[0]?.ownerUserId;
+		if (ownerUserId === void 0 || entries.some((entry) => entry.ownerUserId !== ownerUserId)) throw new ArkmePluginError("login-context-changed", "登录账号已切换，请重试当前操作", false, 409);
+		await this.preference.restore(entries.map((entry) => entry.ref), {
+			ownerUserId,
+			...signal === void 0 ? {} : { signal }
+		});
+		await this.invalidateBestEffort();
+	}
+	async resolveEntry(entryKind, entryRef, signal) {
+		return entryKind === "source" ? await this.source.chatConversationListPreferenceEntry(entryRef, signal) : await this.bot.botConversationListPreferenceEntry(entryRef);
+	}
+	async invalidateBestEffort() {
+		try {
+			await this.invalidation.invalidateConversationListPreferenceForCurrentSession();
+		} catch {}
+	}
+};
+function isFatalResolutionError(error) {
+	if (error instanceof Error && error.name === "AbortError") return true;
+	return error !== null && typeof error === "object" && "code" in error && error.code === "login-context-changed";
+}
+//#endregion
 //#region src/services/contact-service.ts
 const CONTACT_REF_TTL_MS = 10 * 6e4;
 const MAX_CONTACT_REFS = 512;
@@ -52639,9 +53588,9 @@ var GroupAiPolishService = class {
 		try {
 			config = await this.queryGroupAiPolishConfig(chatSessionUid, session, options.signal);
 		} catch {
-			return await this.chat.sendChatSourceTextRaw(sourceRef, chatSessionUid, originalText, recordUid, relationUid, session, void 0, void 0, options.signal, options);
+			return await this.chat.sendChatSourceTextRaw(sourceRef, chatSessionUid, originalText, recordUid, relationUid, session, void 0, options.contentPayload, options.signal, options);
 		}
-		if (!config.enabled || config.activeRuleUid === "") return await this.chat.sendChatSourceTextRaw(sourceRef, chatSessionUid, originalText, recordUid, relationUid, session, void 0, void 0, options.signal, options);
+		if (!config.enabled || config.activeRuleUid === "") return await this.chat.sendChatSourceTextRaw(sourceRef, chatSessionUid, originalText, recordUid, relationUid, session, void 0, options.contentPayload, options.signal, options);
 		const taskUid = randomUUID();
 		let polished;
 		try {
@@ -52657,7 +53606,7 @@ var GroupAiPolishService = class {
 			}, session, options.signal);
 			polished = this.aiPolishTextResult(data);
 		} catch (error) {
-			const sent = await this.chat.sendChatSourceTextRaw(sourceRef, chatSessionUid, originalText, recordUid, relationUid, session, void 0, void 0, options.signal, options);
+			const sent = await this.chat.sendChatSourceTextRaw(sourceRef, chatSessionUid, originalText, recordUid, relationUid, session, void 0, options.contentPayload, options.signal, options);
 			return this.withFailedAiPolishRetry(sent, sourceRef, chatSessionUid, relationUid, recordUid, originalText, 1, session.userId, safeFailureMessage$2(error));
 		}
 		if (polished.state === 1 && polished.action === 1 && polished.polishedText !== "") {
@@ -52673,7 +53622,7 @@ var GroupAiPolishService = class {
 					model: polished.modelVersion,
 					prompt: polished.promptVersion,
 					...Object.keys(polished.extra).length === 0 ? {} : { extra: polished.extra }
-				}, void 0, options.signal, options),
+				}, options.contentPayload, options.signal, options),
 				aiPolish: {
 					state: "polished",
 					originalText,
@@ -52681,7 +53630,7 @@ var GroupAiPolishService = class {
 				}
 			};
 		}
-		const sent = await this.chat.sendChatSourceTextRaw(sourceRef, chatSessionUid, originalText, recordUid, relationUid, session, void 0, void 0, options.signal, options);
+		const sent = await this.chat.sendChatSourceTextRaw(sourceRef, chatSessionUid, originalText, recordUid, relationUid, session, void 0, options.contentPayload, options.signal, options);
 		if (polished.action === 2) return {
 			...sent,
 			aiPolish: {
@@ -53650,6 +54599,79 @@ var InterwovenService = class {
 	}
 };
 //#endregion
+//#region src/link-metadata.ts
+function arkmeIsGenericLinkMetadataTitle(rawTitle) {
+	const title = rawTitle?.trim() ?? "";
+	if (title === "") return true;
+	if (title === "分享链接") return true;
+	if (title === "即我" || title === "即我-对话发现自我" || title === "即我 - 对话发现自我") return true;
+	if (title === "即我-进入Ta的世界" || title === "即我 - 进入Ta的世界") return true;
+	if (title.toLowerCase().includes("this page could not be found")) return true;
+	return /^404\b/u.test(title);
+}
+function linkUrl(rawUrl) {
+	return rawUrl instanceof URL ? new URL(rawUrl.href) : new URL(rawUrl);
+}
+function arkmeExtensionShareRefFromLink(rawUrl) {
+	let url;
+	try {
+		url = linkUrl(rawUrl);
+	} catch {
+		return;
+	}
+	if (url.protocol !== "https:" || url.username !== "" || url.password !== "") return void 0;
+	const host = url.hostname.replace(/^www\./iu, "").toLowerCase();
+	if (![
+		"jiwo.cc",
+		"app.arkme.ai",
+		"app-test.arkme.ai",
+		"jotmo-app.senguo.me"
+	].includes(host)) return void 0;
+	const parts = url.pathname.split("/").filter(Boolean);
+	const shareRef = parts.length === 4 && parts[0] === "app" && parts[1] === "share" && parts[2] === "extension" ? parts[3] : void 0;
+	return shareRef !== void 0 && /^extshare_[0-9a-f]{32}$/u.test(shareRef) ? shareRef : void 0;
+}
+function arkmeKnownLinkMetadataFallback(rawUrl) {
+	try {
+		const url = linkUrl(rawUrl);
+		const host = url.hostname.replace(/^www\./iu, "").toLowerCase();
+		const parts = url.pathname.split("/").filter(Boolean);
+		if (host === "github.com") {
+			if (parts.length >= 4 && parts[2] === "pull") return {
+				url: url.href,
+				title: `Pull Request #${parts[3]} · ${parts[0]}/${parts[1]}`
+			};
+			if (parts.length >= 2) return {
+				url: url.href,
+				title: `${parts[0]}/${parts[1]}`
+			};
+		}
+		if ((host === "codeup.aliyun.com" || host.endsWith(".codeup.aliyun.com")) && parts.includes("change")) {
+			const changeIndex = parts.indexOf("change");
+			const repository = changeIndex >= 2 ? parts[changeIndex - 1] : void 0;
+			const changeNo = parts[changeIndex + 1];
+			if (repository !== void 0 && changeNo !== void 0) return {
+				url: url.href,
+				title: `${repository} · Change #${changeNo}`
+			};
+		}
+	} catch {}
+	return null;
+}
+function arkmeRequiredLinkMetadataFallback(rawUrl) {
+	const url = linkUrl(rawUrl);
+	const siteName = url.hostname.replace(/^www\./iu, "");
+	const known = arkmeKnownLinkMetadataFallback(url);
+	return known === null ? {
+		url: url.href,
+		title: "分享链接",
+		siteName
+	} : {
+		...known,
+		siteName
+	};
+}
+//#endregion
 //#region src/services/link-metadata-service.ts
 const MAX_LINK_METADATA_BYTES = 2 * 1024 * 1024;
 const LINK_METADATA_TIMEOUT_MS = 8e3;
@@ -53658,8 +54680,10 @@ const MAX_LINK_METADATA_REDIRECTS = 3;
 const MAX_LINK_TITLE_LENGTH = 300;
 const MAX_LINK_URL_LENGTH = 4096;
 const blockedAddresses = new BlockList();
+const proxySyntheticAddresses = new BlockList();
 const globalIpv6Addresses = new BlockList();
 globalIpv6Addresses.addSubnet("2000::", 3, "ipv6");
+proxySyntheticAddresses.addSubnet("198.18.0.0", 15, "ipv4");
 for (const [network, prefix] of [
 	["0.0.0.0", 8],
 	["10.0.0.0", 8],
@@ -53697,6 +54721,14 @@ function isPublicNetworkAddress(address) {
 	if (family === 6) return globalIpv6Addresses.check(address, "ipv6") && !blockedAddresses.check(address, "ipv6");
 	return false;
 }
+function isProxySyntheticNetworkAddress(address) {
+	const mapped = ipv4FromMappedIpv6(address);
+	if (mapped !== void 0) return isIP(mapped) === 4 && proxySyntheticAddresses.check(mapped, "ipv4");
+	return isIP(address) === 4 && proxySyntheticAddresses.check(address, "ipv4");
+}
+function isAllowedLinkMetadataAddress(address) {
+	return isPublicNetworkAddress(address) || isProxySyntheticNetworkAddress(address);
+}
 function safeWebUrl(raw) {
 	let url;
 	try {
@@ -53737,6 +54769,10 @@ function tagAttributes(tag) {
 	}
 	return attributes;
 }
+function preferredDocumentTitle(candidates) {
+	for (const candidate of candidates) if (candidate !== void 0 && !arkmeIsGenericLinkMetadataTitle(candidate)) return candidate;
+	return "";
+}
 function documentMetadata(url, html) {
 	const metadata = /* @__PURE__ */ new Map();
 	for (const match of html.matchAll(/<meta\b[^>]*>/giu)) {
@@ -53747,7 +54783,11 @@ function documentMetadata(url, html) {
 		if (content !== "") metadata.set(property, content);
 	}
 	const documentTitle = /<title\b[^>]*>([\s\S]*?)<\/title\s*>/iu.exec(html)?.[1];
-	const title = metadata.get("og:title") ?? metadata.get("twitter:title") ?? (documentTitle === void 0 ? "" : normalizedTitle(documentTitle));
+	const title = preferredDocumentTitle([
+		metadata.get("og:title"),
+		metadata.get("twitter:title"),
+		documentTitle === void 0 ? void 0 : normalizedTitle(documentTitle)
+	]);
 	if (title === "") return null;
 	const description = metadata.get("og:description") ?? metadata.get("description");
 	const siteName = metadata.get("og:site_name") ?? url.hostname.replace(/^www\./iu, "");
@@ -53774,8 +54814,13 @@ function missingDnsAnswer(error) {
 }
 var NodeArkmeHostAddressResolver = class {
 	resolverFactory;
-	constructor(resolverFactory = () => new Resolver()) {
+	systemLookup;
+	constructor(resolverFactory = () => new Resolver(), systemLookup = async (hostname) => await lookup(hostname, {
+		all: true,
+		verbatim: true
+	})) {
 		this.resolverFactory = resolverFactory;
+		this.systemLookup = systemLookup;
 	}
 	async lookup(hostname, options = {}) {
 		options.signal?.throwIfAborted();
@@ -53802,7 +54847,13 @@ var NodeArkmeHostAddressResolver = class {
 			}))];
 		} catch (error) {
 			options.signal?.throwIfAborted();
-			throw error;
+			try {
+				const addresses = await this.systemLookup(hostname);
+				options.signal?.throwIfAborted();
+				return addresses;
+			} catch {
+				throw error;
+			}
 		} finally {
 			options.signal?.removeEventListener("abort", abort);
 		}
@@ -53913,7 +54964,7 @@ var NodeArkmeLinkDocumentReader = class {
 		} catch (error) {
 			throw pluginError(error);
 		}
-		if (addresses.length === 0 || addresses.some((item) => !isPublicNetworkAddress(item.address))) throw new ArkmePluginError("link-metadata-url-unsafe", "该网址不允许解析标题", false, 400);
+		if (addresses.length === 0 || addresses.some((item) => !isAllowedLinkMetadataAddress(item.address))) throw new ArkmePluginError("link-metadata-url-unsafe", "该网址不允许解析标题", false, 400);
 		return await this.transport.read(url, addresses, options);
 	}
 };
@@ -56513,9 +57564,6 @@ var RecordingImportCoordinator = class {
 				job = await this.transition(job, "accepted", {
 					sourceHandle: "",
 					sha256: "",
-					sessionId: void 0,
-					childId: void 0,
-					childFinished: void 0,
 					uploadCheckpoint: void 0
 				});
 				await this.source.discard(sourceHandle).catch(() => void 0);
@@ -57138,8 +58186,78 @@ function safeFailureMessage$1(error) {
 	if (error instanceof Error && error.message.trim() !== "") return error.message;
 	return "未知错误";
 }
+function recordingImportErrorCode(error) {
+	if (error === null || typeof error !== "object" || !("code" in error)) return void 0;
+	return typeof error.code === "string" ? error.code : void 0;
+}
 const RECORDING_IMPORT_VISIBLE_LIMIT = 20;
 const RECORDING_IMPORT_UNRESOLVED_LIMIT = 20;
+const RECORDING_IMPORT_HISTORY_MAX_PAGE_SIZE = 50;
+const RECORDING_IMPORT_SESSION_REF_PREFIX = "arkme-recording-import-session-v1";
+function recordingImportOwnerStatus(task) {
+	const owner = task.session;
+	const ownerProgress = task.progress;
+	if (!owner.hasFinishedUpload) return {
+		status: "uploading",
+		statusDetail: "上传中"
+	};
+	if (task.processingCompleted) {
+		if (ownerProgress?.displayStatus === "partial") return {
+			status: "partial",
+			statusDetail: "部分完成"
+		};
+		if (ownerProgress?.displayStatus === "failed") return {
+			status: "failed",
+			statusDetail: "处理失败"
+		};
+		if (ownerProgress?.displayStatus === "completed") return {
+			status: "completed",
+			statusDetail: "导入完成"
+		};
+		return {
+			status: "completed",
+			statusDetail: "已完成"
+		};
+	}
+	if ([
+		"completed",
+		"partial",
+		"failed"
+	].includes(ownerProgress?.displayStatus ?? "")) return {
+		status: "processing",
+		statusDetail: "处理中"
+	};
+	switch (ownerProgress?.displayStatus) {
+		case "speaker-waiting": return {
+			status: "speaker-waiting",
+			statusDetail: "等待识别说话人"
+		};
+		case "speaker-recognizing": return {
+			status: "speaker-recognizing",
+			statusDetail: "说话人识别中"
+		};
+		case "transcript-waiting": return {
+			status: "transcript-waiting",
+			statusDetail: "等待转写"
+		};
+		case "transcribing": return {
+			status: "transcribing",
+			statusDetail: "转写中"
+		};
+		case "unavailable": return {
+			status: "unavailable",
+			statusDetail: "状态不可用"
+		};
+		default: return {
+			status: "waiting",
+			statusDetail: "等待中"
+		};
+	}
+}
+function recordingImportProcessingDuration(timing) {
+	if (timing === void 0 || timing.timingState === "unavailable") return void 0;
+	return Math.max(0, timing.totalDurationMillis);
+}
 var RecordingService = class {
 	runtime;
 	recordingImports;
@@ -57148,12 +58266,14 @@ var RecordingService = class {
 	media;
 	userCandidates;
 	recordingImportSource;
+	recordingImportOwnerGateway;
 	constructor(runtime, dependencies) {
 		this.runtime = runtime;
 		this.profile = dependencies.profile;
 		this.media = dependencies.media;
 		this.userCandidates = dependencies.userCandidates;
 		this.recordingImportSource = dependencies.recordingImportSource;
+		this.recordingImportOwnerGateway = dependencies.recordingImportOwnerGateway;
 		this.recordingImports = new RecordingImportCoordinator(runtime.stateStore, dependencies.recordingImportGateway, dependencies.recordingImportSource, async () => (await runtime.requireSession()).userId);
 	}
 	dispose() {
@@ -57332,11 +58452,26 @@ var RecordingService = class {
 	}
 	async recordingImportPreflight(fileNames, signal) {
 		this.assertWorkbenchEnabled();
-		const normalized = [...new Set(fileNames.map((value) => value.trim()).filter((value) => value !== ""))];
-		if (normalized.length === 0 || normalized.length > 100 || normalized.some((value) => value.length > 255)) throw new ArkmePluginError("recording-import-preflight-invalid", "待检查录音文件名无效", false);
-		const data = await this.runtime.authenticatedAudioPost("/api/v1/audio/check-exist-same-orig", { orig_names: normalized }, await this.runtime.requireSession(), signal);
-		const duplicates = new Set(listValue$5(data.exist_names).map(stringValue$1).map((value) => value.trim()).filter((value) => value !== ""));
-		return { duplicateFileNames: normalized.filter((value) => duplicates.has(value)) };
+		const candidatesByKey = /* @__PURE__ */ new Map();
+		for (const value of fileNames) {
+			const candidate = value.trim();
+			const key = recordingImportFileNameKey(candidate);
+			if (key !== "" && !candidatesByKey.has(key)) candidatesByKey.set(key, candidate);
+		}
+		const candidates = [...candidatesByKey.values()];
+		if (candidates.length === 0 || candidates.some((value) => value.length > 255)) throw new ArkmePluginError("recording-import-preflight-invalid", "待检查录音文件名无效", false);
+		const session = await this.runtime.requireSession();
+		const unresolvedLocalFileNameKeys = new Set((await this.runtime.stateStore.listRecordingImportJobs(session.userId)).filter((job) => !["accepted", "cancelled"].includes(job.phase)).map((job) => recordingImportFileNameKey(job.fileName)));
+		const audioOwnerFileNameKeys = /* @__PURE__ */ new Set();
+		for (const value of await this.recordingImportOwnerGateway.findExistingFileNames({
+			viewerUserId: session.userId,
+			fileNames: candidates,
+			...signal === void 0 ? {} : { signal }
+		})) {
+			const key = recordingImportFileNameKey(value);
+			if (key !== "") audioOwnerFileNameKeys.add(key);
+		}
+		return { duplicateFileNames: candidates.filter((value) => unresolvedLocalFileNameKeys.has(recordingImportFileNameKey(value)) || audioOwnerFileNameKeys.has(recordingImportFileNameKey(value))) };
 	}
 	async acceptRecordingImport(sourceHandle, metadata, expectedUserId) {
 		this.assertWorkbenchEnabled();
@@ -57360,7 +58495,8 @@ var RecordingService = class {
 			await this.recordingImportSource.discard(sourceHandle).catch(() => void 0);
 			return toPublicRecordingImportJob(existing, await this.recordingImportRef(existing));
 		}
-		if (unresolvedJobs.some((job) => job.fileName === metadata.fileName)) throw new ArkmePluginError("recording-import-duplicate-in-progress", "同名录音正在导入，请等待当前任务完成或取消后重试", false, 409);
+		const fileNameKey = recordingImportFileNameKey(metadata.fileName);
+		if (unresolvedJobs.some((job) => recordingImportFileNameKey(job.fileName) === fileNameKey)) throw new ArkmePluginError("recording-import-duplicate-in-progress", "同名录音正在导入，请等待当前任务完成或取消后重试", false, 409);
 		if (unresolvedJobs.length >= RECORDING_IMPORT_UNRESOLVED_LIMIT) throw new ArkmePluginError("recording-import-pending-limit", "待处理录音过多，请先重试或取消现有任务", false, 409);
 		const probe = await this.recordingImportSource.inspect(sourceHandle, metadata);
 		session = await this.requireRecordingImportSession(expectedUserId);
@@ -57402,7 +58538,7 @@ var RecordingService = class {
 		if (job === void 0) throw new ArkmePluginError("recording-import-not-found", "录音导入任务不存在", false, 404);
 		return toPublicRecordingImportJob(job, importRef);
 	}
-	async recordingImportList() {
+	async recordingImportList(signal) {
 		this.assertWorkbenchEnabled();
 		const session = await this.runtime.requireSession();
 		const jobs = await this.runtime.stateStore.listRecordingImportJobs(session.userId);
@@ -57413,9 +58549,106 @@ var RecordingService = class {
 		].includes(job.phase)) this.runRecordingImport(job);
 		const newestFirst = (left, right) => right.createdAtMillis - left.createdAtMillis;
 		const unresolved = jobs.filter((job) => !["accepted", "cancelled"].includes(job.phase)).sort(newestFirst);
-		const accepted = jobs.filter((job) => job.phase === "accepted").sort(newestFirst).slice(0, Math.max(0, RECORDING_IMPORT_VISIBLE_LIMIT - unresolved.length));
-		const visible = [...unresolved, ...accepted].sort(newestFirst);
-		return await Promise.all(visible.map(async (job) => toPublicRecordingImportJob(job, await this.recordingImportRef(job))));
+		let activeOwnerTasks;
+		let owner = { state: "available" };
+		try {
+			activeOwnerTasks = (await this.recordingImportOwnerGateway.listOwnerTasks({
+				viewerUserId: session.userId,
+				scope: "active",
+				toMillis: Date.now(),
+				limit: RECORDING_IMPORT_VISIBLE_LIMIT,
+				offset: 0,
+				...signal === void 0 ? {} : { signal }
+			})).tasks;
+		} catch (error) {
+			if (signal?.aborted === true || recordingImportErrorCode(error) === "recording-import-account-mismatch") throw error;
+			owner = {
+				state: "unavailable",
+				message: "Audio 上传任务读取失败，请稍后重试"
+			};
+		}
+		const visibleLocal = unresolved;
+		const projectedLocal = await Promise.all(visibleLocal.map(async (job) => toPublicRecordingImportJob(job, await this.recordingImportRef(job))));
+		if (activeOwnerTasks === void 0) return {
+			items: projectedLocal,
+			owner
+		};
+		const ownerRefKey = await this.recordingRefKey(RECORDING_IMPORT_SESSION_REF_PREFIX);
+		const unresolvedOwnerSessionIds = new Set(unresolved.flatMap((job) => job.sessionId === void 0 ? [] : [job.sessionId]));
+		const projectedOwner = await Promise.all(activeOwnerTasks.filter((task) => !unresolvedOwnerSessionIds.has(task.session.sessionId)).map(async (task) => await this.projectRecordingImportOwnerTask(task, session.userId, ownerRefKey)));
+		return {
+			items: [...projectedLocal, ...projectedOwner].sort((left, right) => right.createdAtMillis - left.createdAtMillis),
+			owner
+		};
+	}
+	async recordingImportHistory(input, signal) {
+		this.assertWorkbenchEnabled();
+		const session = await this.runtime.requireSession();
+		const toMillis = Math.trunc(input.toMillis);
+		const limit = Math.trunc(input.limit);
+		const offset = Math.trunc(input.offset);
+		if (!Number.isSafeInteger(toMillis) || toMillis <= 0 || !Number.isSafeInteger(limit) || limit < 1 || limit > RECORDING_IMPORT_HISTORY_MAX_PAGE_SIZE || !Number.isSafeInteger(offset) || offset < 0) throw new ArkmePluginError("recording-import-history-invalid", "已完成任务查询参数无效", false);
+		const page = await this.recordingImportOwnerGateway.listOwnerTasks({
+			viewerUserId: session.userId,
+			scope: "completed",
+			toMillis,
+			limit,
+			offset,
+			...signal === void 0 ? {} : { signal }
+		});
+		if (page.tasks.some((task) => !task.session.hasFinishedUpload || !task.processingCompleted)) throw new ArkmePluginError("recording-import-history-owner-invalid", "已完成任务数据暂不可用，请稍后重试", true, 502);
+		const ownerRefKey = await this.recordingRefKey(RECORDING_IMPORT_SESSION_REF_PREFIX);
+		return {
+			items: await Promise.all(page.tasks.map(async (task) => await this.projectRecordingImportHistoryItem(task, session.userId, ownerRefKey))),
+			...page.total === void 0 ? {} : { total: page.total },
+			offset,
+			hasMore: page.hasMore
+		};
+	}
+	async updateRecordingImportSessionStart(sessionRef, startAtMillis, signal) {
+		this.assertWorkbenchEnabled();
+		const start = Math.trunc(startAtMillis);
+		if (!isRecordingInstantOnOrAfterUnixEpoch(start) || start > Date.now()) throw new ArkmePluginError("recording-import-start-invalid", "录音开始时间无效", false);
+		const session = await this.runtime.requireSession();
+		const target = await this.openRecordingImportSessionRef(sessionRef);
+		await this.assertRecordingImportOwnerMutationSafe(session.userId, target.sessionId);
+		if (start + (await this.recordingImportOwnerGateway.loadOwnerSession({
+			viewerUserId: session.userId,
+			sessionId: target.sessionId,
+			...signal === void 0 ? {} : { signal }
+		})).durationMillis > Date.now()) throw new ArkmePluginError("recording-import-end-invalid", "录音结束时间不能晚于当前时间", false);
+		await this.recordingImportOwnerGateway.updateOwnerSessionStart({
+			viewerUserId: session.userId,
+			sessionId: target.sessionId,
+			startAtMillis: start,
+			...signal === void 0 ? {} : { signal }
+		});
+	}
+	async updateRecordingImportSessionOwnership(sessionRef, ownership, signal) {
+		this.assertWorkbenchEnabled();
+		const session = await this.runtime.requireSession();
+		const target = await this.openRecordingImportSessionRef(sessionRef);
+		const belongUserId = ownership === "self" ? session.userId : 0;
+		await this.assertRecordingImportOwnerMutationSafe(session.userId, target.sessionId);
+		await this.recordingImportOwnerGateway.updateOwnerSessionOwnership({
+			viewerUserId: session.userId,
+			sessionId: target.sessionId,
+			belongUserId,
+			...signal === void 0 ? {} : { signal }
+		});
+	}
+	async deleteRecordingImportSession(sessionRef, signal) {
+		this.assertWorkbenchEnabled();
+		const session = await this.runtime.requireSession();
+		const target = await this.openRecordingImportSessionRef(sessionRef);
+		await this.assertRecordingImportOwnerMutationSafe(session.userId, target.sessionId);
+		const jobs = await this.runtime.stateStore.listRecordingImportJobs(session.userId);
+		await this.recordingImportOwnerGateway.deleteOwnerSession({
+			viewerUserId: session.userId,
+			sessionId: target.sessionId,
+			...signal === void 0 ? {} : { signal }
+		});
+		await Promise.all(jobs.filter((job) => job.sessionId === target.sessionId).map(async (job) => await this.runtime.stateStore.removeRecordingImportJob(session.userId, job.jobId)));
 	}
 	async retryRecordingImport(importRef, expectedRevision) {
 		this.assertWorkbenchEnabled();
@@ -57494,6 +58727,81 @@ var RecordingService = class {
 			throw error;
 		}
 	}
+	async projectRecordingImportHistoryItem(task, viewerUserId, ownerRefKey) {
+		const owner = task.session;
+		const ownerProgress = task.progress;
+		const status = recordingImportOwnerStatus(task);
+		const processingDurationMillis = recordingImportProcessingDuration(ownerProgress?.processingTiming);
+		return {
+			taskKey: await this.recordingImportTaskKey(owner.sessionId, viewerUserId, ownerRefKey),
+			sessionRef: await this.recordingImportSessionRef(owner, viewerUserId, ownerRefKey),
+			ownership: owner.ownership,
+			fileName: owner.fileName,
+			fileSize: owner.fileSize,
+			parsedSize: owner.parsedSize,
+			durationMillis: owner.durationMillis,
+			startAtMillis: owner.startAtMillis,
+			endAtMillis: owner.endAtMillis,
+			progress: 1,
+			status: status.status,
+			statusDetail: status.statusDetail,
+			...processingDurationMillis === void 0 ? {} : { processingDurationMillis },
+			createdAtMillis: owner.createdAtMillis,
+			updatedAtMillis: owner.updatedAtMillis,
+			...ownerProgress?.processingTiming === void 0 ? {} : { processing: ownerProgress.processingTiming }
+		};
+	}
+	async projectRecordingImportOwnerTask(task, viewerUserId, ownerRefKey) {
+		const owner = task.session;
+		const ownerProgress = task.progress;
+		const status = recordingImportOwnerStatus(task);
+		const processingDurationMillis = recordingImportProcessingDuration(ownerProgress?.processingTiming);
+		return {
+			kind: "owner",
+			taskKey: await this.recordingImportTaskKey(owner.sessionId, viewerUserId, ownerRefKey),
+			sessionRef: await this.recordingImportSessionRef(owner, viewerUserId, ownerRefKey),
+			ownership: owner.ownership,
+			fileName: owner.fileName,
+			fileSize: owner.fileSize,
+			parsedSize: owner.parsedSize,
+			durationMillis: owner.durationMillis,
+			startAtMillis: owner.startAtMillis,
+			endAtMillis: owner.endAtMillis,
+			progress: owner.hasFinishedUpload ? 1 : owner.fileSize <= 0 ? 0 : Math.min(1, owner.parsedSize / owner.fileSize),
+			status: status.status,
+			statusDetail: status.statusDetail,
+			...processingDurationMillis === void 0 ? {} : { processingDurationMillis },
+			createdAtMillis: owner.createdAtMillis,
+			updatedAtMillis: owner.updatedAtMillis,
+			...ownerProgress?.processingTiming === void 0 ? {} : { processing: ownerProgress.processingTiming }
+		};
+	}
+	async recordingImportTaskKey(sessionId, viewerUserId, refKey) {
+		const userId = viewerUserId ?? (await this.runtime.requireSession()).userId;
+		return createHmac("sha256", refKey ?? await this.recordingRefKey(RECORDING_IMPORT_SESSION_REF_PREFIX)).update(`${String(userId)}\0${sessionId}`).digest("base64url");
+	}
+	async recordingImportSessionRef(owner, viewerUserId, refKey) {
+		const payload = {
+			version: 1,
+			viewerUserId: viewerUserId ?? (await this.runtime.requireSession()).userId,
+			sessionId: owner.sessionId
+		};
+		return this.sealRecordingRefWithKey(RECORDING_IMPORT_SESSION_REF_PREFIX, payload, refKey ?? await this.recordingRefKey(RECORDING_IMPORT_SESSION_REF_PREFIX));
+	}
+	async openRecordingImportSessionRef(sessionRef) {
+		const raw = await this.openRecordingRef(RECORDING_IMPORT_SESSION_REF_PREFIX, sessionRef);
+		const payload = {
+			version: 1,
+			viewerUserId: numberValue$5(raw.viewerUserId),
+			sessionId: stringValue$1(raw.sessionId).trim()
+		};
+		if (payload.sessionId === "") throw new ArkmePluginError("recording-import-session-ref-invalid", "录音导入任务引用无效", false);
+		return payload;
+	}
+	async assertRecordingImportOwnerMutationSafe(userId, sessionId) {
+		if ((await this.runtime.stateStore.listRecordingImportJobs(userId)).find((job) => job.sessionId === sessionId && !["accepted", "cancelled"].includes(job.phase)) === void 0) return;
+		throw new ArkmePluginError("recording-import-owner-mutation-active", "录音仍在本机上传任务中，请先重试或取消当前任务", false, 409);
+	}
 	async recordingCalendar(fromStamp, toStamp, signal) {
 		const from = Math.trunc(fromStamp);
 		const to = Math.trunc(toStamp);
@@ -57874,12 +59182,115 @@ var RecordingService = class {
 //#endregion
 //#region src/services/recording-import-gateway.ts
 const AUDIO_SESSION_RECOVERY_LIMIT = 500;
+const AUDIO_IMPORT_DUPLICATE_BATCH_SIZE = 100;
+const AUDIO_IMPORT_PROGRESS_BATCH_SIZE = 100;
+const AUDIO_IMPORT_OWNER_PAGE_SIZE = 100;
+const PROCESSING_STAGES = /* @__PURE__ */ new Set([
+	"sd",
+	"vad",
+	"asr"
+]);
+const PROCESSING_OUTCOMES = /* @__PURE__ */ new Set(["success", "failed"]);
 function numberValue$4(value) {
 	return typeof value === "number" && Number.isFinite(value) ? value : 0;
 }
 function optionalIntegerValue(value) {
 	return typeof value === "number" && Number.isSafeInteger(value) ? value : void 0;
 }
+function nonNegativeIntegerValue(value) {
+	return typeof value === "number" && Number.isSafeInteger(value) && value > 0 ? value : 0;
+}
+function processingTimingState(value) {
+	return value === "processing" || value === "completed" ? value : "unavailable";
+}
+function processingTimingRow(value) {
+	if (value === null || typeof value !== "object" || Array.isArray(value)) return void 0;
+	const raw = value;
+	const stage = stringValue$1(raw.stage).trim().toLowerCase();
+	const outcome = stringValue$1(raw.outcome).trim().toLowerCase();
+	const startedAtMillis = optionalIntegerValue(raw.started_at_ms);
+	const endedAtMillis = optionalIntegerValue(raw.ended_at_ms);
+	const durationMillis = optionalIntegerValue(raw.duration_ms);
+	const provider = stringValue$1(raw.provider).trim();
+	const model = stringValue$1(raw.model).trim();
+	if (!PROCESSING_STAGES.has(stage) || !PROCESSING_OUTCOMES.has(outcome) || startedAtMillis === void 0 || endedAtMillis === void 0 || durationMillis === void 0 || startedAtMillis <= 0 || endedAtMillis < startedAtMillis || durationMillis < 0 || provider === "" || model === "") return void 0;
+	return {
+		stage,
+		outcome,
+		startedAtMillis,
+		endedAtMillis,
+		durationMillis,
+		provider,
+		model,
+		modelVersion: stringValue$1(raw.model_version).trim()
+	};
+}
+function processingTiming(value, timingState) {
+	if (!Array.isArray(value)) return {
+		timingState: "unavailable",
+		totalDurationMillis: 0,
+		rows: []
+	};
+	const parsedRows = value.map(processingTimingRow);
+	if (parsedRows.some((row) => row === void 0)) return {
+		timingState: "unavailable",
+		totalDurationMillis: 0,
+		rows: []
+	};
+	const rows = parsedRows;
+	const totalDurationMillis = rows.reduce((total, row) => total + row.durationMillis, 0);
+	if (!Number.isSafeInteger(totalDurationMillis)) return {
+		timingState: "unavailable",
+		totalDurationMillis: 0,
+		rows: []
+	};
+	return {
+		timingState,
+		totalDurationMillis,
+		rows
+	};
+}
+function ownerDisplayStatus(values) {
+	const statuses = values.filter((value) => Number.isSafeInteger(value) && value >= 1 && value <= 6);
+	if (statuses.length === 0) return void 0;
+	const active = statuses.filter((value) => value <= 4);
+	if (active.length > 0) switch (Math.min(...active)) {
+		case 1: return "speaker-waiting";
+		case 2: return "speaker-recognizing";
+		case 3: return "transcript-waiting";
+		case 4: return "transcribing";
+	}
+	const completedCount = statuses.filter((value) => value === 5).length;
+	const failedCount = statuses.filter((value) => value === 6).length;
+	if (completedCount > 0 && failedCount > 0) return "partial";
+	if (failedCount > 0) return "failed";
+	if (completedCount > 0) return "completed";
+}
+function ownerSession(value, viewerUserId) {
+	const owner = objectValue$1(value);
+	const sessionId = stringValue$1(owner.id).trim();
+	const rawStartAtMillis = optionalIntegerValue(owner.start_at);
+	if (optionalIntegerValue(owner.source) !== 2 || sessionId === "" || rawStartAtMillis === void 0 || rawStartAtMillis < 0) return void 0;
+	const startAtMillis = rawStartAtMillis;
+	const durationMillis = optionalIntegerValue(owner.duration);
+	const explicitEndAtMillis = owner.end_at === void 0 ? 0 : optionalIntegerValue(owner.end_at);
+	if (durationMillis === void 0 || durationMillis < 0 || explicitEndAtMillis === void 0 || explicitEndAtMillis < 0) return void 0;
+	const inferredEndAtMillis = startAtMillis + durationMillis;
+	if (!Number.isSafeInteger(inferredEndAtMillis)) return void 0;
+	return {
+		sessionId,
+		ownership: numberValue$4(owner.belong_usr) === viewerUserId ? "self" : "other",
+		fileName: stringValue$1(owner.orig_name).trim(),
+		fileSize: nonNegativeIntegerValue(owner.source_size),
+		parsedSize: nonNegativeIntegerValue(owner.size),
+		durationMillis,
+		startAtMillis,
+		endAtMillis: explicitEndAtMillis > startAtMillis ? explicitEndAtMillis : inferredEndAtMillis,
+		createdAtMillis: nonNegativeIntegerValue(owner.create_at),
+		updatedAtMillis: nonNegativeIntegerValue(owner.update_at),
+		hasFinishedUpload: owner.has_finish_spk === true
+	};
+}
 function remoteFileName(job) {
 	const extension = job.fileName.trim().toLowerCase().match(/\.[^.]+$/)?.[0] ?? "";
 	return `arkme_${job.jobId}_0${extension}`;
@@ -57891,12 +59302,137 @@ var AudioRecordingImportGateway = class {
 		this.runtime = runtime;
 		this.createOssClient = createOssClient;
 	}
+	async findExistingFileNames(input) {
+		const existing = [];
+		for (let offset = 0; offset < input.fileNames.length; offset += AUDIO_IMPORT_DUPLICATE_BATCH_SIZE) {
+			const data = await this.authenticatedOwnerPost(input.viewerUserId, "/api/v1/audio/check-exist-same-orig", { orig_names: input.fileNames.slice(offset, offset + AUDIO_IMPORT_DUPLICATE_BATCH_SIZE) }, input.signal);
+			if (!Array.isArray(data.exist_names)) continue;
+			existing.push(...data.exist_names.map(stringValue$1).map((value) => value.trim()).filter(Boolean));
+		}
+		return existing;
+	}
+	async listOwnerTasks(input) {
+		const offset = Math.max(0, Math.trunc(input.offset));
+		const limit = Math.max(0, Math.trunc(input.limit));
+		if (limit === 0) return {
+			tasks: [],
+			hasMore: false
+		};
+		const scoped = [];
+		const targetCount = offset + limit + 1;
+		let remoteOffset = 0;
+		let exhausted = false;
+		while (scoped.length < targetCount) {
+			const data = await this.authenticatedOwnerPost(input.viewerUserId, "/api/v1/audio/get-session-ls", {
+				to_stamp: Math.trunc(input.toMillis),
+				limit: AUDIO_IMPORT_OWNER_PAGE_SIZE,
+				offset: remoteOffset,
+				query_new: false,
+				task_scope: input.scope
+			}, input.signal);
+			const rawSessions = Array.isArray(data.session_ls) ? data.session_ls : [];
+			const ownerSnapshots = rawSessions.map((raw) => ({
+				raw: objectValue$1(raw),
+				session: ownerSession(raw, input.viewerUserId)
+			})).filter((owner) => owner.session !== void 0).map(({ raw, session: owner }) => {
+				if (typeof raw.has_done_child !== "boolean") throw new RecordingImportContractError("recording-import-owner-completion-unavailable", "Audio 暂未返回录音处理终态，请稍后重试", true);
+				const processingCompleted = raw.has_done_child;
+				if (input.scope === "completed" !== processingCompleted) throw new RecordingImportContractError("recording-import-owner-scope-invalid", "Audio 返回的录音任务范围无效，请稍后重试", true);
+				return {
+					session: owner,
+					processingCompleted
+				};
+			});
+			const sealed = ownerSnapshots.filter((task) => task.session.hasFinishedUpload);
+			let progress = /* @__PURE__ */ new Map();
+			if (sealed.length > 0) try {
+				progress = await this.loadOwnerProgressForSession(input.viewerUserId, sealed.map((task) => task.session.sessionId), input.signal);
+			} catch (error) {
+				if (input.signal?.aborted === true || this.isAccountMismatch(error)) throw error;
+			}
+			for (const task of ownerSnapshots) {
+				const ownerProgress = progress.get(task.session.sessionId);
+				scoped.push({
+					...task,
+					...ownerProgress === void 0 ? {} : { progress: ownerProgress }
+				});
+			}
+			remoteOffset += rawSessions.length;
+			if (rawSessions.length < AUDIO_IMPORT_OWNER_PAGE_SIZE) {
+				exhausted = true;
+				break;
+			}
+		}
+		return {
+			tasks: scoped.slice(offset, offset + limit),
+			...exhausted ? { total: scoped.length } : {},
+			hasMore: scoped.length > offset + limit || !exhausted
+		};
+	}
+	async loadOwnerSession(input) {
+		const normalized = input.sessionId.trim();
+		if (normalized === "") throw new RecordingImportContractError("recording-import-session-invalid", "Audio 会话引用无效");
+		const owner = ownerSession(await this.authenticatedOwnerPost(input.viewerUserId, "/api/v1/audio/get-session-by-id", { session_id: normalized }, input.signal), input.viewerUserId);
+		if (owner === void 0 || owner.sessionId !== normalized) throw new RecordingImportContractError("recording-import-session-invalid", "Audio 会话数据无效", true);
+		return owner;
+	}
+	async loadOwnerProgressForSession(viewerUserId, sessionIds, signal) {
+		const normalized = [...new Set(sessionIds.map((value) => value.trim()).filter((value) => value !== ""))];
+		if (normalized.length === 0) return /* @__PURE__ */ new Map();
+		const result = /* @__PURE__ */ new Map();
+		for (let offset = 0; offset < normalized.length; offset += AUDIO_IMPORT_PROGRESS_BATCH_SIZE) {
+			const batch = normalized.slice(offset, offset + AUDIO_IMPORT_PROGRESS_BATCH_SIZE);
+			const data = await this.authenticatedOwnerPost(viewerUserId, "/api/v1/audio/get-session-deal-status", { session_ids: batch }, signal);
+			for (const raw of Array.isArray(data.item_ls) ? data.item_ls : []) {
+				const owner = objectValue$1(raw);
+				const sessionId = stringValue$1(owner.session_id).trim();
+				if (sessionId === "" || !batch.includes(sessionId)) continue;
+				const statusListAvailable = Array.isArray(owner.child_status_ls);
+				const parsedStatuses = (statusListAvailable ? owner.child_status_ls : []).map((child) => optionalIntegerValue(objectValue$1(child).status));
+				const displayStatus = statusListAvailable && parsedStatuses.every((status) => status !== void 0 && status >= 1 && status <= 6) ? ownerDisplayStatus(parsedStatuses) : "unavailable";
+				const timingState = processingTimingState(owner.timing_state);
+				result.set(sessionId, {
+					...displayStatus === void 0 ? {} : { displayStatus },
+					timingState,
+					processingTiming: processingTiming(owner.processing_timing_ls, timingState)
+				});
+			}
+		}
+		return result;
+	}
+	async updateOwnerSessionStart(input) {
+		await this.authenticatedOwnerPost(input.viewerUserId, "/api/v1/audio/modify-session-start", {
+			session_id: input.sessionId.trim(),
+			start_at: Math.trunc(input.startAtMillis),
+			tz_offset: -new Date(input.startAtMillis).getTimezoneOffset() * 6e4
+		}, input.signal, {
+			lane: "write",
+			bypassCache: true
+		});
+	}
+	async updateOwnerSessionOwnership(input) {
+		if (input.belongUserId !== 0 && input.belongUserId !== input.viewerUserId) throw new ArkmePluginError("recording-import-owner-invalid", "录音数据归属无效", false);
+		await this.authenticatedOwnerPost(input.viewerUserId, "/api/v1/audio/modify-session-belong-usr", {
+			session_id: input.sessionId.trim(),
+			belong_usr: input.belongUserId
+		}, input.signal, {
+			lane: "write",
+			bypassCache: true
+		});
+	}
+	async deleteOwnerSession(input) {
+		await this.authenticatedOwnerPost(input.viewerUserId, "/api/v1/audio/del-session", { session_id: input.sessionId.trim() }, input.signal, {
+			lane: "write",
+			bypassCache: true
+		});
+	}
 	async ensureSession(job, signal) {
 		const recovered = await this.recoverSession(job, signal);
 		if (recovered !== void 0) return recovered.sessionId;
 		let session = await this.requireJobSession(job);
 		const duplicate = await this.runtime.authenticatedAudioPost("/api/v1/audio/check-exist-same-orig", { orig_names: [job.fileName] }, session, signal);
-		if ((Array.isArray(duplicate.exist_names) ? duplicate.exist_names : []).some((value) => stringValue$1(value) === job.fileName)) throw new RecordingImportContractError("recording-import-duplicate", "已存在同名录音，请更名后重试");
+		const fileNameKey = recordingImportFileNameKey(job.fileName);
+		if ((Array.isArray(duplicate.exist_names) ? duplicate.exist_names : []).some((value) => recordingImportFileNameKey(stringValue$1(value)) === fileNameKey)) throw new RecordingImportContractError("recording-import-duplicate", "已存在同名录音，请更名后重试");
 		const timezoneOffsetMillis = -new Date(job.startAtMillis).getTimezoneOffset() * 6e4;
 		session = await this.requireJobSession(job);
 		const sessionId = stringValue$1((await this.runtime.authenticatedAudioPost("/api/v1/audio/new-session", {
@@ -58020,10 +59556,19 @@ var AudioRecordingImportGateway = class {
 		return credentials;
 	}
 	async requireJobSession(job) {
+		return await this.requireViewerSession(job.userId);
+	}
+	async requireViewerSession(viewerUserId) {
 		const session = await this.runtime.requireSession();
-		if (session.userId !== job.userId) throw new ArkmePluginError("recording-import-account-mismatch", "登录账号已变化，已停止录音导入", true, 403);
+		if (session.userId !== viewerUserId) throw new ArkmePluginError("recording-import-account-mismatch", "登录账号已变化，已停止录音导入", true, 403);
 		return session;
 	}
+	async authenticatedOwnerPost(viewerUserId, path, body, signal, options = {}) {
+		return await this.runtime.authenticatedAudioPost(path, body, await this.requireViewerSession(viewerUserId), signal, options);
+	}
+	isAccountMismatch(error) {
+		return error instanceof ArkmePluginError && error.code === "recording-import-account-mismatch";
+	}
 	async recoverSession(job, signal, normalizeOwnership = true) {
 		const session = await this.requireJobSession(job);
 		const matchesIdentity = (item) => numberValue$4(item.source) === 2 && numberValue$4(item.start_at) === job.startAtMillis && stringValue$1(item.orig_name) === job.fileName;
@@ -58414,6 +59959,42 @@ var SearchService = class {
 		}, session, options.signal);
 		return await this.withNavigationTargets(this.recordSearchResult(data, lockedRecordUids), options.signal);
 	}
+	/** Query the canonical record-tag projection used by Flutter's tag search. */
+	async searchTagRecords(options) {
+		const normalizedTag = arkmeNormalizedHashTag(options.normalizedTag);
+		if (normalizedTag === "") throw new ArkmePluginError("record-tag-query-empty", "搜索标签不能为空", false);
+		const session = await this.runtime.requireSession();
+		const data = await this.runtime.authenticatedPost("/api/v1/records/tags/query", {
+			normalized_tag: normalizedTag,
+			limit: Math.min(100, Math.max(1, Math.trunc(options.limit))),
+			...options.cursorSendAt === void 0 ? {} : { cursor_send_at: Math.trunc(options.cursorSendAt) },
+			...options.cursorRecordUid?.trim() ? { cursor_record_uid: options.cursorRecordUid.trim() } : {}
+		}, session, options.signal);
+		const items = listValue$3(data.items).map((raw) => {
+			const item = objectValue$1(raw);
+			const core = objectValue$1(item.record_core);
+			const sourceKind = Math.trunc(numberValue$2(core.origin_kind));
+			const sourceUid = stringValue$1(core.origin_container_ref).trim();
+			return {
+				...item,
+				source_kind: sourceKind,
+				...sourceUid === "" ? {} : { source_uid: sourceUid },
+				route_target_kind: sourceKind === 2 ? "topic" : "default_category",
+				match_summary: { snippet: stringValue$1(core.text_content) }
+			};
+		});
+		const nextSendAt = numberValue$2(data.next_send_at);
+		const nextRecordUid = stringValue$1(data.next_record_uid).trim();
+		const result = this.recordSearchResult({
+			items,
+			source_aggregates: [],
+			has_more: booleanValue$1(data.has_more),
+			query_guard: { state: "complete" },
+			page_summary: { item_count: items.length },
+			...nextSendAt > 0 && nextRecordUid !== "" ? { next_cursor: `${String(nextSendAt)}:${nextRecordUid}` } : {}
+		});
+		return await this.withNavigationTargets(result, options.signal);
+	}
 	async searchFiles(options) {
 		const page = options.query?.trim() ? await this.searchRemote({
 			...options,
@@ -61011,6 +62592,8 @@ const ARKME_WORLD_IMAGE_REF_TTL_MILLIS = 900 * 1e3;
 const MAX_ARKME_WORLD_IMAGE_REFS = 2048;
 const ARKME_WORLD_AVATAR_RESOLUTION_CACHE_TTL_MILLIS = 300 * 1e3;
 const MAX_ARKME_WORLD_AVATAR_RESOLUTION_CACHE_ENTRIES = 2048;
+const ARKME_WORLD_EXTENSION_SHARE_CACHE_TTL_MILLIS = 300 * 1e3;
+const MAX_ARKME_WORLD_EXTENSION_SHARE_CACHE_ENTRIES = 512;
 const ARKME_WORLD_RECORD_REF_TTL_MILLIS = 900 * 1e3;
 const MAX_ARKME_WORLD_RECORD_REFS = 4096;
 const ARKME_VOICEPRINT_PLAY_SCOPE = 2;
@@ -61087,6 +62670,18 @@ function worldExtensionPublicationShare(rawPublication, rawItem) {
 		url: parsed.href
 	};
 }
+function worldExtensionShareFromCatalogDetail(raw) {
+	const response = objectValue$1(raw);
+	return worldExtensionPublicationShare({ share: objectValue$1(response.extension ?? response).share }, {});
+}
+function worldTextWithExtensionShare(textContent, share) {
+	const content = textContent.trim();
+	if (share === void 0) return content;
+	const shareUrl = share.url.trim();
+	if (shareUrl === "") return content;
+	if (content.includes(shareUrl)) return content;
+	return content === "" ? shareUrl : `${content}\n${shareUrl}`;
+}
 function isTopLevelWorldRecord(raw) {
 	return stringValue$1(objectValue$1(raw).parent_record_uid).trim() === "";
 }
@@ -61201,6 +62796,8 @@ var WorldService = class {
 	viewerLabels;
 	worldImageRefs = /* @__PURE__ */ new Map();
 	worldAvatarResolutionCache = /* @__PURE__ */ new Map();
+	extensionPublicationShareCache = /* @__PURE__ */ new Map();
+	extensionPublicationShareInFlight = /* @__PURE__ */ new Map();
 	worldRecordRefs = /* @__PURE__ */ new Map();
 	voiceprintSocialCache = /* @__PURE__ */ new Map();
 	voiceprintSocialInFlight = /* @__PURE__ */ new Map();
@@ -61214,6 +62811,8 @@ var WorldService = class {
 	dispose() {
 		this.worldImageRefs.clear();
 		this.worldAvatarResolutionCache.clear();
+		this.extensionPublicationShareCache.clear();
+		this.extensionPublicationShareInFlight.clear();
 		this.worldRecordRefs.clear();
 		this.voiceprintSocialCache.clear();
 		this.voiceprintSocialInFlight.clear();
@@ -61247,7 +62846,7 @@ var WorldService = class {
 		}, void 0, [200], options.signal);
 		const rawItems = listValue(data.list);
 		const resolvedAvatars = await this.resolveWorldAvatarUrls(rawItems, session, options.signal);
-		const items = (await Promise.all(rawItems.map((raw) => this.worldFeedItem(raw, session.userId, resolvedAvatars)))).filter((item) => item !== void 0);
+		const items = (await Promise.all(rawItems.map((raw) => this.worldFeedItem(raw, session.userId, resolvedAvatars, options.signal)))).filter((item) => item !== void 0);
 		const total = Math.max(0, Math.trunc(numberValue(data.total)));
 		const nextOffset = offset + rawItems.length;
 		const hasMore = rawItems.length > 0 && nextOffset < total;
@@ -61274,7 +62873,7 @@ var WorldService = class {
 			const rawItems = listValue(data.list);
 			const rootItems = rawItems.filter(isTopLevelWorldRecord);
 			const resolvedAvatars = await this.resolveWorldAvatarUrls(rootItems, session, options.signal);
-			items = (await Promise.all(rootItems.map((raw) => this.worldFeedItem(raw, session.userId, resolvedAvatars)))).filter((item) => item !== void 0);
+			items = (await Promise.all(rootItems.map((raw) => this.worldFeedItem(raw, session.userId, resolvedAvatars, options.signal)))).filter((item) => item !== void 0);
 			total = Math.max(0, Math.trunc(numberValue(data.total)));
 			offset += rawItems.length;
 			hasMore = rawItems.length > 0 && offset < total;
@@ -61306,7 +62905,7 @@ var WorldService = class {
 			total = Math.max(0, Math.trunc(numberValue(data.total)));
 			const rootItems = rawItems.filter(isTopLevelWorldRecord);
 			const resolvedAvatars = await this.resolveWorldAvatarUrls(rootItems, session, options.signal);
-			items = (await Promise.all(rootItems.map((raw) => this.worldFeedItem(raw, session.userId, resolvedAvatars)))).filter((item) => item !== void 0);
+			items = (await Promise.all(rootItems.map((raw) => this.worldFeedItem(raw, session.userId, resolvedAvatars, options.signal)))).filter((item) => item !== void 0);
 			offset += rawItems.length;
 			hasMore = rawItems.length > 0 && offset < total;
 			attempts += 1;
@@ -61873,7 +63472,7 @@ var WorldService = class {
 			extendCount: Math.max(0, Math.trunc(numberValue(item.extend_count)))
 		};
 	}
-	async worldFeedItem(raw, viewerUserId, resolvedAvatars) {
+	async worldFeedItem(raw, viewerUserId, resolvedAvatars, signal) {
 		const item = objectValue$1(raw);
 		const recordUid = stringValue$1(item.record_uid).trim();
 		const textContent = stringValue$1(item.text_content ?? item.content).trim();
@@ -61883,6 +63482,8 @@ var WorldService = class {
 		const extensionId = stringValue$1(rawExtensionPublication.extension_id).trim();
 		const extensionVisibility = stringValue$1(rawExtensionPublication.visibility).trim();
 		const isExtensionPublication = recordType === "extension_publication" && extensionId !== "" && extensionVisibility === "public";
+		let extensionShare = isExtensionPublication ? worldExtensionPublicationShare(rawExtensionPublication, item) : void 0;
+		if (isExtensionPublication && extensionShare === void 0) extensionShare = await this.extensionPublicationShare(extensionId, signal);
 		const rawImages = listValue(item.images).map(stringValue$1).map((value) => value.trim()).filter((value) => value !== "");
 		const videoCount = listValue(item.videos).length;
 		const voiceCount = listValue(item.voices).length;
@@ -61916,7 +63517,7 @@ var WorldService = class {
 			...avatarRef === void 0 ? {} : { avatarRef },
 			...avatarRef === void 0 && avatarFallback !== void 0 ? { avatarFallback } : {},
 			headline,
-			textContent,
+			textContent: isExtensionPublication ? worldTextWithExtensionShare(textContent, extensionShare) : textContent,
 			tags: listValue(item.tags).map(stringValue$1).map((tag) => tag.trim()).filter((tag) => tag !== ""),
 			templateKind: Math.trunc(numberValue(item.template_kind)),
 			createdAtMillis: Math.trunc(numberValue(item.created_at)),
@@ -61933,10 +63534,7 @@ var WorldService = class {
 					version: stringValue$1(rawExtensionPublication.version).trim(),
 					name: stringValue$1(rawExtensionPublication.name).trim() || "未命名插件",
 					description: stringValue$1(rawExtensionPublication.description).trim(),
-					...(() => {
-						const share = worldExtensionPublicationShare(rawExtensionPublication, item);
-						return share === void 0 ? {} : { share };
-					})(),
+					...extensionShare === void 0 ? {} : { share: extensionShare },
 					...(() => {
 						const iconRef = stringValue$1(rawExtensionPublication.icon_ref).trim();
 						return iconRef === "" ? {} : { iconRef };
@@ -61953,6 +63551,44 @@ var WorldService = class {
 			} : {}
 		};
 	}
+	async extensionPublicationShare(extensionId, signal) {
+		const normalized = extensionId.trim();
+		if (normalized === "") return void 0;
+		const now = Date.now();
+		const cached = this.extensionPublicationShareCache.get(normalized);
+		if (cached !== void 0 && cached.expiresAtMillis > now) return cached.share;
+		const inFlight = this.extensionPublicationShareInFlight.get(normalized);
+		if (inFlight !== void 0) return await inFlight;
+		const load = this.loadExtensionPublicationShare(normalized, signal);
+		this.extensionPublicationShareInFlight.set(normalized, load);
+		try {
+			const share = await load;
+			if (this.extensionPublicationShareCache.size >= MAX_ARKME_WORLD_EXTENSION_SHARE_CACHE_ENTRIES) {
+				const oldestKey = this.extensionPublicationShareCache.keys().next().value;
+				if (oldestKey !== void 0) this.extensionPublicationShareCache.delete(oldestKey);
+			}
+			this.extensionPublicationShareCache.set(normalized, {
+				...share === void 0 ? {} : { share },
+				expiresAtMillis: Date.now() + ARKME_WORLD_EXTENSION_SHARE_CACHE_TTL_MILLIS
+			});
+			return share;
+		} finally {
+			this.extensionPublicationShareInFlight.delete(normalized);
+		}
+	}
+	async loadExtensionPublicationShare(extensionId, signal) {
+		try {
+			return worldExtensionShareFromCatalogDetail(await this.runtime.extensionPost("/api/public/v1/extensions/detail", { extension_id: extensionId }, signal, {
+				lane: "background-read",
+				key: `world-extension-share:${extensionId}`,
+				cacheMs: ARKME_WORLD_EXTENSION_SHARE_CACHE_TTL_MILLIS,
+				failureCooldownMs: 3e4
+			}));
+		} catch (error) {
+			if (error instanceof Error && error.name === "AbortError") throw error;
+			return;
+		}
+	}
 	isTrustedWorldImageUrl(raw) {
 		if (raw.length > 4096) return false;
 		try {
@@ -62204,6 +63840,7 @@ var ArkmeService = class {
 	media;
 	privacy;
 	source;
+	conversationDirectoryVisibility;
 	record;
 	search;
 	bot;
@@ -62276,7 +63913,8 @@ var ArkmeService = class {
 		this.interwoven = new InterwovenService(this.runtime, this.source, this.profile);
 		this.linkMetadata = new ArkmeLinkMetadataService(linkDocumentReader);
 		this.aiPolish = new GroupAiPolishService(this.runtime, this.source, { sendChatSourceTextRaw: async (...args) => await this.chat.sendChatSourceTextRaw(...args) });
-		this.realtime = new ChatRealtimeService(this.runtime, this.source, { chatTimelineItems: async (data, session, chatSessionUid) => await this.chat.chatTimelineItems(data, session, chatSessionUid) });
+		this.realtime = new ChatRealtimeService(this.runtime, this.source, { chatTimelineItems: async (data, session, chatSessionUid, sourceKind) => await this.chat.chatTimelineItems(data, session, chatSessionUid, sourceKind) });
+		this.conversationDirectoryVisibility = new ConversationDirectoryVisibilityService(new ConversationListPreferenceService(this.runtime), this.source, this.bot, this.realtime);
 		this.chat = new ChatService(this.runtime, this.source, this.profile, this.media, this.record, this.bot, this.arko, this.aiPolish, this.realtime, this.privacy, this.messageActions);
 		this.userBan = new UserBanService(this.runtime, this.chat);
 		this.botConversation = new BotConversationService(this.runtime, this.bot, this.chat, async () => {
@@ -62284,8 +63922,10 @@ var ArkmeService = class {
 		}, this.messageActions);
 		this.relatedQuickNote = new RelatedQuickNoteService(this.runtime, this.record, this.media, this.profile, this.privacy);
 		this.contactDirectory = new ContactDirectoryService(this.runtime, this.source, this.bot, this.profile, this.world, this.chat);
+		const recordingImportGateway = new AudioRecordingImportGateway(this.runtime);
 		this.recording = new RecordingService(this.runtime, {
-			recordingImportGateway: new AudioRecordingImportGateway(this.runtime),
+			recordingImportGateway,
+			recordingImportOwnerGateway: recordingImportGateway,
 			recordingImportSource: new LocalRecordingImportSource(),
 			profile: this.profile,
 			media: this.media,
@@ -62452,7 +64092,7 @@ var ArkmeService = class {
 		return await this.botConversation.updateNotificationPreference(botRef, muted, options);
 	}
 	async openBotChat(botRef, options = {}) {
-		return await this.bot.openBotChat(botRef, options);
+		return await this.conversationDirectoryVisibility.openBotContactConversation(botRef, options);
 	}
 	async listBotPrivateChatDirectory(options = {}) {
 		return await this.botConversation.directory(options);
@@ -62550,6 +64190,7 @@ var ArkmeService = class {
 				messageReadReceipts: true,
 				messageReport: true,
 				userBanManagement: true,
+				groupOwnerGovernance: true,
 				richContentRead: this.config.richMediaRenderEnabled !== false,
 				richContentSend: this.config.richMediaSendEnabled !== false,
 				...this.config.richMediaSendEnabled === false ? {} : { backgroundSound: true },
@@ -62677,10 +64318,14 @@ var ArkmeService = class {
 		return await this.contactDirectory.contactWorld(contactRef, options);
 	}
 	async openDirectoryContactChat(contactRef, signal) {
-		return await this.contactDirectory.openContactChat(contactRef, signal);
+		const result = await this.contactDirectory.openContactChat(contactRef, signal);
+		this.conversationDirectoryVisibility.restoreSource(result.source).catch(() => void 0);
+		return result;
 	}
 	async openDirectoryGroupChat(sourceRef, signal) {
-		return await this.contactDirectory.openGroupChat(sourceRef, signal);
+		const source = await this.contactDirectory.openGroupChat(sourceRef, signal);
+		this.conversationDirectoryVisibility.restoreSource(source).catch(() => void 0);
+		return source;
 	}
 	async unmarkedSpeakerOptions(candidateRef, signal) {
 		return await this.unmarkedSpeaker.markOptions(candidateRef, signal);
@@ -62745,8 +64390,11 @@ var ArkmeService = class {
 	/** @internal Built-in loopback UI only. */ async recordingImportStatus(importRef) {
 		return await this.recording.recordingImportStatus(importRef);
 	}
-	/** @internal Built-in loopback UI only. */ async recordingImportList() {
-		return await this.recording.recordingImportList();
+	/** @internal Built-in loopback UI only. */ async recordingImportList(signal) {
+		return await this.recording.recordingImportList(signal);
+	}
+	/** @internal Built-in loopback UI only. */ async recordingImportHistory(input, signal) {
+		return await this.recording.recordingImportHistory(input, signal);
 	}
 	/** @internal Built-in loopback UI only. */ async retryRecordingImport(importRef, expectedRevision) {
 		return await this.recording.retryRecordingImport(importRef, expectedRevision);
@@ -62754,6 +64402,15 @@ var ArkmeService = class {
 	/** @internal Built-in loopback UI only. */ async cancelRecordingImport(importRef, expectedRevision) {
 		return await this.recording.cancelRecordingImport(importRef, expectedRevision);
 	}
+	/** @internal Built-in loopback UI only. */ async updateRecordingImportSessionStart(sessionRef, startAtMillis, signal) {
+		await this.recording.updateRecordingImportSessionStart(sessionRef, startAtMillis, signal);
+	}
+	/** @internal Built-in loopback UI only. */ async updateRecordingImportSessionOwnership(sessionRef, ownership, signal) {
+		await this.recording.updateRecordingImportSessionOwnership(sessionRef, ownership, signal);
+	}
+	/** @internal Built-in loopback UI only. */ async deleteRecordingImportSession(sessionRef, signal) {
+		await this.recording.deleteRecordingImportSession(sessionRef, signal);
+	}
 	async resumeRecordingImports() {
 		await this.recording.resumeRecordingImports();
 	}
@@ -62835,8 +64492,14 @@ var ArkmeService = class {
 	async listSources(directory, options = {}) {
 		return await this.source.listSources(directory, options);
 	}
-	async setChatDirectoryPolicy(sourceRef, options = {}) {
-		return await this.source.setChatDirectoryPolicy(sourceRef, options);
+	async setChatDirectoryPin(sourceRef, pinned, signal) {
+		return await this.source.setChatDirectoryPin(sourceRef, pinned, signal);
+	}
+	async conversationDirectoryVisibilitySnapshot(sourceRefs, botRefs, signal) {
+		return await this.conversationDirectoryVisibility.query(sourceRefs, botRefs, signal);
+	}
+	async setConversationDirectoryVisibility(entryKind, entryRef, hidden, signal) {
+		await this.conversationDirectoryVisibility.setVisibility(entryKind, entryRef, hidden, signal);
 	}
 	async dshBetaCommunityEntryState(signal) {
 		return await this.community.dshBetaCommunityEntryState(signal);
@@ -62961,7 +64624,9 @@ var ArkmeService = class {
 	async openPrivateChatFromContact(contactRef, options = {}) {
 		const session = await this.runtime.requireSession();
 		const peerUserId = await this.contact.resolveRegisteredContactUserId(contactRef, session, options.signal);
-		return await this.chat.openPrivateChatFromUser(peerUserId, options);
+		const result = await this.chat.openPrivateChatFromUser(peerUserId, options);
+		this.conversationDirectoryVisibility.restoreSource(result.source).catch(() => void 0);
+		return result;
 	}
 	async officialAuthorProfile(signal) {
 		return await this.chat.officialAuthorProfile(signal === void 0 ? {} : { signal });
@@ -63015,6 +64680,18 @@ var ArkmeService = class {
 	async reportMessage(messageRef, reportType, options = {}) {
 		return await this.chat.reportMessage(messageRef, reportType, options);
 	}
+	async withdrawGroupMessage(messageWithdrawalRef, options = {}) {
+		return await this.chat.withdrawGroupMessage(messageWithdrawalRef, options);
+	}
+	async removeGroupMember(sourceRef, memberRef, options = {}) {
+		return await this.chat.removeGroupMember(sourceRef, memberRef, options);
+	}
+	async listGroupJoinRestrictions(sourceRef, options = {}) {
+		return await this.chat.listGroupJoinRestrictions(sourceRef, options);
+	}
+	async setGroupJoinRestriction(sourceRef, memberRef, restricted, options = {}) {
+		return await this.chat.setGroupJoinRestriction(sourceRef, memberRef, restricted, options);
+	}
 	async copySourceMessageLink(sourceRef, actionRefs, options = {}) {
 		return await this.chat.copySourceMessageLink(sourceRef, actionRefs, options);
 	}
@@ -63164,6 +64841,9 @@ var ArkmeService = class {
 	async searchRemote(options) {
 		return await this.search.searchRemote(options);
 	}
+	async searchTagRecords(options) {
+		return await this.search.searchTagRecords(options);
+	}
 	async searchHistory(limit = 10) {
 		return await this.search.searchHistory(limit);
 	}
@@ -63339,6 +65019,9 @@ var ArkmeService = class {
 		await this.realtime.invalidateRecordProjection();
 		return result;
 	}
+	async listRecordTags(limit = 100, signal) {
+		return await this.record.listTags(limit, signal);
+	}
 	async createTextForConversation(recordUid, textContent) {
 		const result = await this.record.createTextForConversation(recordUid, textContent);
 		if (result.localState !== "failed") await this.realtime.invalidateRecordProjection();
@@ -64939,4 +66622,4 @@ async function invokePersistentArkmeExtension(extensionId, method, args) {
 	return jsonValue(await handler(jsonValue(args)));
 }
 //#endregion
-export { ARKME_VOICEPRINT_ENROLLMENT_MIN_DURATION_MS as $, inspectNativeBundleArtifactV3 as A, ARKME_EXTENSION_ICON_MAX_BYTES as B, ARKME_BUNDLE_MAX_BYTES as C, bundleSha256 as D, arkmeSandboxEntryId as E, assertExtensionArtifactSize as F, validateVoiceprintPcm16Wav as G, ARKME_EXTENSION_PREVIEW_MAX_BYTES as H, canonicalExtensionJson as I, arkmeRichBackgroundSound as J, isRecordingInstantOnOrAfterUnixEpoch as K, sha256Hex as L, packLocalNativeBundleDirectoryV3 as M, readNativeBundleTarballV3 as N, canonicalBundleJson as O, renderArkmeSandboxHostEntry as P, ARKME_VOICEPRINT_ENROLLMENT_MAX_DURATION_MS as Q, unpackArkmeExtension as R, ARKME_BUNDLE_ARTIFACT_KIND as S, ArkmeBundleArtifactError as T, ARKME_EXTENSION_RUNTIME_UNAVAILABLE_MESSAGE as U, ARKME_EXTENSION_MAX_BYTES as V, ArkmeService as W, ARKME_PROVIDER_CONTRACT_VERSION as X, ARKME_DEFAULT_SHARE_WEBSITE as Y, ARKME_VOICEPRINT_ENROLLMENT_MAX_AUDIO_BYTES as Z, arkmeClientContentDigest as _, persistentArkmeExtensionActive as a, arkmeNormalizedFileMimeType as at, verifyExtensionResolutionSignature as b, persistentExtensionBundleDirectory as c, recordingImportFileKind as ct, readPersistentExtensionActivation as d, ArkmePluginError as dt, ARKME_WORLD_PUBLISH_MAX_IMAGES as et, refreshPersistentClientWrapper as f, ArkmeOutgoingCallError as ft, activeProfileExtensionOwnerConflicts as g, renderArkmeBundleClientBundle as h, invokePersistentArkmeExtension as i, arkmeCanInlineLocalFile as it, packBundleFiles as j, inspectBundleArtifact as k, persistentExtensionPackageIdentity as l, sameRecordingImportIdentity as lt, writePersistentExtensionActivation as m, applyPersistentArkmeHostExtension as n, ARKME_RUNTIME_INSTANCE_ID as nt, persistentArkmeExtensionRuntimeState as o, arkmePickedFileKind as ot, repairPersistentExtensionInstallation as p, SecretValue as pt, arkmeFileBackgroundSound as q, deactivatePersistentArkmeExtension as r, ARKME_TOOL_FILE_MAX_BYTES as rt, materializePersistentExtensionBundle as s, isArkmeBotAvatarRef as st, activatePersistentArkmeExtension as t, ARKME_WORLD_PUBLISH_MAX_IMAGE_BYTES as tt, quarantinePersistentExtension as u, MAX_RECORDING_IMPORT_BYTES as ut, arkmeClientContentDigestFromSource as v, ARKME_NATIVE_BUNDLE_ARTIFACT_KIND as w, verifyNativeBundleResolutionSignature as x, verifyBundleResolutionSignature as y, ARKME_EXTENSION_FORMAT as z };
+export { ARKME_PROVIDER_CONTRACT_VERSION as $, inspectNativeBundleArtifactV3 as A, ARKME_EXTENSION_ICON_MAX_BYTES as B, ARKME_BUNDLE_MAX_BYTES as C, bundleSha256 as D, arkmeSandboxEntryId as E, assertExtensionArtifactSize as F, validateVoiceprintPcm16Wav as G, ARKME_EXTENSION_PREVIEW_MAX_BYTES as H, canonicalExtensionJson as I, arkmeIsGenericLinkMetadataTitle as J, isRecordingInstantOnOrAfterUnixEpoch as K, sha256Hex as L, packLocalNativeBundleDirectoryV3 as M, readNativeBundleTarballV3 as N, canonicalBundleJson as O, renderArkmeSandboxHostEntry as P, ARKME_DEFAULT_SHARE_WEBSITE as Q, unpackArkmeExtension as R, ARKME_BUNDLE_ARTIFACT_KIND as S, ArkmeBundleArtifactError as T, ARKME_EXTENSION_RUNTIME_UNAVAILABLE_MESSAGE as U, ARKME_EXTENSION_MAX_BYTES as V, ArkmeService as W, arkmeFileBackgroundSound as X, arkmeRequiredLinkMetadataFallback as Y, arkmeRichBackgroundSound as Z, arkmeClientContentDigest as _, SecretValue as _t, persistentArkmeExtensionActive as a, ARKME_RUNTIME_INSTANCE_ID as at, verifyExtensionResolutionSignature as b, persistentExtensionBundleDirectory as c, arkmeNormalizedFileMimeType as ct, readPersistentExtensionActivation as d, recordingImportFileKind as dt, ARKME_VOICEPRINT_ENROLLMENT_MAX_AUDIO_BYTES as et, refreshPersistentClientWrapper as f, sameRecordingImportIdentity as ft, activeProfileExtensionOwnerConflicts as g, ArkmeOutgoingCallError as gt, renderArkmeBundleClientBundle as h, ArkmePluginError as ht, invokePersistentArkmeExtension as i, ARKME_WORLD_PUBLISH_MAX_IMAGE_BYTES as it, packBundleFiles as j, inspectBundleArtifact as k, persistentExtensionPackageIdentity as l, arkmePickedFileKind as lt, writePersistentExtensionActivation as m, recordingImportFileNameKey as mt, applyPersistentArkmeHostExtension as n, ARKME_VOICEPRINT_ENROLLMENT_MIN_DURATION_MS as nt, persistentArkmeExtensionRuntimeState as o, ARKME_TOOL_FILE_MAX_BYTES as ot, repairPersistentExtensionInstallation as p, MAX_RECORDING_IMPORT_BYTES as pt, arkmeExtensionShareRefFromLink as q, deactivatePersistentArkmeExtension as r, ARKME_WORLD_PUBLISH_MAX_IMAGES as rt, materializePersistentExtensionBundle as s, arkmeCanInlineLocalFile as st, activatePersistentArkmeExtension as t, ARKME_VOICEPRINT_ENROLLMENT_MAX_DURATION_MS as tt, quarantinePersistentExtension as u, isArkmeBotAvatarRef as ut, arkmeClientContentDigestFromSource as v, ARKME_NATIVE_BUNDLE_ARTIFACT_KIND as w, verifyNativeBundleResolutionSignature as x, verifyBundleResolutionSignature as y, ARKME_EXTENSION_FORMAT as z };