@openclaw/imessage 2026.9.1-beta.1 → 2026.9.2

package/dist/{monitor-DRD_Dnp9.js → monitor-CESwxMQ4.js}

@@ -1,15 +1,14 @@
-import { d as resolveIMessageChatDbLookupPath, f as resolveIMessageHomeDir, l as resolveIMessageRemoteHost, o as resolveIMessageAccount } from "./accounts-DIpGOIiN.js";
-import { c as parseIMessageAllowTarget, f as getCachedIMessagePrivateApiStatus, i as isAllowedIMessageReplyContextSender, l as parseIMessageTarget, n as formatIMessageChatTarget, p as imessageRpcSupportsMethod, s as normalizeIMessageHandle } from "./message-tool-api-BwIxJDoz.js";
-import { c as rememberIMessageReplyCache, f as getIMessageRuntime, s as isKnownFromMeIMessageMessageId, v as resolveIMessageDirectChatService } from "./monitor-reply-cache-BdeUQaHO.js";
-import { o as createIMessageRpcClient, r as sanitizeOutboundText } from "./sanitize-outbound-g651fIhi.js";
-import { f as probeIMessage, r as resolveIMessageInboundConversationId } from "./group-policy-BipELT2x.js";
-import { n as resolveIMessageAttachmentRoots, r as resolveIMessageRemoteAttachmentRoots } from "./media-contract-BVXuQHG2.js";
-import { a as resolveCatchupConfig, i as performIMessageCatchup, n as advanceIMessageCatchupCursor } from "./catchup-Dh-Rv4Ur.js";
-import { c as stripLeadingEchoTextCorruptionMarkers, i as hasPersistedIMessageEcho, o as resolveIMessageEchoMediaKey } from "./persisted-echo-cache-DGxy-J4t.js";
-import { i as registerIMessageApprovalReactionTarget, n as handleIMessageApprovalReaction, o as listPendingIMessageApprovalReactionPollTargets, r as maybeResolveIMessageApprovalReaction, s as buildIMessageApprovalConversationKeyForInbound } from "./approval-reactions-Cvwmdlev.js";
-import { a as maybeResolveIMessageApprovalPollVote, o as iMessageApprovalControlBindings, t as sendMessageIMessage } from "./send-DVQY6M5M.js";
-import { t as resolveIMessageReactionContext } from "./reaction-context-BAYI7pz0.js";
-import { n as maybeResolveIMessageQuestionReaction, t as hasIMessageQuestionReactionTarget } from "./question-reactions-viP7ZcyG.js";
+import { d as resolveIMessageChatDbLookupPath, f as resolveIMessageHomeDir, l as resolveIMessageRemoteHost, o as resolveIMessageAccount } from "./accounts-CCirBEIm.js";
+import { c as parseIMessageAllowTarget, f as getCachedIMessagePrivateApiStatus, i as isAllowedIMessageReplyContextSender, l as parseIMessageTarget, n as formatIMessageChatTarget, p as imessageRpcSupportsMethod, s as normalizeIMessageHandle } from "./message-tool-api-CUoFESHj.js";
+import { d as rememberIMessageReplyCache, o as createIMessageRpcClient, r as sanitizeOutboundText, u as isKnownFromMeIMessageMessageId, y as resolveIMessageDirectChatService } from "./sanitize-outbound-Bvo4g1Mp.js";
+import { f as probeIMessage, r as resolveIMessageInboundConversationId } from "./group-policy-Cp8SDG4G.js";
+import { t as getIMessageRuntime } from "./runtime-Cza4CY5T.js";
+import { d as resolveIMessageEchoMediaKey, l as capFailureRetriesMap, t as IMESSAGE_CATCHUP_CURSOR_NAMESPACE, u as resolveIMessageCatchupCursorKey } from "./state-contract-DvahEY4X.js";
+import { n as resolveIMessageAttachmentRoots, r as resolveIMessageRemoteAttachmentRoots } from "./media-contract-pns3TSS5.js";
+import { i as registerIMessageApprovalReactionTarget, n as handleIMessageApprovalReaction, o as listPendingIMessageApprovalReactionPollTargets, r as maybeResolveIMessageApprovalReaction, s as buildIMessageApprovalConversationKeyForInbound } from "./approval-reactions-sVpDno7d.js";
+import { c as iMessageApprovalControlBindings, n as hasPersistedIMessageEcho, r as stripLeadingEchoTextCorruptionMarkers, s as maybeResolveIMessageApprovalPollVote, t as sendMessageIMessage } from "./send-DC981dqK.js";
+import { n as normalizeIMessageGuid, t as resolveIMessageReactionContext } from "./reaction-context-Br-vAJFp.js";
+import { n as maybeResolveIMessageQuestionReaction, t as hasIMessageQuestionReactionTarget } from "./question-reactions-9tBYB1_F.js";
 import { bindIngressLifecycleToReplyOptions, createChannelIngressError, createChannelIngressMonitor, createChannelMessageReplyPipeline, createMessageReceiptFromOutboundResults, listMessageReceiptPlatformIds, resolveChannelStreamingBlockEnabled } from "openclaw/plugin-sdk/channel-outbound";
 import { chunkMarkdownTextWithMode as chunkTextWithMode, resolveChunkMode, resolveTextChunkLimit } from "openclaw/plugin-sdk/reply-runtime";
 import { resolveAgentRoute, resolveInboundLastRouteSessionKey } from "openclaw/plugin-sdk/routing";
