@openclaw/imessage 2026.10.10 → 2026.11.2

package/dist/.setup/{channel.runtime-BW4A0m4h.mjs → channel.runtime-BomnjKt2.mjs}

@@ -1,19 +1,19 @@
-import { c as parseIMessageTarget, o as normalizeIMessageHandle, r as isAllowedIMessageReplyContextSender, s as parseIMessageAllowTarget, t as formatIMessageChatTarget } from "./targets-CIx4BKqL.mjs";
-import { d as resolveIMessageChatDbLookupPath, f as resolveIMessageHomeDir, l as resolveIMessageRemoteHost, o as resolveIMessageAccount, r as listEnabledIMessageAccounts, s as resolveIMessageDuplicateSourceOwner } from "./accounts-BH0coL46.mjs";
-import { r as imessageRpcSupportsMethod } from "./message-tool-api-CxSY_rh7.mjs";
-import { S as resolveIMessageDirectChatService, h as resolveIMessageEchoMediaKey, m as resolveIMessageCatchupCursorKey, n as createIMessageRpcClient, o as isKnownFromMeIMessageTarget, p as capFailureRetriesMap, s as rememberIMessageReplyCache, u as IMESSAGE_CATCHUP_CURSOR_NAMESPACE } from "./client-C3e7ZLqA.mjs";
-import { a as normalizeIMessageMessageId, i as normalizeIMessageGuid, n as probeIMessage, r as probeIMessagePrivateApi } from "./actions-CW7XYYF4.mjs";
-import { t as getIMessageRuntime } from "./runtime-BRQCPuAD.mjs";
-import { a as resolveIMessageGroupSystemPrompt, s as resolveIMessageInboundConversationId } from "./channel-6kcKpSRw.mjs";
-import { r as sanitizeOutboundText } from "./sanitize-outbound-C02fJrn6.mjs";
-import { n as resolveIMessageAttachmentRoots, r as resolveIMessageRemoteAttachmentRoots } from "./media-contract-CoixpXRX.mjs";
-import { t as IMESSAGE_LEGACY_OUTBOUND_SEND_DEP_KEYS } from "./outbound-send-deps-_da8jqeo.mjs";
-import { i as resolveIMessageStartupRowidWatermark } from "./remote-file-CCgMYZ-u.mjs";
-import { i as registerIMessageApprovalReactionTarget, n as handleIMessageApprovalReaction, o as listPendingIMessageApprovalReactionPollTargets, r as maybeResolveIMessageApprovalReaction } from "./approval-reactions-B9CJS0NT.mjs";
-import { n as hasPersistedIMessageEcho, r as normalizeIMessageEchoText, s as maybeResolveIMessageApprovalPollVote, t as sendMessageIMessage } from "./send-D98hQFdv.mjs";
-import { t as resolveIMessageReactionContext } from "./reaction-context-Bw00FkmU.mjs";
-import { n as maybeResolveIMessageQuestionReaction, t as hasIMessageQuestionReactionTarget } from "./question-reactions-DTj-VH3N.mjs";
-import { imessageSetupWizard } from "./setup-surface-aRZhAzzQ.mjs";
+import { c as parseIMessageTarget, o as normalizeIMessageHandle, r as isAllowedIMessageReplyContextSender, s as parseIMessageAllowTarget, t as formatIMessageChatTarget } from "./targets-B4oU7n-v.mjs";
+import { d as resolveIMessageChatDbLookupPath, f as resolveIMessageHomeDir, l as resolveIMessageRemoteHost, o as resolveIMessageAccount, r as listEnabledIMessageAccounts, s as resolveIMessageDuplicateSourceOwner } from "./accounts-DacCvDBt.mjs";
+import { r as imessageRpcSupportsMethod } from "./message-tool-api-B5NfPnFL.mjs";
+import { C as resolveIMessageDirectChatService, c as rememberIMessageReplyCache, d as IMESSAGE_CATCHUP_CURSOR_NAMESPACE, g as resolveIMessageEchoMediaKey, h as resolveIMessageCatchupCursorKey, m as capFailureRetriesMap, n as createIMessageRpcClient, s as isKnownFromMeIMessageTarget } from "./client-DlNC08mM.mjs";
+import { a as probeIMessage, c as normalizeIMessageMessageId, o as probeIMessagePrivateApi, s as normalizeIMessageGuid } from "./actions-FOjSVXxg.mjs";
+import { t as getIMessageRuntime } from "./runtime-Cza4CY5T.mjs";
+import { a as resolveIMessageGroupSystemPrompt, s as resolveIMessageInboundConversationId } from "./channel-BtDnHgzF.mjs";
+import { r as sanitizeOutboundText } from "./sanitize-outbound-BtEY324R.mjs";
+import { n as resolveIMessageAttachmentRoots, r as resolveIMessageRemoteAttachmentRoots } from "./media-contract-BwWs5PM7.mjs";
+import { t as IMESSAGE_LEGACY_OUTBOUND_SEND_DEP_KEYS } from "./outbound-send-deps-B-QEsLSM.mjs";
+import { i as resolveIMessageStartupRowidWatermark } from "./remote-file-D8UX85bK.mjs";
+import { i as registerIMessageApprovalReactionTarget, n as handleIMessageApprovalReaction, o as listPendingIMessageApprovalReactionPollTargets, r as maybeResolveIMessageApprovalReaction } from "./approval-reactions-g1TDaSN2.mjs";
+import { n as hasPersistedIMessageEcho, r as normalizeIMessageEchoText, s as maybeResolveIMessageApprovalPollVote, t as sendMessageIMessage } from "./send-D44ovNNq.mjs";
+import { t as resolveIMessageReactionContext } from "./reaction-context-7yLnHd5m.mjs";
+import { n as maybeResolveIMessageQuestionReaction, t as hasIMessageQuestionReactionTarget } from "./question-reactions-CgZKeyy3.mjs";
+import { imessageSetupWizard } from "./setup-surface-DPqiLGy0.mjs";
 import { asSafeIntegerInRange, hasNonEmptyString, isRecord, normalizeLowercaseStringOrEmpty, normalizeOptionalString, normalizeStringEntries, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { normalizeChannelDmPolicy } from "openclaw/plugin-sdk/channel-config-helpers";
 import { bindIngressLifecycleToReplyOptions, createAccountStatusSink, createChannelDeliveryAccumulator, createChannelIngressError, createChannelIngressMonitor, createChannelMessageReplyPipeline, resolveChannelStreamingBlockEnabled, resolveOutboundSendDep } from "openclaw/plugin-sdk/channel-outbound";
@@ -62,7 +62,7 @@ import { readFileHandleBounded } from "openclaw/plugin-sdk/file-access-runtime";
 import { saveMediaBuffer } from "openclaw/plugin-sdk/media-store";
 import { loadWebMedia } from "openclaw/plugin-sdk/web-media";
 import { enqueueRoutedSystemEvent } from "openclaw/plugin-sdk/system-event-runtime";
-// extensions/imessage/src/approval-reaction-poller.ts
+//#region extensions/imessage/src/approval-reaction-poller.ts
 const RECENT_CHAT_LIMIT = 50;
 const PER_CHAT_HISTORY_LIMIT$1 = 30;
 function normalizeChatId(value) {
@@ -199,7 +199,8 @@ async function pollPendingIMessageApprovalReactions(params) {
 		}
 	}
 }
