@senguoyun/dsh-arkme 0.1.85 → 0.1.86

package/lib/{persistent-runtime-adGFmkIa.js → persistent-runtime-DfmCJcxH.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";
@@ -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;
@@ -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);
@@ -1855,6 +1955,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 = {}) {
@@ -2946,7 +3053,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 +3072,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 +3086,7 @@ var ReactionService = class {
 						targets.push(wire);
 					}
 				}
+				targets.sort((left, right) => targetKey(left).localeCompare(targetKey(right)));
 				path = "query";
 				body = { targets };
 				break;
@@ -3060,7 +3169,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 +52599,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 +88203,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 +88216,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 +88498,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 +88551,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 +88737,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 +90565,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();
@@ -98960,6 +99228,7 @@ var ArkmeService = class {
 				messageReport: true,
 				userBanManagement: true,
 				selfRoles: true,
+				imageCacheRead: true,
 				directMessageAdmission: true,
 				reactionsV1: true,
 				groupOwnerGovernance: true,
@@ -99933,110 +100202,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);