@senguoyun/dsh-arkme 0.1.86 → 0.1.87

package/lib/index.js

@@ -1,4 +1,4 @@
-import { A as inspectNativeBundleArtifactV3, At as recordOwnerId, Bt as __exportAll, Ct as recordingImportFileNameKey, D as bundleSha256, E as arkmeSandboxEntryId, Et as registerManagedAiProvider, F as assertExtensionArtifactSize, Ft as parseArrangementBoardCachePages, G as validateVoiceprintPcm16Wav, Ht as __toCommonJS, I as canonicalExtensionJson, It as registerDSHAgentInputRecordSync, J as arkmeRequiredLinkMetadataFallback, K as arkmeExtensionShareRefFromLink, L as sha256Hex, Lt as createDesktopLifecycleReader, M as packLocalNativeBundleDirectoryV3, Mt as parseArkmeRecordReeditAttachments, N as readNativeBundleTarballV3, Nt as parseArkmeRecordReeditMentions, O as canonicalBundleJson, Ot as ArkmePluginError, P as renderArkmeSandboxHostEntry, Q as ARKME_PROVIDER_CONTRACT_VERSION, R as unpackArkmeExtension, Rt as __commonJSMin, S as ARKME_BUNDLE_ARTIFACT_KIND, T as ArkmeBundleArtifactError, Tt as normalizeRecentEmojiIds, U as ARKME_EXTENSION_RUNTIME_UNAVAILABLE_MESSAGE, Vt as __require, W as ArkmeService, X as arkmeRichBackgroundSound, Y as arkmeFileBackgroundSound, Z as ARKME_DEFAULT_SHARE_WEBSITE, _ as arkmeClientContentDigest, _t as ArkmeDirectMessageAdmissionError, at as cachedMemberItem, b as verifyExtensionResolutionSignature, bt as recordingImportFileKind, c as persistentExtensionBundleDirectory, ct as SelfRoleSyncStore, d as readPersistentExtensionActivation, dt as arkmeCanInlineLocalFile, f as refreshPersistentClientWrapper, ft as arkmeNormalizedFileMimeType, g as activeProfileExtensionOwnerConflicts, gt as SecretValue, h as renderArkmeBundleClientBundle, ht as ArkmeOutgoingCallError, i as invokePersistentArkmeExtension, it as applyMemberUpdate, j as packBundleFiles, jt as ArkmeRecordReeditDraftConflict, k as inspectBundleArtifact, kt as retryAfterMillis, l as persistentExtensionPackageIdentity, lt as ARKME_RUNTIME_INSTANCE_ID, m as writePersistentExtensionActivation, mt as isArkmeBotAvatarRef, nt as ARKME_WORLD_PUBLISH_MAX_IMAGES, o as persistentArkmeExtensionRuntimeState, ot as mergeMemberJoinEvents, p as repairPersistentExtensionInstallation, pt as arkmePickedFileKind, q as arkmeIsGenericLinkMetadataTitle, r as deactivatePersistentArkmeExtension, rt as ARKME_WORLD_PUBLISH_MAX_IMAGE_BYTES, s as materializePersistentExtensionBundle, st as validateMemberUpdate, t as activatePersistentArkmeExtension, u as quarantinePersistentExtension, ut as ARKME_TOOL_FILE_MAX_BYTES, v as arkmeClientContentDigestFromSource, vt as isRecordingInstantOnOrAfterUnixEpoch, w as ARKME_NATIVE_BUNDLE_ARTIFACT_KIND, wt as isRecentEmojiId, x as verifyNativeBundleResolutionSignature, xt as sameRecordingImportIdentity, y as verifyBundleResolutionSignature, yt as isUnresolvedRecordingImportJob, z as ARKME_EXTENSION_FORMAT, zt as __esmMin } from "./persistent-runtime-DfmCJcxH.js";
+import { A as inspectNativeBundleArtifactV3, At as recordOwnerId, Bt as __exportAll, Ct as recordingImportFileNameKey, D as bundleSha256, E as arkmeSandboxEntryId, Et as registerManagedAiProvider, F as assertExtensionArtifactSize, Ft as parseArrangementBoardCachePages, G as validateVoiceprintPcm16Wav, Ht as __toCommonJS, I as canonicalExtensionJson, It as registerDSHAgentInputRecordSync, J as arkmeRequiredLinkMetadataFallback, K as arkmeExtensionShareRefFromLink, L as sha256Hex, Lt as createDesktopLifecycleReader, M as packLocalNativeBundleDirectoryV3, Mt as parseArkmeRecordReeditAttachments, N as readNativeBundleTarballV3, Nt as parseArkmeRecordReeditMentions, O as canonicalBundleJson, Ot as ArkmePluginError, P as renderArkmeSandboxHostEntry, Q as ARKME_PROVIDER_CONTRACT_VERSION, R as unpackArkmeExtension, Rt as __commonJSMin, S as ARKME_BUNDLE_ARTIFACT_KIND, T as ArkmeBundleArtifactError, Tt as normalizeRecentEmojiIds, U as ARKME_EXTENSION_RUNTIME_UNAVAILABLE_MESSAGE, Vt as __require, W as ArkmeService, X as arkmeRichBackgroundSound, Y as arkmeFileBackgroundSound, Z as ARKME_DEFAULT_SHARE_WEBSITE, _ as arkmeClientContentDigest, _t as ArkmeDirectMessageAdmissionError, at as cachedMemberItem, b as verifyExtensionResolutionSignature, bt as recordingImportFileKind, c as persistentExtensionBundleDirectory, ct as SelfRoleSyncStore, d as readPersistentExtensionActivation, dt as arkmeCanInlineLocalFile, f as refreshPersistentClientWrapper, ft as arkmeNormalizedFileMimeType, g as activeProfileExtensionOwnerConflicts, gt as SecretValue, h as renderArkmeBundleClientBundle, ht as ArkmeOutgoingCallError, i as invokePersistentArkmeExtension, it as applyMemberUpdate, j as packBundleFiles, jt as ArkmeRecordReeditDraftConflict, k as inspectBundleArtifact, kt as retryAfterMillis, l as persistentExtensionPackageIdentity, lt as ARKME_RUNTIME_INSTANCE_ID, m as writePersistentExtensionActivation, mt as isArkmeBotAvatarRef, nt as ARKME_WORLD_PUBLISH_MAX_IMAGES, o as persistentArkmeExtensionRuntimeState, ot as mergeMemberJoinEvents, p as repairPersistentExtensionInstallation, pt as arkmePickedFileKind, q as arkmeIsGenericLinkMetadataTitle, r as deactivatePersistentArkmeExtension, rt as ARKME_WORLD_PUBLISH_MAX_IMAGE_BYTES, s as materializePersistentExtensionBundle, st as validateMemberUpdate, t as activatePersistentArkmeExtension, u as quarantinePersistentExtension, ut as ARKME_TOOL_FILE_MAX_BYTES, v as arkmeClientContentDigestFromSource, vt as isRecordingInstantOnOrAfterUnixEpoch, w as ARKME_NATIVE_BUNDLE_ARTIFACT_KIND, wt as isRecentEmojiId, x as verifyNativeBundleResolutionSignature, xt as sameRecordingImportIdentity, y as verifyBundleResolutionSignature, yt as isUnresolvedRecordingImportJob, z as ARKME_EXTENSION_FORMAT, zt as __esmMin } from "./persistent-runtime-0qn1BZ6S.js";
 import { i as securePrivateFileSync, n as securePrivateDirectorySync, r as securePrivateFile, t as securePrivateDirectory } from "./private-filesystem-CGh4FtyA.js";
 import { _ as parsePluginUpdateManifest, b as validatePluginUpdateServiceOrigin, d as writePluginUpdateLifecycleLog, f as PluginUpdateInstallStateStore, g as existingCachedPluginArtifactPath, h as downloadAndCachePluginArtifact, m as PluginUpdateArtifactError, n as buildTargetInstallArgs, o as reconcilePluginUpdaterProfilePolicy, p as ARKME_PLUGIN_PACKAGE_NAME$1, t as assertTargetArtifactIntegrity, u as detachManagedProfilePluginLink, v as pluginUpdateEndpointUrl, y as validatePluginUpdateArtifactOrigin } from "./plugin-updater-helper-dNxHpiVg.js";
 import { i as prepareProfilePackageManager, n as isArkmeProfilePackageName, r as localExtensionPnpmArgs, t as applyArkmeProfileBundlePolicy } from "./profile-bundle-policy-8_y3QfHe.js";