-// extensions/imessage/src/chat.ts
+//#endregion
+//#region extensions/imessage/src/chat.ts
 async function runChatAction(method, to, opts, isTyping) {
 	const cfg = requireRuntimeConfig(opts.cfg, "iMessage chat action");
 	const account = opts.account ?? resolveIMessageAccount({
@@ -241,7 +242,8 @@ async function sendIMessageTyping(to, isTyping, opts) {
 async function markIMessageChatRead(to, opts) {
 	await runChatAction("read", to, opts);
 }
-// extensions/imessage/src/monitor/abort-handler.ts
+//#endregion
+//#region extensions/imessage/src/monitor/abort-handler.ts
 function attachIMessageMonitorAbortHandler(params) {
 	const abort = params.abortSignal;
 	if (!abort) return () => {};
@@ -253,7 +255,8 @@ function attachIMessageMonitorAbortHandler(params) {
 	abort.addEventListener("abort", onAbort, { once: true });
 	return () => abort.removeEventListener("abort", onAbort);
 }
-// extensions/imessage/src/monitor/catchup.ts
+//#endregion
+//#region extensions/imessage/src/monitor/catchup.ts
 const DEFAULT_MAX_AGE_MINUTES = 120;
 const MAX_MAX_AGE_MINUTES = 720;
 const DEFAULT_PER_RUN_LIMIT = 50;
@@ -486,7 +489,8 @@ async function performIMessageCatchup(params) {
 	if (summary.replayed > 0 || summary.failed > 0 || summary.givenUp > 0) params.log?.(`imessage catchup: replayed=${summary.replayed} skippedFromMe=${summary.skippedFromMe} skippedGivenUp=${summary.skippedGivenUp} failed=${summary.failed} givenUp=${summary.givenUp} fetchedCount=${summary.fetchedCount}`);
 	return summary;
 }
-// extensions/imessage/src/monitor/strip-imsg-length-prefixed-text.ts
+//#endregion
+//#region extensions/imessage/src/monitor/strip-imsg-length-prefixed-text.ts
 const utf8Decoder = new TextDecoder();
 function readVarint(buf, start) {
 	let offset = start;
@@ -521,7 +525,8 @@ function stripImessageLengthPrefixedUtf8Text(text) {
 	const inner = utf8Decoder.decode(stripped);
 	return inner.length > 0 ? inner : text;
 }
-// extensions/imessage/src/monitor/parse-notification.ts
+//#endregion
+//#region extensions/imessage/src/monitor/parse-notification.ts
 function isOptionalString(value) {
 	return value === void 0 || value === null || typeof value === "string";
 }
@@ -554,7 +559,8 @@ function parseIMessageNotification(raw) {
 		reply_to_text: typeof message.reply_to_text === "string" ? stripImessageLengthPrefixedUtf8Text(message.reply_to_text) : message.reply_to_text
 	};
 }
-// extensions/imessage/src/monitor/catchup-bridge.ts
+//#endregion
+//#region extensions/imessage/src/monitor/catchup-bridge.ts
 const PER_CHAT_HISTORY_LIMIT = 500;
 const CATCHUP_CHATS_LIST_LIMIT = 200;
 const CATCHUP_RPC_TIMEOUT_MS = 3e4;
@@ -679,7 +685,8 @@ async function runIMessageCatchup(params) {
 		...params.now ? { now: params.now() } : {}
 	});
 }
-// extensions/imessage/src/monitor/coalesce.ts
+//#endregion
+//#region extensions/imessage/src/monitor/coalesce.ts
 const MAX_COALESCED_TEXT_CHARS = 4e3;
 const MAX_COALESCED_ATTACHMENTS = 20;
 /**
@@ -740,7 +747,8 @@ function combineIMessagePayloads(payloads) {
 		reply_to_sender: reply.reply_to_sender ?? null
 	};
 }
-// extensions/imessage/src/monitor/conversation-repair.ts
+//#endregion
+//#region extensions/imessage/src/monitor/conversation-repair.ts
 const DEFAULT_CHATS_LIMIT = 20;
 const DEFAULT_PER_CHAT_HISTORY_LIMIT = 50;
 const DEFAULT_RPC_TIMEOUT_MS = 5e3;
@@ -848,7 +856,8 @@ async function repairIMessageConversationAnchor(params) {
 	runtime?.log?.(`imessage: recovered anchorless message GUID=${guid} chat_id=${repaired.chat_id ?? "unknown"} is_group=${repaired.is_group}`);
 	return repaired;
 }
-// extensions/imessage/src/monitor/deliver.ts
+//#endregion
+//#region extensions/imessage/src/monitor/deliver.ts
 async function deliverIMessageReply(params) {
 	const { payload, target, runtime, maxBytes, textLimit, accountId, sentMessageCache } = params;
 	const scope = `${accountId ?? ""}:${target}`;
@@ -911,7 +920,8 @@ function createIMessageEchoCachingSend(params) {
 		return sent;
 	};
 }
-// extensions/imessage/src/monitor/dm-history.ts
+//#endregion
+//#region extensions/imessage/src/monitor/dm-history.ts
 const DM_HISTORY_RPC_TIMEOUT_MS = 1e4;
 function resolveIMessageDmHistoryLimit(params) {
 	const senderCandidates = [
@@ -981,7 +991,8 @@ async function resolveIMessageDmHistoryContext(params) {
 		})).join("\n\n")
 	};
 }
-// extensions/imessage/src/monitor/drop-diagnostic-cache.ts
+//#endregion
+//#region extensions/imessage/src/monitor/drop-diagnostic-cache.ts
 const THROTTLED_DROP_DIAGNOSTIC_CACHE_MAX_SIZE = 512;
 function createIMessageThrottledDropDiagnosticCache() {
 	return createDedupeCache({
@@ -989,7 +1000,8 @@ function createIMessageThrottledDropDiagnosticCache() {
 		ttlMs: 0
 	});
 }
-// extensions/imessage/src/monitor/echo-cache.ts
+//#endregion
+//#region extensions/imessage/src/monitor/echo-cache.ts
 const SENT_MESSAGE_TEXT_TTL_MS = 4e3;
 const SENT_MESSAGE_ID_TTL_MS = 6e4;
 function createSentMessageCache() {
@@ -1062,7 +1074,8 @@ function createSentMessageCache() {
 		has
 	};
 }
-// extensions/imessage/src/monitor/group-allowlist-warnings.ts
+//#endregion
+//#region extensions/imessage/src/monitor/group-allowlist-warnings.ts
 const PER_CHAT_WARNING_CACHE_MAX_SIZE = 512;
 const startupWarned = /* @__PURE__ */ new Set();
 const perChatWarned = createDedupeCache({
@@ -1098,7 +1111,8 @@ function warnGroupAllowlistDropPerChatOnce(params) {
 	params.log(`imessage: dropping group message from chat_id=${chat} (account "${params.accountId}") — not in channels.imessage.groups allowlist. Add channels.imessage.groups["${chat}"] or channels.imessage.groups["*"] to allow it.`);
 	return true;
 }
-// extensions/imessage/src/monitor/inbound-dedupe.ts
+//#endregion
+//#region extensions/imessage/src/monitor/inbound-dedupe.ts
 const IMESSAGE_STALE_INBOUND_THRESHOLD_MS = 9e5;
 const IMESSAGE_RECOVERY_MAX_AGE_MS = 72e5;
 /**
@@ -1114,7 +1128,8 @@ function isStaleIMessageBacklog(message, nowMs, thresholdMs = IMESSAGE_STALE_INB
 	if (!Number.isFinite(sentMs)) return false;
 	return nowMs - sentMs > thresholdMs;
 }
-// extensions/imessage/src/conversation-route.ts
+//#endregion
+//#region extensions/imessage/src/conversation-route.ts
 async function resolveIMessageConversationRoute(params) {
 	const routeInput = {
 		channel: "imessage",
@@ -1173,7 +1188,8 @@ async function resolveIMessageConversationRoute(params) {
 		bindingResolution: runtimeRoute.bindingRecord ? null : bindingResolution
 	};
 }
-// src/channels/mention-gating.ts
+//#endregion
+//#region src/channels/mention-gating.ts
 function resolveBotThreadMentionPolicy(params) {
 	if (!params.isBotOwnedThread || params.requireMentionInBotThreads === void 0) return {
 		requireMention: params.requireMention,
@@ -1184,7 +1200,8 @@ function resolveBotThreadMentionPolicy(params) {
 		implicitMentionKinds: params.requireMentionInBotThreads ? params.implicitMentionKinds?.filter((kind) => kind === "native") : params.implicitMentionKinds
 	};
 }
-// extensions/imessage/src/monitor/mention-policy.ts
+//#endregion
+//#region extensions/imessage/src/monitor/mention-policy.ts
 async function resolveIMessageInboundMentionPolicy(params) {
 	const groups = resolveChannelGroups(params.cfg, "imessage", params.accountId);
 	const { "*": defaults, ...scopes } = groups ?? {};
@@ -1216,7 +1233,8 @@ async function resolveIMessageInboundMentionPolicy(params) {
 		enforceMentionRequirement: isBotOwnedThread && requireMentionInBotThreads === true
 	};
 }
-// extensions/imessage/src/monitor/reflection-guard.ts
+//#endregion
+//#region extensions/imessage/src/monitor/reflection-guard.ts
 const REFLECTION_PATTERNS = [
 	{
 		re: /(?:#\+){2,}#?/,
@@ -1269,7 +1287,8 @@ function detectReflectedContent(text) {
 		matchedLabels
 	};
 }
-// extensions/imessage/src/monitor/inbound-processing.ts
+//#endregion
+//#region extensions/imessage/src/monitor/inbound-processing.ts
 const normalizeNonEmpty = (value) => value.trim() || null;
 const imessageConversationIdentityKinds = /* @__PURE__ */ new Set([
 	"plugin:imessage-chat-id",
@@ -1907,7 +1926,8 @@ async function buildIMessageInboundContext(params) {
 		inboundHistory
 	};
 }
-// extensions/imessage/src/monitor/ingress.ts
+//#endregion
+//#region extensions/imessage/src/monitor/ingress.ts
 const IMESSAGE_INGRESS_PAYLOAD_VERSION = 1;
 const IMESSAGE_INGRESS_DRAIN_INTERVAL_MS = 1e3;
 const IMessageIngressPayloadError = createChannelIngressError("IMessageIngressPayloadError");
@@ -2058,7 +2078,8 @@ function createIMessageDurableIngress(options) {
 		waitForIdle: monitor.waitForIdle
 	};
 }
-// extensions/imessage/src/monitor/loop-rate-limiter.ts
+//#endregion
+//#region extensions/imessage/src/monitor/loop-rate-limiter.ts
 /**
 * Per-conversation rate limiter that detects rapid-fire identical echo
 * patterns and suppresses them before they amplify into queue overflow.
@@ -2100,7 +2121,8 @@ function createLoopRateLimiter() {
 		}
 	};
 }
-// extensions/imessage/src/monitor/media-staging.ts
+//#endregion
+//#region extensions/imessage/src/monitor/media-staging.ts
 function createTypeOnlyIMessageAttachment(attachment) {
 	const contentType = attachment.mime_type?.trim() || void 0;
 	return {
@@ -2195,7 +2217,8 @@ async function stageIMessageAttachments(attachments, params) {
 		unavailableCount
 	};
 }
-// extensions/imessage/src/monitor/poll-comment.ts
+//#endregion
+//#region extensions/imessage/src/monitor/poll-comment.ts
 const DEFAULT_COMMENT_WINDOW_MS = 15e3;
 function createPollCommentFolder(options) {
 	const windowMs = options?.windowMs ?? DEFAULT_COMMENT_WINDOW_MS;
@@ -2223,7 +2246,8 @@ function createPollCommentFolder(options) {
 		}
 	};
 }
-// extensions/imessage/src/monitor/poll-render.ts
+//#endregion
+//#region extensions/imessage/src/monitor/poll-render.ts
 function renderIMessagePollBody(poll, sender, renderOptions) {
 	const options = poll.options ?? [];
 	if (poll.kind === "vote" || poll.vote && options.length === 0) {
@@ -2264,7 +2288,8 @@ function renderIMessagePollBody(poll, sender, renderOptions) {
 	const selector = renderOptions?.preferOptionId ? "pollOptionId = the stable option id shown above" : "pollOptionIndex = the option number";
 	return `\u{1F4CA} Poll${question ? `: ${question}` : ""} — options: ${optionList}. Cast your vote on this poll with the poll-vote action (${selector}); do not answer in a text reply.`;
 }
-// extensions/imessage/src/monitor/reaction-system-event.ts
+//#endregion
+//#region extensions/imessage/src/monitor/reaction-system-event.ts
 function enqueueIMessageReactionSystemEvent(params) {
 	const { decision, runtime } = params;
 	const queued = enqueueRoutedSystemEvent(decision.text, decision.route, { contextKey: decision.contextKey });
@@ -2272,7 +2297,8 @@ function enqueueIMessageReactionSystemEvent(params) {
 	params.logVerbose?.("imessage: reaction event enqueued");
 	return queued;
 }
-// extensions/imessage/src/monitor/recovery-cursor.ts
+//#endregion
+//#region extensions/imessage/src/monitor/recovery-cursor.ts
 const RECOVERY_CURSOR_STORE_OPTIONS = {
 	namespace: "imessage.recovery-cursor",
 	maxEntries: 64
@@ -2311,6 +2337,9 @@ function resolveIMessageRecoveryCursorDbIdentity(params) {
 	return `local:cli:${cliPath}`;
 }
 function recoveryCursorStoreKey(accountId, dbIdentity) {
+	return createHash("sha256").update(JSON.stringify([accountId, dbIdentity]), "utf8").digest("hex").slice(0, 32);
+}
+function legacyNulRecoveryCursorStoreKey(accountId, dbIdentity) {
 	return `${accountId}\u0000${dbIdentity}`;
 }
 function decideRecoveryCursorUpdate(current, update) {
@@ -2337,7 +2366,9 @@ async function readRecoveryCursor(accountId, dbIdentity) {
 		const key = recoveryCursorStoreKey(accountId, dbIdentity);
 		const value = await store.lookup(key);
 		if (value) return Number.isFinite(value.lastRowid) ? value.lastRowid : null;
-		const legacy = await store.consume(accountId);
+		const nulKey = legacyNulRecoveryCursorStoreKey(accountId, dbIdentity);
+		const hasNulKey = (await store.entries()).some((entry) => entry.key === nulKey);
+		const legacy = await store.consume(hasNulKey ? nulKey : accountId);
 		if (legacy && Number.isFinite(legacy.lastRowid)) {
 			await store.registerIfAbsent(key, { lastRowid: legacy.lastRowid });
 			const adopted = await store.lookup(key);
@@ -2397,7 +2428,8 @@ async function advanceIMessageRecoveryCursor(accountId, dbIdentity, rowid) {
 		});
 	} catch {}
 }
-// extensions/imessage/src/monitor/self-chat-cache.ts
+//#endregion
+//#region extensions/imessage/src/monitor/self-chat-cache.ts
 const SELF_CHAT_TTL_MS = 1e4;
 const SELF_CHAT_CREATED_AT_TOLERANCE_MS = 1e3;
 const MAX_SELF_CHAT_CACHE_ENTRIES = 512;
@@ -2476,7 +2508,8 @@ var DefaultSelfChatCache = class {
 function createSelfChatCache() {
 	return new DefaultSelfChatCache();
 }
-// extensions/imessage/src/monitor/watch-error-log.ts
+//#endregion
+//#region extensions/imessage/src/monitor/watch-error-log.ts
 const MAX_WATCH_ERROR_MESSAGE_CHARS = 200;
 function sanitizeIMessageWatchErrorPayload(payload) {
 	if (!isRecord(payload)) return {};
@@ -2488,7 +2521,8 @@ function sanitizeIMessageWatchErrorPayload(payload) {
 	}
 	return safe;
 }
-// extensions/imessage/src/monitor/monitor-provider.ts
+//#endregion
+//#region extensions/imessage/src/monitor/monitor-provider.ts
 const WATCH_SUBSCRIBE_MAX_ATTEMPTS = 3;
 const WATCH_SUBSCRIBE_RETRY_DELAY_MS = 1e3;
 const CHANNEL_APPROVAL_GATEWAY_RUNTIME_CONTEXT_CAPABILITY = "approval.gateway";
@@ -2690,12 +2724,7 @@ async function monitorIMessageProvider(opts) {
 							return;
 						}
 						const combined = entries.length === 1 ? expectDefined(entries[0], "single iMessage dispatch entry").message : combineIMessagePayloads(entries.map((entry) => entry.message));
-						if (entries.length > 1 && shouldLogVerbose()) {
-							const text = combined.text ?? "";
-							const preview = sliceUtf16Safe(text, 0, 50);
-							const ellipsis = text.length > 50 ? "..." : "";
-							logVerbose(`[imessage] merged ${entries.length} debounced messages: "${preview}${ellipsis}"`);
-						}
+						if (entries.length > 1 && shouldLogVerbose()) logVerbose(`[imessage] merged ${entries.length} debounced messages chars=${combined.text?.length ?? 0}`);
 						await handleMessageNow(combined, admissionLifecycle);
 						await settle();
 					} catch (err) {
@@ -3013,10 +3042,7 @@ async function monitorIMessageProvider(opts) {
 			allowFrom,
 			normalizeEntry: normalizeIMessageHandle
 		});
-		if (shouldLogVerbose()) {
-			const preview = truncateUtf16Safe(ctxPayload.Body ?? "", 200).replace(/\n/g, "\\n");
-			logVerbose(`imessage inbound: chatId=${chatId ?? "unknown"} from=${ctxPayload.From} len=${(ctxPayload.Body ?? "").length} preview="${preview}"`);
-		}
+		if (shouldLogVerbose()) logVerbose(`imessage inbound: chatId=${chatId ?? "unknown"} from=${ctxPayload.From} len=${(ctxPayload.Body ?? "").length}`);
 		const sendReadReceipts = imessageCfg.sendReadReceipts !== false;
 		const typingTarget = ctxPayload.To;
 		const readTarget = !decision.isGroup && decision.chatGuid ? `chat_guid:${decision.chatGuid}` : typingTarget;
@@ -3410,7 +3436,8 @@ async function monitorIMessageProvider(opts) {
 		await ingress.stop();
 	}
 }
-// extensions/imessage/src/channel.runtime.ts
+//#endregion
+//#region extensions/imessage/src/channel.runtime.ts
 async function sendIMessageOutbound(params) {
 	const send = resolveOutboundSendDep(params.deps, "imessage", { legacyKeys: IMESSAGE_LEGACY_OUTBOUND_SEND_DEP_KEYS }) ?? sendMessageIMessage;
 	const maxBytes = resolveChannelMediaMaxBytes({
@@ -3490,4 +3517,5 @@ async function startIMessageGatewayAccount(ctx) {
 		statusSink
 	});
 }
+//#endregion
 export { imessageSetupWizard, probeIMessageAccount, sendIMessageOutbound, startIMessageGatewayAccount };

package/dist/.setup/{client-C3e7ZLqA.mjs → client-DlNC08mM.mjs}

@@ -1,7 +1,7 @@
-import { u as expandIMessageUserPath } from "./accounts-BH0coL46.mjs";
-import { i as invalidateCachedIMessagePrivateApiStatus } from "./message-tool-api-CxSY_rh7.mjs";
-import { t as getIMessageRuntime } from "./runtime-BRQCPuAD.mjs";
-import { asNullableRecord, isRecord, normalizeLowercaseStringOrEmpty, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
+import { u as expandIMessageUserPath } from "./accounts-DacCvDBt.mjs";
+import { i as invalidateCachedIMessagePrivateApiStatus } from "./message-tool-api-B5NfPnFL.mjs";
+import { t as getIMessageRuntime } from "./runtime-Cza4CY5T.mjs";
+import { asNullableRecord, asOptionalRecord, isRecord, normalizeLowercaseStringOrEmpty, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { normalizeE164 } from "openclaw/plugin-sdk/account-resolution";
 import { logVerbose } from "openclaw/plugin-sdk/runtime-env";
 import { createHash } from "node:crypto";
@@ -12,7 +12,7 @@ import { StringDecoder } from "node:string_decoder";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { captureChannelReadAuthority, captureEffectAuthority } from "openclaw/plugin-sdk/fetch-runtime";
 import { raceWithTimeout } from "openclaw/plugin-sdk/time-runtime";
-// extensions/imessage/src/chat-context.ts
+//#region extensions/imessage/src/chat-context.ts
 const EMAIL_HANDLE_PATTERN = /^[^\s@]+@[^\s@]+$/u;
 function parseDirectChatIdentity(raw) {
 	const trimmed = raw.trim();
@@ -86,10 +86,12 @@ function resolveIMessageChatMatch(cached, current) {
 	if (comparisons.length === 0) return "unknown";
 	return comparisons.every(Boolean) ? "match" : "mismatch";
 }
-// extensions/imessage/src/constants.ts
+//#endregion
+//#region extensions/imessage/src/constants.ts
 const DEFAULT_IMESSAGE_PROBE_TIMEOUT_MS = 1e4;
 const DEFAULT_IMESSAGE_SEND_TIMEOUT_MS = 18e4;
-// extensions/imessage/src/state-contract.ts
+//#endregion
+//#region extensions/imessage/src/state-contract.ts
 const IMESSAGE_REPLY_CACHE_NAMESPACE = "imessage.reply-cache";
 const IMESSAGE_REPLY_CACHE_MAX_ENTRIES = 2e3;
 const IMESSAGE_REPLY_CACHE_COUNTER_NAMESPACE = "imessage.reply-cache-counter";
@@ -142,7 +144,8 @@ function resolveIMessageEchoMediaKey(media) {
 	const normalizedContentType = contentType?.split(";", 1)[0]?.trim();
 	return normalizedContentType ? `mime:${normalizedContentType}` : void 0;
 }
-// extensions/imessage/src/monitor-reply-cache.ts
+//#endregion
+//#region extensions/imessage/src/monitor-reply-cache.ts
 /** Recency window for the "react to the latest message" fallback. */
 const LATEST_FALLBACK_MS = 6e5;
 let persistenceFailureLogged = false;
@@ -373,7 +376,8 @@ function isCurrentMessageInChat(params) {
 		accountId: params.accountId
 	}) === "match";
 }
-// extensions/imessage/src/cli-output.ts
+//#endregion
+//#region extensions/imessage/src/cli-output.ts
 const IMESSAGE_CLI_STDOUT_MAX_BYTES = 8388608;
 const IMESSAGE_CLI_STDERR_TAIL_BYTES = 65536;
 function parseLastJsonObject(stdout) {
@@ -420,7 +424,8 @@ async function runIMessageCliJsonCommand(params) {
 	}
 	return parsed;
 }
-// extensions/imessage/src/bridge-recovery.ts
+//#endregion
+//#region extensions/imessage/src/bridge-recovery.ts
 const BRIDGE_RECOVERY_TIMEOUT_MS = 3e4;
 const recoveries = /* @__PURE__ */ new Map();
 /**
@@ -441,7 +446,24 @@ function recoverIMessageBridge(cliPath) {
 	recoveries.set(cliPath, recovery);
 	return recovery;
 }
-// extensions/imessage/src/client.ts
+//#endregion
+//#region extensions/imessage/src/process-diagnostics.ts
+function describeIMessageAutomationFailure(data, remoteHost) {
+	const failure = asOptionalRecord(data);
+	if (failure?.transport !== "applescript" || typeof failure.detail !== "string") return;
+	const code = /^Messages automation failed with AppleScript error (-1712|-1743)\.$/u.exec(failure.detail)?.[1];
+	if (!code) return;
+	const reason = code === "-1743" ? "Messages Automation was denied." : "Messages Automation timed out. A missing Automation grant is one possible cause.";
+	const context = remoteHost ? "Check System Settings > Privacy & Security > Automation for the SSH/wrapper process on the Messages Mac, not this Gateway's local runtime or Terminal." : "Check System Settings > Privacy & Security > Automation for the Gateway/launcher on the Messages Mac. Local Gateway runtime: " + JSON.stringify(process.execPath) + ". An app update that switches Node to Bun or moves the Gateway to a new runtime path needs this grant once; review the process macOS identifies, not just Terminal or OpenClaw.app.";
+	return reason + " " + context + " Channel probes do not verify sending.";
+}
+function normalizeIMessageAutomationError(message) {
+	const code = /Messages automation failed with AppleScript error (-1712|-1743)(?![0-9])/i.exec(message)?.[1];
+	if (!code) return;
+	return (code === "-1712" ? "Messages took too long to respond, so OpenClaw couldn't confirm your iMessage was sent. Open Messages on your Mac and approve any permission prompt. If the app is frozen, quit and reopen it. " : "OpenClaw couldn't send your iMessage because it doesn't have permission to control Messages. ") + "On the Mac running Messages, open System Settings > Privacy & Security > Automation and allow Messages access for the process running OpenClaw. If this started after an OpenClaw update, you may need to allow access again. For an app-managed or remote Gateway, check the actual launcher or SSH/wrapper process on the Messages Mac. Check whether your message was delivered and review queued replies before retrying to avoid duplicates. Technical details: Messages automation failed with AppleScript error " + code + ".";
+}
+//#endregion
+//#region extensions/imessage/src/client.ts
 const IMSG_APPLE_FRAMEWORK_STDERR_PATTERN = /^(?:\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}\.\d+ imsg\[\d+:\d+\] )?Could not fetch group for change type \d+ with identifier [^:]+:ABGroup, making it a delete change type\.$/u;
 var IMessageRpcRequestError = class extends Error {
 	constructor(message, code, data) {
@@ -512,7 +534,8 @@ var IMessageRpcClient = class {
 		this.configuredCliPath = opts.cliPath?.trim() || "imsg";
 		this.cliPath = expandIMessageUserPath(this.configuredCliPath);
 		const dbPath = opts.dbPath?.trim();
-		this.dbPath = dbPath ? opts.remoteHost?.trim() ? dbPath : resolveUserPath(dbPath) : void 0;
+		this.remoteHost = opts.remoteHost?.trim();
+		this.dbPath = dbPath ? this.remoteHost ? dbPath : resolveUserPath(dbPath) : void 0;
 		this.runtime = opts.runtime;
 		this.onNotification = opts.onNotification;
 		this.terminal = new Promise((resolve) => {
@@ -689,7 +712,8 @@ var IMessageRpcClient = class {
 					if (detailText) suffixes.push(detailText);
 				}
 				const msg = suffixes.length > 0 ? `${baseMessage}: ${suffixes.join(" ")}` : baseMessage;
-				pending.reject(new IMessageRpcRequestError(msg, typeof code === "number" ? code : void 0, details));
+				const guidance = describeIMessageAutomationFailure(details, this.remoteHost);
+				pending.reject(new IMessageRpcRequestError(guidance ? `${msg} ${guidance}` : msg, typeof code === "number" ? code : void 0, details));
 				return;
 			}
 			pending.resolve(parsed.result);
@@ -736,4 +760,5 @@ async function createIMessageRpcClient(opts = {}) {
 	await client.start();
 	return client;
 }
-export { resolveIMessageDirectChatService as S, DEFAULT_IMESSAGE_PROBE_TIMEOUT_MS as _, isIMessageCurrentMessageInChatAsync as a, isIMessageEmailChatIdentifier as b, resolveIMessageCachedResourceBinding as c, IMESSAGE_SENT_ECHOES_NAMESPACE as d, IMESSAGE_SENT_ECHOES_TTL_MS as f, resolveIMessageSentEchoEntryKey as g, resolveIMessageEchoMediaKey as h, findLatestIMessageEntryForChat as i, resolveIMessageMessageId as l, resolveIMessageCatchupCursorKey as m, createIMessageRpcClient as n, isKnownFromMeIMessageTarget as o, capFailureRetriesMap as p, runIMessageCliJsonCommand as r, rememberIMessageReplyCache as s, IMessageRpcRequestError as t, IMESSAGE_CATCHUP_CURSOR_NAMESPACE as u, DEFAULT_IMESSAGE_SEND_TIMEOUT_MS as v, normalizeDirectChatIdentifier as x, chatContextFromIMessageTarget as y };
+//#endregion
+export { resolveIMessageDirectChatService as C, normalizeDirectChatIdentifier as S, resolveIMessageSentEchoEntryKey as _, findLatestIMessageEntryForChat as a, chatContextFromIMessageTarget as b, rememberIMessageReplyCache as c, IMESSAGE_CATCHUP_CURSOR_NAMESPACE as d, IMESSAGE_SENT_ECHOES_NAMESPACE as f, resolveIMessageEchoMediaKey as g, resolveIMessageCatchupCursorKey as h, runIMessageCliJsonCommand as i, resolveIMessageCachedResourceBinding as l, capFailureRetriesMap as m, createIMessageRpcClient as n, isIMessageCurrentMessageInChatAsync as o, IMESSAGE_SENT_ECHOES_TTL_MS as p, normalizeIMessageAutomationError as r, isKnownFromMeIMessageTarget as s, IMessageRpcRequestError as t, resolveIMessageMessageId as u, DEFAULT_IMESSAGE_PROBE_TIMEOUT_MS as v, isIMessageEmailChatIdentifier as x, DEFAULT_IMESSAGE_SEND_TIMEOUT_MS as y };

package/dist/.setup/{config-schema-DRkdRC21.mjs → config-schema-DXwa_3V5.mjs}

@@ -1,7 +1,7 @@
 import { createChannelConfigUiHints } from "openclaw/plugin-sdk/channel-core";
 import { ChannelDeliveryStreamingConfigSchema, ChannelSendReadReceiptsSchema, ExecutableTokenSchema, buildChannelAccountSchemaParts, buildChannelConfigSchema, buildChannelReactionShape, buildGroupEntrySchema, isSafeScpRemoteHost, isValidInboundPathRootPattern, refineChannelDmPolicy } from "openclaw/plugin-sdk/channel-config-schema";
 import { z } from "zod";
-// extensions/imessage/src/config-ui-hints.ts
+//#region extensions/imessage/src/config-ui-hints.ts
 const iMessageChannelConfigUiHints = {
 	"": {
 		label: "iMessage",
@@ -35,7 +35,8 @@ const iMessageChannelConfigUiHints = {
 		help: "Preferred imsg RPC send transport for normal outbound replies. \"auto\" uses the IMCore bridge when available, \"bridge\" requires it, and \"applescript\" forces Messages automation."
 	}
 };
-// extensions/imessage/src/config-schema.ts
+//#endregion
+//#region extensions/imessage/src/config-schema.ts
 const IMessageActionSchema = z.object({
 	reactions: z.boolean().optional(),
 	edit: z.boolean().optional(),
@@ -117,4 +118,5 @@ const IMessageConfigSchema = IMessageAccountSchemaBase.extend({
 	}
 });
 const IMessageChannelConfigSchema = buildChannelConfigSchema(IMessageConfigSchema, { uiHints: iMessageChannelConfigUiHints });
+//#endregion
 export { IMessageChannelConfigSchema as t };

package/dist/.setup/{conversation-bindings-vZFn6sN2.mjs → conversation-bindings-DR-dbHjs.mjs}

@@ -1,5 +1,5 @@
 import { createAccountScopedConversationBindingManager, createAccountScopedConversationBindingManagerV2, resetAccountScopedConversationBindingsForTests } from "openclaw/plugin-sdk/thread-bindings-runtime";
-// extensions/imessage/src/conversation-bindings.ts
+//#region extensions/imessage/src/conversation-bindings.ts
 const IMESSAGE_CONVERSATION_BINDINGS_STATE_KEY = Symbol.for("openclaw.imessageConversationBindingsState");
 function toSessionBindingTargetKind(raw) {
 	return raw === "subagent" ? "subagent" : "session";
@@ -32,4 +32,5 @@ function createIMessageConversationBindingManagerV2(params) {
 const testing = { resetIMessageConversationBindingsForTests() {
 	resetAccountScopedConversationBindingsForTests({ stateKey: IMESSAGE_CONVERSATION_BINDINGS_STATE_KEY });
 } };
+//#endregion
 export { createIMessageConversationBindingManagerV2 as n, testing as r, createIMessageConversationBindingManager as t };

package/dist/.setup/{media-contract-CoixpXRX.mjs → media-contract-BwWs5PM7.mjs}

@@ -1,6 +1,6 @@
-import { o as resolveIMessageAccount } from "./accounts-BH0coL46.mjs";
+import { o as resolveIMessageAccount } from "./accounts-DacCvDBt.mjs";
 import { mergeInboundPathRoots } from "openclaw/plugin-sdk/channel-inbound";
-// extensions/imessage/src/media-contract.ts
+//#region extensions/imessage/src/media-contract.ts
 const DEFAULT_IMESSAGE_ATTACHMENT_ROOTS = ["/Users/*/Library/Messages/Attachments"];
 function resolveIMessageAttachmentRoots(params) {
 	const account = resolveIMessageAccount(params);
@@ -10,4 +10,5 @@ function resolveIMessageRemoteAttachmentRoots(params) {
 	const account = resolveIMessageAccount(params);
 	return mergeInboundPathRoots(account.config.remoteAttachmentRoots, params.cfg.channels?.imessage?.remoteAttachmentRoots, account.config.attachmentRoots, params.cfg.channels?.imessage?.attachmentRoots, DEFAULT_IMESSAGE_ATTACHMENT_ROOTS);
 }
+//#endregion
 export { resolveIMessageAttachmentRoots as n, resolveIMessageRemoteAttachmentRoots as r, DEFAULT_IMESSAGE_ATTACHMENT_ROOTS as t };

package/dist/.setup/{message-tool-api-CxSY_rh7.mjs → message-tool-api-B5NfPnFL.mjs}

@@ -1,9 +1,9 @@
-import { n as inferIMessageTargetChatType } from "./targets-CIx4BKqL.mjs";
-import { c as getCachedIMessageRemoteHost, o as resolveIMessageAccount } from "./accounts-BH0coL46.mjs";
+import { n as inferIMessageTargetChatType } from "./targets-B4oU7n-v.mjs";
+import { c as getCachedIMessageRemoteHost, o as resolveIMessageAccount } from "./accounts-DacCvDBt.mjs";
 import { createActionGate } from "openclaw/plugin-sdk/channel-actions";
 import { Type } from "typebox";
 import { asDateTimestampMs } from "openclaw/plugin-sdk/number-runtime";
-// extensions/imessage/src/actions-contract.ts
+//#region extensions/imessage/src/actions-contract.ts
 const IMESSAGE_ACTIONS = {
 	react: { gate: "reactions" },
 	edit: { gate: "edit" },
@@ -35,7 +35,8 @@ const IMESSAGE_ACTIONS = {
 	"poll-vote": { gate: "polls" }
 };
 const IMESSAGE_ACTION_NAMES = Object.keys(IMESSAGE_ACTIONS);
-// extensions/imessage/src/private-api-status.ts
+//#endregion
+//#region extensions/imessage/src/private-api-status.ts
 const FOUNDATIONAL_RPC_METHODS = /* @__PURE__ */ new Set([
 	"chats.list",
 	"messages.history",
@@ -74,7 +75,8 @@ function setCachedIMessagePrivateApiStatus(cliPath, status, expiresAt = 0) {
 		expiresAt
 	});
 }
-// extensions/imessage/src/message-tool-api.ts
+//#endregion
+//#region extensions/imessage/src/message-tool-api.ts
 function isGroupTarget(raw, chatType) {
 	if (chatType) return chatType !== "direct";
 	if (!raw) return false;
@@ -127,4 +129,5 @@ function describeIMessageMessageTool({ cfg, accountId, chatType, currentChannelI
 		} } : {}
 	};
 }
+//#endregion
 export { setCachedIMessagePrivateApiStatus as a, invalidateCachedIMessagePrivateApiStatus as i, getCachedIMessagePrivateApiStatus as n, IMESSAGE_ACTIONS as o, imessageRpcSupportsMethod as r, IMESSAGE_ACTION_NAMES as s, describeIMessageMessageTool as t };

package/dist/.setup/{outbound-send-deps-_da8jqeo.mjs → outbound-send-deps-B-QEsLSM.mjs}

@@ -1,3 +1,4 @@
-// extensions/imessage/src/outbound-send-deps.ts
+//#region extensions/imessage/src/outbound-send-deps.ts
 const IMESSAGE_LEGACY_OUTBOUND_SEND_DEP_KEYS = ["sendIMessage"];
+//#endregion
 export { IMESSAGE_LEGACY_OUTBOUND_SEND_DEP_KEYS as t };

package/dist/.setup/{question-reactions-DTj-VH3N.mjs → question-reactions-CgZKeyy3.mjs}

@@ -1,8 +1,8 @@
-import { t as __exportAll } from "./rolldown-runtime-782esTHO.mjs";
-import { i as normalizeIMessageGuid } from "./actions-CW7XYYF4.mjs";
-import { t as resolveIMessageReactionContext } from "./reaction-context-Bw00FkmU.mjs";
+import { t as __exportAll } from "./rolldown-runtime-BBjsoOtd.mjs";
+import { s as normalizeIMessageGuid } from "./actions-FOjSVXxg.mjs";
+import { t as resolveIMessageReactionContext } from "./reaction-context-7yLnHd5m.mjs";
 import { createQuestionReactionTargetStore, questionGatewayRuntime } from "openclaw/plugin-sdk/question-gateway-runtime";
-// extensions/imessage/src/question-reactions.ts
+//#region extensions/imessage/src/question-reactions.ts
 var question_reactions_exports = /* @__PURE__ */ __exportAll({
 	hasIMessageQuestionReactionTarget: () => hasIMessageQuestionReactionTarget,
 	maybeResolveIMessageQuestionReaction: () => maybeResolveIMessageQuestionReaction,
@@ -64,4 +64,5 @@ async function maybeResolveIMessageQuestionReaction(params) {
 		logDebug: params.logDebug
 	});
 }
+//#endregion
 export { maybeResolveIMessageQuestionReaction as n, question_reactions_exports as r, hasIMessageQuestionReactionTarget as t };

package/dist/.setup/{reaction-context-Bw00FkmU.mjs → reaction-context-7yLnHd5m.mjs}

@@ -1,5 +1,5 @@
-import { i as normalizeIMessageGuid } from "./actions-CW7XYYF4.mjs";
-// extensions/imessage/src/monitor/reaction-context.ts
+import { s as normalizeIMessageGuid } from "./actions-FOjSVXxg.mjs";
+//#region extensions/imessage/src/monitor/reaction-context.ts
 const TAPBACK_TEXT_PATTERNS = [
 	{
 		prefix: "loved",
@@ -102,4 +102,5 @@ function resolveIMessageReactionContext(message, bodyText) {
 	}
 	return resolveTapbackTextContext(bodyText);
 }
+//#endregion
 export { resolveIMessageReactionContext as t };