@senguoyun/dsh-arkme 0.1.85 → 0.1.87

package/lib/{persistent-runtime-adGFmkIa.js → persistent-runtime-0qn1BZ6S.js}

@@ -10,6 +10,7 @@ import { defineTool } from "@deepseek-ai/dsh-tools";
 import { access, chmod as chmod$1, copyFile, lstat, mkdir, mkdtemp, open, opendir, readFile, realpath, rename, rm, stat, unlink, writeFile } from "node:fs/promises";
 import { fileURLToPath, fileURLToPath as urlToPath } from "node:url";
 import { request } from "node:http";
+import { AsyncLocalStorage } from "node:async_hooks";
 import { homedir, hostname, platform, tmpdir } from "node:os";
 import { request as request$1 } from "node:https";
 import { BlockList, isIP } from "node:net";
@@ -392,7 +393,7 @@ function keys(value, allowed) {
 function text$12(value, max) {
 	if (typeof value !== "string" || value.length > max) fail$1();
 }
-function integer$6(value) {
+function integer$7(value) {
 	if (!Number.isSafeInteger(value) || value < 0) fail$1();
 }
 /** Validate the browser projection only; owner IDs and arbitrary payload fields are never persisted. */
@@ -408,9 +409,9 @@ function parseArrangementBoardCachePages(value) {
 			"nextOffset",
 			"board"
 		]);
-		integer$6(page.total);
+		integer$7(page.total);
 		if (typeof page.hasMore !== "boolean" || !Array.isArray(page.items) || page.items.length > 50 || page.items.length > page.total) fail$1();
-		if (page.nextOffset !== void 0) integer$6(page.nextOffset);
+		if (page.nextOffset !== void 0) integer$7(page.nextOffset);
 		if (page.board !== void 0) {
 			const board = object$8(page.board);
 			keys(board, ["supported", "version"]);
@@ -439,9 +440,9 @@ function parseArrangementBoardCachePages(value) {
 			text$12(item.title, 2e4);
 			text$12(item.description, 2e5);
 			text$12(item.reminderState, 256);
-			integer$6(item.createdAtMillis);
-			integer$6(item.updatedAtMillis);
-			for (const key of ["dueAtMillis", "remindAtMillis"]) if (item[key] !== void 0) integer$6(item[key]);
+			integer$7(item.createdAtMillis);
+			integer$7(item.updatedAtMillis);
+			for (const key of ["dueAtMillis", "remindAtMillis"]) if (item[key] !== void 0) integer$7(item[key]);
 			if (item.recognitionState !== void 0) text$12(item.recognitionState, 256);
 			if (item.creationSource !== void 0) {
 				const source = object$8(item.creationSource);
@@ -455,12 +456,12 @@ function parseArrangementBoardCachePages(value) {
 					"input",
 					"none"
 				].includes(source.kind) || !Array.isArray(source.items) || source.items.length > 100) fail$1();
-				integer$6(source.unavailableCount);
+				integer$7(source.unavailableCount);
 				for (const rawSource of source.items) {
 					const entry = object$8(rawSource);
 					keys(entry, ["text", "createdAtMillis"]);
 					text$12(entry.text, 2e5);
-					if (entry.createdAtMillis !== void 0) integer$6(entry.createdAtMillis);
+					if (entry.createdAtMillis !== void 0) integer$7(entry.createdAtMillis);
 				}
 			}
 		}
@@ -537,6 +538,56 @@ function stringifyOwnerJson(value) {
 	});
 }
 //#endregion