@@ -14277,6 +14277,7 @@ function createArkmeHostApi(service, options) {
 				"recordings.import.session.update-ownership",
 				"recordings.import.session.delete",
 				"recordings.speaker.assign-item",
+				"speaker-directory.seen",
 				"openapi.mcp.retry",
 				"team.create",
 				"team.join-by-jotmo-id"
@@ -14643,6 +14644,11 @@ async function dispatchArkmeHostOperation(service, operation, params, updateMana
 		case "recordings.import.session.delete": return await service.deleteRecordingImportSession(stringParam(params, "sessionRef").trim(), requestSignal);
 		case "recordings.playback.open": return await service.recordingPlayback(stringParam(params, "itemRef").trim(), requestSignal);
 		case "recordings.speaker.cached-options": return await service.cachedRecordingSpeakerOptions(requestSignal);
+		case "speaker-directory.summary": return await service.speakerDirectorySummary(params, requestSignal);
+		case "speaker-directory.list": return await service.speakerDirectoryList(params, requestSignal);
+		case "speaker-directory.seen": return await service.speakerDirectorySeen(params, requestSignal);
+		case "speaker-directory.open": return await service.speakerDirectoryOpen(params, requestSignal);
+		case "speaker-directory.avatars": return await service.speakerDirectoryAvatars(params, requestSignal);
 		case "recordings.speaker.options": return await service.recordingSpeakerOptions(requestSignal);
 		case "recordings.speaker.presence": return await service.recordingSpeakerPresence(requestSignal);
 		case "recordings.speaker.members": return await service.recordingSpeakerMembers(stringParam(params, "speakerRef").trim(), requestSignal, stringParam(params, "expectedVersion").trim() || void 0);

package/lib/persistent-extension.js

@@ -1,2 +1,2 @@
-import { a as persistentArkmeExtensionActive, i as invokePersistentArkmeExtension, n as applyPersistentArkmeHostExtension, o as persistentArkmeExtensionRuntimeState, r as deactivatePersistentArkmeExtension, t as activatePersistentArkmeExtension } from "./persistent-runtime-DfmCJcxH.js";
+import { a as persistentArkmeExtensionActive, i as invokePersistentArkmeExtension, n as applyPersistentArkmeHostExtension, o as persistentArkmeExtensionRuntimeState, r as deactivatePersistentArkmeExtension, t as activatePersistentArkmeExtension } from "./persistent-runtime-0qn1BZ6S.js";
 export { activatePersistentArkmeExtension, applyPersistentArkmeHostExtension, deactivatePersistentArkmeExtension, invokePersistentArkmeExtension, persistentArkmeExtensionActive, persistentArkmeExtensionRuntimeState };

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

@@ -393,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. */
@@ -409,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"]);
@@ -440,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);
@@ -456,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);
 				}
 			}
 		}
