@senguoyun/dsh-arkme 0.1.84 → 0.1.85

package/lib/harness-model-client.js

@@ -1358,6 +1358,24 @@ Arkme 用户|Arkme user
 正在读取录音|Loading recordings
 当前窗口说话人统计|Speaker statistics for this range
 当前窗口说话人图例|Speakers in this range
+全天说话人统计|All-day speaker statistics
+全天说话人图例|All-day speakers
+关闭全天说话人统计|Close all-day speaker statistics
+时间轴记录|Timeline entry
+时间未标注|Time unavailable
+场景类型|Scene
+场景说明|Scene note
+环境说明|Environment note
+评价|Assessment
+评价分数|Assessment score
+事件标签|Event tags
+时段总结|Period summary
+参与者|Participants
+说话人备注|Speaker note
+待办|To-do
+代表性原话|Representative quotes
+对话摘要|Dialogue summaries
+其他信息|Other information
 暂停播放|Pause
 转发录音片段|Forward recording segment
 转发对象|Forwarding destination
@@ -2502,6 +2520,46 @@ AI 额度充值流程|AI point purchase
 				if (normalized === "") throw new TypeError("Arkme call reference must not be empty");
 				return await this.call("calls.history.summary.retry", { callRef: normalized }, signal);
 			}
+			async requireSelfRoles(signal) {
+				if ((await this.capabilities(signal)).features.selfRoles !== true) throw new Error("当前 Arkme Provider 不支持跨端角色，请升级");
+			}
+			async listSelfRoles(expectedUserId, signal) {
+				await this.requireSelfRoles(signal);
+				return await this.call("self-roles.list", { expectedUserId }, signal);
+			}
+			async createSelfRole(expectedUserId, name, avatarRef, signal) {
+				await this.requireSelfRoles(signal);
+				return await this.call("self-roles.create", {
+					expectedUserId,
+					name,
+					...avatarRef === void 0 ? {} : { avatarRef }
+				}, signal);
+			}
+			async updateSelfRole(expectedUserId, roleId, name, avatarRef, signal) {
+				await this.requireSelfRoles(signal);
+				return await this.call("self-roles.update", {
+					expectedUserId,
+					roleId,
+					name,
+					...avatarRef === void 0 ? {} : { avatarRef }
+				}, signal);
+			}
+			async deleteSelfRole(expectedUserId, roleId, signal) {
+				await this.requireSelfRoles(signal);
+				return await this.call("self-roles.delete", {
+					expectedUserId,
+					roleId
+				}, signal);
+			}
+			async bindSelfRole(expectedUserId, sourceRef, recordUid, roleId, signal) {
+				await this.requireSelfRoles(signal);
+				return await this.call("self-roles.bind", {
+					expectedUserId,
+					sourceRef,
+					recordUid,
+					roleId
+				}, signal);
+			}
 			async profile(options = {}) {
 				return await this.call(options.refresh === true ? "user.profile.refresh" : "user.profile", void 0, options.signal);
 			}

package/lib/harness-native-selection-client.js