+//#region src/reaction-diagnostics.ts
+/** Timing metadata only: no credentials, message refs, names or message bodies. */
+function reactionTraceId(value) {
+	return value && /^[a-f0-9-]{36}$/.test(value) ? value : globalThis.crypto.randomUUID();
+}
+function logReactionTiming(traceId, stage, started, detail = {}) {
+	console.info(`[ArkmeReactionTiming] ${JSON.stringify({
+		traceId,
+		stage,
+		at: Date.now(),
+		durationMs: Math.round((performance.now() - started) * 100) / 100,
+		...detail
+	})}`);
+}
+//#endregion
+//#region src/reaction-host-diagnostics.ts
+const context = new AsyncLocalStorage();
+function bindReactionTrace(work) {
+	return AsyncLocalStorage.bind(work);
+}
+async function withReactionTrace(input, work) {
+	if (process.env.ARKME_REACTION_DIAGNOSTICS !== "1") return await work();
+	return await context.run(reactionTraceId(input.traceId), () => measureReaction("host-total", { action: input.action }, work));
+}
+async function measureReaction(stage, detail, work) {
+	const traceId = context.getStore();
+	if (!traceId) return await work();
+	const started = performance.now();
+	let ok = false;
+	try {
+		const result = await work();
+		ok = true;
+		return result;
+	} finally {
+		logReactionTiming(traceId, stage, started, {
+			...detail,
+			ok
+		});
+	}
+}
+function reactionQueueObserver(route) {
+	const traceId = context.getStore();
+	if (!traceId) return void 0;
+	const started = performance.now();
+	return (event, detail) => logReactionTiming(traceId, `queue-${event}`, started, {
+		route,
+		...detail
+	});
+}
+//#endregion
 //#region src/http-retry-after.ts
 /** HTTP delta-seconds and HTTP-date share one parser; never shorten a server hint. */
 function retryAfterMillis(value) {
@@ -723,6 +774,10 @@ var ArkmeRequestCoordinator = class {
 		const existing = this.inFlight.get(fullKey);
 		if (existing !== void 0 && existing.epoch === epoch && !existing.controller.signal.aborted) {
 			this.bump(request, "joined");
+			request.onQueue?.("join", {
+				lane: request.lane,
+				service: request.service
+			});
 			return await this.joinFlight(existing, request.signal).then(clone);
 		}
 		const controller = new AbortController();
@@ -825,7 +880,7 @@ var ArkmeRequestCoordinator = class {
 		const deadline = recovery === void 0 ? void 0 : setTimeout(() => controller.abort(recovery.timeout()), recovery.deadlineMs);
 		try {
 			while (true) {
-				release = await this.acquire(request.lane, request.service, controller.signal, route);
+				release = await this.acquire(request.lane, request.service, controller.signal, route, request.onQueue);
 				this.bump(request, "started");
 				if (controller.signal.aborted) throw abortError(controller.signal.reason);
 				if (this.epoch(scope) !== epoch) throw new ArkmeStaleRequestError();
@@ -902,7 +957,7 @@ var ArkmeRequestCoordinator = class {
 			});
 		});
 	}
-	acquire(lane, service, signal, route) {
+	acquire(lane, service, signal, route, onQueue) {
 		if (signal.aborted) return Promise.reject(abortError(signal.reason));
 		const laneLimit = this.laneLimits.get(lane);
 		const serviceLimit = this.serviceLimits.get(service);
@@ -928,6 +983,12 @@ var ArkmeRequestCoordinator = class {
 				const index = this.queue.indexOf(queued);
 				if (index >= 0) this.queue.splice(index, 1);
 				signal.removeEventListener("abort", abort);
+				onQueue?.("cancel", {
+					lane,
+					service,
+					queueWaitMs: this.now() - queued.queuedAt,
+					blockedBy: [...queued.blockedBy ?? []].join(",")
+				});
 				reject(abortError(signal.reason));
 			};
 			queued = {
@@ -938,10 +999,24 @@ var ArkmeRequestCoordinator = class {
 				signal,
 				resolve,
 				reject,
-				abort
+				abort,
+				queuedAt: this.now(),
+				...onQueue ? {
+					onQueue,
+					blockedBy: /* @__PURE__ */ new Set()
+				} : {}
 			};
 			signal.addEventListener("abort", abort, { once: true });
 			this.queue.push(queued);
+			onQueue?.("enter", {
+				lane,
+				service,
+				queueLength: this.queue.length,
+				laneQueued,
+				serviceQueued,
+				laneActive: laneLimit.active,
+				serviceActive: serviceLimit.active
+			});
 			this.queue.sort((left, right) => LANE_PRIORITY[left.lane] - LANE_PRIORITY[right.lane] || left.sequence - right.sequence);
 			this.drain();
 		});
@@ -969,6 +1044,13 @@ var ArkmeRequestCoordinator = class {
 				queued.route.tokens = Math.max(0, queued.route.tokens - 1);
 				queued.route.active += 1;
 			}
+			queued.onQueue?.("start", {
+				lane: queued.lane,
+				service: queued.service,
+				queueWaitMs: this.now() - queued.queuedAt,
+				queueLength: this.queue.length,
+				blockedBy: [...queued.blockedBy ?? []].join(",")
+			});
 			let released = false;
 			queued.resolve(() => {
 				if (released) return;
@@ -993,17 +1075,23 @@ var ArkmeRequestCoordinator = class {
 			}
 			const lane = this.laneLimits.get(queued.lane);
 			const service = this.serviceLimits.get(queued.service);
-			this.refill(lane);
-			this.refill(service);
-			const route = queued.route;
-			if (route !== void 0) {
-				this.refill(route);
-				if (route.active >= route.maxConcurrent || route.tokens < 1 || this.now() < route.cooldownUntil) continue;
-			}
-			if (lane.active < lane.maxConcurrent && service.active < service.maxConcurrent && this.now() >= lane.cooldownUntil && this.now() >= service.cooldownUntil && lane.tokens >= 1 && service.tokens >= 1) return index;
+			const laneBlocked = this.blocked(lane, "lane", queued.blockedBy);
+			const serviceBlocked = this.blocked(service, "service", queued.blockedBy);
+			const routeBlocked = queued.route !== void 0 && this.blocked(queued.route, "route", queued.blockedBy);
+			if (!laneBlocked && !serviceBlocked && !routeBlocked) return index;
 		}
 		return -1;
 	}
+	blocked(limit, kind, reasons) {
+		this.refill(limit);
+		const concurrency = limit.active >= limit.maxConcurrent, rate = limit.tokens < 1, cooldown = this.now() < limit.cooldownUntil;
+		if (reasons) {
+			if (concurrency) reasons.add(`${kind}-concurrency`);
+			if (rate) reasons.add(`${kind}-rate`);
+			if (cooldown) reasons.add(`${kind}-cooldown`);
+		}
+		return concurrency || rate || cooldown;
+	}
 	refill(limit) {
 		const now = this.now();
 		if (now <= limit.lastRefillAt) return;
@@ -1218,7 +1306,7 @@ var HttpArkmeAccountScopeBridge = class {
 		this.fetchImpl = fetchImpl;
 	}
 	async attest(identity) {
-		return status$1(await this.request("account.scope.attest", identity));
+		return status$2(await this.request("account.scope.attest", identity));
 	}
 	async prepare(identity) {
 		const value = await this.request("account.scope.prepare", identity);
@@ -1227,17 +1315,17 @@ var HttpArkmeAccountScopeBridge = class {
 		return { transitionRef };
 	}
 	async commit(transitionRef) {
-		return status$1(await this.request("account.scope.commit", { transitionRef }));
+		return status$2(await this.request("account.scope.commit", { transitionRef }));
 	}
 	async abort(transitionRef) {
-		if (status$1(await this.request("account.scope.abort", { transitionRef })).status !== "ready") throw new Error("Desktop account scope abort response is invalid");
+		if (status$2(await this.request("account.scope.abort", { transitionRef })).status !== "ready") throw new Error("Desktop account scope abort response is invalid");
 		return { status: "ready" };
 	}
 	async request(action, payload) {
 		return await requestArkmeDesktopBridge(this.config, this.fetchImpl, action, payload);
 	}
 };
-function status$1(value) {
+function status$2(value) {
 	if (value.status !== "ready" && value.status !== "relaunch") throw new Error("Desktop account scope response is invalid");
 	return { status: value.status };
 }
@@ -1631,6 +1719,16 @@ var ServiceRuntime = class {
 			"/api/v1/chats/contacts/list",
 			"/api/v1/chats/common-group/query"
 		])).has(path)) return true;
+		if (baseUrl === this.config.recordBaseUrl && (/* @__PURE__ */ new Set([
+			"/api/v1/reactions/query",
+			"/api/v1/reactions/notifications/query",
+			"/api/v1/reactions/actors/query",
+			"/api/v1/reactions/groups/query",
+			"/api/v1/reactions/history/query",
+			"/api/v1/reactions/received/query",
+			"/api/v1/reactions/history-policy/query",
+			"/api/v1/reactions/library/query"
+		])).has(path)) return true;
 		if (baseUrl === this.config.botBaseUrl && path === "/api/v1/bot/list") return true;
 		if (baseUrl === this.config.audioBaseUrl && path === "/api/v1/audio/unmarked-speakers/list") return true;
 		return false;
@@ -1638,7 +1736,8 @@ var ServiceRuntime = class {
 	async post(baseUrl, path, body, bearer, successCodes, signal, preferDataError = false, options = {}, preserveHttpError = false, preserveForbiddenError = false) {
 		const read = this.registeredRead(baseUrl, path) && !(body instanceof FormData);
 		const route = `${baseUrl.replace(/\/+$/, "")}${path}`;
-		return await this.requestCoordinator.run({
+		const onQueue = reactionQueueObserver(path);
+		return await measureReaction("upstream-total", { route: path }, () => this.requestCoordinator.run({
 			scope: options.scope ?? "public",
 			lane: options.lane ?? "write",
 			service: options.service ?? this.requestService(baseUrl),
@@ -1649,7 +1748,7 @@ var ServiceRuntime = class {
 			...options.cancelWhenUnobserved === void 0 ? {} : { cancelWhenUnobserved: options.cancelWhenUnobserved },
 			...signal === void 0 ? {} : { signal },
 			...read ? {
-				lane: options.lane === "background-read" ? "background-read" : "interactive-read",
+				lane: options.lane === "background-read" || path === "/api/v1/reactions/notifications/query" ? "background-read" : "interactive-read",
 				route,
 				key: `owner-read:${route}:${stableReadParameters(body)}`,
 				cacheMs: 0,
@@ -1670,8 +1769,9 @@ var ServiceRuntime = class {
 				"login-expired"
 			].includes(error.code),
 			serviceCooldownMs: (error) => read || options.publishServiceCooldown === false ? 0 : this.remoteServiceCooldownMs(error),
-			operation: async (coordinatedSignal) => await this.postDirect(baseUrl, path, body, bearer, successCodes, coordinatedSignal, preferDataError, preserveHttpError, preserveForbiddenError)
-		}).catch((error) => {
+			...onQueue ? { onQueue } : {},
+			operation: bindReactionTrace(async (coordinatedSignal) => await measureReaction("upstream-http", { route: path }, () => this.postDirect(baseUrl, path, body, bearer, successCodes, coordinatedSignal, preferDataError, preserveHttpError, preserveForbiddenError)))
+		})).catch((error) => {
 			if (options.trackWriteOutcome === true && error instanceof ArkmeRequestQueueOverflowError) throw new ArkmePluginError("arkme-request-queue-full", "发送请求较多，请稍后重试", true, 503, { cause: error });
 			if (options.trackWriteOutcome === true && error instanceof Error && error.name === "AbortError") throw new ArkmePluginError("arkme-request-aborted", "发送请求已取消", true, 409, { cause: error });
 			if (options.trackWriteOutcome === true && error instanceof ArkmePluginError && remoteWriteOutcomeUnknown(error)) throw withUnknownWriteOutcome(error);
@@ -1699,7 +1799,11 @@ var ServiceRuntime = class {
 			});
 			if (response.status === 401 || response.status === 403 && !preserveForbiddenError) throw new ArkmePluginError(`auth-http-${response.status}`, "Arkme 登录凭据已失效", false, response.status);
 			if (!response.ok) {
-				const retryAfter = retryAfterMillis(response.headers.get("retry-after"));
+				let retryAfter = retryAfterMillis(response.headers.get("retry-after"));
+				if (path.startsWith("/api/v1/audio/speaker-directory/") && response.status === 429) try {
+					const milliseconds = objectValue$2(objectValue$2(await response.clone().json()).data).retry_after_ms;
+					if (typeof milliseconds === "number" && Number.isFinite(milliseconds) && milliseconds >= 0) retryAfter = Math.max(retryAfter ?? 0, milliseconds);
+				} catch {}
 				if (preserveHttpError) {
 					let errorEnvelope;
 					try {
@@ -1855,6 +1959,13 @@ var ServiceRuntime = class {
 			if (!(error instanceof ArkmePluginError) || !["auth-http-401", "auth-http-403"].includes(error.code)) throw error;
 			session = await this.refreshAccessToken(session);
 			return await this.post(this.config.recordBaseUrl, path, body, session.accessToken, [0], signal, false, requestOptions());
+		} finally {
+			if ([
+				"/api/v1/reactions/set",
+				"/api/v1/reactions/notifications/read",
+				"/api/v1/reactions/history-policy/set",
+				"/api/v1/reactions/library/set"
+			].includes(path)) this.requestCoordinator.invalidateKey(this.requestScope(session.userId), `owner-read:${this.config.recordBaseUrl.replace(/\/+$/, "")}/api/v1/reactions/`);
 		}
 	}
 	async authenticatedCalendarPost(path, body, initialSession, signal, options = {}) {
@@ -2053,6 +2164,228 @@ var ServiceRuntime = class {
 	}
 };
 //#endregion
+//#region src/services/speaker-directory-service.ts
+const prefix$2 = "arkme-speaker-directory-detail-v1";
+const invalid$13 = () => new ArkmePluginError("speaker-directory-contract-invalid", "说话人目录响应无效，请稍后重试", true, 502);
+function integer$6(value) {
+	if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) throw invalid$13();
+	return value;
+}
+function str(value) {
+	if (typeof value !== "string") throw invalid$13();
+	return value;
+}
+function status$1(data) {
+	if (![
+		"fresh",
+		"stale",
+		"building",
+		"failed",
+		"disabled",
+		"snapshot_expired"
+	].includes(String(data.state)) || !["complete", "unknown"].includes(String(data.coverage))) throw invalid$13();
+	return {
+		state: data.state,
+		coverage: data.coverage,
+		retryAfterMs: integer$6(data.retry_after_ms ?? 0),
+		processingSessionCount: integer$6(data.processing_session_count ?? 0),
+		pendingIdentityAggregationCount: integer$6(data.pending_identity_aggregation_count ?? 0),
+		insufficientEvidenceCount: integer$6(data.insufficient_evidence_count ?? 0),
+		scanTruncated: data.scan_truncated === true
+	};
+}
+function inputString(value, maxBytes, fallback = "") {
+	if (value === void 0) return fallback;
+	if (typeof value !== "string" || Buffer.byteLength(value) > maxBytes) throw new ArkmePluginError("speaker-directory-input-invalid", "说话人查询条件过长或无效", false);
+	return value;
+}
+var SpeakerDirectoryService = class {
+	runtime;
+	recording;
+	unmarked;
+	constructor(runtime, recording, unmarked) {
+		this.runtime = runtime;
+		this.recording = recording;
+		this.unmarked = unmarked;
+	}
+	async request(path, body, signal) {
+		const session = await this.runtime.requireSession();
+		const data = await this.runtime.authenticatedAudioPost(`/api/v1/audio/speaker-directory/${path}`, body, session, signal, {
+			lane: path === "seen" ? "write" : "interactive-read",
+			cacheMs: 0,
+			cancelWhenUnobserved: true
+		});
+		signal?.throwIfAborted();
+		const current = await this.runtime.requireSession();
+		if (current.userId !== session.userId || current.refreshToken !== session.refreshToken) throw new ArkmePluginError("speaker-directory-account-changed", "账号已切换，请重新打开目录", false, 409);
+		return {
+			data: objectValue$2(data),
+			session
+		};
+	}
+	async summary(input, signal) {
+		const body = {};
+		if (input.snapshotVersion !== void 0) body.snapshot_version = inputString(input.snapshotVersion, 128);
+		if (input.seenVersion !== void 0) {
+			if (typeof input.seenVersion !== "number" || !Number.isSafeInteger(input.seenVersion) || input.seenVersion < 0) throw new ArkmePluginError("speaker-directory-input-invalid", "查看版本无效", false);
+			body.seen_version = input.seenVersion;
+		}
+		const { data } = await this.request("summary", body, signal);
+		const state = status$1(data);
+		const count = (value) => value === null || value === void 0 ? null : integer$6(value);
+		const result = {
+			...state,
+			totalCount: count(data.total_count),
+			markedCount: count(data.marked_count),
+			unmarkedCount: count(data.unmarked_count),
+			unseenCount: count(data.unseen_count),
+			snapshotVersion: str(data.snapshot_version ?? ""),
+			seenVersion: integer$6(data.seen_version ?? 0),
+			updatedAt: integer$6(data.updated_at ?? 0),
+			notModified: data.not_modified === true
+		};
+		if (state.coverage === "complete" && state.state !== "disabled" && state.state !== "snapshot_expired" && (result.totalCount === null || result.markedCount === null || result.unmarkedCount === null || result.unseenCount === null || result.totalCount !== result.markedCount + result.unmarkedCount || result.snapshotVersion === "")) throw invalid$13();
+		return result;
+	}
+	async list(input, signal) {
+		const filter = input.filter ?? "all", sort = input.sort ?? "frequent";
+		const query = inputString(input.query, 4096).trim().toLowerCase();
+		inputString(query, 256);
+		const limit = input.limit === void 0 || input.limit === 0 ? 50 : input.limit;
+		if (![
+			"all",
+			"marked",
+			"unmarked"
+		].includes(String(filter)) || !["frequent", "recent"].includes(String(sort)) || typeof limit !== "number" || !Number.isInteger(limit) || limit < 1 || limit > 100) throw new ArkmePluginError("speaker-directory-input-invalid", "说话人查询条件无效", false);
+		const { data, session } = await this.request("list", {
+			filter,
+			sort,
+			query,
+			limit,
+			snapshot_version: inputString(input.snapshotVersion, 128),
+			cursor: inputString(input.cursor, 4096)
+		}, signal);
+		const state = status$1(data);
+		if (state.state === "disabled" || state.state === "snapshot_expired" || state.coverage === "unknown") return {
+			...state,
+			items: [],
+			hasMore: false,
+			nextCursor: "",
+			snapshotVersion: "",
+			throughCursor: ""
+		};
+		if (!Array.isArray(data.items) || typeof data.has_more !== "boolean") throw invalid$13();
+		const snapshotVersion = str(data.snapshot_version), throughCursor = str(data.through_cursor), nextCursor = str(data.next_cursor);
+		if (!snapshotVersion || !throughCursor || data.has_more && !nextCursor) throw invalid$13();
+		const key = await this.key();
+		const items = data.items.map((value) => {
+			const raw = objectValue$2(value), ref = objectValue$2(raw.detail_ref);
+			if (!["marked", "unmarked"].includes(String(raw.type)) || typeof raw.is_self !== "boolean" || ref.type !== (raw.type === "marked" ? "speaker" : "candidate") || !str(ref.id) || !str(raw.person_key)) throw invalid$13();
+			if (ref.expected_version !== void 0) str(ref.expected_version);
+			const iv = randomBytes(12), cipher = createCipheriv("aes-256-gcm", key, iv);
+			const encrypted = Buffer.concat([cipher.update(JSON.stringify({
+				userId: session.userId,
+				environment: this.runtime.config.environment,
+				type: ref.type,
+				id: ref.id,
+				expectedVersion: ref.expected_version
+			})), cipher.final()]);
+			return {
+				personKey: str(raw.person_key),
+				type: raw.type,
+				displayName: str(raw.display_name),
+				displayNumber: integer$6(raw.display_number),
+				isSelf: raw.is_self,
+				dayCount: integer$6(raw.day_count),
+				lastSeenAt: integer$6(raw.last_seen_at),
+				detailRef: [
+					prefix$2,
+					iv.toString("base64url"),
+					encrypted.toString("base64url"),
+					cipher.getAuthTag().toString("base64url")
+				].join(".")
+			};
+		});
+		signal?.throwIfAborted();
+		return {
+			...state,
+			items,
+			hasMore: data.has_more,
+			nextCursor,
+			snapshotVersion,
+			throughCursor
+		};
+	}
+	async seen(input, signal) {
+		const cursor = inputString(input.throughCursor, 4096);
+		if (!cursor) throw new ArkmePluginError("speaker-directory-input-invalid", "缺少目录查看凭据", false);
+		const { data } = await this.request("seen", { through_cursor: cursor }, signal);
+		if (data.success === true) return {
+			success: true,
+			seenVersion: integer$6(data.seen_version)
+		};
+		if (data.state === "disabled" || data.state === "snapshot_expired") return {
+			success: false,
+			state: data.state,
+			retryAfterMs: integer$6(data.retry_after_ms ?? 0)
+		};
+		throw invalid$13();
+	}
+	async open(input, signal) {
+		const session = await this.runtime.requireSession();
+		const ref = await this.readDetailRef(input.detailRef, session.userId);
+		signal?.throwIfAborted();
+		if (ref.type === "candidate") return {
+			type: "candidate",
+			candidateRef: await this.unmarked.directoryCandidateRef(str(ref.id), signal)
+		};
+		if (ref.type !== "speaker") throw invalid$13();
+		return {
+			type: "speaker",
+			speakerRef: await this.recording.directorySpeakerRef(str(ref.id), session.userId),
+			...ref.expectedVersion === void 0 ? {} : { expectedVersion: str(ref.expectedVersion) }
+		};
+	}
+	async avatars(input, signal) {
+		if (!Array.isArray(input.detailRefs) || input.detailRefs.length > 50) throw new ArkmePluginError("speaker-directory-input-invalid", "头像查询参数无效", false);
+		const session = await this.runtime.requireSession();
+		const requested = await Promise.all([...new Set(input.detailRefs)].map(async (detailRef) => {
+			const ref = await this.readDetailRef(detailRef, session.userId);
+			if (ref.type !== "speaker") throw new ArkmePluginError("speaker-directory-input-invalid", "仅查询已标记人物头像", false);
+			return {
+				detailRef: str(detailRef),
+				id: str(ref.id)
+			};
+		}));
+		signal?.throwIfAborted();
+		const avatars = await this.recording.directorySpeakerAvatars(requested.map((item) => item.id), session.userId, signal);
+		const current = await this.runtime.requireSession();
+		if (current.userId !== session.userId || current.refreshToken !== session.refreshToken) throw new ArkmePluginError("speaker-directory-account-changed", "账号已切换", false, 409);
+		signal?.throwIfAborted();
+		return requested.map(({ detailRef, id }) => ({
+			detailRef,
+			...avatars.has(id) ? { avatarRef: avatars.get(id) } : {}
+		}));
+	}
+	async readDetailRef(value, viewerUserId) {
+		const [kind, iv, bytes, tag, ...extra] = inputString(value, 16384).split(".");
+		let ref;
+		try {
+			if (kind !== prefix$2 || !iv || !bytes || !tag || extra.length) throw new Error("invalid reference");
+			const decipher = createDecipheriv("aes-256-gcm", await this.key(), Buffer.from(iv, "base64url"));
+			decipher.setAuthTag(Buffer.from(tag, "base64url"));
+			ref = objectValue$2(JSON.parse(Buffer.concat([decipher.update(Buffer.from(bytes, "base64url")), decipher.final()]).toString("utf8")));
+		} catch {
+			throw new ArkmePluginError("speaker-directory-detail-invalid", "人物引用已失效，请刷新目录", false, 400);
+		}
+		if (ref.userId !== viewerUserId || ref.environment !== this.runtime.config.environment) throw new ArkmePluginError("speaker-directory-account-mismatch", "人物引用与当前账号不匹配", false, 403);
+		return ref;
+	}
+	async key() {
+		return createHash("sha256").update(await this.runtime.stateStore.uniqueCode()).update(`\0${prefix$2}`).digest();
+	}
+};
+//#endregion
 //#region src/services/self-role-service.ts
 /** Account-scoped role recovery. Existing message senders only request a frozen
 * snapshot; role CRUD does not enqueue or resend message content. */
@@ -2946,7 +3279,7 @@ var ReactionService = class {
 		const ids = /* @__PURE__ */ new Map();
 		const resolve = async (target) => {
 			if (!target || typeof target.id !== "string" || !target.id || target.id.length > 1024 || !(typeof target.worldRecordRef === "string" && !target.sourceRef && !target.messageActionRef || !target.worldRecordRef && typeof target.sourceRef === "string" && typeof target.messageActionRef === "string")) throw new ArkmePluginError("reaction-target-invalid", "表态目标无效", false);
-			return await this.resolve(target);
+			return await measureReaction("target-resolve", {}, () => this.resolve(target));
 		};
 		switch (input.action) {
 			case "notifications":
@@ -2965,6 +3298,7 @@ var ReactionService = class {
 				})) };
 				break;
 			case "query": {
+				if (input.actorPresentation !== void 0 && input.actorPresentation !== "deferred") throw new ArkmePluginError("reaction-query-invalid", "表态展示选项无效", false);
 				if (!Array.isArray(input.targets) || input.targets.length < 1 || input.targets.length > 50) throw new ArkmePluginError("reaction-query-invalid", "表态查询数量无效", false);
 				const targets = [], seenIDs = /* @__PURE__ */ new Set();
 				for (const target of input.targets) {
@@ -2978,6 +3312,7 @@ var ReactionService = class {
 						targets.push(wire);
 					}
 				}
+				targets.sort((left, right) => targetKey(left).localeCompare(targetKey(right)));
 				path = "query";
 				body = { targets };
 				break;
@@ -3060,7 +3395,7 @@ var ReactionService = class {
 		}
 		const before = await this.runtime.requireSession();
 		if (`${this.runtime.config.environment}:${before.userId}` !== accountKey) throw new ArkmePluginError("reaction-account-changed", "账号已变化", false);
-		const result = objectValue$2(await this.runtime.authenticatedPost(`/api/v1/reactions/${path}`, body, session, signal));
+		const result = objectValue$2(await measureReaction("reaction-owner", { action: input.action }, () => this.runtime.authenticatedPost(`/api/v1/reactions/${path}`, body, session, signal)));
 		const current = await this.runtime.requireSession();
 		if (signal?.aborted || `${this.runtime.config.environment}:${current.userId}` !== accountKey) throw new ArkmePluginError("reaction-account-changed", "账号已变化", false);
 		if (input.action === "query") {
@@ -52490,6 +52825,12 @@ var ChatService = class {
 			rel_uid: reference.relationUid
 		};
 	}
+	async reactionActorReferences(sourceRef, userIds) {
+		const session = await this.runtime.requireSession();
+		const source = await this.source.openSourceRef(sourceRef, session.userId);
+		if (source.kind !== "private_chat" && source.kind !== "group_chat") return /* @__PURE__ */ new Map();
+		return new Map(await Promise.all([...new Set(userIds)].map(async (id) => [id, await this.sealChatMemberRef(session.userId, source.ownerRef, id)])));
+	}
 	/** Keep viewer-owned remarks separate from group nicknames and public profiles. */
 	async reactionActorLabels(sourceRef, userIds, signal) {
 		const session = await this.runtime.requireSession();
@@ -88088,6 +88429,10 @@ var MediaService = class {
 	imageCacheBytes = 0;
 	activeImageDownloads = 0;
 	imageDownloadWaiters = [];
+	avatarAssets = /* @__PURE__ */ new Map();
+	avatarAssetTimer;
+	imageGeneration = 0;
+	localAvatarReads = /* @__PURE__ */ new Map();
 	constructor(runtime, profile, worldImages, recordIdentity, botImages, selfRoleAvatars) {
 		this.runtime = runtime;
 		this.profile = profile;
@@ -88097,19 +88442,27 @@ var MediaService = class {
 		this.selfRoleAvatars = selfRoleAvatars;
 	}
 	dispose() {
+		this.imageGeneration += 1;
+		clearTimeout(this.avatarAssetTimer);
+		this.avatarAssetTimer = void 0;
+		for (const pending of this.avatarAssets.values()) pending.reject(/* @__PURE__ */ new Error("Avatar image scope changed"));
+		this.avatarAssets.clear();
 		this.mediaRefs.clear();
 		this.stableMediaRefs.clear();
 		this.imageCache.clear();
 		this.imageInFlight.clear();
+		this.localAvatarReads.clear();
 		this.imageCacheBytes = 0;
 		this.imageDownloadWaiters.splice(0).forEach((resolve) => {
 			resolve();
 		});
 	}
 	async queryFileAssets(fileAssetUids, signal) {
+		return await this.queryFileAssetsForSession(await this.runtime.requireSession(), fileAssetUids, signal);
+	}
+	async queryFileAssetsForSession(session, fileAssetUids, signal) {
 		const unique = [...new Set(fileAssetUids.map((uid) => uid.trim()).filter((uid) => uid !== ""))].slice(0, 50);
 		if (unique.length === 0) return [];
-		const session = await this.runtime.requireSession();
 		return listValue$10((await this.runtime.authenticatedPost("/api/v1/files/assets/query", { file_asset_uids: unique }, session, signal, { lane: "interactive-read" })).items).map((raw) => {
 			const item = objectValue$2(raw);
 			const previewUrl = safeHttpsUrl(item.preview_url);
@@ -88371,7 +88724,11 @@ var MediaService = class {
 	}
 	async readImage(imageRef, options = {}) {
 		options.signal?.throwIfAborted();
+		const generation = this.imageGeneration;
 		const session = await this.runtime.requireSession();
+		const assetMatch = /^file_asset:\/\/([A-Za-z0-9_-]{8,128})$/.exec(imageRef.trim());
+		if (assetMatch !== null) return await this.readFileAssetImage(session, assetMatch[1], options, generation);
+		if (options.cacheOnly) throw new ArkmePluginError("image-cache-miss", "本地没有可用的资产头像", false, 404);
 		const isProfileImage = imageRef.trim().startsWith("arkme-profile-image-v1.");
 		const isBotImage = imageRef.trim().startsWith("arkme-bot-image-v1.");
 		const isSelfRoleImage = imageRef.trim().startsWith("arkme-self-role-image-v1.");
@@ -88420,6 +88777,145 @@ var MediaService = class {
 			if (this.imageInFlight.get(cacheKey) === pending) this.imageInFlight.delete(cacheKey);
 		}
 	}
+	/** Immutable asset bytes survive URL expiry and Host restarts in the existing avatar store. */
+	async readFileAssetImage(session, uid, options, generation) {
+		await this.assertImageAccount(session, generation);
+		options.signal?.throwIfAborted();
+		const byteLimit = Math.min(MAX_SELF_ROLE_AVATAR_BYTES, Math.max(1, Math.trunc(options.maxBytes ?? 8388608)));
+		const diskKey = `asset:${this.runtime.config.environment}:${uid}`;
+		const cacheKey = `${session.userId}:${byteLimit}:${diskKey}`;
+		const cached = this.cachedImage(cacheKey);
+		if (cached !== void 0) return cached;
+		if (options.cacheOnly) {
+			const value = await this.readLocalFileAssetImage(session, uid, diskKey, byteLimit, generation);
+			options.signal?.throwIfAborted();
+			await this.assertImageAccount(session, generation);
+			if (value === void 0) throw new ArkmePluginError("image-cache-miss", "本地没有可用的资产头像", false, 404);
+			this.cacheImage(cacheKey, value);
+			return cloneImageBytes(value);
+		}
+		let pending = this.imageInFlight.get(cacheKey);
+		if (pending === void 0) {
+			pending = this.loadFileAssetImage(session, uid, diskKey, byteLimit, generation);
+			this.imageInFlight.set(cacheKey, pending);
+		}
+		try {
+			const value = await pending;
+			options.signal?.throwIfAborted();
+			await this.assertImageAccount(session, generation);
+			this.cacheImage(cacheKey, value);
+			return cloneImageBytes(value);
+		} finally {
+			if (this.imageInFlight.get(cacheKey) === pending) this.imageInFlight.delete(cacheKey);
+		}
+	}
+	async assertImageAccount(session, generation) {
+		const current = await this.runtime.requireSession();
+		if (generation !== this.imageGeneration || current.userId !== session.userId) throw new ArkmePluginError("image-account-changed", "账号已切换，请重试", false, 409);
+	}
+	async validAvatar(image, byteLimit) {
+		if (image.bytes <= 0 || image.bytes !== image.data.byteLength || image.bytes > byteLimit || imageMediaType(image.data) !== image.mediaType) return false;
+		try {
+			const { default: sharp } = await import("sharp");
+			await sharp(image.data, {
+				failOn: "warning",
+				limitInputPixels: 64 * 1024 * 1024
+			}).resize(1, 1).raw().toBuffer();
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	async readLocalFileAssetImage(session, uid, diskKey, byteLimit, generation) {
+		const key = `${generation}:${session.userId}:${byteLimit}:${diskKey}`;
+		let pending = this.localAvatarReads.get(key);
+		if (pending === void 0) {
+			pending = (async () => {
+				const persisted = await this.runtime.stateStore.readAvatarCache?.(session.userId, diskKey).catch(() => void 0);
+				if (persisted !== void 0 && await this.validAvatar(persisted, byteLimit)) return persisted;
+				await this.assertImageAccount(session, generation);
+				const localRef = await this.runtime.stateStore.selfRoleAvatarLocalRef?.(session.userId, uid).catch(() => void 0);
+				const original = localRef === void 0 ? void 0 : await this.selfRoleAvatars?.read(session.userId, localRef, byteLimit).catch(() => void 0);
+				return original !== void 0 && await this.validAvatar(original, byteLimit) ? original : void 0;
+			})();
+			this.localAvatarReads.set(key, pending);
+		}
+		try {
+			const value = await pending;
+			await this.assertImageAccount(session, generation);
+			return value;
+		} finally {
+			if (this.localAvatarReads.get(key) === pending) this.localAvatarReads.delete(key);
+		}
+	}
+	async loadFileAssetImage(session, uid, diskKey, byteLimit, generation) {
+		let value = await this.readLocalFileAssetImage(session, uid, diskKey, byteLimit, generation);
+		if (value === void 0) {
+			await this.assertImageAccount(session, generation);
+			const asset = await this.queueAvatarAsset(session, uid, generation);
+			const url = asset?.previewUrl ?? asset?.downloadUrl;
+			if (url === void 0) throw new ArkmePluginError("image-ref-unavailable", "历史头像当前不可用", true, 404);
+			await this.assertImageAccount(session, generation);
+			value = await this.withImageDownloadPermit(async () => {
+				await this.assertImageAccount(session, generation);
+				return await this.downloadSignedImage(trustedSignedImageUrl$1(this.runtime.config.environment, url), byteLimit, void 0, this.runtime.requestScope(session.userId));
+			});
+			if (!await this.validAvatar(value, byteLimit)) throw new ArkmePluginError("image-bytes-invalid", "头像数据损坏，请重试", true, 502);
+		}
+		await this.assertImageAccount(session, generation);
+		await this.runtime.stateStore.writeAvatarCache?.(session.userId, diskKey, value).catch(() => {
+			console.warn("dsh-arkme: avatar_cache_write_failed");
+		});
+		return value;
+	}
+	queueAvatarAsset(session, uid, generation) {
+		const key = `${session.userId}:${uid}`;
+		const existing = this.avatarAssets.get(key);
+		if (existing !== void 0) return existing.promise;
+		let resolve;
+		let reject;
+		const promise = new Promise((done, fail) => {
+			resolve = done;
+			reject = fail;
+		});
+		this.avatarAssets.set(key, {
+			session,
+			uid,
+			generation,
+			started: false,
+			promise,
+			resolve,
+			reject
+		});
+		this.avatarAssetTimer ??= setTimeout(() => {
+			this.avatarAssetTimer = void 0;
+			this.flushAvatarAssets();
+		}, 8);
+		return promise;
+	}
+	async flushAvatarAssets() {
+		const groups = /* @__PURE__ */ new Map();
+		for (const entry of this.avatarAssets.entries()) {
+			if (entry[1].started) continue;
+			entry[1].started = true;
+			const group = groups.get(entry[1].session.userId) ?? [];
+			group.push(entry);
+			groups.set(entry[1].session.userId, group);
+		}
+		for (const group of groups.values()) for (let start = 0; start < group.length; start += 50) {
+			const batch = group.slice(start, start + 50);
+			try {
+				await this.assertImageAccount(batch[0][1].session, batch[0][1].generation);
+				const items = await this.queryFileAssetsForSession(batch[0][1].session, batch.map(([, pending]) => pending.uid));
+				const byUid = new Map(items.map((item) => [item.fileAssetUid, item]));
+				for (const [, pending] of batch) pending.resolve(byUid.get(pending.uid));
+			} catch (error) {
+				for (const [, pending] of batch) pending.reject(error);
+			} finally {
+				for (const [key, pending] of batch) if (this.avatarAssets.get(key) === pending) this.avatarAssets.delete(key);
+			}
+		}
+	}
 	cachedImage(cacheKey) {
 		const cached = this.imageCache.get(cacheKey);
 		if (cached === void 0) return void 0;
@@ -88467,13 +88963,6 @@ var MediaService = class {
 			if (this.selfRoleAvatars === void 0) throw new ArkmePluginError("self-role-avatar-missing", "本地角色头像不可用", false, 404);
 			return await this.selfRoleAvatars.read(session.userId, imageRef.trim(), byteLimit);
 		}
-		const snapshotAsset = /^file_asset:\/\/([A-Za-z0-9_-]{8,128})$/.exec(imageRef.trim());
-		if (snapshotAsset !== null) {
-			const asset = (await this.queryFileAssets([snapshotAsset[1]], signal)).find((item) => item.fileAssetUid === snapshotAsset[1]);
-			const url = asset?.previewUrl ?? asset?.downloadUrl;
-			if (url === void 0) throw new ArkmePluginError("image-ref-unavailable", "历史头像当前不可用", true, 404);
-			return await this.downloadSignedImage(trustedSignedImageUrl$1(this.runtime.config.environment, url), byteLimit, signal, this.runtime.requestScope(session.userId));
-		}
 		if (imageRef.trim().startsWith("arkme-bot-image-v1.")) {
 			if (this.botImages === void 0) throw new ArkmePluginError("bot-image-ref-invalid", "Bot 头像引用不可用", false, 403);
 			const reference = await this.botImages.openBotImageRef(imageRef, session.userId);
@@ -90302,6 +90791,11 @@ var ProfileService = class {
 			}
 			if (cached.value !== null) profiles.set(userId, cached.value);
 		}
+		await measureReaction("profile-cache", {
+			requested: normalized.length,
+			hits: normalized.length - missing.length,
+			misses: missing.length
+		}, async () => void 0);
 		for (const batch of chunksOf(missing, 50)) {
 			if (batch.length === 0) continue;
 			const startedAtMillis = Date.now();
@@ -92128,6 +92622,46 @@ var RecordingService = class {
 			...numberValue$5(data.retry_after_ms) > 0 ? { retryAfterMs: numberValue$5(data.retry_after_ms) } : {}
 		};
 	}
+	/** Called only for an authenticated, Host-verified directory detail_ref. */
+	async directorySpeakerRef(speakerId, viewerUserId) {
+		return this.sealRecordingRefWithKey("arkme-recording-speaker-v1", {
+			version: 1,
+			viewerUserId,
+			target: {
+				kind: "speaker",
+				speakerId
+			}
+		}, await this.recordingRefKey("arkme-recording-speaker-v1"));
+	}
+	/** Enrich only verified directory speakers; do not load contact suggestions or presence stats. */
+	async directorySpeakerAvatars(speakerIds, viewerUserId, signal) {
+		const session = await this.runtime.requireSession();
+		const revision = this.speakerCacheRevision;
+		if (session.userId !== viewerUserId) throw new ArkmePluginError("recording-ref-account-mismatch", "账号已切换", false, 403);
+		if (speakerIds.length === 0) return /* @__PURE__ */ new Map();
+		const data = await this.runtime.authenticatedAudioPost("/api/v1/audio/get-speaker-ls", {}, session, signal, {
+			lane: "background-read",
+			key: "directory-speaker-avatars",
+			cacheMs: 1e4
+		});
+		if (!Array.isArray(data.spk_ls)) throw new ArkmePluginError("recording-speaker-contract-invalid", "说话人资料响应无效", true, 502);
+		const wanted = new Set(speakerIds);
+		const bindings = /* @__PURE__ */ new Map();
+		for (const value of data.spk_ls) {
+			const raw = objectValue$2(value);
+			const id = stringValue$2(raw.speaker_id ?? raw.id ?? raw.spk_id).trim();
+			const userId = positiveUserId(raw.ref_usr_id ?? raw.ref_user_id ?? raw.user_id);
+			if (wanted.has(id) && userId !== void 0) bindings.set(id, userId);
+		}
+		const profiles = await this.recordingSpeakerProfiles([...new Set(bindings.values())], session, signal, true);
+		await this.assertSpeakerReadCurrent(session, revision, signal);
+		const result = /* @__PURE__ */ new Map();
+		for (const [id, userId] of bindings) {
+			const avatar = profiles.get(userId)?.avatarRef;
+			if (avatar) result.set(id, avatar);
+		}
+		return result;
+	}
 	/** All-history source identities, authorized by the same account-bound speaker reference as the UI. */
 	async recordingSpeakerMembers(speakerRef, signal, expectedVersion) {
 		this.assertWorkbenchEnabled();
@@ -93194,7 +93728,7 @@ var RecordingService = class {
 	async recordingRefKey(prefix) {
 		return createHash("sha256").update(await this.runtime.stateStore.uniqueCode()).update(`\0${prefix}`).digest();
 	}
-	async recordingSpeakerProfiles(userIds, session, signal) {
+	async recordingSpeakerProfiles(userIds, session, signal, propagateFailure = false) {
 		if (this.profile === void 0) return /* @__PURE__ */ new Map();
 		if (userIds.length === 0) return /* @__PURE__ */ new Map();
 		try {
@@ -93208,7 +93742,8 @@ var RecordingService = class {
 				}];
 			}));
 			return new Map(entries);
-		} catch {
+		} catch (error) {
+			if (propagateFailure) throw error;
 			return /* @__PURE__ */ new Map();
 		}
 	}
@@ -95778,6 +96313,28 @@ var UnmarkedSpeakerService = class {
 			...typeof data.cursor_stale === "boolean" ? { cursorStale: data.cursor_stale } : {}
 		};
 	}
+	/** Hydrate on selection, so paginating a large directory never evicts selected references. */
+	async directoryCandidateRef(candidateId, signal) {
+		const session = await this.runtime.requireSession();
+		const data = await this.runtime.authenticatedAudioPost("/api/v1/audio/unmarked-speakers/detail", { candidate_id: candidateId }, session, signal);
+		signal?.throwIfAborted();
+		const current = await this.runtime.requireSession();
+		if (current.userId !== session.userId || current.refreshToken !== session.refreshToken) throw new ArkmePluginError("unmarked-candidate-ref-account-mismatch", "账号已切换", false, 403);
+		if (data.outcome === "candidate_not_found") throw new ArkmePluginError("unmarked-candidate-not-found", "该人物已变化，请刷新目录", false, 404);
+		const raw = objectValue$2(data.candidate);
+		if (stringValue$2(raw.candidate_id) !== candidateId || !["cross_day", "single_day"].includes(String(raw.status))) throw new ArkmePluginError("unmarked-detail-contract-invalid", "人物详情暂不可用", true, 502);
+		this.pruneRefs();
+		return this.sealCandidateRef(session.userId, {
+			candidateId,
+			status: raw.status,
+			speakerToken: boundedInteger(raw.speaker_display_number) > 0 ? String(raw.speaker_display_number) : stringValue$2(raw.label),
+			appearanceDays: boundedInteger(raw.day_count),
+			validAudioDurationMillis: boundedInteger(raw.total_speech_duration_ms),
+			segmentCount: boundedInteger(raw.segment_count),
+			firstSeenAtMillis: positiveTimestamp(raw.first_seen_at),
+			latestAtMillis: positiveTimestamp(raw.last_seen_at)
+		});
+	}
 	async markOptions(candidateRef, signal) {
 		const { session, entry, normalizedRef } = await this.resolveCandidateRef(candidateRef);
 		const data = await this.runtime.authenticatedAudioPost("/api/v1/audio/unmarked-speakers/mark-options", { candidate_id: entry.candidateId }, session, signal, {
@@ -98463,6 +99020,7 @@ var ArkmeService = class {
 	relatedQuickNote;
 	contact;
 	contactDirectory;
+	speakerDirectory;
 	unmarkedSpeaker;
 	voiceprint;
 	userBan;
@@ -98592,6 +99150,7 @@ var ArkmeService = class {
 			forwardGateway: new OwnerRecordingForwardGateway(this.runtime, this.source, this.realtime, this.chat)
 		});
 		this.unmarkedSpeaker = new UnmarkedSpeakerService(this.runtime, this.media);
+		this.speakerDirectory = new SpeakerDirectoryService(this.runtime, this.recording, this.unmarkedSpeaker);
 		this.contact = new ContactService(this.runtime, this.source, this.profile, this.realtime);
 		this.voiceprint = new VoiceprintService(this.runtime, this.profile, { resolveRegisteredContactUserId: async (contactRef, session, signal) => await this.contact.resolveRegisteredContactUserId(contactRef, session, signal) });
 		this.auth = new AuthService(this.runtime, this.profile, {
@@ -98960,6 +99519,7 @@ var ArkmeService = class {
 				messageReport: true,
 				userBanManagement: true,
 				selfRoles: true,
+				imageCacheRead: true,
 				directMessageAdmission: true,
 				reactionsV1: true,
 				groupOwnerGovernance: true,
@@ -99213,6 +99773,21 @@ var ArkmeService = class {
 	async cachedRecordingSpeakerOptions(signal) {
 		return await this.recording.cachedRecordingSpeakerOptions(signal);
 	}
+	async speakerDirectorySummary(input, signal) {
+		return this.speakerDirectory.summary(input, signal);
+	}
+	async speakerDirectoryAvatars(input, signal) {
+		return this.speakerDirectory.avatars(input, signal);
+	}
+	async speakerDirectoryList(input, signal) {
+		return this.speakerDirectory.list(input, signal);
+	}
+	async speakerDirectorySeen(input, signal) {
+		return this.speakerDirectory.seen(input, signal);
+	}
+	async speakerDirectoryOpen(input, signal) {
+		return this.speakerDirectory.open(input, signal);
+	}
 	async recordingSpeakerOptions(signal) {
 		return await this.recording.recordingSpeakerOptions(signal);
 	}
@@ -99933,110 +100508,132 @@ var ArkmeService = class {
 		return await this.chat.favoriteStickers(signal);
 	}
 	async reactions(input, signal) {
-		const result = await new ReactionService(this.runtime, (target) => target.worldRecordRef !== void 0 ? this.world.reactionTarget(target.worldRecordRef) : this.chat.reactionTarget(target.sourceRef, target.messageActionRef), (uid) => this.world.reactionReference(uid), (viewer, uid) => this.source.chatDirectorySourceKey(viewer, uid), async (items, signal) => {
-			const session = await this.runtime.requireSession();
-			const [sources, profiles] = await Promise.all([this.source.chatSourcesBySessionUids([...new Set(items.map((item) => item.sessionUID).filter(Boolean))], signal), this.profile.publicProfileSummariesByUserIds([...new Set(items.map((item) => item.senderID).filter((id) => id > 0))], session, signal, 5e3)]);
-			const missingAvatars = [...sources].filter(([, source]) => !source.avatarRef && !source.avatarRefs?.length && !source.groupAvatar);
-			if (missingAvatars.length > 0) try {
-				const hydrated = await this.source.hydrateDirectoryPage(missingAvatars.map(([, source]) => source), signal ?? new AbortController().signal);
-				missingAvatars.forEach(([uid], index) => {
-					if (hydrated[index]) sources.set(uid, hydrated[index]);
+		return await withReactionTrace(input, async () => {
+			const result = await new ReactionService(this.runtime, (target) => target.worldRecordRef !== void 0 ? this.world.reactionTarget(target.worldRecordRef) : this.chat.reactionTarget(target.sourceRef, target.messageActionRef), (uid) => this.world.reactionReference(uid), (viewer, uid) => this.source.chatDirectorySourceKey(viewer, uid), async (items, signal) => {
+				const session = await this.runtime.requireSession();
+				const [sources, profiles] = await Promise.all([this.source.chatSourcesBySessionUids([...new Set(items.map((item) => item.sessionUID).filter(Boolean))], signal), this.profile.publicProfileSummariesByUserIds([...new Set(items.map((item) => item.senderID).filter((id) => id > 0))], session, signal, 5e3)]);
+				const missingAvatars = [...sources].filter(([, source]) => !source.avatarRef && !source.avatarRefs?.length && !source.groupAvatar);
+				if (missingAvatars.length > 0) try {
+					const hydrated = await this.source.hydrateDirectoryPage(missingAvatars.map(([, source]) => source), signal ?? new AbortController().signal);
+					missingAvatars.forEach(([uid], index) => {
+						if (hydrated[index]) sources.set(uid, hydrated[index]);
+					});
+				} catch {
+					signal?.throwIfAborted();
+				}
+				const selfSource = items.some((item) => item.sourceKind === "send_to_self" && item.message) ? {
+					sourceRef: await this.source.sealSourceRef(session.userId, "send_to_self", "all", "发给自己"),
+					kind: "send_to_self",
+					displayName: "发给自己",
+					activeAtMillis: 0,
+					unreadCount: 0
+				} : void 0;
+				return items.map((item) => {
+					const source = item.sourceKind === "send_to_self" ? selfSource : sources.get(item.sessionUID);
+					return {
+						sourceName: item.sourceKind === "send_to_self" ? "发给自己" : source?.displayName,
+						authorName: item.senderID === session.userId ? "我" : profiles.get(item.senderID)?.displayName,
+						...source && item.message ? { originalMessage: {
+							source,
+							itemUid: item.message.recordUID,
+							recordOwnerUserId: item.message.ownerUserID,
+							sendAtMillis: item.message.sendAtMillis
+						} } : {},
+						...source ? { avatar: {
+							...source.avatarRef ? { avatarRef: source.avatarRef } : {},
+							...source.avatarRefs ? { avatarRefs: source.avatarRefs } : {},
+							...source.groupAvatar ? { groupAvatar: source.groupAvatar } : {}
+						} } : {}
+					};
 				});
-			} catch {
-				signal?.throwIfAborted();
-			}
-			const selfSource = items.some((item) => item.sourceKind === "send_to_self" && item.message) ? {
-				sourceRef: await this.source.sealSourceRef(session.userId, "send_to_self", "all", "发给自己"),
-				kind: "send_to_self",
-				displayName: "发给自己",
-				activeAtMillis: 0,
-				unreadCount: 0
-			} : void 0;
-			return items.map((item) => {
-				const source = item.sourceKind === "send_to_self" ? selfSource : sources.get(item.sessionUID);
-				return {
-					sourceName: item.sourceKind === "send_to_self" ? "发给自己" : source?.displayName,
-					authorName: item.senderID === session.userId ? "我" : profiles.get(item.senderID)?.displayName,
-					...source && item.message ? { originalMessage: {
-						source,
-						itemUid: item.message.recordUID,
-						recordOwnerUserId: item.message.ownerUserID,
-						sendAtMillis: item.message.sendAtMillis
-					} } : {},
-					...source ? { avatar: {
-						...source.avatarRef ? { avatarRef: source.avatarRef } : {},
-						...source.avatarRefs ? { avatarRefs: source.avatarRefs } : {},
-						...source.groupAvatar ? { groupAvatar: source.groupAvatar } : {}
-					} } : {}
-				};
+			}).request(input, signal);
+			if (`${this.config.environment}:${(await this.runtime.requireSession()).userId}` !== input.accountKey || signal?.aborted) throw new ArkmePluginError("reaction-account-changed", "账号已变化", false);
+			const actorLabels = async (sourceRef, ids) => {
+				if (!sourceRef || !ids.length) return /* @__PURE__ */ new Map();
+				try {
+					return await this.chat.reactionActorLabels(sourceRef, ids, signal);
+				} catch (error) {
+					if (signal?.aborted) throw error;
+					return /* @__PURE__ */ new Map();
+				}
+			};
+			const actorAvatars = async (viewer, profiles) => new Map(await Promise.all([...profiles].filter(([, profile]) => profile.avatarUrl).map(async ([id]) => [id, await this.profile.sealProfileImageRef(viewer, id)])));
+			const presentActor = (userId, profileName, label, avatarRef) => ({
+				userId,
+				displayName: label?.remark || label?.groupNickname || profileName?.trim() || "用户",
+				...label?.groupNickname ? { groupNickname: label.groupNickname } : {},
+				...avatarRef ? { avatarRef } : {}
 			});
-		}).request(input, signal);
-		if (`${this.config.environment}:${(await this.runtime.requireSession()).userId}` !== input.accountKey || signal?.aborted) throw new ArkmePluginError("reaction-account-changed", "账号已变化", false);
-		const actorLabels = async (sourceRef, ids) => {
-			if (!sourceRef || !ids.length) return /* @__PURE__ */ new Map();
-			try {
-				return await this.chat.reactionActorLabels(sourceRef, ids, signal);
-			} catch (error) {
-				if (signal?.aborted) throw error;
-				return /* @__PURE__ */ new Map();
+			if (input.action === "query" || input.action === "groups") {
+				const page = result;
+				const groupPage = result;
+				const groups = input.action === "query" ? page.items.flatMap((item) => item.actors_visible ? item.groups : []) : groupPage.items;
+				const ids = [...new Set(groups.flatMap((group) => group.actorIds))];
+				const session = await this.runtime.requireSession();
+				const sourceByTarget = new Map(input.action === "query" ? input.targets.map((target) => [target.id, target.sourceRef]) : []);
+				const sourceIds = /* @__PURE__ */ new Map();
+				const include = (sourceRef, actorIds) => {
+					if (!sourceRef || !actorIds.length) return;
+					const users = sourceIds.get(sourceRef) ?? /* @__PURE__ */ new Set();
+					actorIds.forEach((id) => users.add(id));
+					sourceIds.set(sourceRef, users);
+				};
+				if (input.action === "query") {
+					for (const item of page.items) if (item.actors_visible) include(sourceByTarget.get(item.target_id), item.groups.flatMap((group) => group.actorIds));
+				} else include(input.target.sourceRef, ids);
+				if (input.action === "query" && input.actorPresentation === "deferred") {
+					const references = /* @__PURE__ */ new Map();
+					for (const [sourceRef, users] of sourceIds) references.set(sourceRef, await this.chat.reactionActorReferences(sourceRef, [...users]));
+					if (`${this.config.environment}:${(await this.runtime.requireSession()).userId}` !== input.accountKey || signal?.aborted) throw new ArkmePluginError("reaction-account-changed", "账号已变化", false);
+					return {
+						...page,
+						items: page.items.map((item) => ({
+							...item,
+							groups: item.groups.map(({ actorIds, ...group }) => ({
+								...group,
+								actors: item.actors_visible ? actorIds.map((userId) => ({
+									userId,
+									displayName: "用户",
+									presentationPending: true,
+									...references.get(sourceByTarget.get(item.target_id) ?? "")?.get(userId) ? { memberRef: references.get(sourceByTarget.get(item.target_id)).get(userId) } : {}
+								})) : []
+							}))
+						}))
+					};
+				}
+				const [profiles, labels] = await Promise.all([measureReaction("actor-profiles", { count: ids.length }, () => this.profile.publicProfileSummariesByUserIds(ids, session, signal, 5e3)), (async () => {
+					const labels = /* @__PURE__ */ new Map();
+					for (const [sourceRef, users] of sourceIds) labels.set(sourceRef, await measureReaction("actor-labels", { count: users.size }, () => actorLabels(sourceRef, [...users])));
+					return labels;
+				})()]);
+				const avatars = await actorAvatars(session.userId, profiles);
+				if (`${this.config.environment}:${(await this.runtime.requireSession()).userId}` !== input.accountKey || signal?.aborted) throw new ArkmePluginError("reaction-account-changed", "账号已变化", false);
+				const present = ({ actorIds, ...group }, sourceRef, visible = true) => ({
+					...group,
+					actors: visible ? actorIds.map((userId) => presentActor(userId, profiles.get(userId)?.displayName, labels.get(sourceRef ?? "")?.get(userId), avatars.get(userId))) : []
+				});
+				return input.action === "query" ? {
+					...page,
+					items: page.items.map((item) => ({
+						...item,
+						groups: item.groups.map((group) => present(group, sourceByTarget.get(item.target_id), item.actors_visible))
+					}))
+				} : {
+					...groupPage,
+					items: groupPage.items.map((group) => present(group, input.target.sourceRef))
+				};
 			}
-		};
-		const actorAvatars = async (viewer, profiles) => new Map(await Promise.all([...profiles].filter(([, profile]) => profile.avatarUrl).map(async ([id]) => [id, await this.profile.sealProfileImageRef(viewer, id)])));
-		const presentActor = (userId, profileName, label, avatarRef) => ({
-			userId,
-			displayName: label?.remark || label?.groupNickname || profileName?.trim() || "用户",
-			...label?.groupNickname ? { groupNickname: label.groupNickname } : {},
-			...avatarRef ? { avatarRef } : {}
-		});
-		if (input.action === "query" || input.action === "groups") {
+			if (input.action !== "actors") return result;
 			const page = result;
-			const groupPage = result;
-			const groups = input.action === "query" ? page.items.flatMap((item) => item.actors_visible ? item.groups : []) : groupPage.items;
-			const ids = [...new Set(groups.flatMap((group) => group.actorIds))];
 			const session = await this.runtime.requireSession();
-			const sourceByTarget = new Map(input.action === "query" ? input.targets.map((target) => [target.id, target.sourceRef]) : []);
-			const sourceIds = /* @__PURE__ */ new Map();
-			const include = (sourceRef, actorIds) => {
-				if (!sourceRef || !actorIds.length) return;
-				const users = sourceIds.get(sourceRef) ?? /* @__PURE__ */ new Set();
-				actorIds.forEach((id) => users.add(id));
-				sourceIds.set(sourceRef, users);
-			};
-			if (input.action === "query") {
-				for (const item of page.items) if (item.actors_visible) include(sourceByTarget.get(item.target_id), item.groups.flatMap((group) => group.actorIds));
-			} else include(input.target.sourceRef, ids);
-			const [profiles, labels] = await Promise.all([this.profile.publicProfileSummariesByUserIds(ids, session, signal, 5e3), (async () => {
-				const labels = /* @__PURE__ */ new Map();
-				for (const [sourceRef, users] of sourceIds) labels.set(sourceRef, await actorLabels(sourceRef, [...users]));
-				return labels;
-			})()]);
+			const [profiles, labels] = await Promise.all([this.profile.publicProfileSummariesByUserIds(page.user_ids, session, signal, 5e3), actorLabels(input.target.sourceRef, page.user_ids)]);
 			const avatars = await actorAvatars(session.userId, profiles);
 			if (`${this.config.environment}:${(await this.runtime.requireSession()).userId}` !== input.accountKey || signal?.aborted) throw new ArkmePluginError("reaction-account-changed", "账号已变化", false);
-			const present = ({ actorIds, ...group }, sourceRef, visible = true) => ({
-				...group,
-				actors: visible ? actorIds.map((userId) => presentActor(userId, profiles.get(userId)?.displayName, labels.get(sourceRef ?? "")?.get(userId), avatars.get(userId))) : []
-			});
-			return input.action === "query" ? {
-				...page,
-				items: page.items.map((item) => ({
-					...item,
-					groups: item.groups.map((group) => present(group, sourceByTarget.get(item.target_id), item.actors_visible))
-				}))
-			} : {
-				...groupPage,
-				items: groupPage.items.map((group) => present(group, input.target.sourceRef))
+			return {
+				items: page.user_ids.map((userId) => presentActor(userId, profiles.get(userId)?.displayName, labels.get(userId), avatars.get(userId))),
+				has_more: page.has_more
 			};
-		}
-		if (input.action !== "actors") return result;
-		const page = result;
-		const session = await this.runtime.requireSession();
-		const [profiles, labels] = await Promise.all([this.profile.publicProfileSummariesByUserIds(page.user_ids, session, signal, 5e3), actorLabels(input.target.sourceRef, page.user_ids)]);
-		const avatars = await actorAvatars(session.userId, profiles);
-		if (`${this.config.environment}:${(await this.runtime.requireSession()).userId}` !== input.accountKey || signal?.aborted) throw new ArkmePluginError("reaction-account-changed", "账号已变化", false);
-		return {
-			items: page.user_ids.map((userId) => presentActor(userId, profiles.get(userId)?.displayName, labels.get(userId), avatars.get(userId))),
-			has_more: page.has_more
-		};
+		});
 	}
 	async addFavoriteSticker(item, signal) {
 		return await this.chat.addFavoriteSticker(item, signal);