@@ -1306,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);
@@ -1315,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 };
 }
@@ -1799,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 {
@@ -2160,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. */
@@ -92396,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();
@@ -93462,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 {
@@ -93476,7 +93742,8 @@ var RecordingService = class {
 				}];
 			}));
 			return new Map(entries);
-		} catch {
+		} catch (error) {
+			if (propagateFailure) throw error;
 			return /* @__PURE__ */ new Map();
 		}
 	}
@@ -96046,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, {
@@ -98731,6 +99020,7 @@ var ArkmeService = class {
 	relatedQuickNote;
 	contact;
 	contactDirectory;
+	speakerDirectory;
 	unmarkedSpeaker;
 	voiceprint;
 	userBan;
@@ -98860,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, {
@@ -99482,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);
 	}

package/lib/types/arkme-service.d.ts

@@ -83,6 +83,7 @@ export declare class ArkmeService {
     private readonly relatedQuickNote;
     private readonly contact;
     private readonly contactDirectory;
+    private readonly speakerDirectory;
     private readonly unmarkedSpeaker;
     private readonly voiceprint;
     private readonly userBan;
@@ -332,6 +333,11 @@ export declare class ArkmeService {
     recordingDay(dateStamp: number, signal?: AbortSignal): Promise<ArkmeRecordingDay>;
     recordingPlayback(itemRef: string, signal?: AbortSignal): Promise<ArkmeRecordingPlayback>;
     cachedRecordingSpeakerOptions(signal?: AbortSignal): Promise<ArkmeRecordingSpeakerCandidate[] | null>;
+    speakerDirectorySummary(input: Record<string, unknown>, signal?: AbortSignal): Promise<import("./speaker-directory-contract.js").SpeakerDirectorySummary>;
+    speakerDirectoryAvatars(input: Record<string, unknown>, signal?: AbortSignal): Promise<import("./speaker-directory-contract.js").SpeakerDirectoryAvatar[]>;
+    speakerDirectoryList(input: Record<string, unknown>, signal?: AbortSignal): Promise<import("./speaker-directory-contract.js").SpeakerDirectoryPage>;
+    speakerDirectorySeen(input: Record<string, unknown>, signal?: AbortSignal): Promise<import("./speaker-directory-contract.js").SpeakerDirectorySeen>;
+    speakerDirectoryOpen(input: Record<string, unknown>, signal?: AbortSignal): Promise<import("./speaker-directory-contract.js").SpeakerDirectoryDetail>;
     recordingSpeakerOptions(signal?: AbortSignal): Promise<ArkmeRecordingSpeakerCandidate[]>;
     recordingSpeakerPresence(signal?: AbortSignal): Promise<ArkmeRecordingSpeakerPresence>;
     recordingSpeakerMembers(speakerRef: string, signal?: AbortSignal, expectedVersion?: string): Promise<import("./types.js").ArkmeRecordingSpeakerMembers>;