@senguoyun/dsh-arkme 0.1.61 → 0.1.63

package/lib/harness-model-client.js

@@ -1155,6 +1155,9 @@ window.__ModuleLoader__.load({
 			async localFiles(signal) {
 				return this.call("files.local.list", void 0, signal);
 			}
+			async openLocalFileFolder(fileRef, signal) {
+				return this.call("files.local.open-folder", { fileRef }, signal);
+			}
 			async openLocalFile(fileRef, signal) {
 				return this.call("files.local.open", { fileRef }, signal);
 			}

package/lib/harness-session-client.js

@@ -8,6 +8,52 @@ window.__ModuleLoader__.load({
 		/** Same-origin bridge owned and disposed by the embedded session client. */
 		const HARNESS_SESSION_NAVIGATION_KEY = "__arkmeHarnessSessionNavigation";
 		//#endregion
+		//#region src/client/harness-session-selection.ts
+		/** The embedded runtime owns selection. Visibility/presence clears must never erase it. */
+		function observeHarnessSessionSelection(sessions, bridge) {
+			if (bridge === void 0) return () => {};
+			let stopped = false;
+			let pending;
+			let retry;
+			const persist = async (selection) => {
+				if (stopped || pending !== selection) return;
+				try {
+					if (!await bridge.save(selection.sessionId, selection.subagentAddress)) stopped = true;
+				} catch (error) {
+					if (stopped || pending !== selection) return;
+					console.warn("Arkme could not persist the current Harness session.", error);
+					if (++selection.failures <= 3) retry = setTimeout(() => {
+						retry = void 0;
+						persist(selection);
+					}, 1e3);
+				}
+			};
+			const changed = () => {
+				const snapshot = sessions.list.getSnapshot();
+				if (stopped || snapshot.phase !== "ready" || !snapshot.current || !snapshot.byId[snapshot.current]) return;
+				const key = JSON.stringify([snapshot.current, snapshot.currentAddress]);
+				if (pending?.key === key) return;
+				if (retry !== void 0) {
+					clearTimeout(retry);
+					retry = void 0;
+				}
+				pending = {
+					sessionId: snapshot.current,
+					subagentAddress: snapshot.currentAddress,
+					key,
+					failures: 0
+				};
+				persist(pending);
+			};
+			const unsubscribe = sessions.list.subscribe(changed);
+			changed();
+			return () => {
+				stopped = true;
+				if (retry !== void 0) clearTimeout(retry);
+				unsubscribe();
+			};
+		}
+		//#endregion
 		//#region src/client/harness-session-client.ts
 		const inject = [
 			"sessions",
@@ -23,6 +69,8 @@ window.__ModuleLoader__.load({
 				const apiPath = document.querySelector("meta[name=\"arkme-session-api\"]")?.content;
 				const sessions = ctx.sessions;
 				if (sessions === void 0) return () => void 0;
+				const parent = window.parent;
+				const stopPersistence = observeHarnessSessionSelection(sessions, parent?.arkmeDesktop?.sessionSelection);
 				const frameWindow = window;
 				const navigation = {
 					async has(sessionId) {
@@ -49,6 +97,7 @@ window.__ModuleLoader__.load({
 				};
 				frameWindow[HARNESS_SESSION_NAVIGATION_KEY] = navigation;
 				const disposeNavigation = () => {
+					stopPersistence();
 					if (frameWindow["__arkmeHarnessSessionNavigation"] === navigation) delete frameWindow[HARNESS_SESSION_NAVIGATION_KEY];
 				};
 				if (apiPath === void 0 || !/^\/[A-Za-z0-9/_-]+$/.test(apiPath)) return disposeNavigation;

package/lib/index.js

@@ -1,4 +1,4 @@
-import { $ as ARKME_DEFAULT_SHARE_WEBSITE, A as inspectNativeBundleArtifactV3, At as registerDSHAgentInputRecordSync, D as bundleSha256, Dt as ArkmePluginError, E as arkmeSandboxEntryId, Et as normalizeRecentEmojiIds, F as assertExtensionArtifactSize, Ft as __require, G as validateVoiceprintPcm16Wav, I as canonicalExtensionJson, It as __toCommonJS, J as arkmeRequiredLinkMetadataFallback, K as arkmeExtensionShareRefFromLink, L as sha256Hex, M as packLocalNativeBundleDirectoryV3, Mt as __commonJSMin, N as readNativeBundleTarballV3, Nt as __esmMin, O as canonicalBundleJson, Ot as retryAfterMillis, P as renderArkmeSandboxHostEntry, Pt as __exportAll, Q as parseArkmeRecordReeditAttachments, R as unpackArkmeExtension, S as ARKME_BUNDLE_ARTIFACT_KIND, St as sameRecordingImportIdentity, T as ArkmeBundleArtifactError, Tt as isRecentEmojiId, U as ARKME_EXTENSION_RUNTIME_UNAVAILABLE_MESSAGE, W as ArkmeService, X as arkmeRichBackgroundSound, Y as arkmeFileBackgroundSound, Z as ArkmeRecordReeditDraftConflict, _ as arkmeClientContentDigest, _t as SecretValue, at as ARKME_WORLD_PUBLISH_MAX_IMAGE_BYTES, b as verifyExtensionResolutionSignature, bt as isUnresolvedRecordingImportJob, c as persistentExtensionBundleDirectory, ct as mergeMemberJoinEvents, d as readPersistentExtensionActivation, dt as ARKME_TOOL_FILE_MAX_BYTES, et as ARKME_PROVIDER_CONTRACT_VERSION, f as refreshPersistentClientWrapper, ft as arkmeCanInlineLocalFile, g as activeProfileExtensionOwnerConflicts, gt as ArkmeOutgoingCallError, h as renderArkmeBundleClientBundle, ht as isArkmeBotAvatarRef, i as invokePersistentArkmeExtension, it as ARKME_WORLD_PUBLISH_MAX_IMAGES, j as packBundleFiles, jt as createDesktopLifecycleReader, k as inspectBundleArtifact, kt as recordOwnerId, l as persistentExtensionPackageIdentity, lt as validateMemberUpdate, m as writePersistentExtensionActivation, mt as arkmePickedFileKind, o as persistentArkmeExtensionRuntimeState, ot as applyMemberUpdate, p as repairPersistentExtensionInstallation, pt as arkmeNormalizedFileMimeType, q as arkmeIsGenericLinkMetadataTitle, r as deactivatePersistentArkmeExtension, s as materializePersistentExtensionBundle, st as cachedMemberItem, t as activatePersistentArkmeExtension, u as quarantinePersistentExtension, ut as ARKME_RUNTIME_INSTANCE_ID, v as arkmeClientContentDigestFromSource, vt as ArkmeDirectMessageAdmissionError, w as ARKME_NATIVE_BUNDLE_ARTIFACT_KIND, wt as recordingImportFileNameKey, x as verifyNativeBundleResolutionSignature, xt as recordingImportFileKind, y as verifyBundleResolutionSignature, yt as isRecordingInstantOnOrAfterUnixEpoch, z as ARKME_EXTENSION_FORMAT } from "./persistent-runtime-CXd9RuRR.js";
+import { $ as ARKME_DEFAULT_SHARE_WEBSITE, A as inspectNativeBundleArtifactV3, At as registerDSHAgentInputRecordSync, D as bundleSha256, Dt as ArkmePluginError, E as arkmeSandboxEntryId, Et as normalizeRecentEmojiIds, F as assertExtensionArtifactSize, Ft as __require, G as validateVoiceprintPcm16Wav, I as canonicalExtensionJson, It as __toCommonJS, J as arkmeRequiredLinkMetadataFallback, K as arkmeExtensionShareRefFromLink, L as sha256Hex, M as packLocalNativeBundleDirectoryV3, Mt as __commonJSMin, N as readNativeBundleTarballV3, Nt as __esmMin, O as canonicalBundleJson, Ot as retryAfterMillis, P as renderArkmeSandboxHostEntry, Pt as __exportAll, Q as parseArkmeRecordReeditAttachments, R as unpackArkmeExtension, S as ARKME_BUNDLE_ARTIFACT_KIND, St as sameRecordingImportIdentity, T as ArkmeBundleArtifactError, Tt as isRecentEmojiId, U as ARKME_EXTENSION_RUNTIME_UNAVAILABLE_MESSAGE, W as ArkmeService, X as arkmeRichBackgroundSound, Y as arkmeFileBackgroundSound, Z as ArkmeRecordReeditDraftConflict, _ as arkmeClientContentDigest, _t as SecretValue, at as ARKME_WORLD_PUBLISH_MAX_IMAGE_BYTES, b as verifyExtensionResolutionSignature, bt as isUnresolvedRecordingImportJob, c as persistentExtensionBundleDirectory, ct as mergeMemberJoinEvents, d as readPersistentExtensionActivation, dt as ARKME_TOOL_FILE_MAX_BYTES, et as ARKME_PROVIDER_CONTRACT_VERSION, f as refreshPersistentClientWrapper, ft as arkmeCanInlineLocalFile, g as activeProfileExtensionOwnerConflicts, gt as ArkmeOutgoingCallError, h as renderArkmeBundleClientBundle, ht as isArkmeBotAvatarRef, i as invokePersistentArkmeExtension, it as ARKME_WORLD_PUBLISH_MAX_IMAGES, j as packBundleFiles, jt as createDesktopLifecycleReader, k as inspectBundleArtifact, kt as recordOwnerId, l as persistentExtensionPackageIdentity, lt as validateMemberUpdate, m as writePersistentExtensionActivation, mt as arkmePickedFileKind, o as persistentArkmeExtensionRuntimeState, ot as applyMemberUpdate, p as repairPersistentExtensionInstallation, pt as arkmeNormalizedFileMimeType, q as arkmeIsGenericLinkMetadataTitle, r as deactivatePersistentArkmeExtension, s as materializePersistentExtensionBundle, st as cachedMemberItem, t as activatePersistentArkmeExtension, u as quarantinePersistentExtension, ut as ARKME_RUNTIME_INSTANCE_ID, v as arkmeClientContentDigestFromSource, vt as ArkmeDirectMessageAdmissionError, w as ARKME_NATIVE_BUNDLE_ARTIFACT_KIND, wt as recordingImportFileNameKey, x as verifyNativeBundleResolutionSignature, xt as recordingImportFileKind, y as verifyBundleResolutionSignature, yt as isRecordingInstantOnOrAfterUnixEpoch, z as ARKME_EXTENSION_FORMAT } from "./persistent-runtime-CBKy5v5l.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-y7wzJLOx.js";
 import { a as securePrivateDirectory, c as securePrivateFileSync, i as prepareProfilePackageManager, n as isArkmeProfilePackageName, o as securePrivateDirectorySync, r as localExtensionPnpmArgs, s as securePrivateFile, t as applyArkmeProfileBundlePolicy } from "./profile-bundle-policy-DLXDyohJ.js";
 import { i as invokeArkmeBundle, n as arkmeBundleActive, r as deactivateArkmeBundle } from "./bundle-runtime-CE73h3vS.js";
@@ -11891,7 +11891,8 @@ async function dispatchArkmeHostOperation(service, operation, params, updateMana
 		case "chat.member.private.open": return await service.openPrivateChatFromMember(stringParam(params, "sourceRef"), stringParam(params, "memberRef"), requestSignal === void 0 ? {} : { signal: requestSignal });
 		case "files.capabilities": return service.fileCapabilities();
 		case "files.local.list": return await service.fileList();
-		case "files.local.open": return await service.fileOpenLocal(stringParam(params, "fileRef"));
+		case "files.local.open-folder": return await service.fileOpenLocalFolder(stringParam(params, "fileRef"), requestSignal);
+		case "files.local.open": return await service.fileOpenLocal(stringParam(params, "fileRef"), requestSignal);
 		case "files.local.remove":
 			await service.fileRemove(stringParam(params, "fileRef"));
 			return { removed: true };
@@ -12026,6 +12027,9 @@ async function dispatchArkmeHostOperation(service, operation, params, updateMana
 				}
 			});
 		}
+		case "calls.invite.create": return await service.createShareCallLink(outgoingMediaTypeParam(params));
+		case "calls.receiver.prepare": return await service.prepareCallReceiver();
+		case "calls.receiver.claim": return await service.claimIncomingCall(requiredCallParam(params, "callRequestId", "call-request-invalid"));
 		case "calls.outgoing.prepare": return await service.prepareOutgoingCall({
 			sourceRef: requiredCallParam(params, "sourceRef", "call-source-invalid", 4096),
 			mediaType: outgoingMediaTypeParam(params),
@@ -12256,6 +12260,25 @@ async function openDshHostPath(ctx, path, signal) {
 	if (response.result.ok !== true || !isRecord(response.result.value) || response.result.value.opened !== true) throw new Error("DSH apiProxy.host.openPath 返回了无效响应");
 }
 //#endregion
+//#region src/harness-session-restore-script.ts
+/**
+* The outer runtime and native iframe share an origin, but own different stores.
+* An outer pending-list projection can overwrite the native boot key with {}.
+* Route only this iframe's official selection read to the parent preload cache;
+* do not change other keys, sessionStorage, writes, or the upstream runtime.
+* This must precede every boot script, including asynchronously loaded modules.
+*/
+const HARNESS_SESSION_RESTORE_SCRIPT = `(() => {
+  const bridge = window.parent?.arkmeDesktop?.sessionSelection;
+  if (typeof bridge?.restore !== 'function') return;
+  const storage = window.localStorage;
+  const getItem = Storage.prototype.getItem;
+  Storage.prototype.getItem = function(key) {
+    if (this === storage && key === 'dsh.sessions.current') return bridge.restore();
+    return getItem.call(this, key);
+  };
+})();`;
+//#endregion
 //#region src/harness-embed-route.ts
 const ARKME_PLUGIN_PACKAGE_NAME = "@senguoyun/dsh-arkme";
 const DSH_CLIENT_HMR_PACKAGE_NAME = "@deepseek-ai/dsh-client-hmr";
@@ -12464,6 +12487,10 @@ function createHarnessEmbedRouteHandler(options) {
 				projectedGraph.rev = shortHash(`${projectedGraph.rev}:${rev}`);
 			}
 			let html = replaceHarnessBootGraph(await options.readRootHtml(request), fullGraph, projectedGraph);
+			if (options.sessionClient !== void 0) {
+				if (!/<head(?:\s[^>]*)?>/i.test(html)) throw new Error("harness session restore requires a document head");
+				html = html.replace(/<head(?:\s[^>]*)?>/i, (head) => `${head}<script data-arkme-session-restore>${HARNESS_SESSION_RESTORE_SCRIPT}<\/script>`);
+			}
 			if (options.selectionClientRevision && /^[a-f0-9]+$/.test(options.selectionClientRevision)) html = html.replace("</head>", `<meta name="arkme-native-selection" content="/arkme-self/harness-native-selection-client.js?rev=${options.selectionClientRevision}"></head>`);
 			if (options.sessionClient?.apiPath !== void 0) {
 				const apiPath = options.sessionClient.apiPath;

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

package/lib/{persistent-runtime-CXd9RuRR.js → persistent-runtime-CBKy5v5l.js}

@@ -1,7 +1,7 @@
 import { createRequire } from "node:module";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import { chmodSync, constants, createReadStream, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
-import { chmod as chmod$1, copyFile, link, lstat, mkdir, open, opendir, readFile, realpath, rename, rm, stat, unlink, writeFile } from "node:fs/promises";
+import { chmod as chmod$1, copyFile, lstat, mkdir, open, opendir, readFile, realpath, rename, rm, stat, unlink, writeFile } from "node:fs/promises";
 import { createCipheriv, createDecipheriv, createHash, createHmac, createPublicKey, randomBytes, randomUUID, timingSafeEqual, verify } from "node:crypto";
 import minpath, { basename, dirname, isAbsolute, join, posix, relative, resolve, sep } from "node:path";
 import { fileURLToPath, fileURLToPath as urlToPath } from "node:url";
@@ -17146,7 +17146,7 @@ function formatLinkAsAutolink(node, state) {
 * @import {Link, Parents} from 'mdast'
 * @import {Exit} from '../types.js'
 */
-link$1.peek = linkPeek;
+link.peek = linkPeek;
 /**
 * @param {Link} node
 * @param {Parents | undefined} _
@@ -17154,7 +17154,7 @@ link$1.peek = linkPeek;
 * @param {Info} info
 * @returns {string}
 */
-function link$1(node, _, state, info) {
+function link(node, _, state, info) {
 	const quote = checkQuote(state);
 	const suffix = quote === "\"" ? "Quote" : "Apostrophe";
 	const tracker = state.createTracker(info);
@@ -17623,7 +17623,7 @@ const handle = {
 	image,
 	imageReference,
 	inlineCode,
-	link: link$1,
+	link,
 	linkReference,
 	list: list$1,
 	listItem,
@@ -39129,8 +39129,23 @@ var CallHistoryService = class {
 			cacheMs: 2e3,
 			failureCooldownMs: 2e3
 		});
-		const validItems = (await Promise.all(this.historyItems(raw).map(async (item) => await this.normalizeHistoryItem(item, session.userId)))).filter((item) => item !== void 0);
+		const rawItems = this.historyItems(raw);
+		const items = await Promise.all(rawItems.map(async (item) => await this.normalizeHistoryItem(item, session.userId)));
+		const validItems = items.filter((item) => item !== void 0);
 		await this.attachPeerPresentation(validItems, session, signal);
+		items.forEach((item, index) => {
+			if (item === void 0) return;
+			const source = rawItems[index];
+			const record = {
+				...source,
+				...objectValue$2(source.trtc ?? source.call ?? source.call_record)
+			};
+			const names = /* @__PURE__ */ new Map();
+			for (const [id, name] of Object.entries(objectValue$2(record.participant_display_names ?? record.participantDisplayNames))) if (Number(id) > 0 && typeof name === "string" && name.trim()) names.set(Number(id), name.trim());
+			if (item.peerUserId !== void 0 && !/^Arkme 用户 \d+$/.test(item.peerDisplayName)) names.set(item.peerUserId, item.peerDisplayName);
+			const summary = safeSummary(renderCallRecordSummary(record, session.userId, names));
+			if (summary) item.summaryPreview = summary;
+		});
 		const hasMore = booleanValue$9(raw.has_more ?? raw.hasMore);
 		const nextCursor = firstString$1(raw, [
 			"next_cursor",
@@ -39255,13 +39270,6 @@ var CallHistoryService = class {
 		const calleeUserIds = numberList(item.callee_user_ids ?? item.calleeUserIds);
 		const connectedUserIds = numberList(item.connected_user_ids ?? item.connectedUserIds);
 		const peerUserId = this.resolvePeerUserId(viewerUserId, callerUserId, calleeUserIds, connectedUserIds, item);
-		const summaryText = safeSummary(firstString$1(item, [
-			"call_summary",
-			"callSummary",
-			"summary_text",
-			"summaryText",
-			"summary"
-		]));
 		const summaryUpdatedAtMillis = firstEpochMillis(item, [
 			"call_summary_updated_at",
 			"callSummaryUpdatedAt",
@@ -39305,7 +39313,6 @@ var CallHistoryService = class {
 				"summary_status",
 				"summaryStatus"
 			])),
-			...summaryText === "" ? {} : { summaryPreview: summaryText },
 			...summaryUpdatedAtMillis > 0 ? { summaryUpdatedAtMillis } : {},
 			canOpenDetail: true,
 			canRedial: peerUserId > 0,
@@ -47909,6 +47916,8 @@ var ChatService = class {
 					textContent,
 					textFormat,
 					sourceType,
+					templateKind: numberValue$19(item.template_kind ?? item.templateKind),
+					displayKind: numberValue$19(item.display_kind ?? item.displayKind),
 					...contentBlocks.length === 0 ? {} : { contentBlocks },
 					...files.length > contentBlocks.length ? { mediaUnavailable: true } : {},
 					...segments.length === 0 ? {} : { segments },
@@ -82222,6 +82231,54 @@ var OutgoingCallService = class {
 		callDiag("dispose", {});
 		this.broker.dispose();
 	}
+	async createShareCallLink(mediaType) {
+		if (mediaType !== "audio" && mediaType !== "video") throw new ArkmePluginError("call-media-invalid", "通话类型无效", false, 400);
+		const session = await this.runtime.requireSession();
+		const data = await this.runtime.authenticatedWebrtcPost("/api/v1/trtc/share-call-link/create", { call_media_type: mediaType === "video" ? 1 : 0 }, session);
+		const current = await this.runtime.accountScopedSession();
+		if (current?.userId !== session.userId || current.refreshToken !== session.refreshToken) throw new ArkmePluginError("call-account-changed", "登录账号已变化，请重试", false, 409);
+		const profile = objectValue$2(data.sharer_profile);
+		let url;
+		try {
+			url = new URL(stringValue$2(data.call_url), this.runtime.config.webrtcBaseUrl);
+		} catch {
+			throw new ArkmePluginError("call-link-invalid", "通话邀请链接无效，请重试", true, 502);
+		}
+		if (url.origin !== new URL(this.runtime.config.webrtcBaseUrl).origin || url.protocol !== "https:" || url.pathname !== "/share-call" || !url.searchParams.get("token")?.trim() || url.username || url.password || numberValue$9(data.expires_at) <= Date.now() || data.call_media_type !== (mediaType === "video" ? 1 : 0) || numberValue$9(profile.user_id) !== session.userId) throw new ArkmePluginError("call-link-invalid", "通话邀请链接无效，请重试", true, 502);
+		return {
+			callUrl: url.href,
+			expiresAtMillis: numberValue$9(data.expires_at),
+			mediaType,
+			sharerDisplayName: stringValue$2(profile.display_name).trim() || "Arkme 用户"
+		};
+	}
+	async prepareCallReceiver() {
+		const session = await this.runtime.requireSession();
+		const profile = (await this.profile.refreshProfile()).profile;
+		if (profile === null) throw new ArkmePluginError("profile-contract-invalid", "无法读取当前账号资料", true, 502);
+		const credentials = await this.runtime.authenticatedWebrtcPost("/api/v1/trtc/credentials", {}, session);
+		const current = await this.runtime.accountScopedSession();
+		if (current?.userId !== session.userId || current.refreshToken !== session.refreshToken) throw new ArkmePluginError("call-account-changed", "登录账号已变化，请重试", false, 409);
+		const sdkAppId = numberValue$9(credentials.sdk_app_id);
+		const userId = stringValue$2(credentials.user_id).trim();
+		const userSig = stringValue$2(credentials.user_sig).trim();
+		if (!Number.isSafeInteger(sdkAppId) || sdkAppId <= 0 || userId === "" || userSig === "") throw new ArkmePluginError("call-credentials-invalid", "桌面通话初始化失败", true, 502);
+		return {
+			accountUserId: session.userId,
+			bootstrap: {
+				sdkAppId,
+				userId,
+				userSig,
+				nickName: profile.displayName.trim() || "Arkme 用户",
+				avatar: "",
+				outgoingOnly: false
+			}
+		};
+	}
+	async claimIncomingCall(callRequestId) {
+		const session = await this.runtime.requireSession();
+		return { expiresAtMillis: this.broker.acquireLease(session.userId, callRequestId) };
+	}
 	async requestOutgoingCall(sourceRef, mediaType, signal) {
 		const session = await this.runtime.requireSession();
 		const source = await this.source.openSourceRef(sourceRef, session.userId);
@@ -86659,17 +86716,21 @@ var FileTransfers = class {
 			recursive: true,
 			mode: 448
 		});
+		const sourceInfo = await stat(source);
+		const targetInfo = await lstat(target).catch((error) => {
+			if (error.code === "ENOENT") return void 0;
+			throw error;
+		});
+		if (targetInfo !== void 0 && !targetInfo.isFile()) throw fail("file-open-target-invalid", "本地打开副本不是普通文件");
+		if (targetInfo !== void 0 && (targetInfo.dev !== sourceInfo.dev || targetInfo.ino !== sourceInfo.ino)) return target;
+		const temporary = join(directory, `${randomUUID()}.tmp`);
 		try {
-			await link(source, target);
-		} catch (error) {
-			if (error.code !== "EEXIST") throw error;
-			const info = await stat(target).catch(() => void 0);
-			if (!info?.isFile() || info.size !== file.size) {
-				await unlink(target).catch(() => {});
-				await link(source, target);
-			}
+			await copyFile(source, temporary, constants.COPYFILE_FICLONE);
+			await chmod$1(temporary, 384);
+			await rename(temporary, target);
+		} finally {
+			await unlink(temporary).catch(() => {});
 		}
-		await chmod$1(target, 384);
 		return target;
 	}
 	async assertUser(userId, signal) {
@@ -86834,25 +86895,40 @@ var FileTransfers = class {
 			file: publicFile(file)
 		};
 	}
-	async openLocal(ref) {
-		if (this.ports.openPath === void 0) throw fail("file-open-unavailable", "当前宿主不能使用本机应用打开文件");
+	async openLocal(ref, signal) {
+		return {
+			opened: true,
+			file: await this.openLocalTarget(ref, "file", signal)
+		};
+	}
+	async openLocalFolder(ref, signal) {
+		await this.openLocalTarget(ref, "folder", signal);
+		return { folderOpened: true };
+	}
+	async openLocalTarget(ref, target, signal) {
+		if (this.ports.openPath === void 0) throw fail("file-open-unavailable", target === "folder" ? "当前宿主不能打开本机文件夹" : "当前宿主不能使用本机应用打开文件");
 		const controller = new AbortController();
 		this.controllers.add(controller);
+		const operationSignal = signal === void 0 ? controller.signal : AbortSignal.any([signal, controller.signal]);
 		try {
+			operationSignal.throwIfAborted();
 			const userId = await this.ports.currentUser();
-			const { file } = await this.readLocal(ref);
-			await this.assertUser(userId, controller.signal);
-			const path = await this.nativeOpenPath(userId, ref, file);
-			await this.assertUser(userId, controller.signal);
-			await this.ports.openPath(path, controller.signal);
-			await this.assertUser(userId, controller.signal);
-			return {
-				opened: true,
-				file
-			};
+			const { file, path } = await this.exclusive(async () => {
+				await this.assertUser(userId, operationSignal);
+				const { file } = await this.readLocal(ref);
+				await this.assertUser(userId, operationSignal);
+				return {
+					file,
+					path: await this.nativeOpenPath(userId, ref, file)
+				};
+			});
+			await this.assertUser(userId, operationSignal);
+			await this.ports.openPath(target === "folder" ? dirname(path) : path, operationSignal);
+			await this.assertUser(userId, operationSignal);
+			return file;
 		} catch (error) {
 			if (error instanceof ArkmePluginError) throw error;
-			throw fail("file-open-failed", "文件打开失败，请重试");
+			throw target === "folder" ? fail("file-folder-open-failed", "文件夹打开失败，请重试") : fail("file-open-failed", "文件打开失败，请重试");
 		} finally {
 			this.controllers.delete(controller);
 		}
@@ -90353,8 +90429,11 @@ var ArkmeService = class {
 	attachLocalFileOpener(openPath) {
 		this.localFileOpener = openPath;
 	}
-	async fileOpenLocal(ref) {
-		return await this.filesOwner().openLocal(ref);
+	async fileOpenLocal(ref, signal) {
+		return await this.filesOwner().openLocal(ref, signal);
+	}
+	async fileOpenLocalFolder(ref, signal) {
+		return await this.filesOwner().openLocalFolder(ref, signal);
 	}
 	async fileRemove(ref) {
 		await this.filesOwner().remove(ref);
@@ -90649,6 +90728,15 @@ var ArkmeService = class {
 	async prepareOutgoingCall(input) {
 		return await this.outgoingCall.prepareOutgoingCall(input);
 	}
+	async createShareCallLink(mediaType) {
+		return await this.outgoingCall.createShareCallLink(mediaType);
+	}
+	async prepareCallReceiver() {
+		return await this.outgoingCall.prepareCallReceiver();
+	}
+	async claimIncomingCall(callRequestId) {
+		return await this.outgoingCall.claimIncomingCall(callRequestId);
+	}
 	async heartbeatOutgoingCall(callRequestId) {
 		return await this.outgoingCall.heartbeatOutgoingCall(callRequestId);
 	}

package/lib/sdk.js

@@ -1150,6 +1150,9 @@ var ArkmeSdk = class {
 	async localFiles(signal) {
 		return this.call("files.local.list", void 0, signal);
 	}
+	async openLocalFileFolder(fileRef, signal) {
+		return this.call("files.local.open-folder", { fileRef }, signal);
+	}
 	async openLocalFile(fileRef, signal) {
 		return this.call("files.local.open", { fileRef }, signal);
 	}

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

@@ -100,7 +100,10 @@ export declare class ArkmeService {
         file: ArkmeLocalFile;
     }>;
     attachLocalFileOpener(openPath: (path: string, signal: AbortSignal) => Promise<void>): void;
-    fileOpenLocal(ref: string): Promise<import("./file-transfer-contract.js").ArkmeFileOpenResult>;
+    fileOpenLocal(ref: string, signal?: AbortSignal): Promise<import("./file-transfer-contract.js").ArkmeFileOpenResult>;
+    fileOpenLocalFolder(ref: string, signal?: AbortSignal): Promise<{
+        folderOpened: true;
+    }>;
     fileRemove(ref: string): Promise<void>;
     fileSend(input: ArkmeFileSendInput): Promise<import("./file-transfer-contract.js").ArkmeFileSendTask>;
     fileSendTasks(sourceRef?: string): Promise<import("./file-transfer-contract.js").ArkmeFileSendTask[]>;
@@ -203,6 +206,11 @@ export declare class ArkmeService {
         callRequestId: string;
         signal?: AbortSignal;
     }): Promise<ArkmeOutgoingCallPrepareResult>;
+    createShareCallLink(mediaType: ArkmeOutgoingCallMediaType): Promise<import("./outgoing-call-contract.js").ArkmeShareCallLink>;
+    prepareCallReceiver(): Promise<import("./outgoing-call-contract.js").ArkmeCallReceiverPrepareResult>;
+    claimIncomingCall(callRequestId: string): Promise<{
+        expiresAtMillis: number;
+    }>;
     heartbeatOutgoingCall(callRequestId: string): Promise<{
         expiresAtMillis: number;
     }>;