@senguoyun/dsh-arkme 0.1.47 → 0.1.49

package/lib/{persistent-runtime-DpNP9UKr.js → persistent-runtime-D2pt8S-e.js}

@@ -1,20 +1,21 @@
+import { createRequire } from "node:module";
+import { defineTool } from "@deepseek-ai/dsh-tools";
 import { chmodSync, createReadStream, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
+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 { createCipheriv, createDecipheriv, createHash, createHmac, createPublicKey, randomBytes, randomUUID, timingSafeEqual, verify } from "node:crypto";
 import minpath, { basename, dirname, isAbsolute, join, posix, relative, resolve, sep } from "node:path";
 import { fileURLToPath, fileURLToPath as urlToPath } 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 minproc from "node:process";
-import { Resolver, lookup } from "node:dns/promises";
+import { gunzipSync, gzipSync } from "node:zlib";
 import { request } from "node:http";
 import { request as request$1 } from "node:https";
+import { Readable } from "node:stream";
 import { BlockList, isIP } from "node:net";
+import minproc from "node:process";
+import { Resolver, lookup } from "node:dns/promises";
 import OSS from "ali-oss";
-import { Readable } from "node:stream";
-import { gunzipSync, gzipSync } from "node:zlib";
 import { createContext, runInContext } from "node:vm";
 import { Context } from "@deepseek-ai/cordis";
-import { defineTool } from "@deepseek-ai/dsh-tools";
 import { parseDocument } from "yaml";
 //#region \0rolldown/runtime.js
 var __create = Object.create;
@@ -23,6 +24,14 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esmMin = (fn, res, err) => () => {
+	if (err) throw err[0];
+	try {
+		return fn && (res = fn(fn = 0)), res;
+	} catch (e) {
+		throw err = [e], e;
+	}
+};
 var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
 var __exportAll = (all, no_symbols) => {
 	let target = {};
@@ -47,15 +56,258 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	value: mod,
 	enumerable: true
 }) : target, mod));
+var __toCommonJS = (mod) => __hasOwnProp.call(mod, "module.exports") ? mod["module.exports"] : __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __require = /* #__PURE__ */ (() => createRequire(import.meta.url))();
 //#endregion