@@ -537,6 +537,46 @@ window.__ModuleLoader__.load({
 				if (normalized === "") throw new TypeError("Arkme call reference must not be empty");
 				return await this.call("calls.history.summary.retry", { callRef: normalized }, signal);
 			}
+			async requireSelfRoles(signal) {
+				if ((await this.capabilities(signal)).features.selfRoles !== true) throw new Error("当前 Arkme Provider 不支持跨端角色，请升级");
+			}
+			async listSelfRoles(expectedUserId, signal) {
+				await this.requireSelfRoles(signal);
+				return await this.call("self-roles.list", { expectedUserId }, signal);
+			}
+			async createSelfRole(expectedUserId, name, avatarRef, signal) {
+				await this.requireSelfRoles(signal);
+				return await this.call("self-roles.create", {
+					expectedUserId,
+					name,
+					...avatarRef === void 0 ? {} : { avatarRef }
+				}, signal);
+			}
+			async updateSelfRole(expectedUserId, roleId, name, avatarRef, signal) {
+				await this.requireSelfRoles(signal);
+				return await this.call("self-roles.update", {
+					expectedUserId,
+					roleId,
+					name,
+					...avatarRef === void 0 ? {} : { avatarRef }
+				}, signal);
+			}
+			async deleteSelfRole(expectedUserId, roleId, signal) {
+				await this.requireSelfRoles(signal);
+				return await this.call("self-roles.delete", {
+					expectedUserId,
+					roleId
+				}, signal);
+			}
+			async bindSelfRole(expectedUserId, sourceRef, recordUid, roleId, signal) {
+				await this.requireSelfRoles(signal);
+				return await this.call("self-roles.bind", {
+					expectedUserId,
+					sourceRef,
+					recordUid,
+					roleId
+				}, signal);
+			}
 			async profile(options = {}) {
 				return await this.call(options.refresh === true ? "user.profile.refresh" : "user.profile", void 0, options.signal);
 			}
@@ -3788,6 +3828,24 @@ Arkme 用户|Arkme user
 正在读取录音|Loading recordings
 当前窗口说话人统计|Speaker statistics for this range
 当前窗口说话人图例|Speakers in this range
+全天说话人统计|All-day speaker statistics
+全天说话人图例|All-day speakers
+关闭全天说话人统计|Close all-day speaker statistics
+时间轴记录|Timeline entry
+时间未标注|Time unavailable
+场景类型|Scene
+场景说明|Scene note
+环境说明|Environment note
+评价|Assessment
+评价分数|Assessment score
+事件标签|Event tags
+时段总结|Period summary
+参与者|Participants
+说话人备注|Speaker note
+待办|To-do
+代表性原话|Representative quotes
+对话摘要|Dialogue summaries
+其他信息|Other information
 暂停播放|Pause
 转发录音片段|Forward recording segment
 转发对象|Forwarding destination

package/lib/harness-sidebar-client.js

@@ -479,6 +479,46 @@ window.__ModuleLoader__.load({
 				if (normalized === "") throw new TypeError("Arkme call reference must not be empty");
 				return await this.call("calls.history.summary.retry", { callRef: normalized }, signal);
 			}
+			async requireSelfRoles(signal) {
+				if ((await this.capabilities(signal)).features.selfRoles !== true) throw new Error("当前 Arkme Provider 不支持跨端角色，请升级");
+			}
+			async listSelfRoles(expectedUserId, signal) {
+				await this.requireSelfRoles(signal);
+				return await this.call("self-roles.list", { expectedUserId }, signal);
+			}
+			async createSelfRole(expectedUserId, name, avatarRef, signal) {
+				await this.requireSelfRoles(signal);
+				return await this.call("self-roles.create", {
+					expectedUserId,
+					name,
+					...avatarRef === void 0 ? {} : { avatarRef }
+				}, signal);
+			}
+			async updateSelfRole(expectedUserId, roleId, name, avatarRef, signal) {
+				await this.requireSelfRoles(signal);
+				return await this.call("self-roles.update", {
+					expectedUserId,
+					roleId,
+					name,
+					...avatarRef === void 0 ? {} : { avatarRef }
+				}, signal);
+			}
+			async deleteSelfRole(expectedUserId, roleId, signal) {
+				await this.requireSelfRoles(signal);
+				return await this.call("self-roles.delete", {
+					expectedUserId,
+					roleId
+				}, signal);
+			}
+			async bindSelfRole(expectedUserId, sourceRef, recordUid, roleId, signal) {
+				await this.requireSelfRoles(signal);
+				return await this.call("self-roles.bind", {
+					expectedUserId,
+					sourceRef,
+					recordUid,
+					roleId
+				}, signal);
+			}
 			async profile(options = {}) {
 				return await this.call(options.refresh === true ? "user.profile.refresh" : "user.profile", void 0, options.signal);
 			}

package/lib/index.js

@@ -1,4 +1,4 @@
-import { A as inspectNativeBundleArtifactV3, At as ArkmeRecordReeditDraftConflict, Bt as __require, Ct as isRecentEmojiId, D as bundleSha256, Dt as ArkmePluginError, E as arkmeSandboxEntryId, F as assertExtensionArtifactSize, Ft as registerDSHAgentInputRecordSync, G as validateVoiceprintPcm16Wav, I as canonicalExtensionJson, It as createDesktopLifecycleReader, J as arkmeRequiredLinkMetadataFallback, K as arkmeExtensionShareRefFromLink, L as sha256Hex, Lt as __commonJSMin, M as packLocalNativeBundleDirectoryV3, Mt as parseArkmeRecordReeditMentions, N as readNativeBundleTarballV3, O as canonicalBundleJson, Ot as retryAfterMillis, P as renderArkmeSandboxHostEntry, Pt as parseArrangementBoardCachePages, Q as ARKME_PROVIDER_CONTRACT_VERSION, R as unpackArkmeExtension, Rt as __esmMin, S as ARKME_BUNDLE_ARTIFACT_KIND, St as recordingImportFileNameKey, T as ArkmeBundleArtifactError, Tt as registerManagedAiProvider, U as ARKME_EXTENSION_RUNTIME_UNAVAILABLE_MESSAGE, Vt as __toCommonJS, W as ArkmeService, X as arkmeRichBackgroundSound, Y as arkmeFileBackgroundSound, Z as ARKME_DEFAULT_SHARE_WEBSITE, _ as arkmeClientContentDigest, _t as isRecordingInstantOnOrAfterUnixEpoch, at as cachedMemberItem, b as verifyExtensionResolutionSignature, bt as sameRecordingImportIdentity, c as persistentExtensionBundleDirectory, ct as ARKME_RUNTIME_INSTANCE_ID, d as readPersistentExtensionActivation, dt as arkmeNormalizedFileMimeType, f as refreshPersistentClientWrapper, ft as arkmePickedFileKind, g as activeProfileExtensionOwnerConflicts, gt as ArkmeDirectMessageAdmissionError, h as renderArkmeBundleClientBundle, ht as SecretValue, i as invokePersistentArkmeExtension, it as applyMemberUpdate, j as packBundleFiles, jt as parseArkmeRecordReeditAttachments, k as inspectBundleArtifact, kt as recordOwnerId, l as persistentExtensionPackageIdentity, lt as ARKME_TOOL_FILE_MAX_BYTES, m as writePersistentExtensionActivation, mt as ArkmeOutgoingCallError, nt as ARKME_WORLD_PUBLISH_MAX_IMAGES, o as persistentArkmeExtensionRuntimeState, ot as mergeMemberJoinEvents, p as repairPersistentExtensionInstallation, pt as isArkmeBotAvatarRef, 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 arkmeCanInlineLocalFile, v as arkmeClientContentDigestFromSource, vt as isUnresolvedRecordingImportJob, w as ARKME_NATIVE_BUNDLE_ARTIFACT_KIND, wt as normalizeRecentEmojiIds, x as verifyNativeBundleResolutionSignature, y as verifyBundleResolutionSignature, yt as recordingImportFileKind, z as ARKME_EXTENSION_FORMAT, zt as __exportAll } from "./persistent-runtime-CuKplHIv.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-adGFmkIa.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";
@@ -86,7 +86,7 @@ function nativeRecord(value) {
 	if (!value || typeof value !== "object" || Array.isArray(value)) throw new DshRemoteError("REMOTE_REQUEST_INVALID", "原生传输数据无效");
 	return value;
 }
-function list$2(value) {
+function list$3(value) {
 	if (!Array.isArray(value)) throw new DshRemoteError("REMOTE_INVALID_RESPONSE", "原生列表数据无效");
 	return value;
 }
@@ -158,7 +158,7 @@ var DshNativeTransport = class {
 		const frame = nativeRecord(value);
 		const ids = async (values) => await scope.owned(values.filter((v) => typeof v === "string"));
 		if (endpoint === "session/list") {
-			const items = list$2(frame.items), owned = await ids(items.map((item) => nativeRecord(item).sessionId));
+			const items = list$3(frame.items), owned = await ids(items.map((item) => nativeRecord(item).sessionId));
 			return {
 				...frame,
 				items: items.filter((item) => owned.has(String(nativeRecord(item).sessionId)))
@@ -175,20 +175,20 @@ var DshNativeTransport = class {
 		}
 		if (endpoint === "workspace/follow" || endpoint === "workspace/archiveSession") {
 			const source = frame.type === "baseline" ? nativeRecord(frame.value) : frame;
-			const items = source.items === void 0 ? [] : list$2(source.items);
-			const owned = await ids([...(source.workspace === void 0 ? items : [source.workspace]).flatMap((item) => list$2(nativeRecord(item).sessionIds)), ...list$2(source.archivedSessionIds ?? [])]);
+			const items = source.items === void 0 ? [] : list$3(source.items);
+			const owned = await ids([...(source.workspace === void 0 ? items : [source.workspace]).flatMap((item) => list$3(nativeRecord(item).sessionIds)), ...list$3(source.archivedSessionIds ?? [])]);
 			const project = (raw) => {
 				const item = nativeRecord(raw);
 				return {
 					...item,
-					sessionIds: list$2(item.sessionIds).filter((id) => owned.has(String(id)))
+					sessionIds: list$3(item.sessionIds).filter((id) => owned.has(String(id)))
 				};
 			};
 			const projected = {
 				...source,
 				...source.items === void 0 ? {} : { items: items.map(project).filter((item) => item.sessionIds.length > 0) },
 				...source.workspace === void 0 ? {} : { workspace: project(source.workspace) },
-				...source.archivedSessionIds === void 0 ? {} : { archivedSessionIds: list$2(source.archivedSessionIds).filter((id) => owned.has(String(id))) }
+				...source.archivedSessionIds === void 0 ? {} : { archivedSessionIds: list$3(source.archivedSessionIds).filter((id) => owned.has(String(id))) }
 			};
 			if (source.workspace !== void 0 && nativeRecord(projected.workspace).sessionIds instanceof Array && nativeRecord(projected.workspace).sessionIds.length === 0) return void 0;
 			return frame.type === "baseline" ? {
@@ -220,10 +220,10 @@ var DshNativeTransport = class {
 			if (frame.type === "emit" && typeof frame.event === "string") {
 				if (frame.event === "llm/adapters-updated") return frame;
 				if (frame.event.startsWith("api-session/")) {
-					const first = list$2(frame.args)[0], id = frame.event === "api-session/added" ? nativeRecord(first).sessionId : first;
+					const first = list$3(frame.args)[0], id = frame.event === "api-session/added" ? nativeRecord(first).sessionId : first;
 					return (await ids([id])).has(String(id)) ? frame : void 0;
 				}
-				if (["agent-preset/selected", "goal/activation-changed"].includes(frame.event)) return (await ids([list$2(frame.args)[0]])).has(String(list$2(frame.args)[0])) ? frame : void 0;
+				if (["agent-preset/selected", "goal/activation-changed"].includes(frame.event)) return (await ids([list$3(frame.args)[0]])).has(String(list$3(frame.args)[0])) ? frame : void 0;
 			}
 			return;
 		}
@@ -1457,7 +1457,7 @@ const MAX_OPEN_CALLS_PER_SESSION = 512;
 function record$4(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
-function list$1(value) {
+function list$2(value) {
 	return Array.isArray(value) ? value : [];
 }
 function firstLine(value) {
@@ -1480,7 +1480,7 @@ function parseArguments(value) {
 function contentText(value) {
 	const parts = [];
 	const collect = (candidate) => {
-		for (const raw of list$1(candidate)) {
+		for (const raw of list$2(candidate)) {
 			const block = record$4(raw);
 			if (block.type === "text" && typeof block.text === "string" && block.text.trim() !== "") parts.push(block.text.trimEnd());
 			else if (block.type === "tool-result") collect(block.content);
@@ -1560,13 +1560,13 @@ function toolPresentation(data) {
 	let summary = "";
 	if (failed && errorSummary !== "") summary = errorSummary;
 	else if (normalizedName === "ask_user_question") {
-		const count = list$1(args.questions).length;
+		const count = list$2(args.questions).length;
 		summary = count === 0 ? "" : data.status === "completed" ? `${count}/${count} 已回答` : `${count} 个问题`;
 	} else if (typeof resultView.summary === "string") summary = firstLine(resultView.summary);
 	else if (typeof resultView.title === "string") summary = firstLine(resultView.title);
 	else if (card === "terminal") summary = firstLine(callView.description) || firstLine(callView.title);
 	else if (typeof callView.title === "string") summary = firstLine(callView.title);
-	else if (normalizedName === "web_search") summary = list$1(args.queries).filter((value) => typeof value === "string").join(", ");
+	else if (normalizedName === "web_search") summary = list$2(args.queries).filter((value) => typeof value === "string").join(", ");
 	else summary = safeArgumentSummary(normalizedName, args);
 	if (title === "Tool call" && name !== "" && !summary.startsWith(name)) summary = summary === "" ? name : `${name} · ${summary}`;
 	if (failed && errorSummary !== "") summary = errorSummary;
@@ -1598,7 +1598,7 @@ function presentationForTimelineNode(kind, data) {
 		case "context": return contextPresentation(data);
 		case "tool": return toolPresentation(data);
 		case "command": {
-			const name = firstLine(record$4(record$4(list$1(data.events).at(-1)).data).name);
+			const name = firstLine(record$4(record$4(list$2(data.events).at(-1)).data).name);
 			return {
 				version: 1,
 				format: "summary",
@@ -1760,7 +1760,7 @@ const MAX_TURN_PROJECTION_BYTES = 4 * 1024 * 1024;
 function record$3(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
-function list(value) {
+function list$1(value) {
 	return Array.isArray(value) ? value : [];
 }
 function nonEmptyId(value) {
@@ -1830,7 +1830,7 @@ function foldLifecycle(nodes, entry, ref, kind) {
 		time: previous?.time ?? entry.event.time,
 		data: {
 			...previous?.data,
-			events: [...list(previous?.data.events), entry.event]
+			events: [...list$1(previous?.data.events), entry.event]
 		},
 		sourceSeqs: [...previous?.sourceSeqs ?? [], entry.event.seq]
 	});
@@ -1912,7 +1912,7 @@ function projectDshHistoryNodes(entries) {
 				if (!isAppendSurface(entry)) break;
 				const key = stepKey(data, event.seq);
 				const message = record$3(data.message);
-				const content = list(message.content ?? data.content).map(record$3);
+				const content = list$1(message.content ?? data.content).map(record$3);
 				assistantBlocks.set(key, content);
 				const ref = `assistant:${key}`;
 				const previous = nodes.get(ref);
@@ -1985,7 +1985,7 @@ function projectDshHistoryNodes(entries) {
 					...previous,
 					data: {
 						...previous.data,
-						dispatches: [...list(previous.data.dispatches), data]
+						dispatches: [...list$1(previous.data.dispatches), data]
 					},
 					sourceSeqs: [...previous.sourceSeqs, event.seq]
 				});
@@ -14779,7 +14779,7 @@ async function dispatchArkmeHostOperation(service, operation, params, updateMana
 		case "arko.cancel": return await service.arkoCancel(numberParam(params, "sessionId", 0), numberParam(params, "assistantMsgId", 0), stringParam(params, "runUid"));
 		case "self-roles.list": return await service.listSelfRoles(numberParam(params, "expectedUserId", 0));
 		case "self-roles.create": return await service.createSelfRole(numberParam(params, "expectedUserId", 0), stringParam(params, "name"), params.avatarRef === void 0 ? void 0 : stringParam(params, "avatarRef"));
-		case "self-roles.update": return await service.updateSelfRole(numberParam(params, "expectedUserId", 0), stringParam(params, "roleId"), stringParam(params, "name"), params.avatarRef === void 0 ? void 0 : stringParam(params, "avatarRef"));
+		case "self-roles.update": return await service.updateSelfRole(numberParam(params, "expectedUserId", 0), stringParam(params, "roleId"), params.name === void 0 ? void 0 : stringParam(params, "name"), params.avatarRef === void 0 ? void 0 : stringParam(params, "avatarRef"));
 		case "self-roles.delete": return await service.deleteSelfRole(numberParam(params, "expectedUserId", 0), stringParam(params, "roleId"));
 		case "self-roles.bind": return await service.bindSelfRole(numberParam(params, "expectedUserId", 0), stringParam(params, "sourceRef"), stringParam(params, "recordUid"), stringParam(params, "roleId"));
 		case "self-roles.unbind": return await service.unbindSelfRole(numberParam(params, "expectedUserId", 0), stringParam(params, "recordUid"), stringParam(params, "roleId"));
@@ -19605,6 +19605,7 @@ function selfRoleSnapshotFromRow(row) {
 }
 var ArkmeLocalDatabase = class {
 	operationalState;
+	selfRoleSync;
 	commonGroups;
 	path;
 	database;
@@ -19742,6 +19743,7 @@ var ArkmeLocalDatabase = class {
 			}
 		});
 		this.commonGroups = new CommonGroupDatabase(this.database, (work) => this.transaction(work));
+		this.selfRoleSync = new SelfRoleSyncStore(this.database, (action) => this.transaction(action));
 		const recordColumns = this.database.prepare("PRAGMA table_info(record_cache)").all();
 		if (!recordColumns.some((column) => column.name === "sender_avatar_ref")) this.database.exec("ALTER TABLE record_cache ADD COLUMN sender_avatar_ref TEXT");
 		if (!recordColumns.some((column) => column.name === "sender_name")) this.database.exec("ALTER TABLE record_cache ADD COLUMN sender_name TEXT");
@@ -19785,35 +19787,9 @@ var ArkmeLocalDatabase = class {
 	async listSelfRoles(userId) {
 		return this.database.prepare(`
       SELECT role_id, name, avatar_ref, created_at_millis, updated_at_millis
-      FROM self_role WHERE user_id = ? ORDER BY created_at_millis, role_id
+      FROM self_role WHERE user_id = ? AND deleted=0 ORDER BY created_at_millis, role_id
     `).all(userId).map(selfRoleFromRow);
 	}
-	/** Historical uploaded avatars occur both on live roles and frozen message presentation. */
-	async legacySelfRoleAvatarRefs(userId) {
-		return this.database.prepare(`
-      SELECT avatar_ref FROM self_role WHERE user_id = ? AND avatar_ref LIKE 'file_asset://%'
-      UNION
-      SELECT avatar_ref FROM self_role_record WHERE user_id = ? AND avatar_ref LIKE 'file_asset://%'
-    `).all(userId, userId).map((row) => row.avatar_ref).filter((ref) => /^file_asset:\/\/[A-Za-z0-9_-]{8,128}$/.test(ref));
-	}
-	/** Replace only byte-equivalent avatar refs; names and historical role identities stay frozen. */
-	async replaceSelfRoleAvatarRef(userId, oldRef, newRef) {
-		if (!/^file_asset:\/\/[A-Za-z0-9_-]{8,128}$/.test(oldRef) || !/^arkme-self-role-image-v1\.[0-9a-f-]{36}$/i.test(newRef)) return 0;
-		let changed = 0;
-		this.transaction(() => {
-			const now = Date.now();
-			const roles = this.database.prepare(`
-        UPDATE self_role
-        SET avatar_ref = ?, updated_at_millis = CASE WHEN updated_at_millis >= ? THEN updated_at_millis + 1 ELSE ? END
-        WHERE user_id = ? AND avatar_ref = ?
-      `).run(newRef, now, now, userId, oldRef);
-			const records = this.database.prepare(`
-        UPDATE self_role_record SET avatar_ref = ? WHERE user_id = ? AND avatar_ref = ?
-      `).run(newRef, userId, oldRef);
-			changed = Number(roles.changes) + Number(records.changes);
-		});
-		return changed;
-	}
 	async createSelfRole(userId, name, avatarRef) {
 		const role = {
 			roleId: randomUUID(),
@@ -19823,36 +19799,37 @@ var ArkmeLocalDatabase = class {
 			updatedAtMillis: Date.now()
 		};
 		this.transaction(() => {
-			if (this.database.prepare("SELECT count(*) AS count FROM self_role WHERE user_id = ?").get(userId).count >= 20) throw new Error("self-role-limit");
+			if (this.database.prepare("SELECT count(*) AS count FROM self_role WHERE user_id = ? AND deleted=0").get(userId).count >= 20) throw new Error("self-role-limit");
 			this.database.prepare(`
-        INSERT INTO self_role (user_id, role_id, name, avatar_ref, created_at_millis, updated_at_millis)
-        VALUES (?, ?, ?, ?, ?, ?)
-      `).run(userId, role.roleId, name, avatarRef ?? null, role.createdAtMillis, role.updatedAtMillis);
+        INSERT INTO self_role (user_id, role_id, name, avatar_ref, created_at_millis, updated_at_millis, name_at, avatar_at)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+      `).run(userId, role.roleId, name, avatarRef ?? null, role.createdAtMillis, role.updatedAtMillis, role.updatedAtMillis, role.updatedAtMillis);
 		});
 		return role;
 	}
 	async updateSelfRole(userId, roleId, name, avatarRef) {
 		const row = this.database.prepare(`
       SELECT role_id, name, avatar_ref, created_at_millis, updated_at_millis
-      FROM self_role WHERE user_id = ? AND role_id = ?
+      FROM self_role WHERE user_id = ? AND role_id = ? AND deleted=0
     `).get(userId, roleId);
 		if (row === void 0) return void 0;
+		const nextName = name ?? row.name;
 		const nextAvatarRef = avatarRef === void 0 ? row.avatar_ref : avatarRef || null;
 		const updatedAtMillis = Math.max(Date.now(), row.updated_at_millis + 1);
 		this.database.prepare(`
-      UPDATE self_role SET name = ?, avatar_ref = ?, updated_at_millis = ?
+      UPDATE self_role SET name_at=CASE WHEN name != ? THEN ? ELSE name_at END, avatar_at=CASE WHEN COALESCE(avatar_ref,'') != ? THEN ? ELSE avatar_at END, name = ?, avatar_ref = ?, updated_at_millis = ?
       WHERE user_id = ? AND role_id = ?
-    `).run(name, nextAvatarRef, updatedAtMillis, userId, roleId);
+    `).run(nextName, updatedAtMillis, nextAvatarRef ?? "", updatedAtMillis, nextName, nextAvatarRef, updatedAtMillis, userId, roleId);
 		this.secureDatabaseFiles();
 		return selfRoleFromRow({
 			...row,
-			name,
+			name: nextName,
 			avatar_ref: nextAvatarRef,
 			updated_at_millis: updatedAtMillis
 		});
 	}
 	async deleteSelfRole(userId, roleId) {
-		const result = this.database.prepare("DELETE FROM self_role WHERE user_id = ? AND role_id = ?").run(userId, roleId);
+		const result = this.database.prepare("UPDATE self_role SET deleted=1, deleted_at=MAX(?,updated_at_millis+1),updated_at_millis=MAX(?,updated_at_millis+1) WHERE user_id = ? AND role_id = ? AND deleted=0").run(Date.now(), Date.now(), userId, roleId);
 		this.secureDatabaseFiles();
 		return Number(result.changes) > 0;
 	}
@@ -19861,7 +19838,7 @@ var ArkmeLocalDatabase = class {
 		this.transaction(() => {
 			const role = this.database.prepare(`
         SELECT role_id, name, avatar_ref, created_at_millis, updated_at_millis
-        FROM self_role WHERE user_id = ? AND role_id = ?
+        FROM self_role WHERE user_id = ? AND role_id = ? AND deleted=0
       `).get(userId, roleId);
 			if (role === void 0) return;
 			const existing = this.database.prepare(`
@@ -19886,7 +19863,7 @@ var ArkmeLocalDatabase = class {
 		return snapshot;
 	}
 	async unbindSelfRole(userId, recordUid, roleId) {
-		this.database.prepare("DELETE FROM self_role_record WHERE user_id = ? AND record_uid = ? AND role_id = ?").run(userId, recordUid, roleId);
+		this.database.prepare("DELETE FROM self_role_record WHERE user_id = ? AND record_uid = ? AND role_id = ? AND cloud_ack=0").run(userId, recordUid, roleId);
 		this.secureDatabaseFiles();
 	}
 	async rebindSelfRole(userId, recordUid, newRecordUid) {
@@ -19894,7 +19871,7 @@ var ArkmeLocalDatabase = class {
 		let rebound = false;
 		this.transaction(() => {
 			const source = this.database.prepare(`
-        SELECT role_id, role_name, avatar_ref FROM self_role_record WHERE user_id = ? AND record_uid = ?
+        SELECT role_id, role_name, avatar_ref, cloud_ack FROM self_role_record WHERE user_id = ? AND record_uid = ?
       `).get(userId, recordUid);
 			const target = this.database.prepare(`
         SELECT role_id, role_name, avatar_ref FROM self_role_record WHERE user_id = ? AND record_uid = ?
@@ -19903,6 +19880,7 @@ var ArkmeLocalDatabase = class {
 				rebound = target !== void 0;
 				return;
 			}
+			if (source.cloud_ack === 1) throw new Error("self-role-record-conflict");
 			if (target !== void 0 && (target.role_id !== source.role_id || target.role_name !== source.role_name || target.avatar_ref !== source.avatar_ref)) throw new Error("self-role-record-conflict");
 			if (target === void 0) this.database.prepare(`
           INSERT INTO self_role_record (user_id, record_uid, role_id, role_name, avatar_ref, bound_at_millis)
@@ -19923,8 +19901,8 @@ var ArkmeLocalDatabase = class {
     `).all(userId, ...uniqueUids);
 		return new Map(rows.map((row) => [row.record_uid, selfRoleSnapshotFromRow(row)]));
 	}
-	/** Stable, account-scoped pages for a future idempotent cloud backfill. No local row is marked synced or removed. */
-	async selfRoleMigrationBatch(userId, afterRecordUid = "", limit = 200) {
+	/** Stable, account-scoped pages for a account-scoped snapshot inspection. No local row is marked synced or removed. */
+	async selfRoleBindings(userId, afterRecordUid = "", limit = 200) {
 		const pageSize = Math.min(200, Math.max(1, Math.trunc(limit) || 200));
 		const rows = this.database.prepare(`
       SELECT record_uid, role_id, role_name, avatar_ref, bound_at_millis
@@ -20455,6 +20433,7 @@ var ArkmeLocalDatabase = class {
 	}
 	upsertSyncedRecord(userId, item) {
 		const now = Date.now();
+		if (item.selfRole) this.selfRoleSync.cacheSnapshot(userId, item.recordUid, item.selfRole);
 		this.database.prepare(`
       INSERT INTO record_cache (
         user_id, record_uid, send_at_millis, title, text_content, template_kind,
@@ -26992,6 +26971,79 @@ function isArkmeCoreToolModule(module) {
 function isArkmeContextToolModule(module) {
 	return module.meta.phase === "attachments" || module.meta.phase === "host";
 }
+const selfRoleToolModules = [defineArkmeCoreToolModule({
+	meta: {
+		id: "business.records.self-roles-list.v1",
+		toolName: "arkme_self_roles_list",
+		kind: "business",
+		phase: "core",
+		effect: "read",
+		profiles: ["business", "hybrid"]
+	},
+	create: (ports) => defineTool({
+		name: "arkme_self_roles_list",
+		description: "List private display roles for the current account. Roles never change the real author or permissions.",
+		parameters: { expected_user_id: {
+			type: "integer",
+			required: true,
+			description: "Current account user ID from the account profile."
+		} },
+		output: TEXT_OUTPUT$3,
+		isConcurrencySafe: () => true,
+		execute: async (args) => taggedJSON("发言角色", await ports.listSelfRoles(args.expected_user_id))
+	})
+}), defineArkmeCoreToolModule({
+	meta: {
+		id: "business.records.self-roles-write.v1",
+		toolName: "arkme_self_roles_write",
+		kind: "business",
+		phase: "core",
+		effect: "write",
+		grant: "explicit-user-write",
+		profiles: ["business", "hybrid"]
+	},
+	create: (ports) => defineTool({
+		name: "arkme_self_roles_write",
+		description: "Only on explicit user request, create, update or delete a private display role. Writes persist locally while offline. Avatar references must come from the current account file upload tools; never use URLs. Deletion preserves historical message presentation.",
+		parameters: {
+			expected_user_id: {
+				type: "integer",
+				required: true,
+				description: "Current account user ID."
+			},
+			action: {
+				type: "string",
+				required: true,
+				enum: [
+					"create",
+					"update",
+					"delete"
+				],
+				description: "Requested operation."
+			},
+			role_id: {
+				type: "string",
+				description: "Existing role ID, required except create."
+			},
+			name: {
+				type: "string",
+				description: "1–20 character role name; required for create. On update omit unchanged fields."
+			},
+			avatar_ref: {
+				type: "string",
+				description: "Current account file_asset:// reference; empty clears avatar."
+			}
+		},
+		output: TEXT_OUTPUT$3,
+		execute: async (args) => {
+			const uid = args.expected_user_id;
+			if (args.action === "create") return taggedJSON("角色已保存", await ports.createSelfRole(uid, args.name ?? "", args.avatar_ref));
+			if (args.action === "update") return taggedJSON("角色已保存", await ports.updateSelfRole(uid, args.role_id ?? "", args.name, args.avatar_ref));
+			if (args.action === "delete") return taggedJSON("角色已删除", await ports.deleteSelfRole(uid, args.role_id ?? ""));
+			throw new Error("Unsupported role operation");
+		}
+	})
+})];
 //#endregion
 //#region src/tools/business/conversation/private-interactions.ts
 const privateInteractionSummaryToolModule = defineArkmeCoreToolModule({
@@ -30761,14 +30813,30 @@ const createRecordToolModule = defineArkmeCoreToolModule({
 		return defineTool({
 			name: "arkme_record_create",
 			description: "Save plain text to the signed-in user's Arkme default category. Call only after an explicit human request in the current conversation. The write is cached locally before remote sync.",
-			parameters: { text: {
-				type: "string",
-				required: true,
-				description: "Exact plain-text content the user explicitly asked to save to Arkme."
-			} },
+			parameters: {
+				role_id: {
+					type: "string",
+					description: "Optional role ID explicitly selected by the user from arkme_self_roles_list."
+				},
+				expected_user_id: {
+					type: "integer",
+					description: "Required with role_id; the currently selected account user ID."
+				},
+				text: {
+					type: "string",
+					required: true,
+					description: "Exact plain-text content the user explicitly asked to save to Arkme."
+				}
+			},
 			output: TEXT_OUTPUT$3,
 			async execute(args, exec) {
-				return formatWriteResult(await ports.createTextForConversation(recordUidForToolCall(String(exec.callId)), args.text));
+				const recordUid = recordUidForToolCall(String(exec.callId));
+				if (args.role_id !== void 0) {
+					if (!args.expected_user_id) throw new Error("选择角色时必须提供当前账号 expected_user_id");
+					const target = await ports.selfTarget();
+					await ports.bindSelfRole(args.expected_user_id, target.sourceRef, recordUid, args.role_id);
+				}
+				return formatWriteResult(await ports.createTextForConversation(recordUid, args.text));
 			}
 		});
 	}
@@ -32465,6 +32533,7 @@ const voiceprintToolModules = [
 //#region src/tools/business/index.ts
 /** Stable model-facing order retained from the pre-catalog registration path. */
 const businessToolModules = [
+	...selfRoleToolModules,
 	directoryReadToolModule,
 	recentRecordsToolModule,
 	...accountBusinessToolModules,

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-CuKplHIv.js";
+import { a as persistentArkmeExtensionActive, i as invokePersistentArkmeExtension, n as applyPersistentArkmeHostExtension, o as persistentArkmeExtensionRuntimeState, r as deactivatePersistentArkmeExtension, t as activatePersistentArkmeExtension } from "./persistent-runtime-adGFmkIa.js";
 export { activatePersistentArkmeExtension, applyPersistentArkmeHostExtension, deactivatePersistentArkmeExtension, invokePersistentArkmeExtension, persistentArkmeExtensionActive, persistentArkmeExtensionRuntimeState };