@@ -19,16 +18,14 @@ import { asSafeIntegerInRange, hasNonEmptyString, isRecord, normalizeOptionalStr
 import fs from "node:fs/promises";
 import { createNonExitingRuntime, danger, logVerbose, shouldLogVerbose, warn } from "openclaw/plugin-sdk/runtime-env";
 import { isInboundPathAllowed, kindFromMime } from "openclaw/plugin-sdk/media-runtime";
-import { asDateTimestampMs, asPositiveFiniteNumber, parseDateStringTimestampMs, timestampMsToIsoString } from "openclaw/plugin-sdk/number-runtime";
+import { asDateTimestampMs, asPositiveFiniteNumber, parseDateStringTimestampMs, resolveIntegerOption, timestampMsToIsoString } from "openclaw/plugin-sdk/number-runtime";
 import { createHash } from "node:crypto";
-import { getRuntimeConfig } from "openclaw/plugin-sdk/runtime-config-snapshot";
+import { createRuntimeConfigReader, getRuntimeConfig } from "openclaw/plugin-sdk/runtime-config-snapshot";
 import { sliceUtf16Safe, truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
 import { collectErrorGraphCandidates, formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
-import { buildChannelGroupsScopeTree, resolveChannelGroupPolicy, resolveScopeRequireMention } from "openclaw/plugin-sdk/channel-policy";
+import { buildChannelGroupsScopeTree, resolveChannelGroupPolicy, resolveChannelGroups, resolveChannelGroupsConfigPath, resolveScopeRequireMention } from "openclaw/plugin-sdk/channel-policy";
 import { convertMarkdownTables as convertMarkdownTables$1, findCodeRegions, isInsideCode, sanitizeTerminalText } from "openclaw/plugin-sdk/text-chunking";
-import { buildChannelInboundEventContext, buildMentionRegexes, createChannelInboundDebouncer, createChannelPartialDeliveryError, filterChannelInboundQuoteContext, formatInboundEnvelope, formatInboundFromLabel, formatInboundMediaUnavailableText, formatMediaPlaceholderText, isChannelPartialDeliveryError, logInboundDrop, matchesMentionPatterns, resolveEnvelopeFormatOptions, resolveInboundMentionDecision, resolveInboundSupplementalSenderAllowed, runChannelInboundEvent, shouldDebounceTextInbound, toInboundMediaFactsWithMetadata } from "openclaw/plugin-sdk/channel-inbound";
-import { openLocalFileSafely, resolvePinnedMainDmOwnerFromAllowlist } from "openclaw/plugin-sdk/security-runtime";
-import { KeyedAsyncQueue } from "openclaw/plugin-sdk/keyed-async-queue";
+import { buildChannelInboundEventContext, buildMentionRegexes, createChannelInboundDebouncer, createChannelPartialDeliveryError, filterChannelInboundQuoteContext, formatInboundEnvelope, formatInboundFromLabel, formatInboundMediaUnavailableText, formatMediaPlaceholderText, isChannelPartialDeliveryError, logInboundDrop, matchesMentionPatterns, resolveEnvelopeFormatOptions, resolveInboundDebounceMs, resolveInboundMentionDecision, resolveInboundSupplementalSenderAllowed, runChannelInboundEvent, shouldDebounceTextInbound, toInboundMediaFactsWithMetadata } from "openclaw/plugin-sdk/channel-inbound";
 import { resolveAgentConfig, resolveHumanDelayConfig } from "openclaw/plugin-sdk/agent-runtime";
 import { CHANNEL_APPROVAL_NATIVE_RUNTIME_CONTEXT_CAPABILITY } from "openclaw/plugin-sdk/approval-handler-runtime";
 import { logTypingFailure } from "openclaw/plugin-sdk/channel-feedback";
@@ -40,12 +37,14 @@ import { channelReadyPatch } from "openclaw/plugin-sdk/gateway-runtime";
 import { redactIdentifier } from "openclaw/plugin-sdk/logging-core";
 import { DEFAULT_GROUP_HISTORY_LIMIT, createChannelHistoryWindow } from "openclaw/plugin-sdk/reply-history";
 import { resolveDefaultGroupPolicy, resolveOpenProviderRuntimeGroupPolicy, warnMissingProviderGroupPolicyFallbackOnce } from "openclaw/plugin-sdk/runtime-group-policy";
+import { openLocalFileSafely, resolvePinnedMainDmOwnerFromAllowlist } from "openclaw/plugin-sdk/security-runtime";
 import { getSessionEntry, readSessionUpdatedAt, resolveSendPolicy, resolveStorePath } from "openclaw/plugin-sdk/session-store-runtime";
 import { openNodeSqliteDatabase } from "openclaw/plugin-sdk/sqlite-runtime";
 import { waitForTransportReady } from "openclaw/plugin-sdk/transport-ready-runtime";
 import { requireRuntimeConfig } from "openclaw/plugin-sdk/plugin-config-runtime";
 import { resolveMarkdownTableMode as resolveMarkdownTableMode$1 } from "openclaw/plugin-sdk/markdown-table-runtime";
 import { resolvePreferredOpenClawTmpDir, withTempWorkspace } from "openclaw/plugin-sdk/temp-path";
+import { KeyedAsyncQueue } from "openclaw/plugin-sdk/keyed-async-queue";
 import { deliverTextOrMediaReply, resolveSendableOutboundReplyParts } from "openclaw/plugin-sdk/reply-payload";
 import { createDedupeCache } from "openclaw/plugin-sdk/dedupe-runtime";
 import { hasControlCommand } from "openclaw/plugin-sdk/command-auth-native";
@@ -74,13 +73,10 @@ function hasUnscopedTarget(targets) {
 function uniqueChatIds(chatIds) {
 	return [...new Set(chatIds)];
 }
-function normalizeMessageGuid(value) {
-	return value.trim().replace(/^p:\d+\//iu, "");
-}
 function enumerateMessageGuidCandidates(value) {
 	const trimmed = value.trim();
 	if (!trimmed) return [];
-	return [trimmed, normalizeMessageGuid(trimmed)].filter((candidate, index, candidates) => candidate.length > 0 && candidates.indexOf(candidate) === index);
+	return [trimmed, normalizeIMessageGuid(trimmed)].filter((candidate, index, candidates) => candidate.length > 0 && candidates.indexOf(candidate) === index);
 }
 function buildPendingTargetsByMessageId(targets) {
 	const pendingByMessageId = /* @__PURE__ */ new Map();
@@ -171,7 +167,7 @@ async function pollPendingIMessageApprovalReactions(params) {
 		for (const message of messages) {
 			const targetGuid = message.guid?.trim();
 			if (!targetGuid) continue;
-			const target = pendingByMessageId.get(targetGuid) ?? pendingByMessageId.get(normalizeMessageGuid(targetGuid));
+			const target = pendingByMessageId.get(targetGuid) ?? pendingByMessageId.get(normalizeIMessageGuid(targetGuid));
 			if (!target) continue;
 			bindObservedConversation({
 				target,
@@ -264,6 +260,269 @@ function attachIMessageMonitorAbortHandler(params) {
 	return () => abort.removeEventListener("abort", onAbort);
 }
 //#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;
+const MAX_PER_RUN_LIMIT = 500;
+const DEFAULT_FIRST_RUN_LOOKBACK_MINUTES = 30;
+const DEFAULT_MAX_FAILURE_RETRIES = 10;
+const MAX_MAX_FAILURE_RETRIES = 1e3;
+const cursorWriteQueue = new KeyedAsyncQueue();
+function openCatchupCursorStore() {
+	return getIMessageRuntime().state.openSyncKeyedStore({
+		namespace: IMESSAGE_CATCHUP_CURSOR_NAMESPACE,
+		maxEntries: 256
+	});
+}
+function updateCatchupCursorStore(key, updateValue) {
+	const store = openCatchupCursorStore();
+	if (!store.update) throw new Error("iMessage catchup cursor persistence requires atomic plugin-state update.");
+	return store.update(key, updateValue);
+}
+function enqueueCursorWrite(accountId, fn) {
+	const key = resolveIMessageCatchupCursorKey(accountId);
+	return cursorWriteQueue.enqueue(key, fn);
+}
+function sanitizeFailureRetriesInput(raw) {
+	if (!raw || typeof raw !== "object") return {};
+	const out = {};
+	for (const [guid, count] of Object.entries(raw)) {
+		if (!guid || typeof guid !== "string") continue;
+		if (typeof count !== "number" || !Number.isFinite(count) || count <= 0) continue;
+		out[guid] = Math.floor(count);
+	}
+	return out;
+}
+function normalizeIMessageCatchupCursor(value) {
+	if (!value || typeof value !== "object") return null;
+	const raw = value;
+	if (typeof raw.lastSeenMs !== "number" || !Number.isFinite(raw.lastSeenMs)) return null;
+	if (typeof raw.lastSeenRowid !== "number" || !Number.isFinite(raw.lastSeenRowid)) return null;
+	const failureRetries = sanitizeFailureRetriesInput(raw.failureRetries);
+	const hasRetries = Object.keys(failureRetries).length > 0;
+	return {
+		lastSeenMs: raw.lastSeenMs,
+		lastSeenRowid: raw.lastSeenRowid,
+		updatedAt: typeof raw.updatedAt === "number" ? raw.updatedAt : 0,
+		...hasRetries ? { failureRetries } : {}
+	};
+}
+function readIMessageCatchupCursor(accountId) {
+	return normalizeIMessageCatchupCursor(openCatchupCursorStore().lookup(resolveIMessageCatchupCursorKey(accountId)));
+}
+async function loadIMessageCatchupCursor(accountId) {
+	return readIMessageCatchupCursor(accountId);
+}
+function buildIMessageCatchupCursor(next) {
+	const sanitized = sanitizeFailureRetriesInput(next.failureRetries);
+	const hasRetries = Object.keys(sanitized).length > 0;
+	return {
+		lastSeenMs: next.lastSeenMs,
+		lastSeenRowid: next.lastSeenRowid,
+		updatedAt: Date.now(),
+		...hasRetries ? { failureRetries: sanitized } : {}
+	};
+}
+async function saveIMessageCatchupCursor(accountId, next, options = {}) {
+	const cursor = buildIMessageCatchupCursor(next);
+	updateCatchupCursorStore(resolveIMessageCatchupCursorKey(accountId), (existingValue) => {
+		const existing = normalizeIMessageCatchupCursor(existingValue);
+		if (existing && cursor.lastSeenRowid < existing.lastSeenRowid) {
+			if (!options.allowCursorRewindForRetries) return;
+			return buildIMessageCatchupCursor({
+				lastSeenMs: cursor.lastSeenMs,
+				lastSeenRowid: cursor.lastSeenRowid,
+				failureRetries: {
+					...existing.failureRetries,
+					...cursor.failureRetries
+				}
+			});
+		}
+		return cursor;
+	});
+}
+function clampInt(value, min, max, fallback) {
+	return resolveIntegerOption(value, fallback, {
+		min,
+		max
+	});
+}
+function resolveCatchupConfig(raw) {
+	return {
+		enabled: Boolean(raw?.enabled),
+		maxAgeMinutes: clampInt(raw?.maxAgeMinutes, 1, MAX_MAX_AGE_MINUTES, DEFAULT_MAX_AGE_MINUTES),
+		perRunLimit: clampInt(raw?.perRunLimit, 1, MAX_PER_RUN_LIMIT, DEFAULT_PER_RUN_LIMIT),
+		firstRunLookbackMinutes: clampInt(raw?.firstRunLookbackMinutes, 1, MAX_MAX_AGE_MINUTES, DEFAULT_FIRST_RUN_LOOKBACK_MINUTES),
+		maxFailureRetries: clampInt(raw?.maxFailureRetries, 1, MAX_MAX_FAILURE_RETRIES, DEFAULT_MAX_FAILURE_RETRIES)
+	};
+}
+async function advanceIMessageCatchupCursor(accountId, next, config) {
+	if (!Number.isFinite(next.lastSeenMs) || !Number.isFinite(next.lastSeenRowid)) return false;
+	return await enqueueCursorWrite(accountId, async () => {
+		let advanced = false;
+		updateCatchupCursorStore(resolveIMessageCatchupCursorKey(accountId), (existingValue) => {
+			const cursor = normalizeIMessageCatchupCursor(existingValue);
+			if (cursor && next.lastSeenRowid <= cursor.lastSeenRowid) return;
+			if (Object.values(cursor?.failureRetries ?? {}).some((count) => count < config.maxFailureRetries)) return;
+			advanced = true;
+			return buildIMessageCatchupCursor({
+				lastSeenMs: Math.max(cursor?.lastSeenMs ?? next.lastSeenMs, next.lastSeenMs),
+				lastSeenRowid: next.lastSeenRowid,
+				failureRetries: cursor?.failureRetries
+			});
+		});
+		return advanced;
+	});
+}
+/**
+* One catchup pass. Loads the cursor, fetches `messages.history`, replays
+* each row through `dispatch`, advances the cursor on success / give-up,
+* persists the cursor, returns a summary.
+*
+* The fetch and dispatch functions are injected so this loop is unit-testable
+* without standing up an `imsg` daemon. The wiring in `monitor-provider.ts`
+* passes the live `client.request("messages.history", ...)` adapter as
+* `fetch` and the `evaluateIMessageInbound` + `runChannelInboundEvent`
+* pipeline as `dispatch`.
+*/
+async function performIMessageCatchup(params) {
+	const now = params.now ?? Date.now();
+	const cfg = params.config;
+	const cursor = await loadIMessageCatchupCursor(params.accountId);
+	const lookbackMs = cursor === null ? cfg.firstRunLookbackMinutes * 6e4 : cfg.maxAgeMinutes * 6e4;
+	const ageBoundMs = now - cfg.maxAgeMinutes * 6e4;
+	const windowStartMs = Math.max(cursor?.lastSeenMs ?? now - lookbackMs, ageBoundMs);
+	const windowEndMs = now;
+	const sinceRowid = cursor?.lastSeenRowid ?? 0;
+	const summary = {
+		querySucceeded: false,
+		fullyCaughtUp: false,
+		fetchedCount: 0,
+		replayed: 0,
+		skippedFromMe: 0,
+		skippedPreCursor: 0,
+		skippedGivenUp: 0,
+		failed: 0,
+		givenUp: 0,
+		cursorBefore: cursor ? {
+			lastSeenMs: cursor.lastSeenMs,
+			lastSeenRowid: cursor.lastSeenRowid
+		} : null,
+		cursorAfter: {
+			lastSeenMs: cursor?.lastSeenMs ?? windowStartMs,
+			lastSeenRowid: cursor?.lastSeenRowid ?? 0
+		},
+		windowStartMs,
+		windowEndMs
+	};
+	let fetchResult;
+	try {
+		fetchResult = await params.fetch({
+			sinceMs: windowStartMs,
+			sinceRowid,
+			limit: cfg.perRunLimit
+		});
+	} catch (err) {
+		params.warn?.(`imessage catchup: fetch failed: ${String(err)}`);
+		return summary;
+	}
+	if (!fetchResult.resolved) {
+		params.warn?.(`imessage catchup: fetch returned unresolved result`);
+		return summary;
+	}
+	summary.querySucceeded = true;
+	summary.fullyCaughtUp = fetchResult.fullyCaughtUp !== false;
+	summary.fetchedCount = fetchResult.rows.length;
+	const rows = fetchResult.rows.toSorted((a, b) => a.rowid - b.rowid);
+	const failureRetries = { ...cursor?.failureRetries };
+	const cursorBeforeMs = cursor?.lastSeenMs ?? windowStartMs;
+	const cursorBeforeRowid = cursor?.lastSeenRowid ?? 0;
+	let highWatermarkMs = cursorBeforeMs;
+	let highWatermarkRowid = cursorBeforeRowid;
+	let earliestHeldFailureRow = null;
+	for (const row of rows) {
+		if (row.rowid <= sinceRowid) {
+			summary.skippedPreCursor += 1;
+			continue;
+		}
+		if (row.date < ageBoundMs) {
+			summary.skippedPreCursor += 1;
+			highWatermarkMs = Math.max(highWatermarkMs, row.date);
+			highWatermarkRowid = Math.max(highWatermarkRowid, row.rowid);
+			continue;
+		}
+		if (row.isFromMe) {
+			try {
+				await params.observeSkippedFromMe?.(row);
+			} catch (err) {
+				params.warn?.(`imessage catchup: from-me observer failed for guid=${row.guid}: ${String(err)}`);
+			}
+			summary.skippedFromMe += 1;
+			highWatermarkMs = Math.max(highWatermarkMs, row.date);
+			highWatermarkRowid = Math.max(highWatermarkRowid, row.rowid);
+			continue;
+		}
+		const priorCount = failureRetries[row.guid] ?? 0;
+		if (priorCount >= cfg.maxFailureRetries) {
+			summary.skippedGivenUp += 1;
+			highWatermarkMs = Math.max(highWatermarkMs, row.date);
+			highWatermarkRowid = Math.max(highWatermarkRowid, row.rowid);
+			continue;
+		}
+		let dispatched;
+		try {
+			dispatched = await params.dispatch(row);
+		} catch (err) {
+			params.warn?.(`imessage catchup: dispatch threw for guid=${row.guid}: ${String(err)}`);
+			dispatched = { ok: false };
+		}
+		if (dispatched.ok) {
+			summary.replayed += 1;
+			delete failureRetries[row.guid];
+			highWatermarkMs = Math.max(highWatermarkMs, row.date);
+			highWatermarkRowid = Math.max(highWatermarkRowid, row.rowid);
+			continue;
+		}
+		const nextCount = priorCount + 1;
+		failureRetries[row.guid] = nextCount;
+		summary.failed += 1;
+		if (nextCount >= cfg.maxFailureRetries) {
+			summary.givenUp += 1;
+			params.warn?.(`imessage catchup: giving up on guid=${row.guid} after ${nextCount} failures; advancing cursor past it`);
+			highWatermarkMs = Math.max(highWatermarkMs, row.date);
+			highWatermarkRowid = Math.max(highWatermarkRowid, row.rowid);
+			continue;
+		}
+		if (earliestHeldFailureRow === null || row.rowid < earliestHeldFailureRow.rowid) earliestHeldFailureRow = row;
+	}
+	if (earliestHeldFailureRow === null) {
+		if (typeof fetchResult.highWatermarkMs === "number") highWatermarkMs = Math.max(highWatermarkMs, fetchResult.highWatermarkMs);
+		if (typeof fetchResult.highWatermarkRowid === "number") highWatermarkRowid = Math.max(highWatermarkRowid, fetchResult.highWatermarkRowid);
+	}
+	let lastSeenMs;
+	let lastSeenRowid;
+	if (earliestHeldFailureRow !== null) {
+		lastSeenMs = Math.max(cursorBeforeMs, earliestHeldFailureRow.date - 1);
+		lastSeenRowid = Math.max(cursorBeforeRowid, earliestHeldFailureRow.rowid - 1);
+	} else {
+		lastSeenMs = highWatermarkMs;
+		lastSeenRowid = highWatermarkRowid;
+	}
+	const capped = capFailureRetriesMap(failureRetries);
+	summary.cursorAfter = {
+		lastSeenMs,
+		lastSeenRowid
+	};
+	await saveIMessageCatchupCursor(params.accountId, {
+		lastSeenMs,
+		lastSeenRowid,
+		failureRetries: capped
+	}, { allowCursorRewindForRetries: earliestHeldFailureRow !== null });
+	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;
+}
+//#endregion
 //#region extensions/imessage/src/monitor/strip-imsg-length-prefixed-text.ts
 const utf8Decoder = new TextDecoder();
 function readVarint(buf, start) {
@@ -515,7 +774,7 @@ function combineIMessagePayloads(payloads) {
 	const first = expectDefined(payloads[0], "first iMessage payload to coalesce");
 	if (payloads.length === 1) return first;
 	const last = expectDefined(payloads.at(-1), "last iMessage payload to coalesce");
-	const boundedPayloads = payloads.length > MAX_COALESCED_ENTRIES ? [...payloads.slice(0, MAX_COALESCED_ENTRIES - 1), last] : payloads;
+	const boundedPayloads = payloads.length > MAX_COALESCED_ENTRIES ? [...payloads.slice(0, 9), last] : payloads;
 	const seenTexts = /* @__PURE__ */ new Set();
 	const textParts = [];
 	for (const payload of boundedPayloads) {
@@ -698,7 +957,8 @@ async function deliverIMessageReply(params) {
 		accountId
 	});
 	const chunkMode = resolveChunkMode(cfg, "imessage", accountId);
-	const reply = resolveSendableOutboundReplyParts(payload, { text: convertMarkdownTables$1(sanitizeOutboundText(payload.text ?? ""), tableMode) });
+	const rawText = sanitizeOutboundText(payload.text ?? "");
+	const reply = resolveSendableOutboundReplyParts(payload, { text: convertMarkdownTables$1(rawText, tableMode) });
 	const accepted = [];
 	const sendAccepted = async (text, mediaUrl) => {
 		const sent = await sendMessageIMessage(target, text, {
@@ -760,7 +1020,8 @@ async function deliverIMessageReply(params) {
 }
 function createIMessageEchoCachingSend(params) {
 	return async (target, text, opts) => {
-		const sent = await sendMessageIMessage(target, sanitizeOutboundText(text), opts);
+		const sanitizedText = sanitizeOutboundText(text);
+		const sent = await sendMessageIMessage(target, sanitizedText, opts);
 		const scope = `${params.accountId ?? opts.accountId ?? ""}:${target}`;
 		const echoText = sent.echoText ?? (sent.sentText || void 0);
 		params.sentMessageCache?.remember(scope, {
@@ -975,8 +1236,8 @@ function warnGroupAllowlistDropPerChatOnce(params) {
 }
 //#endregion
 //#region extensions/imessage/src/monitor/inbound-dedupe.ts
-const IMESSAGE_STALE_INBOUND_THRESHOLD_MS = 900 * 1e3;
-const IMESSAGE_RECOVERY_MAX_AGE_MS = 7200 * 1e3;
+const IMESSAGE_STALE_INBOUND_THRESHOLD_MS = 9e5;
+const IMESSAGE_RECOVERY_MAX_AGE_MS = 72e5;
 /**
 * Age fence: true when the message's own send date is materially older than
 * now, i.e. stale backlog rather than a live message. Fails open (returns
@@ -1720,6 +1981,7 @@ async function buildIMessageInboundContext(params) {
 	const directService = resolveIMessageDirectChatService(params.accountService, decision.chatGuid) ?? "auto";
 	const imessageTo = decision.isGroup ? chatTarget || `imessage:${decision.sender}` : `${directService}:${decision.sender}`;
 	const imessageFrom = decision.isGroup ? `imessage:group:${chatId ?? "unknown"}` : imessageTo;
+	const replyTarget = decision.isGroup ? imessageTo : chatId != null ? `chat_id:${chatId}` : decision.chatGuid ? `chat_guid:${decision.chatGuid}` : imessageTo;
 	const inboundHistory = !decision.isGroup && params.dmHistory?.inboundHistory ? params.dmHistory.inboundHistory : decision.isGroup && decision.historyKey && params.historyLimit > 0 ? createChannelHistoryWindow({ historyMap: params.groupHistories }).buildInboundHistory({
 		historyKey: decision.historyKey,
 		limit: params.historyLimit
@@ -1747,7 +2009,8 @@ async function buildIMessageInboundContext(params) {
 			from: imessageFrom,
 			sender: {
 				id: decision.sender,
-				name: decision.senderNormalized
+				name: decision.senderNormalized,
+				isSelf: params.message.is_from_me === true
 			},
 			conversation: {
 				kind: decision.isGroup ? "group" : "direct",
@@ -1764,7 +2027,7 @@ async function buildIMessageInboundContext(params) {
 				accountId: decision.route.accountId,
 				routeSessionKey: decision.route.sessionKey
 			},
-			reply: { to: imessageTo },
+			reply: { to: replyTarget },
 			message: {
 				body: combinedBody,
 				bodyForAgent: decision.agentBodyText ?? decision.bodyText,
@@ -1922,7 +2185,7 @@ function createIMessageDurableIngress(options) {
 		},
 		pollIntervalMs: IMESSAGE_INGRESS_DRAIN_INTERVAL_MS,
 		retention: {
-			completedTtlMs: 14400 * 1e3,
+			completedTtlMs: 144e5,
 			completedMaxEntries: 1e4,
 			failedMaxEntries: 1e3
 		},
@@ -2049,18 +2312,18 @@ async function readPinnedAttachmentBytes(handle, maxBytes) {
 	let totalBytes = 0;
 	while (totalBytes <= maxBytes) {
 		const remaining = maxBytes + 1 - totalBytes;
-		const chunk = Buffer.allocUnsafe(Math.min(64 * 1024, remaining));
+		const chunk = Buffer.allocUnsafe(Math.min(65536, remaining));
 		const { bytesRead } = await handle.read(chunk, 0, chunk.length, null);
 		if (bytesRead === 0) return Buffer.concat(chunks, totalBytes);
 		chunks.push(chunk.subarray(0, bytesRead));
 		totalBytes += bytesRead;
 	}
-	throw new Error(`attachment exceeds ${Math.round(maxBytes / (1024 * 1024))}MB limit`);
+	throw new Error(`attachment exceeds ${Math.round(maxBytes / 1048576)}MB limit`);
 }
 async function readAttachmentBuffer(params) {
 	const opened = await (params.deps.openLocalFileSafely ?? openLocalFileSafely)({ filePath: params.attachmentPath });
 	try {
-		if (opened.stat.size > params.maxBytes) throw new Error(`attachment exceeds ${Math.round(params.maxBytes / (1024 * 1024))}MB limit`);
+		if (opened.stat.size > params.maxBytes) throw new Error(`attachment exceeds ${Math.round(params.maxBytes / 1048576)}MB limit`);
 		await assertAllowedCanonicalAttachmentPath({
 			canonicalPath: opened.realPath,
 			allowedRoots: params.allowedRoots
@@ -2440,7 +2703,7 @@ function sanitizeIMessageWatchErrorPayload(payload) {
 	if (typeof payload.code === "number" && Number.isFinite(payload.code)) safe.code = payload.code;
 	if (typeof payload.message === "string") {
 		const sanitizedMessage = sanitizeTerminalText(payload.message);
-		if (sanitizedMessage) safe.message = sanitizedMessage.length > MAX_WATCH_ERROR_MESSAGE_CHARS ? `${truncateUtf16Safe(sanitizedMessage, MAX_WATCH_ERROR_MESSAGE_CHARS - 1)}…` : sanitizedMessage;
+		if (sanitizedMessage) safe.message = sanitizedMessage.length > MAX_WATCH_ERROR_MESSAGE_CHARS ? `${truncateUtf16Safe(sanitizedMessage, 199)}…` : sanitizedMessage;
 	}
 	return safe;
 }
@@ -2452,7 +2715,7 @@ const CHANNEL_APPROVAL_GATEWAY_RUNTIME_CONTEXT_CAPABILITY = "approval.gateway";
 const APPROVAL_REACTION_POLL_INTERVAL_MS = 2e3;
 const APPROVAL_REACTION_DISCOVERY_INTERVAL_MS = 6e4;
 const IMESSAGE_TYPING_KEEPALIVE_INTERVAL_MS = 8e3;
-const IMESSAGE_TYPING_KEEPALIVE_MAX_DURATION_MS = 10 * 6e4;
+const IMESSAGE_TYPING_KEEPALIVE_MAX_DURATION_MS = 6e5;
 function resolveConfiguredIMessageTypingMode(cfg, agentId) {
 	return resolveAgentConfig(cfg, agentId)?.typingMode ?? cfg.agents?.defaults?.typingMode;
 }
@@ -2533,17 +2796,16 @@ const IMESSAGE_DIAGNOSTIC_DROP_REASONS = /* @__PURE__ */ new Set([
 	"agent echo in self-chat",
 	"echo",
 	"from me",
+	"no mention",
 	"reflected assistant content",
 	"self-chat echo"
 ]);
-const IMESSAGE_THROTTLED_DIAGNOSTIC_DROP_REASONS = /* @__PURE__ */ new Set(["from me"]);
-function shouldThrottleIMessageInboundDropDiagnostic(reason) {
-	return IMESSAGE_THROTTLED_DIAGNOSTIC_DROP_REASONS.has(reason);
-}
+const IMESSAGE_THROTTLED_DIAGNOSTIC_DROP_REASONS = /* @__PURE__ */ new Set(["from me", "no mention"]);
 function describeIMessageInboundDropDiagnostic(params) {
 	if (!IMESSAGE_DIAGNOSTIC_DROP_REASONS.has(params.reason)) return null;
 	const messageId = typeof params.message.id === "number" || typeof params.message.id === "string" ? String(params.message.id) : "unknown";
-	return `imessage: dropped inbound message account=${params.accountId} reason=${JSON.stringify(params.reason)} chat_id=${params.message.chat_id ?? "unknown"} group=${params.message.is_group === true} message_id=${messageId} guid=${params.message.guid ? "present" : "missing"} created_at=${params.message.created_at ?? "unknown"}`;
+	const mentionHint = params.reason === "no mention" ? ` Mention the agent (default patterns come from its identity name/emoji), or set ${params.groupsConfigPath}["${params.message.chat_id}"].requireMention=false. Preserve existing groups entries; when adding the first groups map, include "*": {} to keep other chats admitted.` : "";
+	return `imessage: dropped inbound message account=${params.accountId} reason=${JSON.stringify(params.reason)} chat_id=${params.message.chat_id ?? "unknown"} group=${params.message.is_group === true} message_id=${messageId} guid=${params.message.guid ? "present" : "missing"} created_at=${params.message.created_at ?? "unknown"}${mentionHint}`;
 }
 function describeIMessageWatchSubscribeStartupFailure(params) {
 	const retry = params.retryDelayMs !== void 0 ? ` retry_in_ms=${params.retryDelayMs}` : "";
@@ -2567,10 +2829,17 @@ async function waitForWatchSubscribeRetryDelay(params) {
 async function monitorIMessageProvider(opts = {}) {
 	const runtime = resolveRuntime(opts);
 	const cfg = opts.config ?? getRuntimeConfig();
+	const readConfig = createRuntimeConfigReader(cfg);
 	const accountInfo = resolveIMessageAccount({
 		cfg,
 		accountId: opts.accountId
 	});
+	const groupsConfigPath = resolveChannelGroupsConfigPath({
+		cfg,
+		channel: "imessage",
+		accountId: accountInfo.accountId,
+		groups: resolveChannelGroups(cfg, "imessage", accountInfo.accountId)
+	});
 	const approvalGatewayRuntime = opts.channelRuntime?.runtimeContexts.get({
 		channelId: "imessage",
 		accountId: accountInfo.accountId,
@@ -2675,6 +2944,10 @@ async function monitorIMessageProvider(opts = {}) {
 	const { debouncer: inboundDebouncer } = createChannelInboundDebouncer({
 		cfg,
 		channel: "imessage",
+		resolveDebounceMs: () => resolveInboundDebounceMs({
+			cfg: readConfig(),
+			channel: "imessage"
+		}),
 		buildKey: (entry) => {
 			const msg = entry.message;
 			const sender = msg.sender?.trim();
@@ -2775,9 +3048,6 @@ async function monitorIMessageProvider(opts = {}) {
 			runtime.error?.(`imessage catchup: failed to advance pending live cursor: ${String(err)}`);
 		}
 	}
-	async function handleMessageNow(message, ingressLifecycle) {
-		await handleMessageNowInner(message, ingressLifecycle);
-	}
 	const pollCommentFolder = createPollCommentFolder();
 	function resolveIMessageInboundBodyText(message) {
 		const messageText = ((message.poll ? renderIMessagePollBody(message.poll, message.sender, { preferOptionId: Boolean(remoteHost) }) : null) ?? message.text ?? "").trim();
@@ -2794,7 +3064,7 @@ async function monitorIMessageProvider(opts = {}) {
 			effectiveAttachmentRoots
 		};
 	}
-	async function handleMessageNowInner(rawMessage, ingressLifecycle) {
+	async function handleMessageNow(rawMessage, ingressLifecycle) {
 		const message = await repairMessageConversationAnchor(rawMessage);
 		if (!message) return;
 		const pollFoldAtMs = message.created_at ? Date.parse(message.created_at) : NaN;
@@ -2836,15 +3106,16 @@ async function monitorIMessageProvider(opts = {}) {
 		const conversationKey = chatId != null ? `group:${chatId}` : `dm:${senderForKey}`;
 		const rateLimitKey = `${accountInfo.accountId}:${conversationKey}`;
 		if (decision.kind === "drop") {
-			if (decision.reason === "echo" || decision.reason === "self-chat echo" || decision.reason === "reflected assistant content") loopRateLimiter.record(rateLimitKey);
+			if (decision.reason === "echo" || decision.reason === "reflected assistant content") loopRateLimiter.record(rateLimitKey);
 			const diagnostic = describeIMessageInboundDropDiagnostic({
 				accountId: accountInfo.accountId,
+				groupsConfigPath,
 				reason: decision.reason,
 				message
 			});
 			if (diagnostic) {
 				const throttleKey = `${rateLimitKey}:${decision.reason}`;
-				if (!shouldThrottleIMessageInboundDropDiagnostic(decision.reason) || !loggedThrottledDropDiagnostics.check(throttleKey)) runtime.log?.(warn(diagnostic));
+				if (!IMESSAGE_THROTTLED_DIAGNOSTIC_DROP_REASONS.has(decision.reason) || !loggedThrottledDropDiagnostics.check(throttleKey)) runtime.log?.(warn(diagnostic));
 			}
 			if (decision.reason === "group id not in allowlist") warnGroupAllowlistDropPerChatOnce({
 				accountId: accountInfo.accountId,
@@ -3273,7 +3544,7 @@ async function monitorIMessageProvider(opts = {}) {
 			const repairedMessage = await repairMessageConversationAnchor(message);
 			if (!repairedMessage) return { kind: "completed" };
 			if (isApprovalCommand) {
-				await handleMessageNowInner(repairedMessage);
+				await handleMessageNow(repairedMessage);
 				return { kind: "completed" };
 			}
 			const conversation = resolveApprovalControlConversation(repairedMessage);

package/dist/{question-reactions-viP7ZcyG.js → question-reactions-9tBYB1_F.js}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { t as resolveIMessageReactionContext } from "./reaction-context-BAYI7pz0.js";
+import { n as normalizeIMessageGuid, t as resolveIMessageReactionContext } from "./reaction-context-Br-vAJFp.js";
 import { createQuestionReactionTargetStore, questionGatewayRuntime } from "openclaw/plugin-sdk/question-gateway-runtime";
 //#region extensions/imessage/src/question-reactions.ts
 var question_reactions_exports = /* @__PURE__ */ __exportAll({
@@ -7,12 +7,9 @@ var question_reactions_exports = /* @__PURE__ */ __exportAll({
 	maybeResolveIMessageQuestionReaction: () => maybeResolveIMessageQuestionReaction,
 	registerIMessageQuestionReactionTargetForDeliveredPayload: () => registerIMessageQuestionReactionTargetForDeliveredPayload
 });
-function normalizeGuid(value) {
-	return value.trim().replace(/^p:\d+\//iu, "");
-}
 function buildKey(identity) {
 	const account = identity.accountId.trim();
-	const guid = normalizeGuid(identity.messageGuid);
+	const guid = normalizeIMessageGuid(identity.messageGuid);
 	return account && guid ? `${account}:${guid}` : null;
 }
 const questionReactionTargets = createQuestionReactionTargetStore({
@@ -25,7 +22,7 @@ const questionReactionTargets = createQuestionReactionTargetStore({
 function reactionCandidates(message, bodyText) {
 	const reaction = resolveIMessageReactionContext(message, bodyText);
 	if (!reaction) return null;
-	const guids = Array.from(new Set([...reaction.targetGuids ?? [], reaction.targetGuid ?? ""].map(normalizeGuid).filter(Boolean)));
+	const guids = Array.from(new Set([...reaction.targetGuids ?? [], reaction.targetGuid ?? ""].map(normalizeIMessageGuid).filter(Boolean)));
 	return guids.length > 0 ? {
 		action: reaction.action,
 		emoji: reaction.emoji,
@@ -39,7 +36,7 @@ function registerIMessageQuestionReactionTargetForDeliveredPayload(params) {
 	for (const result of params.results) {
 		if (result.channel !== "imessage") continue;
 		const guid = typeof result.meta?.imessageMessageGuid === "string" ? result.meta.imessageMessageGuid : result.messageId;
-		if (/^\d+$/u.test(normalizeGuid(guid))) continue;
+		if (/^\d+$/u.test(normalizeIMessageGuid(guid))) continue;
 		registered = questionReactionTargets.register(binding, {
 			accountId: params.accountId,
 			messageGuid: guid

package/dist/{reaction-context-BAYI7pz0.js → reaction-context-Br-vAJFp.js}

@@ -1,3 +1,9 @@
+//#region extensions/imessage/src/message-guid.ts
+/** Strip the `p:<n>/` part prefix Messages puts on some GUIDs so keys match. */
+function normalizeIMessageGuid(value) {
+	return value.trim().replace(/^p:\d+\//iu, "");
+}
+//#endregion
 //#region extensions/imessage/src/monitor/reaction-context.ts
 const TAPBACK_TEXT_PATTERNS = [
 	{
@@ -62,7 +68,7 @@ const TAPBACK_TEXT_PATTERNS = [
 	}
 ];
 function normalizeReactionValue(value) {
-	return typeof value === "string" ? value.trim().replace(/^p:\d+\//iu, "") || void 0 : void 0;
+	return typeof value === "string" ? normalizeIMessageGuid(value) || void 0 : void 0;
 }
 function resolveReactionTargetGuidCandidates(...values) {
 	const candidates = [];
@@ -70,7 +76,7 @@ function resolveReactionTargetGuidCandidates(...values) {
 		if (typeof value !== "string") continue;
 		const raw = value.trim();
 		if (!raw) continue;
-		const normalized = raw.replace(/^p:\d+\//iu, "");
+		const normalized = normalizeIMessageGuid(raw);
 		for (const candidate of [normalized, raw]) if (candidate && !candidates.includes(candidate)) candidates.push(candidate);
 	}
 	return candidates;
@@ -102,4 +108,4 @@ function resolveIMessageReactionContext(message, bodyText) {
 	return resolveTapbackTextContext(bodyText);
 }
 //#endregion
-export { resolveIMessageReactionContext as t };
+export { normalizeIMessageGuid as n, resolveIMessageReactionContext as t };