-//#region src/direct-message-admission.ts
-function directMessageAdmissionMessage(admission) {
-	switch (admission.state) {
-		case "allowed": return "";
-		case "refused_by_self": return "你已拒收对方的消息";
-		case "refused_by_counterpart": return "对方已拒收你的消息";
-		case "mutually_refused": return "你们已互相拒收消息";
+//#region src/services/desktop-attention-bridge.ts
+const DESKTOP_BRIDGE_TIMEOUT_MS = 2e3;
+const DESKTOP_NOTIFICATION_RETRY_MS = 250;
+const MAX_NOTIFICATION_TITLE_LENGTH = 128;
+const MAX_NOTIFICATION_BODY_LENGTH = 512;
+const MAX_NATIVE_BADGE_COUNT = 999999;
+function nonEmptyBounded(value, maxLength) {
+	const normalized = value?.trim() ?? "";
+	return normalized !== "" && normalized.length <= maxLength ? normalized : void 0;
+}
+function isLoopbackHostname(hostname) {
+	return hostname === "127.0.0.1" || hostname === "::1" || hostname === "[::1]";
+}
+/**
+* Resolve the native bridge only when the complete, client-injected contract is
+* present. Partial or non-loopback configuration is rejected as unavailable;
+* no credential is ever sent to a caller-controlled origin.
+*/
+function arkmeDesktopBridgeConfigFromEnv(env) {
+	const rawEndpoint = env.ARKME_DESKTOP_BRIDGE_URL?.trim() ?? "";
+	const token = nonEmptyBounded(env.ARKME_DESKTOP_BRIDGE_TOKEN, 512);
+	const sessionId = nonEmptyBounded(env.ARKME_DESKTOP_BRIDGE_SESSION_ID, 160);
+	if (rawEndpoint === "" && token === void 0 && sessionId === void 0) return void 0;
+	if (rawEndpoint === "" || token === void 0 || token.length < 16 || /\s/.test(token) || sessionId === void 0 || sessionId.length < 8 || !/^[A-Za-z0-9._:-]+$/.test(sessionId)) return void 0;
+	let endpoint;
+	try {
+		endpoint = new URL(rawEndpoint);
+	} catch {
+		return;
 	}
+	if (endpoint.protocol !== "http:" || !isLoopbackHostname(endpoint.hostname) || endpoint.port === "" || endpoint.username !== "" || endpoint.password !== "" || endpoint.pathname !== "/v1/actions" || endpoint.search !== "" || endpoint.hash !== "") return void 0;
+	return {
+		endpoint: endpoint.toString(),
+		token,
+		sessionId
+	};
+}
+function responseObject(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+async function requestArkmeDesktopBridge(config, fetchImpl, action, payload) {
+	const response = await fetchImpl(config.endpoint, {
+		method: "POST",
+		headers: {
+			authorization: `Bearer ${config.token}`,
+			"content-type": "application/json"
+		},
+		body: JSON.stringify({
+			schemaVersion: 1,
+			sessionId: config.sessionId,
+			action,
+			payload
+		}),
+		signal: AbortSignal.timeout(DESKTOP_BRIDGE_TIMEOUT_MS)
+	});
+	if (!response.ok) throw new Error(`desktop bridge returned HTTP ${String(response.status)}`);
+	const body = responseObject(await response.json());
+	const value = responseObject(body?.value);
+	if (body?.ok !== true || value === void 0) throw new Error("desktop bridge returned an invalid response");
+	return value;
+}
+function outcomeFromValue(value) {
+	if (typeof value.accepted !== "boolean") return void 0;
+	return value.outcome === "accepted" || value.outcome === "duplicate" || value.outcome === "unsupported" || value.outcome === "native-failed" || value.outcome === "expired" || value.outcome === "rate-limited" ? value.outcome : void 0;
+}
+var ArkmeDesktopAttentionBridge = class {
+	config;
+	fetchImpl;
+	capabilities;
+	badgeRevision = 0;
+	badgeSourceRevision = 0;
+	badgeGeneration;
+	lastBadgeCount;
+	badgeMutationTail = Promise.resolve();
+	constructor(config = arkmeDesktopBridgeConfigFromEnv(process.env), fetchImpl = fetch, badgeGeneration = Number(process.hrtime.bigint() / 1000n)) {
+		this.config = config;
+		this.fetchImpl = fetchImpl;
+		this.badgeGeneration = Number.isSafeInteger(badgeGeneration) && badgeGeneration > 0 ? badgeGeneration : Math.max(1, Date.now() * 1e3);
+	}
+	available() {
+		return this.config !== void 0;
+	}
+	async showNotification(payload) {
+		const capabilities = await this.readCapabilities(true);
+		if (capabilities?.notificationShow !== true) return {
+			fallbackToBrowser: true,
+			outcome: capabilities === void 0 ? "unavailable" : "unsupported"
+		};
+		const boundedPayload = {
+			...payload,
+			presentation: {
+				title: payload.presentation.title.trim().slice(0, MAX_NOTIFICATION_TITLE_LENGTH),
+				body: payload.presentation.body.trim().slice(0, MAX_NOTIFICATION_BODY_LENGTH)
+			}
+		};
+		for (let attempt = 0; attempt < 2; attempt += 1) {
+			try {
+				const outcome = outcomeFromValue(await this.request("notification.show", boundedPayload)) ?? "native-failed";
+				if (outcome !== "native-failed" || attempt > 0) return {
+					fallbackToBrowser: false,
+					outcome
+				};
+			} catch {
+				if (attempt > 0) return {
+					fallbackToBrowser: false,
+					outcome: "native-failed"
+				};
+			}
+			await new Promise((resolve) => {
+				setTimeout(resolve, DESKTOP_NOTIFICATION_RETRY_MS);
+			});
+		}
+		return {
+			fallbackToBrowser: false,
+			outcome: "native-failed"
+		};
+	}
+	async applyBadgeSummary(summary) {
+		const count = Math.min(MAX_NATIVE_BADGE_COUNT, Math.max(0, Math.trunc(Number.isFinite(summary.count) ? summary.count : 0)));
+		const revision = Math.trunc(summary.revision);
+		if (!Number.isSafeInteger(revision) || revision <= 0) return false;
+		const pending = this.badgeMutationTail.then(async () => await this.applyBadgeSnapshotSerial(count, revision));
+		this.badgeMutationTail = pending.then(() => void 0, () => void 0);
+		return await pending;
+	}
+	async resetBadgeCount() {
+		const pending = this.badgeMutationTail.then(async () => {
+			this.badgeGeneration += 1;
+			this.badgeRevision = 0;
+			this.badgeSourceRevision = 0;
+			this.lastBadgeCount = void 0;
+			for (let attempt = 0; attempt < 3; attempt += 1) if (await this.applyBadgeSnapshotSerial(0, 1)) return true;
+			return false;
+		});
+		this.badgeMutationTail = pending.then(() => void 0, () => void 0);
+		return await pending;
+	}
+	async applyBadgeSnapshotSerial(count, sourceRevision) {
+		if (sourceRevision < this.badgeSourceRevision || sourceRevision === this.badgeSourceRevision && count === this.lastBadgeCount) return true;
+		const capabilities = await this.readCapabilities();
+		if (capabilities === void 0) return this.config === void 0;
+		if (capabilities.badgeApplySnapshot.mode === "unsupported") return true;
+		const revision = Math.max(sourceRevision, this.badgeRevision + 1);
+		try {
+			const outcome = outcomeFromValue(await this.request("badge.applySnapshot", {
+				generation: this.badgeGeneration,
+				revision,
+				count
+			}));
+			if (outcome !== "accepted" && outcome !== "duplicate") return false;
+			this.badgeRevision = revision;
+			this.badgeSourceRevision = sourceRevision;
+			this.lastBadgeCount = count;
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	async readCapabilities(refresh = false) {
+		if (this.config === void 0) return void 0;
+		if (!refresh && this.capabilities !== void 0) return this.capabilities;
+		try {
+			const value = await this.request("capabilities.get", {});
+			if (value.schemaVersion !== 1 || value.sessionId !== this.config.sessionId) return void 0;
+			const capabilities = responseObject(value.capabilities);
+			const mode = responseObject(capabilities?.badgeApplySnapshot)?.mode;
+			if (capabilities?.notificationShow !== true && capabilities?.notificationShow !== false) return void 0;
+			if (mode !== "count" && mode !== "dot" && mode !== "unsupported") return void 0;
+			this.capabilities = {
+				notificationShow: capabilities.notificationShow,
+				badgeApplySnapshot: { mode }
+			};
+			return this.capabilities;
+		} catch {
+			return;
+		}
+	}
+	async request(action, payload) {
+		const config = this.config;
+		if (config === void 0) throw new Error("desktop bridge unavailable");
+		return await requestArkmeDesktopBridge(config, this.fetchImpl, action, payload);
+	}
+};
+/** Samples optional native lifecycle facts without delaying the Host session poll. */
+function createDesktopLifecycleReader(fetchImpl) {
+	const config = arkmeDesktopBridgeConfigFromEnv(process.env);
+	let available;
+	let latest;
+	let flight;
+	let nextRead = 0;
+	return async () => {
+		if (config === void 0 || available === false || flight !== void 0 || performance.now() < nextRead) return latest;
+		nextRead = performance.now() + 2e3;
+		flight = (async () => {
+			if (available === void 0) {
+				available = responseObject(responseObject((await requestArkmeDesktopBridge(config, fetchImpl, "capabilities.get", {})).capabilities)?.lifecycle)?.version === 1;
+				if (!available) return;
+			}
+			const value = await requestArkmeDesktopBridge(config, fetchImpl, "lifecycle.get", {});
+			if (Number.isSafeInteger(value.resumeGeneration) && Number(value.resumeGeneration) >= 0 && typeof value.suspended === "boolean") latest = {
+				resumeGeneration: Number(value.resumeGeneration),
+				suspended: value.suspended
+			};
+		})().catch(() => void 0).finally(() => {
+			flight = void 0;
+		});
+		return latest;
+	};
+}
+//#endregion
+//#region src/chat-attention.ts
+function integerLikeValue$5(value) {
+	if (typeof value === "number" && Number.isFinite(value)) return Math.trunc(value);
+	if (typeof value !== "string" || value.trim() === "") return void 0;
+	const parsed = Number(value.trim());
+	return Number.isFinite(parsed) ? Math.trunc(parsed) : void 0;
+}
+function arkmeChatPolicyNotificationDisabled(policy) {
+	if (policy === null || typeof policy !== "object" || Array.isArray(policy)) return void 0;
+	const value = policy;
+	const muteState = integerLikeValue$5(value.mute_state ?? value.muteState);
+	const notifyState = integerLikeValue$5(value.notify_state ?? value.notifyState);
+	if (muteState === 2 || notifyState === 2) return true;
+	if (muteState === 1 || notifyState === 1) return false;
+}
+function projectArkmeChatAttention(rawUnreadCount, policy, fallbackMuted = false) {
+	const unreadCount = Math.max(0, integerLikeValue$5(rawUnreadCount) ?? 0);
+	const isMuted = arkmeChatPolicyNotificationDisabled(policy) ?? fallbackMuted;
+	const notificationAllowed = !isMuted;
+	return {
+		unreadCount,
+		badgeUnreadCount: notificationAllowed ? unreadCount : 0,
+		notificationAllowed,
+		isMuted
+	};
+}
+function projectArkmeChatAttentionFromMuted(rawUnreadCount, isMuted) {
+	return projectArkmeChatAttention(rawUnreadCount, void 0, isMuted);
+}
+//#endregion
+//#region src/chat-pin-projection.ts
+/** Policy freshness is independent of message sequence and event delivery order. */
+function retainNewerArkmeChatPin(current, incoming) {
+	if (incoming.kind !== "private_chat" && incoming.kind !== "group_chat" || current?.kind !== incoming.kind || current.isPinned === void 0 || current.chatPolicyUpdatedAtMillis === void 0 || current.chatPolicyUpdatedAtMillis <= (incoming.chatPolicyUpdatedAtMillis ?? 0)) return incoming;
+	return {
+		...incoming,
+		isPinned: current.isPinned,
+		chatPolicyUpdatedAtMillis: current.chatPolicyUpdatedAtMillis
+	};
 }
 //#endregion
 //#region src/request-coordinator.ts
@@ -485,190 +737,6 @@ var ArkmeRequestCoordinator = class {
 	}
 };
 //#endregion
-//#region src/services/desktop-attention-bridge.ts
-const DESKTOP_BRIDGE_TIMEOUT_MS = 2e3;
-const DESKTOP_NOTIFICATION_RETRY_MS = 250;
-const MAX_NOTIFICATION_TITLE_LENGTH = 128;
-const MAX_NOTIFICATION_BODY_LENGTH = 512;
-const MAX_NATIVE_BADGE_COUNT = 999999;
-function nonEmptyBounded(value, maxLength) {
-	const normalized = value?.trim() ?? "";
-	return normalized !== "" && normalized.length <= maxLength ? normalized : void 0;
-}
-function isLoopbackHostname(hostname) {
-	return hostname === "127.0.0.1" || hostname === "::1" || hostname === "[::1]";
-}
-/**
-* Resolve the native bridge only when the complete, client-injected contract is
-* present. Partial or non-loopback configuration is rejected as unavailable;
-* no credential is ever sent to a caller-controlled origin.
-*/
-function arkmeDesktopBridgeConfigFromEnv(env) {
-	const rawEndpoint = env.ARKME_DESKTOP_BRIDGE_URL?.trim() ?? "";
-	const token = nonEmptyBounded(env.ARKME_DESKTOP_BRIDGE_TOKEN, 512);
-	const sessionId = nonEmptyBounded(env.ARKME_DESKTOP_BRIDGE_SESSION_ID, 160);
-	if (rawEndpoint === "" && token === void 0 && sessionId === void 0) return void 0;
-	if (rawEndpoint === "" || token === void 0 || token.length < 16 || /\s/.test(token) || sessionId === void 0 || sessionId.length < 8 || !/^[A-Za-z0-9._:-]+$/.test(sessionId)) return void 0;
-	let endpoint;
-	try {
-		endpoint = new URL(rawEndpoint);
-	} catch {
-		return;
-	}
-	if (endpoint.protocol !== "http:" || !isLoopbackHostname(endpoint.hostname) || endpoint.port === "" || endpoint.username !== "" || endpoint.password !== "" || endpoint.pathname !== "/v1/actions" || endpoint.search !== "" || endpoint.hash !== "") return void 0;
-	return {
-		endpoint: endpoint.toString(),
-		token,
-		sessionId
-	};
-}
-function responseObject(value) {
-	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
-}
-async function requestArkmeDesktopBridge(config, fetchImpl, action, payload) {
-	const response = await fetchImpl(config.endpoint, {
-		method: "POST",
-		headers: {
-			authorization: `Bearer ${config.token}`,
-			"content-type": "application/json"
-		},
-		body: JSON.stringify({
-			schemaVersion: 1,
-			sessionId: config.sessionId,
-			action,
-			payload
-		}),
-		signal: AbortSignal.timeout(DESKTOP_BRIDGE_TIMEOUT_MS)
-	});
-	if (!response.ok) throw new Error(`desktop bridge returned HTTP ${String(response.status)}`);
-	const body = responseObject(await response.json());
-	const value = responseObject(body?.value);
-	if (body?.ok !== true || value === void 0) throw new Error("desktop bridge returned an invalid response");
-	return value;
-}
-function outcomeFromValue(value) {
-	if (typeof value.accepted !== "boolean") return void 0;
-	return value.outcome === "accepted" || value.outcome === "duplicate" || value.outcome === "unsupported" || value.outcome === "native-failed" || value.outcome === "expired" || value.outcome === "rate-limited" ? value.outcome : void 0;
-}
-var ArkmeDesktopAttentionBridge = class {
-	config;
-	fetchImpl;
-	capabilities;
-	badgeRevision = 0;
-	badgeSourceRevision = 0;
-	badgeGeneration;
-	lastBadgeCount;
-	badgeMutationTail = Promise.resolve();
-	constructor(config = arkmeDesktopBridgeConfigFromEnv(process.env), fetchImpl = fetch, badgeGeneration = Number(process.hrtime.bigint() / 1000n)) {
-		this.config = config;
-		this.fetchImpl = fetchImpl;
-		this.badgeGeneration = Number.isSafeInteger(badgeGeneration) && badgeGeneration > 0 ? badgeGeneration : Math.max(1, Date.now() * 1e3);
-	}
-	available() {
-		return this.config !== void 0;
-	}
-	async showNotification(payload) {
-		const capabilities = await this.readCapabilities(true);
-		if (capabilities?.notificationShow !== true) return {
-			fallbackToBrowser: true,
-			outcome: capabilities === void 0 ? "unavailable" : "unsupported"
-		};
-		const boundedPayload = {
-			...payload,
-			presentation: {
-				title: payload.presentation.title.trim().slice(0, MAX_NOTIFICATION_TITLE_LENGTH),
-				body: payload.presentation.body.trim().slice(0, MAX_NOTIFICATION_BODY_LENGTH)
-			}
-		};
-		for (let attempt = 0; attempt < 2; attempt += 1) {
-			try {
-				const outcome = outcomeFromValue(await this.request("notification.show", boundedPayload)) ?? "native-failed";
-				if (outcome !== "native-failed" || attempt > 0) return {
-					fallbackToBrowser: false,
-					outcome
-				};
-			} catch {
-				if (attempt > 0) return {
-					fallbackToBrowser: false,
-					outcome: "native-failed"
-				};
-			}
-			await new Promise((resolve) => {
-				setTimeout(resolve, DESKTOP_NOTIFICATION_RETRY_MS);
-			});
-		}
-		return {
-			fallbackToBrowser: false,
-			outcome: "native-failed"
-		};
-	}
-	async applyBadgeSummary(summary) {
-		const count = Math.min(MAX_NATIVE_BADGE_COUNT, Math.max(0, Math.trunc(Number.isFinite(summary.count) ? summary.count : 0)));
-		const revision = Math.trunc(summary.revision);
-		if (!Number.isSafeInteger(revision) || revision <= 0) return false;
-		const pending = this.badgeMutationTail.then(async () => await this.applyBadgeSnapshotSerial(count, revision));
-		this.badgeMutationTail = pending.then(() => void 0, () => void 0);
-		return await pending;
-	}
-	async resetBadgeCount() {
-		const pending = this.badgeMutationTail.then(async () => {
-			this.badgeGeneration += 1;
-			this.badgeRevision = 0;
-			this.badgeSourceRevision = 0;
-			this.lastBadgeCount = void 0;
-			for (let attempt = 0; attempt < 3; attempt += 1) if (await this.applyBadgeSnapshotSerial(0, 1)) return true;
-			return false;
-		});
-		this.badgeMutationTail = pending.then(() => void 0, () => void 0);
-		return await pending;
-	}
-	async applyBadgeSnapshotSerial(count, sourceRevision) {
-		if (sourceRevision < this.badgeSourceRevision || sourceRevision === this.badgeSourceRevision && count === this.lastBadgeCount) return true;
-		const capabilities = await this.readCapabilities();
-		if (capabilities === void 0) return this.config === void 0;
-		if (capabilities.badgeApplySnapshot.mode === "unsupported") return true;
-		const revision = Math.max(sourceRevision, this.badgeRevision + 1);
-		try {
-			const outcome = outcomeFromValue(await this.request("badge.applySnapshot", {
-				generation: this.badgeGeneration,
-				revision,
-				count
-			}));
-			if (outcome !== "accepted" && outcome !== "duplicate") return false;
-			this.badgeRevision = revision;
-			this.badgeSourceRevision = sourceRevision;
-			this.lastBadgeCount = count;
-			return true;
-		} catch {
-			return false;
-		}
-	}
-	async readCapabilities(refresh = false) {
-		if (this.config === void 0) return void 0;
-		if (!refresh && this.capabilities !== void 0) return this.capabilities;
-		try {
-			const value = await this.request("capabilities.get", {});
-			if (value.schemaVersion !== 1 || value.sessionId !== this.config.sessionId) return void 0;
-			const capabilities = responseObject(value.capabilities);
-			const mode = responseObject(capabilities?.badgeApplySnapshot)?.mode;
-			if (capabilities?.notificationShow !== true && capabilities?.notificationShow !== false) return void 0;
-			if (mode !== "count" && mode !== "dot" && mode !== "unsupported") return void 0;
-			this.capabilities = {
-				notificationShow: capabilities.notificationShow,
-				badgeApplySnapshot: { mode }
-			};
-			return this.capabilities;
-		} catch {
-			return;
-		}
-	}
-	async request(action, payload) {
-		const config = this.config;
-		if (config === void 0) throw new Error("desktop bridge unavailable");
-		return await requestArkmeDesktopBridge(config, this.fetchImpl, action, payload);
-	}
-};
-//#endregion
 //#region src/account-session-owner.ts
 var ArkmeAccountSessionOwner = class {
 	store;
@@ -911,6 +979,13 @@ var ServiceRuntime = class {
 	stateStore;
 	fetchImpl;
 	pendingSessionStore;
+	memberCacheRevision = 0;
+	memberCacheEpoch() {
+		return this.memberCacheRevision;
+	}
+	invalidateMemberCache() {
+		this.memberCacheRevision += 1;
+	}
 	requestCoordinator = new ArkmeRequestCoordinator();
 	refreshInFlightByUserId = /* @__PURE__ */ new Map();
 	accountSessions;
@@ -1435,6 +1510,666 @@ var ServiceRuntime = class {
 	}
 };
 //#endregion
+//#region src/services/conversation-directory-service.ts
+const PAGE_SIZE = 20;
+const MAX_ROWS = 2e4;
+const keyOf = (source) => source.sourceKey ?? source.sourceRef;
+/** Merge pages and live changes without interpreting page absence as removal. */
+function mergeDirectorySource(previous, incoming, keepLive = false) {
+	if (previous === void 0) return incoming;
+	const stale = (incoming.latestSequence ?? 0) < (previous.latestSequence ?? 0) || keepLive && (incoming.latestSequence ?? 0) <= (previous.latestSequence ?? 0) && incoming.activeAtMillis <= previous.activeAtMillis;
+	const merged = {
+		...previous,
+		...incoming
+	};
+	if (stale) {
+		merged.sourceRef = previous.sourceRef;
+		for (const field of [
+			"latestSequence",
+			"latestPreview",
+			"activeAtMillis",
+			"unreadCount",
+			"badgeUnreadCount",
+			"hasUnreadMention"
+		]) if (previous[field] !== void 0) Object.assign(merged, { [field]: previous[field] });
+	}
+	if (!stale && incoming.latestPreview === void 0) delete merged.latestPreview;
+	const readSequence = Math.max(previous.readSequence ?? 0, incoming.readSequence ?? 0);
+	if (readSequence > 0) {
+		merged.readSequence = readSequence;
+		if ((merged.latestSequence ?? 0) <= readSequence) merged.unreadCount = 0;
+		else if ((incoming.readSequence ?? 0) < (previous.readSequence ?? 0) && (incoming.latestSequence ?? 0) <= (previous.latestSequence ?? 0)) merged.unreadCount = previous.unreadCount;
+	}
+	Object.assign(merged, projectArkmeChatAttentionFromMuted(merged.unreadCount, merged.isMuted === true));
+	if (merged.unreadCount === 0) merged.hasUnreadMention = false;
+	if (!incoming.avatarRef && previous.avatarRef !== void 0) merged.avatarRef = previous.avatarRef;
+	if (!incoming.avatarRefs?.length && previous.avatarRefs !== void 0) merged.avatarRefs = previous.avatarRefs;
+	if (!incoming.groupAvatar?.slots.length && previous.groupAvatar !== void 0) merged.groupAvatar = previous.groupAvatar;
+	return retainNewerArkmeChatPin(previous, merged);
+}
+/** One account lifecycle owns cache restoration, a twenty-row scan, and directory deltas. */
+var ConversationDirectoryService = class {
+	runtime;
+	source;
+	preferences;
+	readBots;
+	warmAvatar;
+	emit;
+	restoreBots;
+	userId;
+	generation = 0;
+	revision = 0;
+	cachedAtMillis = 0;
+	sourceRemovals = /* @__PURE__ */ new Map();
+	pendingReadAcks = /* @__PURE__ */ new Map();
+	visibilityMutations = /* @__PURE__ */ new Map();
+	sources = /* @__PURE__ */ new Map();
+	mutations = /* @__PURE__ */ new Map();
+	visibility = /* @__PURE__ */ new Map();
+	bots = [];
+	cachedBotKeys = /* @__PURE__ */ new Map();
+	botPinnedKeys = /* @__PURE__ */ new Set();
+	deletedBotRefs = /* @__PURE__ */ new Set();
+	special = {};
+	phase = "cached";
+	error;
+	restore;
+	scan;
+	firstPage;
+	rescanRequested = false;
+	rawBaselineComplete = false;
+	rawBaseline;
+	controller = new AbortController();
+	persistence = Promise.resolve();
+	diskPending = /* @__PURE__ */ new Map();
+	diskWriting = false;
+	cacheFailure;
+	lastPublished = "";
+	avatars = /* @__PURE__ */ new Map();
+	avatarWork;
+	constructor(runtime, source, preferences, readBots, warmAvatar, emit, restoreBots = async (items) => items) {
+		this.runtime = runtime;
+		this.source = source;
+		this.preferences = preferences;
+		this.readBots = readBots;
+		this.warmAvatar = warmAvatar;
+		this.emit = emit;
+		this.restoreBots = restoreBots;
+	}
+	reset() {
+		this.controller.abort();
+		this.controller = new AbortController();
+		this.generation++;
+		this.userId = void 0;
+		this.sourceRemovals.clear();
+		this.pendingReadAcks.clear();
+		this.sources.clear();
+		this.mutations.clear();
+		this.visibility.clear();
+		this.visibilityMutations.clear();
+		this.avatars.clear();
+		this.bots = [];
+		this.cachedBotKeys.clear();
+		this.botPinnedKeys.clear();
+		this.deletedBotRefs.clear();
+		this.special = {};
+		this.restore = void 0;
+		this.scan = void 0;
+		this.firstPage = void 0;
+		this.rawBaseline = void 0;
+		this.avatarWork = void 0;
+		this.phase = "cached";
+		this.error = void 0;
+		this.lastPublished = "";
+		this.cachedAtMillis = 0;
+		this.rescanRequested = false;
+		this.rawBaselineComplete = false;
+	}
+	async activate() {
+		const { userId } = await this.runtime.requireSession();
+		if (userId !== this.userId) {
+			this.reset();
+			this.userId = userId;
+			const generation = this.generation;
+			this.restore = (async () => {
+				const cached = await this.runtime.stateStore.readDirectoryCache?.(userId);
+				if (generation !== this.generation || cached === void 0) return;
+				if (cached.items[0] !== void 0) await this.source.openSourceRef(cached.items[0].sourceRef, userId);
+				if (generation !== this.generation) return;
+				for (const item of cached.items) this.sources.set(keyOf(item), item);
+				this.cachedAtMillis = cached.projection?.cachedAtMillis ?? 0;
+				for (const item of cached.projection?.visibility ?? []) this.visibility.set(`${item.entryKind}:${item.entryRef}`, item);
+				const cachedBots = cached.projection?.bots ?? [];
+				const bots = await this.restoreBots(cachedBots, userId);
+				if (generation !== this.generation) return;
+				this.bots = bots;
+				for (const bot of bots) {
+					if (bot.directoryKey !== void 0) this.cachedBotKeys.set(bot.botRef, bot.directoryKey);
+					const previous = cachedBots.find((item) => item.directoryKey === bot.directoryKey);
+					if (previous === void 0 || previous.botRef === bot.botRef) continue;
+					const visibility = this.visibility.get(`bot:${previous.botRef}`);
+					this.visibility.delete(`bot:${previous.botRef}`);
+					if (visibility !== void 0) this.visibility.set(`bot:${bot.botRef}`, {
+						...visibility,
+						entryRef: bot.botRef
+					});
+				}
+				this.botPinnedKeys = new Set(cached.projection?.botPinnedKeys ?? []);
+				this.deletedBotRefs = new Set(cached.projection?.removedBotRefs ?? []);
+				this.special = {
+					...cached.projection?.sendToSelf === void 0 ? {} : { sendToSelf: cached.projection.sendToSelf },
+					...cached.projection?.arkoProfile === void 0 ? {} : { arkoProfile: cached.projection.arkoProfile },
+					...cached.projection?.arkoPreview === void 0 ? {} : { arkoPreview: cached.projection.arkoPreview }
+				};
+				this.revision = Math.max(this.revision, cached.projection?.revision ?? 0);
+				for (const key of cached.projection?.removedSourceKeys ?? []) this.sourceRemovals.set(key, this.revision);
+			})().catch(() => {});
+		}
+		await this.restore;
+	}
+	async read(force = false, signal) {
+		signal?.throwIfAborted();
+		const pending = this.readSnapshot(force);
+		if (signal === void 0) return await pending;
+		return await new Promise((resolve, reject) => {
+			const abort = () => {
+				reject(signal.reason);
+			};
+			signal.addEventListener("abort", abort, { once: true });
+			pending.then(resolve, reject).finally(() => {
+				signal.removeEventListener("abort", abort);
+			});
+		});
+	}
+	async readSnapshot(force) {
+		await this.activate();
+		const generation = this.generation;
+		const cached = this.snapshot();
+		const hasCache = cached.items.length > 0 || cached.projection.bots.length > 0;
+		if (this.scan === void 0 && (force || this.phase === "cached" || this.phase === "failed")) this.startScan();
+		if (force && this.scan !== void 0 && cached.projection?.phase === "syncing") this.rescanRequested = true;
+		if (hasCache) return structuredClone(cached);
+		await this.firstPage;
+		if (generation !== this.generation) throw new ArkmePluginError("login-context-changed", "账号已切换", false, 409);
+		return structuredClone(this.snapshot());
+	}
+	/** Notification callers join the same scan, but only accept a complete current connection baseline. */
+	async complete() {
+		await this.activate();
+		if (this.rawBaselineComplete && this.scan !== void 0) await this.scan.catch(() => void 0);
+		await this.activate();
+		if (this.scan === void 0) this.startScan();
+		return structuredClone(await this.rawBaseline);
+	}
+	async settled() {
+		while (this.scan !== void 0) await this.scan;
+		while (this.avatarWork !== void 0) await this.avatarWork;
+		while (this.diskWriting) await this.persistence;
+	}
+	startScan() {
+		const generation = this.generation;
+		const userId = this.userId;
+		const signal = this.controller.signal;
+		this.phase = "loading";
+		this.error = void 0;
+		this.rawBaselineComplete = false;
+		let ready;
+		let failed;
+		this.firstPage = new Promise((resolve, reject) => {
+			ready = resolve;
+			failed = reject;
+		});
+		let baselineReady;
+		let baselineFailed;
+		this.rawBaseline = new Promise((resolve, reject) => {
+			baselineReady = resolve;
+			baselineFailed = reject;
+		});
+		this.rawBaseline.catch(() => void 0);
+		const rawSources = /* @__PURE__ */ new Map();
+		this.firstPage.catch(() => void 0);
+		const pending = (async () => {
+			let cursor;
+			const visited = /* @__PURE__ */ new Set();
+			let first = true;
+			do {
+				signal.throwIfAborted();
+				if (visited.size >= MAX_ROWS / PAGE_SIZE) throw new Error("Directory page budget exceeded; synchronization incomplete");
+				const atRevision = this.revision;
+				const page = await this.source.listSources("root", {
+					limit: PAGE_SIZE,
+					refresh: true,
+					firstPaint: true,
+					...cursor === void 0 ? {} : { cursor },
+					signal
+				});
+				if (generation !== this.generation || (await this.runtime.requireSession()).userId !== userId) throw new DOMException("Account changed", "AbortError");
+				if (page.hasMore && (page.nextCursor === void 0 || visited.has(page.nextCursor))) throw new ArkmePluginError("directory-cursor-invalid", "会话目录分页未完成：游标无效", true, 502);
+				for (const item of page.items) rawSources.set(keyOf(item), item);
+				if (!page.hasMore) {
+					this.rawBaselineComplete = true;
+					baselineReady({
+						directory: "root",
+						items: [...rawSources.values()],
+						hasMore: false
+					});
+				}
+				const visibleCandidates = page.items.map((item) => mergeDirectorySource(this.sources.get(keyOf(item)), item, (this.mutations.get(keyOf(item)) ?? 0) > atRevision));
+				const visibility = await this.preferences.query(visibleCandidates.map((item) => item.sourceRef), [], signal).catch((error) => {
+					if (signal.aborted || error instanceof ArkmePluginError && !error.retryable && [
+						401,
+						403,
+						409
+					].includes(error.httpStatus)) throw error;
+					return { items: visibleCandidates.map((item) => ({
+						entryKind: "source",
+						entryRef: item.sourceRef,
+						hidden: this.visibility.get(`source:${item.sourceRef}`)?.hidden ?? false
+					})) };
+				});
+				signal.throwIfAborted();
+				this.phase = "syncing";
+				this.apply(page.items, visibility.items, atRevision);
+				if (first) {
+					first = false;
+					ready();
+				}
+				for (const item of page.items) this.avatars.set(keyOf(item), item);
+				this.startAvatars(generation);
+				if (!page.hasMore) break;
+				cursor = page.nextCursor;
+				visited.add(cursor);
+				await new Promise((resolve) => {
+					setTimeout(resolve, 0);
+				});
+			} while (true);
+			const bots = await this.readBots(signal);
+			if (generation !== this.generation) return;
+			await this.rememberBots(bots.items, userId);
+			if (generation !== this.generation) return;
+			this.phase = "complete";
+			this.apply([]);
+			const refs = new Set(this.bots.flatMap((bot) => bot.avatarRef ? [bot.avatarRef] : []));
+			const previousAvatarWork = this.avatarWork;
+			const avatarWork = (async () => {
+				await previousAvatarWork;
+				for (const ref of refs) {
+					signal.throwIfAborted();
+					await this.warmAvatar(ref, signal).catch(() => void 0);
+				}
+			})().catch(() => void 0).finally(() => {
+				if (this.avatarWork !== avatarWork) return;
+				this.avatarWork = void 0;
+				if (generation === this.generation && this.avatars.size > 0) this.startAvatars(generation);
+			});
+			this.avatarWork = avatarWork;
+		})().catch((error) => {
+			if (generation === this.generation) {
+				this.phase = "failed";
+				this.error = error instanceof Error ? error.message : "目录同步失败";
+				this.publish([]);
+			}
+			failed(error);
+			baselineFailed(error);
+			throw error;
+		}).finally(() => {
+			if (this.scan !== pending) return;
+			this.scan = void 0;
+			if (this.rescanRequested) {
+				this.rescanRequested = false;
+				this.startScan();
+			}
+		});
+		this.scan = pending;
+		pending.catch(() => void 0);
+	}
+	apply(items, visibility = [], atRevision = this.revision, authoritativeAvatars = false) {
+		const changed = [];
+		for (const item of items) {
+			const key = keyOf(item);
+			if ((this.sourceRemovals.get(key) ?? 0) > atRevision) continue;
+			this.sourceRemovals.delete(key);
+			const previous = this.sources.get(key);
+			const ack = this.pendingReadAcks.get(key) ?? this.pendingReadAcks.get(item.sourceRef);
+			const merged = mergeDirectorySource(previous, ack === void 0 ? item : {
+				...item,
+				readSequence: Math.max(item.readSequence ?? 0, ack.effectiveReadSequence),
+				...(item.latestSequence ?? 0) <= ack.effectiveReadSequence ? { unreadCount: ack.unreadCount } : {}
+			}, (this.mutations.get(key) ?? 0) > atRevision);
+			if (authoritativeAvatars) {
+				merged.avatarRef = item.avatarRef ?? "";
+				merged.avatarRefs = item.avatarRefs ?? [];
+				if (item.groupAvatar === void 0) delete merged.groupAvatar;
+				else merged.groupAvatar = item.groupAvatar;
+			}
+			this.pendingReadAcks.delete(key);
+			this.pendingReadAcks.delete(item.sourceRef);
+			if (JSON.stringify(previous) === JSON.stringify(merged)) continue;
+			if (previous === void 0 && this.sources.size >= MAX_ROWS) throw new Error("Conversation directory capacity exceeded; scan incomplete");
+			if (previous !== void 0 && previous.sourceRef !== merged.sourceRef) {
+				this.visibility.delete(`source:${previous.sourceRef}`);
+				this.visibilityMutations.delete(`source:${previous.sourceRef}`);
+			}
+			this.sources.set(key, merged);
+			this.mutations.set(key, this.revision + 1);
+			changed.push(merged);
+		}
+		const currentRefs = new Set(items.flatMap((item) => {
+			const source = this.sources.get(keyOf(item));
+			return source === void 0 ? [] : [source.sourceRef];
+		}));
+		const acceptedVisibility = visibility.filter((entry) => (items.length === 0 || entry.entryKind !== "source" || currentRefs.has(entry.entryRef)) && (this.visibilityMutations.get(`${entry.entryKind}:${entry.entryRef}`) ?? 0) <= atRevision);
+		for (const entry of acceptedVisibility) {
+			const key = `${entry.entryKind}:${entry.entryRef}`;
+			this.visibility.set(key, entry);
+			this.visibilityMutations.set(key, this.revision + 1);
+		}
+		this.publish(changed, acceptedVisibility);
+	}
+	snapshot(items = [...this.sources.values()], visibility = [...this.visibility.values()]) {
+		return {
+			directory: "root",
+			items,
+			hasMore: this.phase !== "complete",
+			projection: {
+				...this.special,
+				removedSourceKeys: [...this.sourceRemovals.keys()],
+				removedBotRefs: [...this.deletedBotRefs],
+				botPinnedKeys: [...this.botPinnedKeys],
+				revision: this.revision,
+				phase: this.phase,
+				cachedAtMillis: this.cachedAtMillis,
+				visibility,
+				bots: this.bots,
+				...this.error === void 0 ? {} : { error: this.error }
+			}
+		};
+	}
+	publish(items, visibility = []) {
+		const fingerprint = JSON.stringify({
+			items,
+			visibility,
+			phase: this.phase,
+			error: this.error,
+			bots: this.bots,
+			special: this.special,
+			pins: [...this.botPinnedKeys],
+			removedBots: [...this.deletedBotRefs],
+			removedSources: [...this.sourceRemovals.keys()]
+		});
+		if (fingerprint === this.lastPublished) return this.cacheFailure === void 0;
+		this.lastPublished = fingerprint;
+		this.revision++;
+		this.cachedAtMillis = Date.now();
+		const page = this.snapshot(items, visibility);
+		const userId = this.userId;
+		this.emit(structuredClone(page));
+		if (!this.diskPending.has(userId) && this.diskPending.size >= 8) {
+			this.cacheFailure = /* @__PURE__ */ new Error("Directory cache pending account capacity exceeded");
+			console.warn("dsh-arkme: directory_cache_queue_full");
+			return false;
+		}
+		const queued = this.diskPending.get(userId);
+		const rows = new Map((queued?.items ?? []).map((item) => [keyOf(item), item]));
+		for (const item of page.items) rows.set(keyOf(item), item);
+		const hidden = new Map((queued?.projection?.visibility ?? []).map((item) => [`${item.entryKind}:${item.entryRef}`, item]));
+		for (const item of page.projection.visibility) hidden.set(`${item.entryKind}:${item.entryRef}`, item);
+		this.diskPending.set(userId, {
+			...page,
+			items: [...rows.values()],
+			projection: {
+				...page.projection,
+				visibility: [...hidden.values()]
+			}
+		});
+		this.flushDisk();
+		return true;
+	}
+	flushDisk() {
+		if (this.diskWriting || this.diskPending.size === 0) return;
+		this.diskWriting = true;
+		this.persistence = (async () => {
+			while (this.diskPending.size > 0) {
+				await new Promise((resolve) => {
+					setTimeout(resolve, 0);
+				});
+				const [userId, page] = this.diskPending.entries().next().value;
+				this.diskPending.delete(userId);
+				try {
+					await this.runtime.stateStore.writeDirectoryCache?.(userId, page);
+					this.cacheFailure = void 0;
+				} catch (error) {
+					this.cacheFailure = error;
+					console.warn("dsh-arkme: directory_cache_write_failed", error instanceof Error ? error.message : "cache failed");
+				}
+			}
+		})().finally(() => {
+			this.diskWriting = false;
+			this.flushDisk();
+		});
+	}
+	startAvatars(generation) {
+		if (this.avatarWork !== void 0) return;
+		const signal = this.controller.signal;
+		const pending = (async () => {
+			while (this.avatars.size > 0 && generation === this.generation) {
+				const items = [...this.avatars.values()].slice(0, PAGE_SIZE);
+				for (const item of items) this.avatars.delete(keyOf(item));
+				const hydrated = await this.source.hydrateDirectoryPage(items.map((item) => this.sources.get(keyOf(item)) ?? item), signal);
+				if (generation !== this.generation) return;
+				this.apply(hydrated.filter((item) => this.sources.has(keyOf(item))).map((item) => {
+					const updated = {
+						...this.sources.get(keyOf(item)),
+						avatarRef: item.avatarRef ?? "",
+						avatarRefs: item.avatarRefs ?? []
+					};
+					if (item.groupAvatar === void 0) delete updated.groupAvatar;
+					else updated.groupAvatar = item.groupAvatar;
+					return updated;
+				}), [], this.revision, true);
+				const refs = new Set(hydrated.flatMap((item) => [item.avatarRef, ...item.avatarRefs ?? []]).filter((ref) => ref !== void 0 && ref.trim() !== ""));
+				for (const ref of refs) {
+					signal.throwIfAborted();
+					await this.warmAvatar(ref, signal).catch(() => void 0);
+				}
+				if (refs.size > 0 && generation === this.generation) {
+					this.revision++;
+					const page = this.snapshot([], []);
+					this.emit({
+						...page,
+						projection: {
+							...page.projection,
+							avatarRefs: [...refs]
+						}
+					});
+				}
+			}
+		})().catch(() => {}).finally(() => {
+			if (this.avatarWork === pending) this.avatarWork = void 0;
+		});
+		this.avatarWork = pending;
+	}
+	async rememberBots(items, expectedUserId) {
+		if (this.userId !== expectedUserId) return;
+		await this.activate();
+		if (this.userId !== expectedUserId) return;
+		const generation = this.generation;
+		const atRevision = this.revision;
+		const visible = await this.preferences.query([], items.map((bot) => bot.botRef), this.controller.signal);
+		if (generation !== this.generation) return;
+		const merged = new Map(this.bots.map((bot) => [bot.directoryKey ?? bot.botRef, bot]));
+		for (const bot of items) {
+			if (this.deletedBotRefs.has(bot.botRef)) continue;
+			const key = bot.directoryKey ?? bot.botRef;
+			const previous = merged.get(key);
+			const next = {
+				...previous,
+				...bot
+			};
+			if ((previous?.latestMessageAtMillis ?? 0) > (bot.latestMessageAtMillis ?? 0)) {
+				next.latestMessageAtMillis = previous.latestMessageAtMillis;
+				if (previous.latestMessagePreview !== void 0) next.latestMessagePreview = previous.latestMessagePreview;
+				else delete next.latestMessagePreview;
+			} else if (bot.latestMessageAtMillis !== void 0 && bot.latestMessagePreview === void 0) delete next.latestMessagePreview;
+			next.conversationListActivityAtMillis = Math.max(previous?.conversationListActivityAtMillis ?? 0, bot.conversationListActivityAtMillis ?? 0);
+			merged.set(key, next);
+		}
+		for (const bot of this.bots) if (bot.directoryKey !== void 0) this.cachedBotKeys.set(bot.botRef, bot.directoryKey);
+		while (this.cachedBotKeys.size > MAX_ROWS) this.cachedBotKeys.delete(this.cachedBotKeys.keys().next().value);
+		this.bots = [...merged.values()];
+		const currentRefs = new Set(this.bots.map((bot) => bot.botRef));
+		for (const [key, entry] of this.visibility) if (entry.entryKind === "bot" && !currentRefs.has(entry.entryRef)) {
+			this.visibility.delete(key);
+			this.visibilityMutations.delete(key);
+		}
+		this.apply([], visible.items.filter((item) => !this.deletedBotRefs.has(item.entryRef)), atRevision);
+	}
+	async forgetSource(sourceRef, expectedUserId) {
+		await this.activate();
+		if (this.userId !== expectedUserId) return;
+		const generation = this.generation;
+		const source = [...this.sources.values()].find((item) => item.sourceRef === sourceRef);
+		const key = source === void 0 ? await this.source.chatDirectorySourceKey(expectedUserId, (await this.source.openSourceRef(sourceRef, expectedUserId)).ownerRef) : keyOf(source);
+		if (generation !== this.generation) return;
+		this.sources.delete(key);
+		this.mutations.delete(key);
+		this.avatars.delete(key);
+		this.visibility.delete(`source:${sourceRef}`);
+		this.visibilityMutations.delete(`source:${sourceRef}`);
+		this.sourceRemovals.set(key, this.revision + 1);
+		if (this.sourceRemovals.size > MAX_ROWS) this.sourceRemovals.delete(this.sourceRemovals.keys().next().value);
+		this.publish([]);
+	}
+	async forgetBot(botRef, expectedUserId) {
+		await this.activate();
+		if (expectedUserId !== void 0 && this.userId !== expectedUserId) return;
+		this.deletedBotRefs.add(botRef);
+		const deleted = this.bots.find((bot) => bot.botRef === botRef || bot.directoryKey !== void 0 && bot.directoryKey === this.cachedBotKeys.get(botRef));
+		if (deleted !== void 0) this.deletedBotRefs.add(deleted.botRef);
+		while (this.deletedBotRefs.size > MAX_ROWS) this.deletedBotRefs.delete(this.deletedBotRefs.values().next().value);
+		if (deleted !== void 0) this.botPinnedKeys.delete(deleted.directoryKey ?? deleted.botRef);
+		this.visibility.delete(`bot:${botRef}`);
+		this.visibilityMutations.delete(`bot:${botRef}`);
+		this.bots = this.bots.filter((bot) => bot !== deleted);
+		this.publish([]);
+	}
+	async pinBot(botRef, pinned) {
+		await this.activate();
+		const generation = this.generation;
+		let bot = this.bots.find((item) => item.botRef === botRef || item.directoryKey !== void 0 && item.directoryKey === this.cachedBotKeys.get(botRef));
+		if (bot === void 0) {
+			const fresh = await this.readBots(this.controller.signal);
+			if (generation !== this.generation) throw new ArkmePluginError("login-context-changed", "账号已切换", false, 409);
+			bot = fresh.items.find((item) => item.botRef === botRef && !this.deletedBotRefs.has(item.botRef));
+			if (bot !== void 0) this.bots.push(bot);
+		}
+		if (bot === void 0) throw new ArkmePluginError("bot-directory-entry-unavailable", "请先加载当前账号的 Bot 目录", false, 404);
+		const key = bot.directoryKey ?? bot.botRef;
+		const previous = this.botPinnedKeys.has(key);
+		if (pinned) this.botPinnedKeys.add(key);
+		else this.botPinnedKeys.delete(key);
+		const admitted = this.publish([]);
+		while (this.diskWriting) await this.persistence;
+		if (generation !== this.generation) throw new ArkmePluginError("login-context-changed", "账号已切换", false, 409);
+		if (!admitted || this.cacheFailure !== void 0) {
+			if (previous) this.botPinnedKeys.add(key);
+			else this.botPinnedKeys.delete(key);
+			this.publish([]);
+			throw new ArkmePluginError("directory-cache-write-failed", "本地置顶状态保存失败，请重试", true, 500);
+		}
+	}
+	async rememberSpecial(patch, expectedUserId) {
+		await this.activate();
+		if (expectedUserId !== void 0 && this.userId !== expectedUserId) return;
+		if (patch.arkoPreview !== void 0 && this.special.arkoPreview !== void 0 && patch.arkoPreview.createdAtMillis < this.special.arkoPreview.createdAtMillis) delete patch.arkoPreview;
+		const next = {
+			...this.special,
+			...patch
+		};
+		if (JSON.stringify(next) === JSON.stringify(this.special)) return;
+		this.special = next;
+		this.publish([]);
+	}
+	async confirmVisibility(entryKind, entryRef, hidden, expectedUserId) {
+		await this.activate();
+		if (expectedUserId !== void 0 && this.userId !== expectedUserId) return;
+		if (entryKind === "bot") {
+			const current = this.bots.find((bot) => bot.botRef === entryRef || bot.directoryKey !== void 0 && bot.directoryKey === this.cachedBotKeys.get(entryRef));
+			if (current !== void 0) {
+				const generation = this.generation;
+				const atRevision = this.revision;
+				const visible = await this.preferences.query([], [current.botRef], this.controller.signal);
+				if (generation === this.generation) this.apply([], visible.items, atRevision);
+				return;
+			}
+		}
+		this.apply([], [{
+			entryKind,
+			entryRef,
+			hidden
+		}]);
+	}
+	async confirmPin(sourceRef, pinned, policyUpdatedAtMillis, expectedUserId) {
+		await this.activate();
+		if (expectedUserId !== void 0 && this.userId !== expectedUserId) return;
+		const source = [...this.sources.values()].find((item) => item.sourceRef === sourceRef);
+		if (source !== void 0) this.apply([{
+			...source,
+			isPinned: pinned,
+			chatPolicyUpdatedAtMillis: policyUpdatedAtMillis
+		}]);
+	}
+	async accept(event) {
+		const generation = this.generation;
+		const atRevision = this.revision;
+		if (this.userId === void 0 || (await this.runtime.accountScopedSession())?.userId !== this.userId || generation !== this.generation) return;
+		if (event.type === "sessions-delta") {
+			if (event.updates.some((item) => this.sourceRemovals.has(keyOf(item.source)))) if (this.scan === void 0) this.startScan();
+			else this.rescanRequested = true;
+			const sources = event.updates.filter((item) => !this.sourceRemovals.has(keyOf(item.source))).map((item) => mergeDirectorySource(this.sources.get(keyOf(item.source)), item.source));
+			const visibility = await this.preferences.query(sources.map((item) => item.sourceRef), [], this.controller.signal);
+			if (generation !== this.generation) return;
+			this.apply(sources, visibility.items, atRevision);
+		} else if (event.type === "read-ack") {
+			const source = [...this.sources.values()].find((item) => item.sourceKey === event.sourceKey || item.sourceRef === event.sourceRef);
+			if (source !== void 0) this.apply([{
+				...source,
+				readSequence: Math.max(source.readSequence ?? 0, event.effectiveReadSequence),
+				...(source.latestSequence ?? 0) <= event.effectiveReadSequence ? {
+					unreadCount: event.unreadCount,
+					badgeUnreadCount: source.isMuted ? 0 : event.unreadCount,
+					...event.unreadCount === 0 ? { hasUnreadMention: false } : {}
+				} : {}
+			}]);
+			else {
+				const key = event.sourceKey ?? event.sourceRef;
+				const previous = this.pendingReadAcks.get(key);
+				if (previous === void 0 || previous.effectiveReadSequence < event.effectiveReadSequence) this.pendingReadAcks.set(key, event);
+				if (this.pendingReadAcks.size > MAX_ROWS) this.pendingReadAcks.delete(this.pendingReadAcks.keys().next().value);
+			}
+		} else if (event.type === "chat-pins-reconciled") this.apply([...this.sources.values()].flatMap((source) => {
+			const pin = event.pins.find((item) => item.sourceKey === source.sourceKey);
+			return pin === void 0 ? [] : [{
+				...source,
+				isPinned: pin.pinned,
+				chatPolicyUpdatedAtMillis: pin.policyUpdatedAtMillis
+			}];
+		}));
+		else if (event.type === "conversation-list-preference-invalidated" || event.type === "chat-policy-invalidated") if (this.scan === void 0) this.startScan();
+		else this.rescanRequested = true;
+	}
+};
+//#endregion
+//#region src/direct-message-admission.ts
+function directMessageAdmissionMessage(admission) {
+	switch (admission.state) {
+		case "allowed": return "";
+		case "refused_by_self": return "你已拒收对方的消息";
+		case "refused_by_counterpart": return "对方已拒收你的消息";
+		case "mutually_refused": return "你们已互相拒收消息";
+	}
+}
+//#endregion
 //#region src/services/direct-message-admission-service.ts
 function projectDirectMessageAdmission(value, chatSessionUid) {
 	const data = objectValue$2(value);
@@ -32377,7 +33112,7 @@ const TOPIC_PRIVACY_PRIVATE = 2;
 const PRIVACY_SNAPSHOT_LIMIT = 100;
 const PRIVACY_SNAPSHOT_MAX_PAGES = 100;
 const PRIVACY_SNAPSHOT_TTL_MS = 3e4;
-function integerLikeValue$5(value) {
+function integerLikeValue$4(value) {
 	if (typeof value === "number" && Number.isFinite(value)) return Math.trunc(value);
 	if (typeof value === "string" && value.trim() !== "") {
 		const parsed = Number(value.trim());
@@ -32390,13 +33125,13 @@ function arkmePrivacyLockedRecord(raw) {
 	const item = objectValue$2(raw);
 	const core = objectValue$2(item.record_core);
 	const extra = objectValue$2(core.extra ?? item.extra);
-	return integerLikeValue$5(core.content_access_state ?? core.contentAccessState ?? item.content_access_state ?? item.contentAccessState ?? extra.content_access_state ?? extra.contentAccessState) === CONTENT_ACCESS_PROTECTED;
+	return integerLikeValue$4(core.content_access_state ?? core.contentAccessState ?? item.content_access_state ?? item.contentAccessState ?? extra.content_access_state ?? extra.contentAccessState) === CONTENT_ACCESS_PROTECTED;
 }
 /** Topic list requests are public-only; retain this guard for stale or malformed responses. */
 function arkmePrivacyLockedTopic(raw) {
 	const item = objectValue$2(raw);
 	const core = objectValue$2(item.topic_core ?? item);
-	return integerLikeValue$5(core.privacy_state ?? core.privacyState) === TOPIC_PRIVACY_PRIVATE;
+	return integerLikeValue$4(core.privacy_state ?? core.privacyState) === TOPIC_PRIVACY_PRIVATE;
 }
 /** Mirrors the mobile visibility snapshot: it returns only privacy metadata, never record content. */
 var ArkmePrivacyVisibilityService = class {
@@ -32436,13 +33171,13 @@ var ArkmePrivacyVisibilityService = class {
 				const item = objectValue$2(raw);
 				const recordUid = stringValue$2(item.record_uid).trim();
 				if (recordUid === "") continue;
-				if (integerLikeValue$5(item.lock_state) === 1 || integerLikeValue$5(item.content_access_state) === CONTENT_ACCESS_PROTECTED) locked.add(recordUid);
+				if (integerLikeValue$4(item.lock_state) === 1 || integerLikeValue$4(item.content_access_state) === CONTENT_ACCESS_PROTECTED) locked.add(recordUid);
 			}
 			if (data.has_more !== true) {
 				complete = true;
 				break;
 			}
-			const nextUpdateAt = integerLikeValue$5(data.next_update_at);
+			const nextUpdateAt = integerLikeValue$4(data.next_update_at);
 			const nextRecordUid = stringValue$2(data.next_record_uid).trim();
 			if (nextUpdateAt <= 0 || nextRecordUid === "") throw new ArkmePluginError("privacy-visibility-snapshot-invalid", "隐私锁快记状态不完整，已停止显示快记", true, 502);
 			cursorUpdateAt = nextUpdateAt;
@@ -32650,7 +33385,7 @@ function contractError$1(field) {
 function listValue$24(value) {
 	return Array.isArray(value) ? value : [];
 }
-function integerLikeValue$4(value) {
+function integerLikeValue$3(value) {
 	if (typeof value === "number" && Number.isFinite(value)) return Math.trunc(value);
 	if (typeof value === "string" && value.trim() !== "") {
 		const parsed = Number(value.trim());
@@ -32670,7 +33405,7 @@ function arkmeMentionMetadataMentionsViewer(record, payload, viewerUserId) {
 	const metadata = arkmeMentionMetadataFromRecord(record, payload);
 	for (const rawMention of listValue$24(metadata.human_mentions ?? metadata.humanMentions)) {
 		const mention = objectValue$2(rawMention);
-		const mentionedUserId = integerLikeValue$4(mention.user_id ?? mention.userId);
+		const mentionedUserId = integerLikeValue$3(mention.user_id ?? mention.userId);
 		if (mentionedUserId === 0 || mentionedUserId === viewerUserId) return true;
 	}
 	return false;
@@ -32928,47 +33663,6 @@ function arkmePickedFileKind(mimeType, fileName = "") {
 	return mediaKind === "image" ? 1 : mediaKind === "video" ? 3 : 4;
 }
 //#endregion
-//#region src/chat-attention.ts
-function integerLikeValue$3(value) {
-	if (typeof value === "number" && Number.isFinite(value)) return Math.trunc(value);
-	if (typeof value !== "string" || value.trim() === "") return void 0;
-	const parsed = Number(value.trim());
-	return Number.isFinite(parsed) ? Math.trunc(parsed) : void 0;
-}
-function arkmeChatPolicyNotificationDisabled(policy) {
-	if (policy === null || typeof policy !== "object" || Array.isArray(policy)) return void 0;
-	const value = policy;
-	const muteState = integerLikeValue$3(value.mute_state ?? value.muteState);
-	const notifyState = integerLikeValue$3(value.notify_state ?? value.notifyState);
-	if (muteState === 2 || notifyState === 2) return true;
-	if (muteState === 1 || notifyState === 1) return false;
-}
-function projectArkmeChatAttention(rawUnreadCount, policy, fallbackMuted = false) {
-	const unreadCount = Math.max(0, integerLikeValue$3(rawUnreadCount) ?? 0);
-	const isMuted = arkmeChatPolicyNotificationDisabled(policy) ?? fallbackMuted;
-	const notificationAllowed = !isMuted;
-	return {
-		unreadCount,
-		badgeUnreadCount: notificationAllowed ? unreadCount : 0,
-		notificationAllowed,
-		isMuted
-	};
-}
-function projectArkmeChatAttentionFromMuted(rawUnreadCount, isMuted) {
-	return projectArkmeChatAttention(rawUnreadCount, void 0, isMuted);
-}
-//#endregion
-//#region src/chat-pin-projection.ts
-/** Policy freshness is independent of message sequence and event delivery order. */
-function retainNewerArkmeChatPin(current, incoming) {
-	if (incoming.kind !== "private_chat" && incoming.kind !== "group_chat" || current?.kind !== incoming.kind || current.isPinned === void 0 || current.chatPolicyUpdatedAtMillis === void 0 || current.chatPolicyUpdatedAtMillis <= (incoming.chatPolicyUpdatedAtMillis ?? 0)) return incoming;
-	return {
-		...incoming,
-		isPinned: current.isPinned,
-		chatPolicyUpdatedAtMillis: current.chatPolicyUpdatedAtMillis
-	};
-}
-//#endregion
 //#region src/arkme-emoji-text.ts
 /** Asset-free emoji catalog shared by Browser UI and Host notification text. */
 const arkmeDefaultEmojiSeeds = Object.freeze([
@@ -34144,7 +34838,7 @@ var SourceService = class {
 		const session = await this.runtime.requireSession();
 		const limit = Math.min(directory === "send_to_self" ? 100 : 50, Math.max(1, Math.trunc(options.limit ?? 30)));
 		const cursor = options.cursor?.trim() ?? "";
-		const cacheKey = `${String(session.userId)}:${directory}:${String(limit)}:${cursor}`;
+		const cacheKey = `${String(session.userId)}:${directory}:${String(limit)}:${cursor}:${options.firstPaint === true ? "first" : "full"}`;
 		this.pruneSourceListCache();
 		const cached = this.sourceListCache.get(cacheKey);
 		if (options.refresh !== true && cached !== void 0 && cached.expiresAtMillis > Date.now()) return cloneSourceList(cached.value);
@@ -34457,6 +35151,7 @@ var SourceService = class {
 				activeAtMillis: arkmeChatSortActiveAt(bundle, chatSession),
 				...attention,
 				...hasUnreadMention === void 0 ? {} : { hasUnreadMention },
+				readSequence: numberValue$26(unread.read_seq),
 				isPinned,
 				chatPolicyUpdatedAtMillis: numberValue$26(currentPolicy.update_at),
 				...numberValue$26(unread.session_last_seq ?? chatSession.last_seq) > 0 ? { latestSequence: numberValue$26(unread.session_last_seq ?? chatSession.last_seq) } : {}
@@ -34472,7 +35167,7 @@ var SourceService = class {
 			} else groupSessionUidByIndex.set(itemIndex, uid);
 		}
 		try {
-			await this.hydrateSourceAvatars(items, privateUserIdByIndex, groupSessionUidByIndex, session, options.signal);
+			if (options.firstPaint !== true) await this.hydrateSourceAvatars(items, privateUserIdByIndex, groupSessionUidByIndex, session, options.signal);
 		} catch (error) {
 			console.warn("dsh-arkme: Chat avatar hydration failed:", safeFailureMessage$6(error));
 		}
@@ -34508,6 +35203,19 @@ var SourceService = class {
 			this.sourceListCache.delete(oldestKey);
 		}
 	}
+	async hydrateDirectoryPage(items, signal) {
+		const session = await this.runtime.requireSession();
+		const hydrated = items.map(cloneSourceItem);
+		const privateUsers = /* @__PURE__ */ new Map();
+		const groups = /* @__PURE__ */ new Map();
+		for (let index = 0; index < items.length; index++) {
+			const item = items[index];
+			if (item.kind === "private_chat" && item.peerUserId !== void 0) privateUsers.set(index, item.peerUserId);
+			if (item.kind === "group_chat") groups.set(index, (await this.openSourceRef(item.sourceRef, session.userId)).ownerRef);
+		}
+		await this.hydrateSourceAvatars(hydrated, privateUsers, groups, session, signal);
+		return hydrated;
+	}
 	async hydrateSourceAvatars(items, privateUserIdByIndex, groupSessionUidByIndex, session, signal) {
 		const groupSnapshotsByIndex = /* @__PURE__ */ new Map();
 		const authoritativeGroupIndices = /* @__PURE__ */ new Set();
@@ -35291,8 +35999,42 @@ var BotService = class {
 	async botDirectoryKey(userId, botId) {
 		return `arkme-bot-directory-v1.${createHmac("sha256", await this.runtime.stateStore.uniqueCode()).update(`arkme-bot-directory-v1:${String(userId)}:${botId}`).digest("base64url")}`;
 	}
+	/** A cached directory entry is a lookup, never a persisted live target/capability. */
+	async restoreDirectoryBots(items, userId) {
+		const secret = await this.runtime.stateStore.uniqueCode();
+		return items.flatMap((bot) => {
+			if (bot.directoryKey === void 0) return [];
+			const payload = Buffer.from(JSON.stringify({ directoryKey: bot.directoryKey })).toString("base64url");
+			const signature = createHmac("sha256", secret).update(`bot-directory-entry-v1:${userId}:${payload}`).digest("base64url");
+			return [{
+				...bot,
+				botRef: `arkme-bot-directory-entry-v1.${payload}.${signature}`
+			}];
+		});
+	}
+	async openDirectoryBotRef(reference, userId) {
+		const parts = reference.split(".");
+		if (parts.length !== 3 || reference.length > 1024) throw new ArkmePluginError("bot-ref-invalid", "Bot 目录引用无效", false, 400);
+		const payload = parts[1];
+		const supplied = Buffer.from(parts[2], "base64url");
+		const expected = createHmac("sha256", await this.runtime.stateStore.uniqueCode()).update(`bot-directory-entry-v1:${userId}:${payload}`).digest();
+		if (supplied.length !== expected.length || !timingSafeEqual(supplied, expected)) throw new ArkmePluginError("bot-ref-invalid", "Bot 目录引用无效", false, 400);
+		let parsed;
+		try {
+			parsed = JSON.parse(Buffer.from(payload, "base64url").toString("utf8"));
+		} catch {
+			throw new ArkmePluginError("bot-ref-invalid", "Bot 目录引用无效", false, 400);
+		}
+		if ((await this.runtime.requireSession()).userId !== userId) throw new ArkmePluginError("bot-ref-account-mismatch", "Bot 目录引用与当前账号不匹配", false, 403);
+		if (typeof parsed?.directoryKey !== "string") throw new ArkmePluginError("bot-ref-invalid", "Bot 目录引用无效", false, 400);
+		const current = (await this.listBots()).items.find((bot) => bot.directoryKey === parsed.directoryKey);
+		if ((await this.runtime.requireSession()).userId !== userId) throw new ArkmePluginError("bot-ref-account-mismatch", "账号已切换", false, 403);
+		if (current === void 0) throw new ArkmePluginError("bot-ref-expired", "Bot 已不可用，请刷新列表", false, 410);
+		return await this.openBotRef(current.botRef, userId);
+	}
 	async openBotRef(botRef, expectedUserId) {
 		const normalized = botRef.trim();
+		if (normalized.startsWith("arkme-bot-directory-entry-v1.")) return await this.openDirectoryBotRef(normalized, expectedUserId);
 		if (!BOT_REF_PATTERN.test(normalized)) throw new ArkmePluginError("bot-ref-invalid", "Bot 引用无效", false);
 		const entry = this.botRefs.get(normalized);
 		if (entry === void 0) throw new ArkmePluginError("bot-ref-expired", "Bot 引用已过期，请刷新 Bot 列表", false, 410);
@@ -36675,6 +37417,29 @@ function decodeDataLine(line) {
 	}
 	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 }
+function decodeArkmeMemberJoinedDataLine(line) {
+	const source = decodeDataLine(line);
+	if (source === void 0 || positiveInteger(source.t) !== 24) return void 0;
+	if (Object.keys(source).some((key) => ![
+		"t",
+		"event_uid",
+		"chat_session_uid",
+		"actor_user_id",
+		"member_user_id",
+		"join_at",
+		"event_at",
+		"source_client_id"
+	].includes(key))) return void 0;
+	const eventUid = nonEmptyString(source.event_uid);
+	const chatSessionUid = nonEmptyString(source.chat_session_uid);
+	const eventAtMillis = positiveInteger(source.event_at);
+	if (eventUid === void 0 || chatSessionUid === void 0 || eventAtMillis === void 0 || positiveInteger(source.actor_user_id) === void 0 || positiveInteger(source.member_user_id) === void 0 || positiveInteger(source.join_at) === void 0 || nonNegativeInteger(source.source_client_id) === void 0) return void 0;
+	return {
+		eventUid,
+		chatSessionUid,
+		eventAtMillis
+	};
+}
 function decodeArkmeMemberEventDataLine(line) {
 	const source = decodeDataLine(line);
 	if (source === void 0 || positiveInteger(source.t) !== 27) return void 0;
@@ -37243,6 +38008,7 @@ var ArkmeChatRealtimeRuntime = class {
 		if (connectionSignal.aborted) return;
 		const policyUpdated = decodeArkmeChatPolicyUpdatedDataLine(line);
 		if (policyUpdated !== void 0 && policyUpdated.userId !== connectionUserId) return;
+		const memberJoined = decodeArkmeMemberJoinedDataLine(line);
 		const memberEvent = decodeArkmeMemberEventDataLine(line);
 		const conversationListPreferenceUpdated = decodeArkmeConversationListPreferenceUpdatedDataLine(line);
 		const projectionInvalidation = conversationListPreferenceUpdated === void 0 ? decodeArkmeProjectionInvalidatedDataLine(line) : void 0;
@@ -37250,20 +38016,29 @@ var ArkmeChatRealtimeRuntime = class {
 		const timelineChanged = conversationListPreferenceUpdated === void 0 && projectionInvalidation === void 0 && readCursorAdvanced === void 0 ? decodeArkmeChatTimelineChangedDataLine(line) : void 0;
 		const messagePreparing = decodeArkmeChatMessagePreparingDataLine(line);
 		const hint = conversationListPreferenceUpdated === void 0 && projectionInvalidation === void 0 && readCursorAdvanced === void 0 && timelineChanged === void 0 ? decodeArkmeChatReceiveDataLine(line) : void 0;
-		const eventUid = policyUpdated?.eventUid ?? memberEvent?.eventUid ?? conversationListPreferenceUpdated?.eventUid ?? projectionInvalidation?.eventUid ?? readCursorAdvanced?.eventUid ?? timelineChanged?.eventUid ?? messagePreparing?.eventUid ?? hint?.eventUid;
+		const eventUid = policyUpdated?.eventUid ?? memberJoined?.eventUid ?? memberEvent?.eventUid ?? conversationListPreferenceUpdated?.eventUid ?? projectionInvalidation?.eventUid ?? readCursorAdvanced?.eventUid ?? timelineChanged?.eventUid ?? messagePreparing?.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 = policyUpdated?.eventAtMillis ?? memberEvent?.eventAtMillis ?? conversationListPreferenceUpdated?.acceptedAtMillis ?? projectionInvalidation?.eventAtMillis ?? readCursorAdvanced?.eventAtMillis ?? timelineChanged?.eventAtMillis ?? messagePreparing?.eventAtMillis ?? hint?.eventAtMillis;
+		this.lastEventAtMillis = policyUpdated?.eventAtMillis ?? memberJoined?.eventAtMillis ?? memberEvent?.eventAtMillis ?? conversationListPreferenceUpdated?.acceptedAtMillis ?? projectionInvalidation?.eventAtMillis ?? readCursorAdvanced?.eventAtMillis ?? timelineChanged?.eventAtMillis ?? messagePreparing?.eventAtMillis ?? hint?.eventAtMillis;
 		if (policyUpdated !== void 0) this.advanceRevision("chat-policy-invalidation", {
 			policyUpdated,
 			connectionUserId,
 			connectionSignal
 		});
-		else if (memberEvent !== void 0) this.advanceRevision("chat-hint", { memberEvent });
+		else if (memberJoined !== void 0) this.advanceRevision("chat-hint", {
+			memberJoined,
+			connectionUserId,
+			connectionSignal
+		});
+		else if (memberEvent !== void 0) this.advanceRevision("chat-hint", {
+			memberEvent,
+			connectionUserId,
+			connectionSignal
+		});
 		else 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", {
@@ -37287,11 +38062,12 @@ var ArkmeChatRealtimeRuntime = class {
 		});
 	}
 	advanceRevision(cause, evidence = {}) {
-		const { hint, readCursorAdvanced, policyUpdated, projectionInvalidation, timelineChanged, messagePreparing, connectionUserId, connectionSignal, connectionStartedAtMillis, conversationListPreferenceUpdated, memberEvent } = evidence;
+		const { hint, readCursorAdvanced, policyUpdated, projectionInvalidation, timelineChanged, messagePreparing, connectionUserId, connectionSignal, connectionStartedAtMillis, conversationListPreferenceUpdated, memberEvent, memberJoined } = evidence;
 		this.revision += 1;
 		const notice = {
 			state: this.state(),
 			cause,
+			...memberJoined === void 0 ? {} : { memberJoined },
 			...memberEvent === void 0 ? {} : { memberEvent },
 			...timelineChanged === void 0 ? {} : { timelineChanged },
 			...messagePreparing === void 0 ? {} : { messagePreparing },
@@ -37360,6 +38136,7 @@ var ChatRealtimeService = class {
 	source;
 	projectionReader;
 	nativeAttention;
+	directoryBaseline;
 	disposed = false;
 	chatRealtime;
 	chatClientListeners = /* @__PURE__ */ new Set();
@@ -37480,8 +38257,8 @@ var ChatRealtimeService = class {
 			this.invalidateChatPolicyForCurrentSession(notice);
 			return;
 		}
-		if (notice.cause === "chat-hint" && notice.memberEvent !== void 0) {
-			this.handleMemberEvent(notice.memberEvent);
+		if (notice.cause === "chat-hint" && (notice.memberEvent !== void 0 || notice.memberJoined !== void 0)) {
+			this.handleMemberEvent(notice);
 			return;
 		}
 		if (notice.cause === "reconcile") {
@@ -37635,13 +38412,21 @@ var ChatRealtimeService = class {
 			console.warn("dsh-arkme: Chat timeline invalidation failed:", safeFailureMessage$5(error));
 		}
 	}
-	async handleMemberEvent(hint) {
+	async handleMemberEvent(notice) {
+		const hint = notice.memberJoined ?? notice.memberEvent;
+		if (hint === void 0 || notice.connectionSignal?.aborted) return;
 		try {
 			const session = await this.runtime.sessionStore.read();
-			if (session === void 0) return;
+			if (session === void 0 || notice.connectionUserId !== void 0 && notice.connectionUserId !== session.userId) return;
+			this.runtime.invalidateMemberCache?.();
 			const sourceKey = await this.source.chatDirectorySourceKey(session.userId, hint.chatSessionUid);
-			if ((await this.runtime.sessionStore.read())?.userId !== session.userId) return;
-			this.emitChatClientEvent({
+			if (notice.connectionSignal?.aborted || (await this.runtime.sessionStore.read())?.userId !== session.userId) return;
+			if (notice.memberJoined !== void 0) this.emitChatClientEvent({
+				type: "members-invalidated",
+				revision: this.nextChatClientRevision(),
+				sourceKey
+			});
+			else this.emitChatClientEvent({
 				type: "member-events-invalidated",
 				revision: this.nextChatClientRevision(),
 				sourceKey,
@@ -37866,11 +38651,12 @@ var ChatRealtimeService = class {
 			this.notificationBaselineSequences.clear();
 			const sequences = /* @__PURE__ */ new Map();
 			const pins = [];
-			this.source.invalidateSourceListCache(session.userId, "root");
+			const shared = this.directoryBaseline === void 0 ? void 0 : await this.directoryBaseline();
 			let cursor;
-			for (let pageIndex = 0; pageIndex < 10; pageIndex += 1) {
-				const page = await this.source.listSources("root", {
-					limit: 50,
+			const visited = /* @__PURE__ */ new Set();
+			while (true) {
+				const page = shared ?? await this.source.listSources("root", {
+					limit: 20,
 					refresh: true,
 					...cursor === void 0 ? {} : { cursor }
 				});
@@ -37887,8 +38673,10 @@ var ChatRealtimeService = class {
 						policyUpdatedAtMillis: item.chatPolicyUpdatedAtMillis
 					});
 				}
-				if (!page.hasMore || page.nextCursor === void 0) break;
+				if (shared !== void 0 || !page.hasMore) break;
+				if (page.nextCursor === void 0 || visited.has(page.nextCursor)) throw new Error("Notification directory cursor is invalid");
 				cursor = page.nextCursor;
+				visited.add(cursor);
 			}
 			const activeSession = await this.runtime.sessionStore.read();
 			const state = this.chatRealtime.state();
@@ -38377,6 +39165,160 @@ var ChatRealtimeService = class {
 	}
 };
 //#endregion
+//#region src/member-directory.ts
+/** Only for the members/page and members/by-user-ids read contracts: 2001/2002 mean unreadable membership/session. */
+function invalidatesMemberSnapshot(error) {
+	const failure = error;
+	const code = failure?.body?.code ?? failure?.code;
+	return code !== void 0 && [
+		"auth-http-401",
+		"auth-http-403",
+		"login-required",
+		"login-expired",
+		"source-ref-invalid",
+		"arkme-code-1000",
+		"arkme-code-403",
+		"arkme-code-1004",
+		"arkme-code-2001",
+		"arkme-code-2002",
+		"chat-members-source-invalid"
+	].includes(code);
+}
+function mergeMemberFacts(previous, facts) {
+	const { memberName: _oldName, ...base } = previous ?? {
+		displayName: facts.memberName || "群成员",
+		recordCount: 0,
+		mentionCount: 0,
+		statsKnown: false
+	};
+	return {
+		...base,
+		memberRef: facts.memberRef,
+		role: facts.role,
+		status: facts.status,
+		isSelf: facts.isSelf,
+		isOwner: facts.isOwner,
+		joinedAtMillis: facts.joinedAtMillis,
+		...facts.memberName === void 0 ? {} : { memberName: facts.memberName }
+	};
+}
+function mergeMemberPresentation(previous, incoming, profileUnavailable) {
+	if (!profileUnavailable) return {
+		...incoming,
+		statsKnown: true
+	};
+	return {
+		...incoming,
+		statsKnown: true,
+		...[
+			"",
+			"群成员",
+			"成员"
+		].includes(incoming.displayName) && previous !== void 0 ? { displayName: previous.displayName } : {},
+		...previous?.avatarRef === void 0 ? {} : { avatarRef: previous.avatarRef }
+	};
+}
+/** Membership creates entities; details can only enrich or explicitly remove known entities. */
+function applyMemberUpdate(members, update) {
+	let changed = false;
+	const put = (item) => {
+		const old = members.get(item.memberRef);
+		const fields = /* @__PURE__ */ new Set([...Object.keys(old ?? {}), ...Object.keys(item)]);
+		if (old !== void 0 && [...fields].every((field) => old[field] === item[field])) return;
+		members.set(item.memberRef, item);
+		changed = true;
+	};
+	if (update.kind === "membership") for (const facts of update.items) put(mergeMemberFacts(members.get(facts.memberRef), facts));
+	else {
+		const unavailable = new Set(update.unavailableProfileMemberRefs);
+		for (const item of update.items) {
+			const old = members.get(item.memberRef);
+			if (old !== void 0) put(mergeMemberPresentation(old, item, unavailable.has(item.memberRef)));
+		}
+	}
+	for (const ref of update.removedMemberRefs) if (members.delete(ref)) changed = true;
+	return changed;
+}
+function validFacts(value) {
+	if (!value || typeof value !== "object") return false;
+	const item = value;
+	return typeof item.memberRef === "string" && item.memberRef.trim() !== "" && item.status === "active" && [
+		"owner",
+		"admin",
+		"member",
+		"unknown"
+	].includes(item.role) && typeof item.isSelf === "boolean" && typeof item.isOwner === "boolean" && Number.isSafeInteger(item.joinedAtMillis) && item.joinedAtMillis >= 0 && (item.memberName === void 0 || typeof item.memberName === "string");
+}
+function cachedMemberItem(value) {
+	if (!validFacts(value)) return void 0;
+	const item = value;
+	if (typeof item.displayName !== "string" || !Number.isSafeInteger(item.recordCount) || item.recordCount < 0 || !Number.isSafeInteger(item.mentionCount) || item.mentionCount < 0 || item.statsKnown !== void 0 && typeof item.statsKnown !== "boolean") return void 0;
+	const result = {
+		memberRef: item.memberRef,
+		role: item.role,
+		status: item.status,
+		isSelf: item.isSelf,
+		isOwner: item.isOwner,
+		joinedAtMillis: item.joinedAtMillis,
+		displayName: item.displayName,
+		recordCount: item.recordCount,
+		mentionCount: item.mentionCount,
+		...item.statsKnown === void 0 ? {} : { statsKnown: item.statsKnown }
+	};
+	for (const field of [
+		"memberName",
+		"secondaryName",
+		"avatarRef",
+		"mentionRef",
+		"mentionDisplayName",
+		"mentionSecondaryName"
+	]) {
+		if (item[field] === void 0) continue;
+		if (typeof item[field] !== "string") return void 0;
+		result[field] = item[field];
+	}
+	return result;
+}
+function validateMemberUpdate(update) {
+	if (!Array.isArray(update.items) || !Array.isArray(update.removedMemberRefs) || update.items.some((item) => !validFacts(item)) || new Set(update.items.map((item) => item.memberRef)).size !== update.items.length || update.removedMemberRefs.some((ref) => typeof ref !== "string" || !ref || update.items.some((item) => item.memberRef === ref))) throw new Error("成员响应无效");
+	if (update.kind === "presentation") {
+		if (update.items.length + update.removedMemberRefs.length > 50) throw new Error("成员资料超出批次上限");
+		if (!Array.isArray(update.unavailableProfileMemberRefs) || update.unavailableProfileMemberRefs.some((ref) => !update.items.some((item) => item.memberRef === ref)) || update.items.some((item) => cachedMemberItem(item) === void 0)) throw new Error("成员资料响应无效");
+	} else if (update.kind !== "membership" || ![
+		"owner",
+		"admin",
+		"member"
+	].includes(update.selfRole) || typeof update.hasMore !== "boolean" || update.items.length + update.removedMemberRefs.length > 100) throw new Error("成员分页响应无效");
+}
+function joinPerson(value) {
+	if (!value || typeof value.displayName !== "string" || typeof value.isSelf !== "boolean" || value.memberRef !== void 0 && (typeof value.memberRef !== "string" || !value.memberRef.trim())) throw new Error("入群事件成员无效");
+	return {
+		displayName: value.displayName,
+		isSelf: value.isSelf,
+		...value.memberRef === void 0 ? {} : { memberRef: value.memberRef }
+	};
+}
+function mergeMemberJoinEvents(previous, incoming) {
+	const events = new Map(previous.map((event) => [event.eventId, event]));
+	for (const event of incoming) {
+		if (!event || typeof event.eventId !== "string" || !event.eventId || !["invite", "direct_add"].includes(event.action) || !Number.isSafeInteger(event.occurredAtMillis) || event.occurredAtMillis < 0 || !Array.isArray(event.invitees)) throw new Error("入群事件无效");
+		const inviter = joinPerson(event.inviter);
+		const incomingPeople = event.invitees.map(joinPerson);
+		if (incomingPeople.some((person) => !person.memberRef)) throw new Error("入群事件缺少成员身份");
+		const old = events.get(event.eventId);
+		const invitees = new Map((old?.invitees ?? []).map((person) => [person.memberRef, person]));
+		for (const person of incomingPeople) invitees.set(person.memberRef, person);
+		events.set(event.eventId, {
+			eventId: event.eventId,
+			action: event.action,
+			occurredAtMillis: event.occurredAtMillis,
+			inviter,
+			invitees: [...invitees.values()]
+		});
+	}
+	return [...events.values()].slice(-2e3);
+}
+//#endregion
 //#region src/services/member-event-service.ts
 const CURSOR_PREFIX = "arkme-member-event-cursor-v1";
 var MemberEventService = class {
@@ -41310,7 +42252,7 @@ async function projectArkmeConversationMemberJoinEvents(rawItems, options) {
 			"manual_add",
 			"added_by_member"
 		])).has(sourceType) ? "direct_add" : "invite";
-		const inviterKey = inviterUserId > 0 ? `id:${String(inviterUserId)}` : `name:${inviterDisplayName}`;
+		const inviterKey = inviterUserId > 0 ? `id:${String(inviterUserId)}` : `unknown-inviter:${String(inviteeUserId)}`;
 		const groupKey = `${String(occurredAtMillis)}|${action}|${inviterKey}`;
 		const group = groups.get(groupKey) ?? {
 			action,
@@ -41675,6 +42617,156 @@ var ChatService = class {
 		this.favoriteStickerMutationTail = pending.then(() => void 0, () => void 0);
 		return await pending;
 	}
+	async cachedSourceMembers(sourceRef, signal) {
+		signal?.throwIfAborted();
+		const session = await this.runtime.requireSession();
+		const source = await this.requireReadReceiptChatSource(sourceRef, session.userId);
+		const cached = await this.runtime.stateStore.cachedConversationMembers?.(session.userId, source.ownerRef).catch(() => void 0);
+		signal?.throwIfAborted();
+		if (cached === void 0) return void 0;
+		const invalid = [];
+		for (const member of cached.items) {
+			signal?.throwIfAborted();
+			try {
+				await this.openChatMemberRef(member.memberRef, session.userId, source.ownerRef);
+			} catch (error) {
+				if (!(error instanceof ArkmePluginError)) return void 0;
+				invalid.push(member.memberRef);
+			}
+		}
+		signal?.throwIfAborted();
+		if (invalid.length === 0) return cached;
+		await this.runtime.stateStore.forgetCachedMembers?.(session.userId, source.ownerRef, invalid).catch(() => void 0);
+	}
+	async pageSourceMembers(sourceRef, options = {}) {
+		options.signal?.throwIfAborted();
+		const session = await this.runtime.requireSession();
+		const cacheEpoch = this.runtime.memberCacheEpoch?.() ?? 0;
+		const source = await this.requireReadReceiptChatSource(sourceRef, session.userId);
+		const limit = options.limit ?? 50;
+		if (!Number.isSafeInteger(limit) || limit < 1 || limit > 100) throw new ArkmePluginError("member-page-invalid", "成员分页大小必须为 1 至 100", false, 400);
+		const after = options.cursor === void 0 ? 0 : await this.openMemberPageCursor(options.cursor, session.userId, source.ownerRef);
+		const data = await this.memberRead(session, source.ownerRef, "/api/v1/chats/members/page", {
+			chat_session_uid: source.ownerRef,
+			after_user_id: after,
+			limit,
+			active_only: false
+		}, options.signal);
+		options.signal?.throwIfAborted();
+		const raw = listValue$16(data.items).map(objectValue$2);
+		const ids = raw.map((item) => numberValue$19(item.user_id));
+		const next = numberValue$19(data.next_user_id);
+		if (stringValue$2(data.chat_session_uid) !== source.ownerRef || !Array.isArray(data.items) || typeof data.has_more !== "boolean" || chatMemberRole$1(data.self_role) === "unknown" || raw.some((item) => chatMemberStatus$1(item.status) === "unknown") || raw.length > limit || ids.some((id, index) => !Number.isSafeInteger(id) || id <= (index === 0 ? after : ids[index - 1])) || data.has_more && (raw.length === 0 || next !== ids.at(-1))) throw new ArkmePluginError("member-page-invalid-response", "成员分页响应无效", true, 502);
+		const active = raw.filter((item) => chatMemberStatus$1(item.status) === "active");
+		const items = await this.projectChatMembers(source.ownerRef, active, session, {
+			includeViewerLabels: false,
+			includeHumanMentionRefs: false,
+			basicOnly: true,
+			...options.signal === void 0 ? {} : { signal: options.signal }
+		});
+		const removedMemberRefs = await Promise.all(raw.filter((item) => chatMemberStatus$1(item.status) !== "active").map((item) => this.sealChatMemberRef(session.userId, source.ownerRef, numberValue$19(item.user_id))));
+		const signingKey = await this.runtime.stateStore.uniqueCode();
+		const joinEvents = source.kind === "group_chat" && this.runtime.config.chatMemberJoinEventsEnabled !== false ? await projectArkmeConversationMemberJoinEvents(raw, {
+			viewerUserId: session.userId,
+			memberRefForUserId: async (id) => await this.sealChatMemberRef(session.userId, source.ownerRef, id),
+			eventIdForStableKey: async (stableKey) => `arkme-chat-join-v1.${createHmac("sha256", signingKey).update(`${session.userId}|${source.ownerRef}|${stableKey}`).digest("base64url")}`
+		}) : [];
+		const page = {
+			kind: "membership",
+			selfRole: chatMemberRole$1(data.self_role),
+			source: await this.source.sourceItem(source),
+			items: items.map(({ memberRef, role, status, isSelf, isOwner, joinedAtMillis, memberName }) => ({
+				memberRef,
+				role,
+				status,
+				isSelf,
+				isOwner,
+				joinedAtMillis,
+				...memberName === void 0 ? {} : { memberName }
+			})),
+			removedMemberRefs,
+			hasMore: data.has_more,
+			joinEvents,
+			...data.has_more ? { nextCursor: await this.sealMemberPageCursor(session.userId, source.ownerRef, next) } : {}
+		};
+		if (!options.signal?.aborted && cacheEpoch === (this.runtime.memberCacheEpoch?.() ?? 0)) await this.runtime.stateStore.mergeConversationMembers?.(session.userId, source.ownerRef, page).catch(() => void 0);
+		return page;
+	}
+	async sourceMembersPresentation(sourceRef, memberRefs, options = {}) {
+		options.signal?.throwIfAborted();
+		const session = await this.runtime.requireSession();
+		const cacheEpoch = this.runtime.memberCacheEpoch?.() ?? 0;
+		const source = await this.requireReadReceiptChatSource(sourceRef, session.userId);
+		if (memberRefs.length < 1 || memberRefs.length > 50 || new Set(memberRefs).size !== memberRefs.length) throw new ArkmePluginError("member-presentation-invalid", "每次需要 1 至 50 个不同成员引用", false, 400);
+		const ids = (await Promise.all(memberRefs.map((ref) => this.openChatMemberRef(ref, session.userId, source.ownerRef)))).map((ref) => ref.targetUserId);
+		const data = await this.memberRead(session, source.ownerRef, "/api/v1/chats/members/by-user-ids", {
+			chat_session_uid: source.ownerRef,
+			user_ids: ids,
+			active_only: true
+		}, options.signal);
+		options.signal?.throwIfAborted();
+		const raw = listValue$16(data.items).map(objectValue$2);
+		const returnedIds = raw.map((item) => numberValue$19(item.user_id));
+		if (stringValue$2(data.chat_session_uid) !== source.ownerRef || !Array.isArray(data.items) || raw.length > ids.length || new Set(returnedIds).size !== raw.length || returnedIds.some((id) => !ids.includes(id)) || raw.some((item) => chatMemberStatus$1(item.status) !== "active")) throw new ArkmePluginError("member-presentation-invalid-response", "成员资料响应无效", true, 502);
+		const profiles = await this.profile.publicProfileSummariesByUserIds(returnedIds, session, options.signal).catch((error) => {
+			if (options.signal?.aborted) throw error;
+			return /* @__PURE__ */ new Map();
+		});
+		const items = await this.projectChatMembers(source.ownerRef, raw, session, {
+			includeViewerLabels: false,
+			includeHumanMentionRefs: source.kind === "group_chat",
+			profiles,
+			...options.signal === void 0 ? {} : { signal: options.signal }
+		});
+		options.signal?.throwIfAborted();
+		const unavailableProfileMemberRefs = await Promise.all(returnedIds.filter((id) => !profiles.has(id)).map((id) => this.sealChatMemberRef(session.userId, source.ownerRef, id)));
+		const result = {
+			kind: "presentation",
+			source: await this.source.sourceItem(source),
+			items,
+			unavailableProfileMemberRefs,
+			removedMemberRefs: memberRefs.filter((_ref, index) => !returnedIds.includes(ids[index]))
+		};
+		if (!options.signal?.aborted && cacheEpoch === (this.runtime.memberCacheEpoch?.() ?? 0)) await this.runtime.stateStore.mergeConversationMembers?.(session.userId, source.ownerRef, result).catch(() => void 0);
+		return result;
+	}
+	async memberRead(session, group, path, body, signal) {
+		try {
+			return await this.runtime.authenticatedChatPost(path, body, session, signal, {
+				lane: path.endsWith("/members/page") ? "interactive-read" : "background-read",
+				key: `members:${this.runtime.memberCacheEpoch?.() ?? 0}:${path}:${JSON.stringify(body)}`,
+				failureCooldownMs: 2e3
+			});
+		} catch (error) {
+			if (invalidatesMemberSnapshot(error)) {
+				this.runtime.invalidateMemberCache?.();
+				await this.runtime.stateStore.clearConversationMembers?.(session.userId, group).catch(() => void 0);
+			}
+			throw error;
+		}
+	}
+	async sealMemberPageCursor(userId, group, after) {
+		const encoded = encodeOpaqueJson$6({
+			userId,
+			group,
+			after
+		});
+		return `arkme-member-page-v1.${encoded}.${createHmac("sha256", await this.runtime.stateStore.uniqueCode()).update(encoded).digest("base64url")}`;
+	}
+	async openMemberPageCursor(cursor, userId, group) {
+		const [prefix, encoded, signature, extra] = cursor.split(".");
+		if (cursor.length > 4096 || prefix !== "arkme-member-page-v1" || !encoded || !signature || extra !== void 0) throw new ArkmePluginError("member-cursor-invalid", "成员分页游标无效", false, 400);
+		const expected = createHmac("sha256", await this.runtime.stateStore.uniqueCode()).update(encoded).digest("base64url");
+		if (Buffer.byteLength(signature) !== expected.length || !timingSafeEqual(Buffer.from(signature), Buffer.from(expected))) throw new ArkmePluginError("member-cursor-invalid", "成员分页游标无效", false, 400);
+		let value;
+		try {
+			value = objectValue$2(decodeOpaqueJson$5(encoded));
+		} catch {
+			throw new ArkmePluginError("member-cursor-invalid", "成员分页游标无效", false, 400);
+		}
+		if (value.userId !== userId || value.group !== group || !Number.isSafeInteger(value.after) || numberValue$19(value.after) <= 0) throw new ArkmePluginError("member-cursor-invalid", "成员分页游标与当前账号或群不匹配", false, 403);
+		return numberValue$19(value.after);
+	}
 	async listSourceMembers(sourceRef, options = {}) {
 		const session = await this.runtime.requireSession();
 		const source = await this.source.openSourceRef(sourceRef, session.userId);
@@ -42084,6 +43176,14 @@ var ChatService = class {
 		}, session, options.signal);
 		const item = objectValue$2(data.item);
 		if (stringValue$2(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);
+		this.runtime.invalidateMemberCache?.();
+		await this.runtime.stateStore.mergeConversationMembers?.(session.userId, source.ownerRef, {
+			kind: "presentation",
+			source: await this.source.sourceItem(source),
+			items: [],
+			removedMemberRefs: [normalizedMemberRef],
+			unavailableProfileMemberRefs: []
+		}).catch(() => void 0);
 		return {
 			sourceRef: normalizedSourceRef,
 			memberRef: normalizedMemberRef,
@@ -42263,6 +43363,41 @@ var ChatService = class {
 				userName: firstJoinDisplayName(item, ["display_name", "displayName"])
 			};
 		});
+		if (options.basicOnly === true) {
+			const cache = await this.runtime.stateStore.cachedConversationMembers?.(session.userId, source.ownerRef).catch(() => void 0);
+			const cached = new Map(cache?.items.map((member) => [member.memberRef, member]));
+			const items = [];
+			for (const member of receiptMembers) {
+				const memberRef = await this.sealChatMemberRef(session.userId, source.ownerRef, member.userId);
+				const known = cached.get(memberRef);
+				const names = resolveChatMemberDisplayNames({
+					userId: member.userId,
+					remarkCandidates: [member.remarkName],
+					memberNameCandidates: [member.memberName],
+					userNameCandidates: [member.userName]
+				});
+				const currentName = names.displayName !== "群成员";
+				items.push({
+					memberRef,
+					displayName: currentName ? names.displayName : known?.displayName ?? names.displayName,
+					displayNameIsCurrent: currentName,
+					...known?.avatarRef === void 0 ? {} : { avatarRef: known.avatarRef },
+					readStatus: member.readStatus,
+					...member.readStatus === "read" && member.readAtMillis > 0 ? { readAtMillis: member.readAtMillis } : {}
+				});
+			}
+			const readCount = items.filter((member) => member.readStatus === "read").length;
+			return {
+				sourceRef,
+				itemUid: message.itemUid,
+				sequence: message.sequence,
+				items,
+				readCount,
+				unreadCount: items.length - readCount,
+				totalMemberCount: items.length,
+				presentationComplete: false
+			};
+		}
 		const userIds = receiptMembers.map((item) => item.userId);
 		const missingRemarkUserIds = receiptMembers.filter((item) => item.remarkName === "").map((item) => item.userId);
 		const [profiles, privateRemarks] = await Promise.all([this.profile.publicProfileSummariesByUserIds(userIds, session, options.signal).catch(() => /* @__PURE__ */ new Map()), missingRemarkUserIds.length === 0 ? Promise.resolve(/* @__PURE__ */ new Map()) : this.source.privateRemarksByUserIds(missingRemarkUserIds, options.signal === void 0 ? {} : { signal: options.signal }).catch(() => /* @__PURE__ */ new Map())]);
@@ -44270,7 +45405,7 @@ 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.privateChatViewerLabelsByUserIds(userIds, { ...options.signal === void 0 ? {} : { signal: options.signal } }).catch(() => /* @__PURE__ */ new Map()) : Promise.resolve(/* @__PURE__ */ new Map())]);
+		const [profiles, viewerLabels] = await Promise.all([options.basicOnly ? Promise.resolve(/* @__PURE__ */ new Map()) : options.profiles !== void 0 ? Promise.resolve(options.profiles) : 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));
@@ -73689,6 +74824,8 @@ var ContactDirectoryService = class {
 	world;
 	chat;
 	contactRefs = /* @__PURE__ */ new Map();
+	remarkRevision = 0;
+	recentRemarks = /* @__PURE__ */ new Map();
 	constructor(runtime, source, bot, profile, world, chat) {
 		this.runtime = runtime;
 		this.source = source;
@@ -73699,6 +74836,7 @@ var ContactDirectoryService = class {
 	}
 	dispose() {
 		this.contactRefs.clear();
+		this.recentRemarks.clear();
 	}
 	async listRecordingSpeakerUsers(session, signal) {
 		const descriptors = await this.loadMergedContactDescriptors(session, signal === void 0 ? {} : { signal });
@@ -73755,9 +74893,12 @@ var ContactDirectoryService = class {
 		const { session, entry } = await this.resolveContactRef(contactRef);
 		const publicProfile = (await this.profile.publicProfileSummariesByUserIds([entry.targetUserId], session, signal)).get(entry.targetUserId);
 		const identity = await this.contactIdentity(entry.targetUserId, entry.remark, publicProfile, session, entry.displayNameSnapshot);
+		const remark = this.contactRefs.get(contactRef.trim())?.remark ?? entry.remark;
 		const updated = {
 			...entry,
-			...identity
+			...identity,
+			remark,
+			displayName: remark || identity.nickname || identity.accountName || entry.displayNameSnapshot || "联系人"
 		};
 		this.contactRefs.set(contactRef.trim(), updated);
 		return {
@@ -73765,9 +74906,49 @@ var ContactDirectoryService = class {
 			displayName: updated.displayName,
 			nickname: updated.nickname,
 			remark: updated.remark,
+			...updated.accountName === void 0 ? {} : { accountName: updated.accountName },
 			...updated.avatarRef === void 0 ? {} : { avatarRef: updated.avatarRef }
 		};
 	}
+	async updateContactRemark(contactRef, remarkValue, signal) {
+		if (signal?.aborted) throw new DOMException("The operation was aborted", "AbortError");
+		const { session, entry } = await this.resolveContactRef(contactRef);
+		const remark = remarkValue.trim();
+		if (Array.from(remark).length > 100) throw new ArkmePluginError("directory-contact-remark-too-long", "备注名最多 100 个字符", false, 400);
+		if (entry.chatSessionUid === void 0) throw new ArkmePluginError("directory-contact-session-unavailable", "暂时无法修改此联系人的备注，请刷新联系人后重试", true, 409);
+		if (signal?.aborted) throw new DOMException("The operation was aborted", "AbortError");
+		const data = await this.runtime.authenticatedChatPost("/api/v1/chats/contacts/update-remark", {
+			chat_session_uid: entry.chatSessionUid,
+			remark,
+			update_at: Date.now()
+		}, session, signal);
+		this.runtime.invalidateKey(this.runtime.requestScope(session.userId), "directory:contacts:");
+		const contact = objectValue$2(data.contact);
+		if (stringValue$2(contact.chat_session_uid) !== entry.chatSessionUid || numberValue$17(contact.user_id) !== entry.targetUserId || contact.remark !== void 0 && typeof contact.remark !== "string") throw new ArkmePluginError("directory-contact-remark-response-invalid", "备注保存响应不完整，请重试", true, 502);
+		const savedRemark = stringValue$2(contact.remark).trim();
+		this.remarkRevision += 1;
+		this.recentRemarks.set(`${session.userId}:${entry.targetUserId}`, {
+			revision: this.remarkRevision,
+			remark: savedRemark
+		});
+		for (const [ref, current] of this.contactRefs) {
+			if (current.viewerUserId !== session.userId || current.targetUserId !== entry.targetUserId) continue;
+			this.contactRefs.set(ref, {
+				...current,
+				remark: savedRemark,
+				displayName: savedRemark || current.nickname || current.accountName || current.displayNameSnapshot || "联系人"
+			});
+		}
+		const current = this.contactRefs.get(contactRef.trim()) ?? entry;
+		return {
+			contactRef: contactRef.trim(),
+			remark: savedRemark,
+			displayName: savedRemark || current.nickname || current.accountName || current.displayNameSnapshot || "联系人",
+			nickname: current.nickname,
+			...current.accountName === void 0 ? {} : { accountName: current.accountName },
+			...current.avatarRef === void 0 ? {} : { avatarRef: current.avatarRef }
+		};
+	}
 	async contactWorld(contactRef, options = {}) {
 		const { entry } = await this.resolveContactRef(contactRef);
 		return await this.world.listUserWorldFeed(entry.targetUserId, cloneWorldOptions(options));
@@ -73830,6 +75011,7 @@ var ContactDirectoryService = class {
 		const session = await this.runtime.requireSession();
 		const limit = boundedLimit$1(options.limit);
 		const offset = await this.openOffsetCursor("contacts", options.cursor, session.userId);
+		const revisionAtStart = this.remarkRevision;
 		const descriptors = await this.loadMergedContactDescriptors(session, options);
 		const pageDescriptors = descriptors.slice(offset, offset + limit);
 		const profiles = await this.profile.publicProfileSummariesByUserIds(pageDescriptors.map((item) => item.targetUserId), session, options.signal);
@@ -73837,7 +75019,17 @@ var ContactDirectoryService = class {
 		this.pruneContactRefs();
 		for (const descriptor of pageDescriptors) {
 			const identity = await this.contactIdentity(descriptor.targetUserId, descriptor.remark, profiles.get(descriptor.targetUserId), session, descriptor.displayNameSnapshot);
-			const contactRef = `arkme-directory-contact-v1.${randomUUID()}`;
+			const recent = this.recentRemarks.get(`${session.userId}:${descriptor.targetUserId}`);
+			if (recent !== void 0 && recent.revision > revisionAtStart) {
+				identity.remark = recent.remark;
+				identity.displayName = recent.remark || identity.nickname || identity.accountName || descriptor.displayNameSnapshot || "联系人";
+			}
+			let contactRef;
+			for (const [ref, current] of this.contactRefs) if (current.viewerUserId === session.userId && current.targetUserId === descriptor.targetUserId && current.expiresAtMillis > Date.now()) {
+				contactRef = ref;
+				break;
+			}
+			contactRef ??= `arkme-directory-contact-v1.${randomUUID()}`;
 			const entry = {
 				viewerUserId: session.userId,
 				targetUserId: descriptor.targetUserId,
@@ -73846,6 +75038,7 @@ var ContactDirectoryService = class {
 				...identity,
 				expiresAtMillis: Date.now() + CONTACT_DIRECTORY_REF_TTL_MS
 			};
+			this.contactRefs.delete(contactRef);
 			this.contactRefs.set(contactRef, entry);
 			const item = {
 				kind: "contact",
@@ -73862,12 +75055,21 @@ var ContactDirectoryService = class {
 		}
 		this.pruneContactRefs();
 		const hasMore = offset + pageDescriptors.length < descriptors.length;
+		const nextCursor = hasMore ? await this.sealOffsetCursor("contacts", offset + pageDescriptors.length, session.userId) : void 0;
+		for (const item of items) {
+			if (item.kind !== "contact") continue;
+			const current = this.contactRefs.get(item.contactRef);
+			if (current === void 0) continue;
+			item.remark = current.remark;
+			item.displayName = current.displayName;
+			item.letter = contactDirectoryLetter(item);
+		}
 		return {
 			section: "contacts",
 			items,
 			total: descriptors.length,
 			hasMore,
-			...hasMore ? { nextCursor: await this.sealOffsetCursor("contacts", offset + pageDescriptors.length, session.userId) } : {}
+			...nextCursor === void 0 ? {} : { nextCursor }
 		};
 	}
 	async loadMergedContactDescriptors(session, options) {
@@ -75190,13 +76392,15 @@ var GroupService = class {
 					});
 					continue;
 				}
-				const outcome = stringValue$2(objectValue$2((await this.runtime.authenticatedChatPost("/api/v1/chats/members/add", {
+				const data = await this.runtime.authenticatedChatPost("/api/v1/chats/members/add", {
 					chat_session_uid: source.ownerRef,
 					target_user_id: candidate.targetUserId,
 					join_at: Date.now(),
 					display_name_snapshot: candidate.displayName,
 					extra: { source: "dsh_arkme_candidate" }
-				}, session, signal)).item).outcome);
+				}, session, signal);
+				this.runtime.invalidateMemberCache?.();
+				const outcome = stringValue$2(objectValue$2(data.item).outcome);
 				results.push({
 					candidateRef,
 					displayName: candidate.displayName,
@@ -75412,6 +76616,8 @@ var GroupService = class {
 			target_user_id: session.userId,
 			action: 1
 		}, session, signal);
+		this.runtime.invalidateMemberCache?.();
+		await this.runtime.stateStore.clearConversationMembers?.(session.userId, source.ownerRef).catch(() => void 0);
 		this.source.invalidateSourceListCache(session.userId, "root");
 		return { status: "ok" };
 	}
@@ -75423,6 +76629,8 @@ var GroupService = class {
 			chat_session_uid: source.ownerRef,
 			update_at: Date.now()
 		}, session, signal);
+		this.runtime.invalidateMemberCache?.();
+		await this.runtime.stateStore.clearConversationMembers?.(session.userId, source.ownerRef).catch(() => void 0);
 		this.source.invalidateSourceListCache(session.userId, "root");
 		return { status: "ok" };
 	}
@@ -76612,12 +77820,28 @@ var MediaService = class {
 		}, void 0, 11e4);
 	}
 	async readImage(imageRef, options = {}) {
+		options.signal?.throwIfAborted();
 		const session = await this.runtime.requireSession();
 		const isProfileImage = imageRef.trim().startsWith("arkme-profile-image-v1.");
+		const isBotImage = imageRef.trim().startsWith("arkme-bot-image-v1.");
+		const isAvatar = isProfileImage || isBotImage;
 		const maximumBytes = isProfileImage ? MAX_ARKME_PROFILE_IMAGE_BYTES : MAX_ARKME_IMAGE_BYTES;
 		const byteLimit = Math.min(maximumBytes, Math.max(1, Math.trunc(options.maxBytes ?? maximumBytes)));
 		const cacheKey = `${String(session.userId)}:${String(byteLimit)}:${imageRef.trim()}`;
-		const cached = this.cachedImage(cacheKey);
+		if (isProfileImage) await this.profile.openProfileImageRef(imageRef, session.userId);
+		const persisted = isAvatar ? await this.runtime.stateStore.readAvatarCache?.(session.userId, imageRef).catch(() => void 0) : void 0;
+		if (persisted !== void 0 && options.refresh !== true && persisted.bytes <= byteLimit) {
+			this.cacheImage(cacheKey, persisted);
+			return cloneImageBytes(persisted);
+		}
+		if (isBotImage) try {
+			if (this.botImages === void 0) throw new ArkmePluginError("bot-image-ref-invalid", "Bot 头像引用不可用", false, 403);
+			await this.botImages.openBotImageRef(imageRef, session.userId);
+		} catch (error) {
+			if (persisted !== void 0 && persisted.bytes <= byteLimit) return cloneImageBytes(persisted);
+			throw error;
+		}
+		const cached = options.refresh === true ? void 0 : this.cachedImage(cacheKey);
 		if (cached !== void 0) return cached;
 		const existing = this.imageInFlight.get(cacheKey);
 		if (existing !== void 0) return cloneImageBytes(await existing);
@@ -76627,8 +77851,13 @@ var MediaService = class {
 		try {
 			const value = await pending;
 			this.cacheImage(cacheKey, value);
+			if (isAvatar) await this.runtime.stateStore.writeAvatarCache?.(session.userId, imageRef, value).catch(() => {
+				console.warn("dsh-arkme: avatar_cache_write_failed");
+			});
 			return cloneImageBytes(value);
 		} catch (error) {
+			options.signal?.throwIfAborted();
+			if (persisted !== void 0 && persisted.bytes <= byteLimit) return cloneImageBytes(persisted);
 			if (isProfileImage) logArkmeAvatarDiagnostic("image_read_failed", {
 				environment: this.runtime.config.environment,
 				viewerUserId: session.userId,
@@ -83017,6 +84246,9 @@ var UnmarkedSpeakerService = class {
 		return ref;
 	}
 	sealCursor(kind, upstreamCursor, viewerUserId, candidateRef) {
+		if (kind === "candidate") {
+			for (const [ref, entry] of this.cursorRefs) if (entry.kind === kind && entry.viewerUserId === viewerUserId && entry.upstreamCursor === upstreamCursor && entry.expiresAtMillis > Date.now()) return ref;
+		}
 		const ref = `${kind === "candidate" ? "arkme-unmarked-candidate-cursor-v1" : "arkme-unmarked-segment-cursor-v1"}.${randomUUID()}`;
 		this.cursorRefs.set(ref, {
 			viewerUserId,
@@ -85356,6 +86588,7 @@ var ArkmeService = class {
 	extensionReview;
 	media;
 	privacy;
+	directory;
 	source;
 	conversationDirectoryVisibility;
 	record;
@@ -85440,6 +86673,20 @@ var ArkmeService = class {
 		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, sourceKind) => await this.chat.chatTimelineItems(data, session, chatSessionUid, sourceKind) });
 		this.conversationDirectoryVisibility = new ConversationDirectoryVisibilityService(new ConversationListPreferenceService(this.runtime), this.source, this.bot, this.realtime);
+		this.directory = new ConversationDirectoryService(this.runtime, this.source, this.conversationDirectoryVisibility, async (signal) => await this.botConversation.directory({ signal }), async (ref, signal) => await this.media.readImage(ref, {
+			signal,
+			refresh: true
+		}), (page) => {
+			this.realtime.emitChatClientEvent({
+				type: "directory-update",
+				revision: this.realtime.nextChatClientRevision(),
+				page
+			});
+		}, async (bots, userId) => await this.bot.restoreDirectoryBots(bots, userId));
+		this.realtime.directoryBaseline = async () => await this.directory.complete();
+		this.realtime.subscribeChatRealtime((event) => {
+			if (event.type !== "directory-update") this.directory.accept(event).catch(() => void 0);
+		});
 		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.directMessageAdmissionOwner = new DirectMessageAdmissionService(this.runtime, this.source);
@@ -85543,6 +86790,7 @@ var ArkmeService = class {
 		return await this.backgroundSoundPreferenceOwner.update(enabled, signal, expectedUserId);
 	}
 	clearAccountState(userIds) {
+		this.directory.reset();
 		this.realtime.resetAttentionSummary();
 		for (const userId of userIds) this.privacy.clear(userId);
 		this.fileTransfers?.cancelActive();
@@ -85590,13 +86838,19 @@ var ArkmeService = class {
 		return await this.bot.connectOpenClawBot(botRef, options);
 	}
 	async listBots(options = {}) {
-		return await this.bot.listBots(options);
+		const { userId } = await this.runtime.requireSession();
+		const result = await this.bot.listBots(options);
+		this.directory.rememberBots(result.items, userId).catch(() => void 0);
+		return result;
 	}
 	async createBot(input, options = {}) {
 		return await this.bot.createBot(input, options);
 	}
 	async createBotSummary(input, options = {}) {
-		return await this.bot.createBotSummary(input, options);
+		const { userId } = await this.runtime.requireSession();
+		const bot = await this.bot.createBotSummary(input, options);
+		this.directory.rememberBots([bot], userId).catch(() => void 0);
+		return bot;
 	}
 	async revealBotSecret(botRef, options = {}) {
 		return await this.bot.revealBotSecret(botRef, options);
@@ -85611,7 +86865,9 @@ var ArkmeService = class {
 		return await this.bot.revealManagedBotToken(botRef, options);
 	}
 	async deleteManagedBot(botRef, confirmationName, options = {}) {
+		const { userId } = await this.runtime.requireSession();
 		await this.bot.deleteManagedBot(botRef, confirmationName, options);
+		await this.directory.forgetBot(botRef, userId).catch(() => void 0);
 	}
 	async botNotificationPreference(botRef, options = {}) {
 		return await this.botConversation.notificationPreference(botRef, options);
@@ -85712,6 +86968,7 @@ var ArkmeService = class {
 				recordCalendar: true,
 				imageLibrary: true,
 				sourceDirectory: true,
+				localFirstDirectory: true,
 				sourceTimeline: true,
 				forwardContent: true,
 				sourceTextSend: true,
@@ -85728,6 +86985,7 @@ var ArkmeService = class {
 				outgoingCall: true,
 				callHistory: true,
 				groupMembers: true,
+				memberDirectoryPaging: true,
 				groupMemberAdd: true,
 				userCard: true,
 				openPrivateChat: true,
@@ -85804,6 +87062,7 @@ var ArkmeService = class {
 		return await this.callHistory.retryCallSummary(callRef, signal);
 	}
 	dispose() {
+		this.directory.reset();
 		this.record.dispose();
 		this.realtime.resetAttentionSummary();
 		this.fileTransfers?.cancelActive();
@@ -85849,6 +87108,9 @@ var ArkmeService = class {
 	async directoryContactProfile(contactRef, signal) {
 		return await this.contactDirectory.contactProfile(contactRef, signal);
 	}
+	async updateDirectoryContactRemark(contactRef, remark, signal) {
+		return await this.contactDirectory.updateContactRemark(contactRef, remark, signal);
+	}
 	async directoryContactWorld(contactRef, options = {}) {
 		return await this.contactDirectory.contactWorld(contactRef, options);
 	}
@@ -85974,7 +87236,10 @@ var ArkmeService = class {
 		return await this.profile.refreshProfile();
 	}
 	async arkoProfile(signal) {
-		return await this.arko.arkoProfile(signal);
+		const { userId } = await this.runtime.requireSession();
+		const profile = await this.arko.arkoProfile(signal);
+		this.directory.rememberSpecial({ arkoProfile: profile }, userId).catch(() => void 0);
+		return profile;
 	}
 	async arkoEnsureSession(signal) {
 		return await this.arko.arkoEnsureSession(signal);
@@ -85989,7 +87254,16 @@ var ArkmeService = class {
 		return await this.arko.arkoActivateModel(routeKey, signal);
 	}
 	async arkoHistoryPage(limit = 50, offset = 0, signal) {
-		return await this.arko.arkoHistoryPage(limit, offset, signal);
+		const { userId } = await this.runtime.requireSession();
+		const page = await this.arko.arkoHistoryPage(limit, offset, signal);
+		if (offset === 0) {
+			const latest = [...page.items].filter((item) => item.text.trim() !== "").sort((a, b) => b.createdAtMillis - a.createdAtMillis || b.messageId - a.messageId)[0];
+			if (latest !== void 0) this.directory.rememberSpecial({ arkoPreview: {
+				text: latest.text,
+				createdAtMillis: latest.createdAtMillis
+			} }, userId).catch(() => void 0);
+		}
+		return page;
 	}
 	async arkoAsk(text, options = {}) {
 		return await this.arko.arkoAsk(text, options);
@@ -86046,16 +87320,34 @@ var ArkmeService = class {
 		return await this.source.moveTopicHierarchy(sourceRef, currentParentSourceRef, nextParentSourceRef, insertBeforeSourceRef);
 	}
 	async listSources(directory, options = {}) {
-		return await this.source.listSources(directory, options);
+		if (options.localFirst === true) {
+			if (directory !== "root") throw new ArkmePluginError("source-directory-invalid", "本地目录仅支持会话列表", false);
+			return await this.directory.read(options.refresh === true, options.signal);
+		}
+		const { userId } = await this.runtime.requireSession();
+		const page = await this.source.listSources(directory, options);
+		if (directory === "send_to_self") {
+			const sendToSelf = page.items.find((item) => item.kind === "send_to_self");
+			if (sendToSelf !== void 0) this.directory.rememberSpecial({ sendToSelf }, userId).catch(() => void 0);
+		}
+		return page;
 	}
 	async setChatDirectoryPin(sourceRef, pinned, signal) {
-		return await this.source.setChatDirectoryPin(sourceRef, pinned, signal);
+		const { userId } = await this.runtime.requireSession();
+		const result = await this.source.setChatDirectoryPin(sourceRef, pinned, signal);
+		await this.directory.confirmPin(sourceRef, result.pinned, result.policyUpdatedAtMillis, userId).catch(() => void 0);
+		return result;
+	}
+	async setBotDirectoryPin(botRef, pinned) {
+		await this.directory.pinBot(botRef, pinned);
 	}
 	async conversationDirectoryVisibilitySnapshot(sourceRefs, botRefs, signal) {
 		return await this.conversationDirectoryVisibility.query(sourceRefs, botRefs, signal);
 	}
 	async setConversationDirectoryVisibility(entryKind, entryRef, hidden, signal) {
+		const { userId } = await this.runtime.requireSession();
 		await this.conversationDirectoryVisibility.setVisibility(entryKind, entryRef, hidden, signal);
+		await this.directory.confirmVisibility(entryKind, entryRef, hidden, userId).catch(() => void 0);
 	}
 	async dshBetaCommunityEntryState(signal) {
 		return await this.community.dshBetaCommunityEntryState(signal);
@@ -86116,6 +87408,15 @@ var ArkmeService = class {
 	async listGroupMembers(sourceRef, options = {}) {
 		return await this.group.listGroupMembers(sourceRef, options);
 	}
+	async cachedSourceMembers(sourceRef, signal) {
+		return await this.chat.cachedSourceMembers(sourceRef, signal);
+	}
+	async pageSourceMembers(sourceRef, options = {}) {
+		return await this.chat.pageSourceMembers(sourceRef, options);
+	}
+	async sourceMembersPresentation(sourceRef, memberRefs, options = {}) {
+		return await this.chat.sourceMembersPresentation(sourceRef, memberRefs, options);
+	}
 	async listSourceMembers(sourceRef, options = {}) {
 		return await this.chat.listSourceMembers(sourceRef, options);
 	}
@@ -86154,10 +87455,16 @@ var ArkmeService = class {
 		return result;
 	}
 	async leaveGroup(sourceRef, signal) {
-		return await this.group.leaveGroup(sourceRef, signal);
+		const { userId } = await this.runtime.requireSession();
+		const result = await this.group.leaveGroup(sourceRef, signal);
+		await this.directory.forgetSource(sourceRef, userId).catch(() => void 0);
+		return result;
 	}
 	async dissolveGroup(sourceRef, signal) {
-		return await this.group.dissolveGroup(sourceRef, signal);
+		const { userId } = await this.runtime.requireSession();
+		const result = await this.group.dissolveGroup(sourceRef, signal);
+		await this.directory.forgetSource(sourceRef, userId).catch(() => void 0);
+		return result;
 	}
 	async reportGroup(sourceRef, reason, signal) {
 		return await this.group.reportGroup(sourceRef, reason, signal);
@@ -88230,4 +89537,4 @@ async function invokePersistentArkmeExtension(extensionId, method, args) {
 	return jsonValue(await handler(jsonValue(args)));
 }
 //#endregion
-export { parseArkmeRecordReeditAttachments 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, ArkmeRecordReeditDraftConflict 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 _, ArkmeOutgoingCallError as _t, persistentArkmeExtensionActive as a, ARKME_WORLD_PUBLISH_MAX_IMAGES as at, verifyExtensionResolutionSignature as b, ArkmePluginError as bt, persistentExtensionBundleDirectory as c, ARKME_TOOL_FILE_MAX_BYTES as ct, readPersistentExtensionActivation as d, arkmePickedFileKind as dt, ARKME_DEFAULT_SHARE_WEBSITE as et, refreshPersistentClientWrapper as f, isArkmeBotAvatarRef as ft, activeProfileExtensionOwnerConflicts as g, recordingImportFileNameKey as gt, renderArkmeBundleClientBundle as h, MAX_RECORDING_IMPORT_BYTES as ht, invokePersistentArkmeExtension as i, ARKME_VOICEPRINT_ENROLLMENT_MIN_DURATION_MS as it, packBundleFiles as j, inspectBundleArtifact as k, persistentExtensionPackageIdentity as l, arkmeCanInlineLocalFile as lt, writePersistentExtensionActivation as m, sameRecordingImportIdentity as mt, applyPersistentArkmeHostExtension as n, ARKME_VOICEPRINT_ENROLLMENT_MAX_AUDIO_BYTES as nt, persistentArkmeExtensionRuntimeState as o, ARKME_WORLD_PUBLISH_MAX_IMAGE_BYTES as ot, repairPersistentExtensionInstallation as p, recordingImportFileKind as pt, arkmeExtensionShareRefFromLink as q, deactivatePersistentArkmeExtension as r, ARKME_VOICEPRINT_ENROLLMENT_MAX_DURATION_MS as rt, materializePersistentExtensionBundle as s, ARKME_RUNTIME_INSTANCE_ID as st, activatePersistentArkmeExtension as t, ARKME_PROVIDER_CONTRACT_VERSION as tt, quarantinePersistentExtension as u, arkmeNormalizedFileMimeType as ut, arkmeClientContentDigestFromSource as v, SecretValue as vt, ARKME_NATIVE_BUNDLE_ARTIFACT_KIND as w, verifyNativeBundleResolutionSignature as x, verifyBundleResolutionSignature as y, ArkmeDirectMessageAdmissionError as yt, ARKME_EXTENSION_FORMAT as z };
+export { parseArkmeRecordReeditAttachments as $, inspectNativeBundleArtifactV3 as A, __toCommonJS as At, ARKME_EXTENSION_ICON_MAX_BYTES as B, ARKME_BUNDLE_MAX_BYTES as C, ArkmeDirectMessageAdmissionError as Ct, bundleSha256 as D, __esmMin as Dt, arkmeSandboxEntryId as E, __commonJSMin as Et, 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, __exportAll as Ot, renderArkmeSandboxHostEntry as P, ArkmeRecordReeditDraftConflict as Q, unpackArkmeExtension as R, ARKME_BUNDLE_ARTIFACT_KIND as S, SecretValue as St, ArkmeBundleArtifactError as T, createDesktopLifecycleReader as Tt, 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 _, recordingImportFileKind as _t, persistentArkmeExtensionActive as a, ARKME_WORLD_PUBLISH_MAX_IMAGES as at, verifyExtensionResolutionSignature as b, recordingImportFileNameKey as bt, persistentExtensionBundleDirectory as c, cachedMemberItem as ct, readPersistentExtensionActivation as d, ARKME_RUNTIME_INSTANCE_ID as dt, ARKME_DEFAULT_SHARE_WEBSITE as et, refreshPersistentClientWrapper as f, ARKME_TOOL_FILE_MAX_BYTES as ft, activeProfileExtensionOwnerConflicts as g, isArkmeBotAvatarRef as gt, renderArkmeBundleClientBundle as h, arkmePickedFileKind as ht, invokePersistentArkmeExtension as i, ARKME_VOICEPRINT_ENROLLMENT_MIN_DURATION_MS as it, packBundleFiles as j, inspectBundleArtifact as k, __require as kt, persistentExtensionPackageIdentity as l, mergeMemberJoinEvents as lt, writePersistentExtensionActivation as m, arkmeNormalizedFileMimeType as mt, applyPersistentArkmeHostExtension as n, ARKME_VOICEPRINT_ENROLLMENT_MAX_AUDIO_BYTES as nt, persistentArkmeExtensionRuntimeState as o, ARKME_WORLD_PUBLISH_MAX_IMAGE_BYTES as ot, repairPersistentExtensionInstallation as p, arkmeCanInlineLocalFile as pt, arkmeExtensionShareRefFromLink as q, deactivatePersistentArkmeExtension as r, ARKME_VOICEPRINT_ENROLLMENT_MAX_DURATION_MS as rt, materializePersistentExtensionBundle as s, applyMemberUpdate as st, activatePersistentArkmeExtension as t, ARKME_PROVIDER_CONTRACT_VERSION as tt, quarantinePersistentExtension as u, validateMemberUpdate as ut, arkmeClientContentDigestFromSource as v, sameRecordingImportIdentity as vt, ARKME_NATIVE_BUNDLE_ARTIFACT_KIND as w, ArkmePluginError as wt, verifyNativeBundleResolutionSignature as x, ArkmeOutgoingCallError as xt, verifyBundleResolutionSignature as y, MAX_RECORDING_IMPORT_BYTES as yt, ARKME_EXTENSION_FORMAT as z };