@openclaw/imessage 2026.8.1-beta.2 → 2026.8.1

package/dist/{send-BUXW76tw.js → send-mgWPKqSV.js}

@@ -1,24 +1,25 @@
-import { A as enumerateConversationKeyForms, D as buildIMessageApprovalConversationKeyForInbound, M as normalizeIMessageGuid, N as getIMessageApprovalApprovers, P as imessageApprovalAuth, _ as appendIMessageApprovalReactionHintForOutboundMessage, j as normalizeConversationKey, k as enumerateApprovalTargetKeys, w as registerIMessageApprovalReactionTargetForOutboundMessage, y as extractIMessageApprovalPromptBinding } from "./group-policy-DF9xSdik.js";
-import { d as resolveIMessageChatDbLookupPath, l as resolveIMessageRemoteHost, n as hasExclusiveIMessageLocalDatabase, o as resolveIMessageAccount } from "./accounts-D00Njxg2.js";
-import { l as parseIMessageTarget, n as formatIMessageChatTarget, s as normalizeIMessageHandle } from "./message-tool-api-CPDfJJoE.js";
-import { c as rememberIMessageReplyCache, h as chatContextFromIMessageTarget, p as getOptionalIMessageRuntime } from "./monitor-reply-cache-DKlYGd5x.js";
-import { a as IMessageRpcRequestError, n as sanitizeIMessageFinalOutboundText, o as createIMessageRpcClient, t as protectIMessageFencedRoleMarkers } from "./sanitize-outbound-CoTZLXMw.js";
-import { a as rememberPersistedIMessageEcho, r as forgetPersistedIMessageEchoKey } from "./persisted-echo-cache-BPWGUK-L.js";
-import { i as runIMessageCliJsonCommand, r as resolveAuthorizedIMessageReplyReference, t as withIMessageRemoteFile } from "./remote-file-DLwO9ved.js";
+import { d as resolveIMessageChatDbLookupPath, l as resolveIMessageRemoteHost, n as hasExclusiveIMessageLocalDatabase, o as resolveIMessageAccount } from "./accounts-CCirBEIm.js";
+import { l as parseIMessageTarget, n as formatIMessageChatTarget, s as normalizeIMessageHandle } from "./message-tool-api-CvIgJpOo.js";
+import { a as IMessageRpcRequestError, h as chatContextFromIMessageTarget, n as sanitizeIMessageFinalOutboundText, o as createIMessageRpcClient, t as protectIMessageFencedRoleMarkers, u as rememberIMessageReplyCache, v as resolveIMessageDirectChatService } from "./sanitize-outbound-Du-r1lNQ.js";
+import { l as getIMessageApprovalApprovers, u as imessageApprovalAuth } from "./group-policy-Dvc-BcWo.js";
+import { n as getOptionalIMessageRuntime, t as getIMessageRuntime } from "./runtime-Cza4CY5T.js";
+import { c as IMESSAGE_SENT_ECHOES_TTL_MS, d as resolveIMessageEchoMediaKey, p as resolveIMessageSentEchoEntryKey, s as IMESSAGE_SENT_ECHOES_NAMESPACE } from "./state-contract-4TK_cDDb.js";
+import { d as normalizeConversationKey, f as normalizeIMessageGuid, i as registerIMessageApprovalReactionTarget, l as enumerateApprovalTargetKeys, s as buildIMessageApprovalConversationKeyForInbound, u as enumerateConversationKeyForms } from "./approval-reactions-LL5yn1Rc.js";
+import { i as runIMessageCliJsonCommand, r as resolveAuthorizedIMessageReplyReference, t as withIMessageRemoteFile } from "./remote-file-6mCj2ZBy.js";
 import { createMessageReceiptFromOutboundResults } from "openclaw/plugin-sdk/channel-outbound";
 import { createLazyRuntimeSurface } from "openclaw/plugin-sdk/lazy-runtime";
 import { accessSync, constants } from "node:fs";
 import { basename } from "node:path";
 import { asOptionalRecord, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { sleep } from "openclaw/plugin-sdk/runtime-env";
+import { logVerbose, sleep } from "openclaw/plugin-sdk/runtime-env";
+import { extractOriginalFilename, kindFromMime, resolveOutboundAttachmentFromUrl } from "openclaw/plugin-sdk/media-runtime";
 import { asDateTimestampMs } from "openclaw/plugin-sdk/number-runtime";
 import { PlatformMessageNotDispatchedError, isApprovalNotFoundError } from "openclaw/plugin-sdk/error-runtime";
-import { createApprovalReactionTargetStore, listApprovalReactionBindings } from "openclaw/plugin-sdk/approval-reaction-runtime";
-import { createPluginStateErrorReporter } from "openclaw/plugin-sdk/plugin-state-runtime";
-import { extractOriginalFilename, kindFromMime, resolveOutboundAttachmentFromUrl } from "openclaw/plugin-sdk/media-runtime";
+import { addApprovalReactionHintToText, createApprovalReactionTargetStore, listApprovalReactionBindings } from "openclaw/plugin-sdk/approval-reaction-runtime";
 import { convertMarkdownTables, stripInlineDirectiveTagsForDelivery } from "openclaw/plugin-sdk/text-chunking";
 import { createChannelPartialDeliveryError } from "openclaw/plugin-sdk/channel-inbound";
 import { openNodeSqliteDatabase } from "openclaw/plugin-sdk/sqlite-runtime";
+import { createPluginStateErrorReporter } from "openclaw/plugin-sdk/plugin-state-runtime";
 import { requireRuntimeConfig } from "openclaw/plugin-sdk/plugin-config-runtime";
 import { resolveMarkdownTableMode } from "openclaw/plugin-sdk/markdown-table-runtime";
 import { resolvePreferredOpenClawTmpDir, withTempWorkspace } from "openclaw/plugin-sdk/temp-path";
@@ -452,6 +453,127 @@ const iMessageApprovalPollTargets = {
 	clearForTest: clearIMessageApprovalPollTargetsForTest
 };
 //#endregion
+//#region extensions/imessage/src/monitor/echo-text-corruption.ts
+function isLeadingEchoTextCorruptionMarker(code) {
+	return code === 0 || code === 65279 || code === 65533 || code === 65534 || code === 65535;
+}
+function stripLeadingEchoTextCorruptionMarkers(text) {
+	let offset = 0;
+	while (offset < text.length && isLeadingEchoTextCorruptionMarker(text.charCodeAt(offset))) offset += 1;
+	return offset === 0 ? text : text.slice(offset);
+}
+//#endregion
+//#region extensions/imessage/src/monitor/persisted-echo-cache.ts
+function normalizeText(text) {
+	if (!text) return;
+	return stripLeadingEchoTextCorruptionMarkers(text.replace(/\r\n?/g, "\n").trim()).trim() || void 0;
+}
+function normalizeMessageId(messageId) {
+	const normalized = messageId?.trim();
+	if (!normalized || normalized === "ok" || normalized === "unknown") return;
+	return normalized;
+}
+let mirror = null;
+let persistenceFailureLogged = false;
+function reportFailure(scope, err) {
+	if (persistenceFailureLogged) return;
+	persistenceFailureLogged = true;
+	logVerbose(`imessage echo-cache: ${scope} disabled after first failure: ${String(err)}`);
+}
+function normalizeMedia(media) {
+	if (!resolveIMessageEchoMediaKey(media)) return;
+	const contentType = media?.contentType?.trim().toLowerCase() || void 0;
+	const kind = media?.kind ?? void 0;
+	return {
+		...kind ? { kind } : {},
+		...contentType ? { contentType } : {}
+	};
+}
+function openPersistedEchoStore() {
+	return getIMessageRuntime().state.openSyncKeyedStore({
+		namespace: IMESSAGE_SENT_ECHOES_NAMESPACE,
+		maxEntries: 256
+	});
+}
+function remainingTtlMs(timestamp) {
+	const remaining = IMESSAGE_SENT_ECHOES_TTL_MS - Math.max(0, Date.now() - timestamp);
+	return remaining > 0 ? remaining : void 0;
+}
+function resolveEntryTtlMs(entry, ttlMs) {
+	if (typeof ttlMs === "number" && Number.isFinite(ttlMs) && ttlMs > 0) return ttlMs;
+	return remainingTtlMs(entry.timestamp);
+}
+function isLiveEntry(entry, now = Date.now()) {
+	const cutoff = now - IMESSAGE_SENT_ECHOES_TTL_MS;
+	return entry.timestamp >= cutoff && (entry.expiresAt == null || entry.expiresAt > now);
+}
+function loadMirrorFromStore() {
+	try {
+		mirror = openPersistedEchoStore().entries().map(({ value }) => value).filter((entry) => isLiveEntry(entry)).toSorted((a, b) => a.timestamp - b.timestamp).slice(-256);
+	} catch (err) {
+		reportFailure("read", err);
+		mirror = [];
+	}
+}
+function readRecentEntries() {
+	loadMirrorFromStore();
+	return mirror ?? [];
+}
+function persistEntry(entry, ttlMs) {
+	const effectiveTtlMs = resolveEntryTtlMs(entry, ttlMs);
+	if (!effectiveTtlMs) return;
+	const key = resolveIMessageSentEchoEntryKey(entry);
+	try {
+		openPersistedEchoStore().register(key, entry, { ttlMs: effectiveTtlMs });
+	} catch (err) {
+		reportFailure("write", err);
+		return;
+	}
+	return key;
+}
+function rememberPersistedIMessageEcho(params) {
+	const text = normalizeText(params.text);
+	const media = normalizeMedia(params.media);
+	const messageId = normalizeMessageId(params.messageId);
+	const entry = {
+		scope: params.scope,
+		timestamp: Date.now(),
+		...text ? { text } : {},
+		...media ? { media } : {},
+		...messageId ? { messageId } : {},
+		...params.pending ? { pending: true } : {}
+	};
+	if (typeof params.ttlMs === "number" && Number.isFinite(params.ttlMs) && params.ttlMs > 0) entry.expiresAt = entry.timestamp + params.ttlMs;
+	if (!entry.text && !entry.media && !entry.messageId) return;
+	loadMirrorFromStore();
+	const key = persistEntry(entry, params.ttlMs);
+	mirror = [...mirror ?? [], entry].filter((candidate) => isLiveEntry(candidate)).slice(-256);
+	return key;
+}
+function forgetPersistedIMessageEchoKey(key) {
+	if (!key) return;
+	try {
+		openPersistedEchoStore().delete(key);
+	} catch (err) {
+		reportFailure("delete", err);
+	}
+	mirror = (mirror ?? []).filter((entry) => resolveIMessageSentEchoEntryKey(entry) !== key);
+}
+function hasPersistedIMessageEcho(params) {
+	const text = normalizeText(params.text);
+	const mediaKey = resolveIMessageEchoMediaKey(params.media);
+	const messageId = normalizeMessageId(params.messageId);
+	if (!text && !mediaKey && !messageId) return false;
+	for (const entry of readRecentEntries()) {
+		if (entry.scope !== params.scope) continue;
+		if (messageId && entry.messageId === messageId) return true;
+		const hasConflictingMessageIds = Boolean(messageId && entry.messageId && messageId !== entry.messageId);
+		if (text && (!hasConflictingMessageIds || params.skipIdShortCircuit) && entry.text === text && (!entry.pending || params.includePendingText)) return true;
+		if (mediaKey && !hasConflictingMessageIds && resolveIMessageEchoMediaKey(entry.media) === mediaKey && (!entry.pending || params.includePendingText)) return true;
+	}
+	return false;
+}
+//#endregion
 //#region extensions/imessage/src/send.ts
 const MIN_PENDING_PERSISTED_ECHO_TTL_MS = 6e4;
 const PENDING_PERSISTED_ECHO_GRACE_MS = 5e3;
@@ -598,7 +720,7 @@ async function resolveFallbackSentMessageGuid(params) {
 	return null;
 }
 function shouldRecoverApprovalPromptGuid(params) {
-	return !params.filePath && !params.replyToId && Boolean(params.message.trim()) && Boolean(extractIMessageApprovalPromptBinding(params.message));
+	return Boolean(params.approvalPrompt && !params.filePath && !params.replyToId);
 }
 function canCheckSentMessageAfterRpcTimeout(params) {
 	return Boolean(params.resolveSentMessageGuidImpl) || canResolveLatestSentMessageGuidFromChatDb(params.dbPath);
@@ -686,11 +808,6 @@ function resultService(value) {
 	const normalized = normalizeOptionalString(value)?.toLowerCase();
 	return normalized === "imessage" || normalized === "sms" ? normalized : void 0;
 }
-function resultChatGuidService(value) {
-	const chatGuid = normalizeOptionalString(value);
-	if (/^imessage;/iu.test(chatGuid ?? "")) return "imessage";
-	return /^sms;/iu.test(chatGuid ?? "") ? "sms" : void 0;
-}
 function resolvePendingPersistedEchoTtlMs(timeoutMs) {
 	return Math.max(MIN_PENDING_PERSISTED_ECHO_TTL_MS, Math.max(0, timeoutMs) + PENDING_PERSISTED_ECHO_GRACE_MS);
 }
@@ -886,7 +1003,10 @@ async function sendMessageIMessage(to, text, opts) {
 	const pendingEchoTtlMs = resolvePendingPersistedEchoTtlMs(timeoutMs);
 	const region = opts.region?.trim() || account.config.region?.trim() || "US";
 	const maxBytes = typeof opts.maxBytes === "number" ? opts.maxBytes : typeof account.config.mediaMaxMb === "number" ? account.config.mediaMaxMb * 1024 * 1024 : 16 * 1024 * 1024;
-	let message = text && opts.approvalKind ? appendIMessageApprovalReactionHintForOutboundMessage(text) : text;
+	let message = opts.approvalPrompt ? addApprovalReactionHintToText({
+		text,
+		allowedDecisions: opts.approvalPrompt.allowedDecisions
+	}) : text;
 	const protectedRoles = protectIMessageFencedRoleMarkers(message);
 	message = protectedRoles.text;
 	let filePath;
@@ -1074,7 +1194,7 @@ async function sendMessageIMessage(to, text, opts) {
 				effectiveReplyToId = void 0;
 			} else if (filePath || !isIMessageRpcSendTimeout(error)) throw error;
 			else if (!shouldRecoverApprovalPromptGuid({
-				message,
+				approvalPrompt: opts.approvalPrompt,
 				filePath,
 				replyToId: resolvedReplyToId
 			}) || !canCheckSentMessageAfterRpcTimeout({
@@ -1105,7 +1225,7 @@ async function sendMessageIMessage(to, text, opts) {
 			resolveMessageGuidImpl: opts.resolveMessageGuidImpl
 		});
 		if (!approvalBindingMessageId && shouldRecoverApprovalPromptGuid({
-			message,
+			approvalPrompt: opts.approvalPrompt,
 			filePath,
 			replyToId: effectiveReplyToId
 		})) approvalBindingMessageId = await resolveFallbackSentMessageGuid({
@@ -1122,7 +1242,7 @@ async function sendMessageIMessage(to, text, opts) {
 			messageId: resolvedId ?? void 0
 		});
 		const providerChatGuid = normalizeOptionalString(result.chat_guid) ?? normalizeOptionalString(result.chatGuid);
-		const confirmedService = resultService(result.service) ?? resultChatGuidService(providerChatGuid) ?? (service === "imessage" || service === "sms" ? service : void 0);
+		const confirmedService = resolveIMessageDirectChatService(resultService(result.service) ?? service, providerChatGuid);
 		if (resolvedId && isConcreteIMessageMessageId(resolvedId)) {
 			const chatContext = chatContextFromIMessageTarget(target, confirmedService ?? service);
 			rememberIMessageReplyCache({
@@ -1134,7 +1254,7 @@ async function sendMessageIMessage(to, text, opts) {
 				isFromMe: true
 			});
 		}
-		if (message && approvalBindingMessageId && opts.approvalKind) {
+		if (message && approvalBindingMessageId && opts.approvalPrompt) {
 			const handleForKey = target.kind === "handle" ? normalizeIMessageHandle(target.to) : void 0;
 			const conversation = {
 				...target.kind === "chat_guid" ? { chatGuid: target.chatGuid } : {},
@@ -1142,12 +1262,13 @@ async function sendMessageIMessage(to, text, opts) {
 				...target.kind === "chat_id" ? { chatId: target.chatId } : {},
 				...handleForKey ? { handle: handleForKey } : {}
 			};
-			registerIMessageApprovalReactionTargetForOutboundMessage({
+			registerIMessageApprovalReactionTarget({
 				accountId: account.accountId,
 				conversation,
 				messageId: approvalBindingMessageId,
-				text: message,
-				approvalKind: opts.approvalKind
+				approvalId: opts.approvalPrompt.approvalId,
+				approvalKind: opts.approvalPrompt.approvalKind,
+				allowedDecisions: opts.approvalPrompt.allowedDecisions
 			});
 		}
 		return {
@@ -1173,4 +1294,4 @@ async function sendMessageIMessage(to, text, opts) {
 	}
 }
 //#endregion
-export { maybeResolveIMessageApprovalPollVote as a, mapSentPollOptionsToDecisions as i, buildApprovalPollOptions as n, iMessageApprovalControlBindings as o, iMessageApprovalPollTargets as r, sendMessageIMessage as t };
+export { iMessageApprovalPollTargets as a, iMessageApprovalControlBindings as c, buildApprovalPollOptions as i, hasPersistedIMessageEcho as n, mapSentPollOptionsToDecisions as o, stripLeadingEchoTextCorruptionMarkers as r, maybeResolveIMessageApprovalPollVote as s, sendMessageIMessage as t };

package/dist/state-contract-4TK_cDDb.js

@@ -0,0 +1,56 @@
+import { createHash } from "node:crypto";
+//#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";
+const IMESSAGE_REPLY_CACHE_COUNTER_KEY = "short-id-counter";
+const IMESSAGE_REPLY_CACHE_TTL_MS = 360 * 60 * 1e3;
+function resolveIMessageReplyCacheEntryKey(messageId) {
+	return createHash("sha256").update(messageId, "utf8").digest("hex").slice(0, 32);
+}
+const MAX_FAILURE_RETRY_MAP_SIZE = 512;
+const MAX_FAILURE_RETRY_MAP_JSON_BYTES = 48e3;
+const textEncoder = new TextEncoder();
+const IMESSAGE_CATCHUP_CURSOR_NAMESPACE = "imessage.catchup-cursors";
+function resolveIMessageCatchupCursorKey(accountId) {
+	return createHash("sha256").update(accountId, "utf8").digest("hex").slice(0, 32);
+}
+/**
+* Bound the retry map so a pathological storm of unique failing GUIDs
+* cannot grow the cursor value without limit. Keeps the `maxSize` entries
+* with the highest counts (closest to give-up) when over the bound.
+*/
+function capFailureRetriesMap(map, maxSize = MAX_FAILURE_RETRY_MAP_SIZE, maxBytes = MAX_FAILURE_RETRY_MAP_JSON_BYTES) {
+	const entries = Object.entries(map);
+	if (entries.length <= maxSize && textEncoder.encode(JSON.stringify(map)).byteLength <= maxBytes) return map;
+	entries.sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]));
+	const capped = {};
+	for (const [guid, count] of entries.slice(0, maxSize)) {
+		capped[guid] = count;
+		if (textEncoder.encode(JSON.stringify(capped)).byteLength > maxBytes) {
+			delete capped[guid];
+			break;
+		}
+	}
+	return capped;
+}
+const IMESSAGE_SENT_ECHOES_TTL_MS = 720 * 60 * 1e3;
+const IMESSAGE_SENT_ECHOES_NAMESPACE = "imessage.sent-echoes";
+function resolveIMessageSentEchoEntryKey(entry) {
+	return createHash("sha256").update(JSON.stringify([
+		entry.scope,
+		entry.text ?? "",
+		resolveIMessageEchoMediaKey(entry.media) ?? "",
+		entry.messageId ?? "",
+		entry.timestamp
+	])).digest("hex").slice(0, 32);
+}
+function resolveIMessageEchoMediaKey(media) {
+	const contentType = media?.contentType?.trim().toLowerCase() || void 0;
+	const kind = media?.kind && media.kind !== "unknown" ? media.kind : void 0;
+	if (kind) return `kind:${kind}`;
+	const normalizedContentType = contentType?.split(";", 1)[0]?.trim();
+	return normalizedContentType ? `mime:${normalizedContentType}` : void 0;
+}
+//#endregion
+export { IMESSAGE_REPLY_CACHE_NAMESPACE as a, IMESSAGE_SENT_ECHOES_TTL_MS as c, resolveIMessageEchoMediaKey as d, resolveIMessageReplyCacheEntryKey as f, IMESSAGE_REPLY_CACHE_MAX_ENTRIES as i, capFailureRetriesMap as l, IMESSAGE_REPLY_CACHE_COUNTER_KEY as n, IMESSAGE_REPLY_CACHE_TTL_MS as o, resolveIMessageSentEchoEntryKey as p, IMESSAGE_REPLY_CACHE_COUNTER_NAMESPACE as r, IMESSAGE_SENT_ECHOES_NAMESPACE as s, IMESSAGE_CATCHUP_CURSOR_NAMESPACE as t, resolveIMessageCatchupCursorKey as u };

package/dist/state-migrations-SFdKp3GQ.js

@@ -0,0 +1,277 @@
+import { a as resolveDefaultIMessageAccountId, i as listIMessageAccountIds, o as resolveIMessageAccount } from "./accounts-CCirBEIm.js";
+import { a as IMESSAGE_REPLY_CACHE_NAMESPACE, c as IMESSAGE_SENT_ECHOES_TTL_MS, f as resolveIMessageReplyCacheEntryKey, i as IMESSAGE_REPLY_CACHE_MAX_ENTRIES, l as capFailureRetriesMap, n as IMESSAGE_REPLY_CACHE_COUNTER_KEY, o as IMESSAGE_REPLY_CACHE_TTL_MS, p as resolveIMessageSentEchoEntryKey, r as IMESSAGE_REPLY_CACHE_COUNTER_NAMESPACE, s as IMESSAGE_SENT_ECHOES_NAMESPACE, t as IMESSAGE_CATCHUP_CURSOR_NAMESPACE, u as resolveIMessageCatchupCursorKey } from "./state-contract-4TK_cDDb.js";
+import fs from "node:fs";
+import path from "node:path";
+import { asFiniteNumber, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
+import { createHash } from "node:crypto";
+import { fileExists } from "openclaw/plugin-sdk/security-runtime";
+import { resolveStateDir } from "openclaw/plugin-sdk/state-paths";
+//#region extensions/imessage/src/state-migrations.ts
+function resolveMigrationStateDir(params) {
+	return params.stateDir ?? resolveStateDir(params.env);
+}
+function remainingTtlMs(timestamp, ttlMs) {
+	const remaining = ttlMs - Math.max(0, Date.now() - timestamp);
+	return remaining > 0 ? remaining : void 0;
+}
+function readJsonl(pathValue) {
+	try {
+		return fs.readFileSync(pathValue, "utf8").split(/\n+/).flatMap((line) => {
+			if (!line) return [];
+			try {
+				return [JSON.parse(line)];
+			} catch {
+				return [];
+			}
+		});
+	} catch (err) {
+		throw new Error(`Failed reading ${pathValue}: ${String(err)}`, { cause: err });
+	}
+}
+function parseReplyCacheEntry(raw) {
+	if (!raw || typeof raw !== "object") return null;
+	const parsed = raw;
+	if (typeof parsed.accountId !== "string" || typeof parsed.messageId !== "string" || typeof parsed.shortId !== "string" || typeof parsed.timestamp !== "number") return null;
+	return {
+		accountId: parsed.accountId,
+		messageId: parsed.messageId,
+		shortId: parsed.shortId,
+		timestamp: parsed.timestamp,
+		...typeof parsed.chatGuid === "string" ? { chatGuid: parsed.chatGuid } : {},
+		...typeof parsed.chatIdentifier === "string" ? { chatIdentifier: parsed.chatIdentifier } : {},
+		...typeof parsed.chatId === "number" ? { chatId: parsed.chatId } : {},
+		...typeof parsed.isFromMe === "boolean" ? { isFromMe: parsed.isFromMe } : {}
+	};
+}
+function readReplyCacheMaxShortId(sourcePath) {
+	let max = 0;
+	for (const raw of readJsonl(sourcePath)) {
+		if (!raw || typeof raw !== "object") continue;
+		const shortId = raw.shortId;
+		if (typeof shortId !== "string") continue;
+		const numeric = Number.parseInt(shortId, 10);
+		if (Number.isFinite(numeric) && numeric > max) max = numeric;
+	}
+	return max;
+}
+function readReplyCounterValue(value) {
+	if (!value || typeof value !== "object") return null;
+	const counter = value.counter;
+	return asFiniteNumber(counter) ?? null;
+}
+function shouldReplaceReplyCounter(existingValue, incomingValue) {
+	const incomingCounter = readReplyCounterValue(incomingValue);
+	if (incomingCounter === null) return false;
+	const existingCounter = readReplyCounterValue(existingValue);
+	return existingCounter === null || incomingCounter > existingCounter;
+}
+function parseSentEchoEntry(raw) {
+	if (!raw || typeof raw !== "object") return null;
+	const parsed = raw;
+	if (typeof parsed.scope !== "string" || typeof parsed.timestamp !== "number") return null;
+	return {
+		scope: parsed.scope,
+		timestamp: parsed.timestamp,
+		...typeof parsed.text === "string" ? { text: parsed.text } : {},
+		...typeof parsed.messageId === "string" ? { messageId: parsed.messageId } : {}
+	};
+}
+function listReplyCacheEntries(sourcePath) {
+	const entriesByKey = /* @__PURE__ */ new Map();
+	for (const entry of readJsonl(sourcePath).map(parseReplyCacheEntry)) {
+		if (!entry) continue;
+		const ttlMs = remainingTtlMs(entry.timestamp, IMESSAGE_REPLY_CACHE_TTL_MS);
+		if (!ttlMs) continue;
+		const key = resolveIMessageReplyCacheEntryKey(entry.messageId);
+		entriesByKey.delete(key);
+		entriesByKey.set(key, {
+			value: entry,
+			ttlMs
+		});
+	}
+	return [...entriesByKey.entries()].slice(-IMESSAGE_REPLY_CACHE_MAX_ENTRIES).map(([key, entry]) => ({
+		key,
+		value: entry.value,
+		ttlMs: entry.ttlMs
+	}));
+}
+function listSentEchoEntries(sourcePath) {
+	return readJsonl(sourcePath).map(parseSentEchoEntry).filter((entry) => Boolean(entry)).slice(-256).flatMap((entry) => {
+		const ttlMs = remainingTtlMs(entry.timestamp, IMESSAGE_SENT_ECHOES_TTL_MS);
+		if (!ttlMs) return [];
+		return [{
+			key: resolveIMessageSentEchoEntryKey(entry),
+			value: entry,
+			ttlMs
+		}];
+	});
+}
+function resolveLegacyCatchupCursorPath(stateDir, accountId) {
+	const safePrefix = accountId.replace(/[^a-zA-Z0-9_-]/g, "_") || "account";
+	const hash = createHash("sha256").update(accountId, "utf8").digest("hex").slice(0, 12);
+	return path.join(stateDir, "imessage", "catchup", `${safePrefix}__${hash}.json`);
+}
+function listLegacyCatchupCursorPaths(stateDir) {
+	const dir = path.join(stateDir, "imessage", "catchup");
+	try {
+		return fs.readdirSync(dir, { withFileTypes: true }).filter((entry) => entry.isFile() && entry.name.endsWith(".json")).map((entry) => path.join(dir, entry.name));
+	} catch {
+		return [];
+	}
+}
+function normalizeCatchupCursor(raw) {
+	if (!raw || typeof raw !== "object") return null;
+	const value = raw;
+	if (typeof value.lastSeenMs !== "number" || !Number.isFinite(value.lastSeenMs) || typeof value.lastSeenRowid !== "number" || !Number.isFinite(value.lastSeenRowid)) return null;
+	const failureRetries = sanitizeCatchupFailureRetries(value.failureRetries);
+	const hasRetries = Object.keys(failureRetries).length > 0;
+	return {
+		lastSeenMs: value.lastSeenMs,
+		lastSeenRowid: value.lastSeenRowid,
+		updatedAt: typeof value.updatedAt === "number" ? value.updatedAt : 0,
+		...hasRetries ? { failureRetries } : {}
+	};
+}
+function readCatchupCursor(sourcePath) {
+	let parsed;
+	try {
+		parsed = JSON.parse(fs.readFileSync(sourcePath, "utf8"));
+	} catch (err) {
+		throw new Error(`Failed reading ${sourcePath}: ${String(err)}`, { cause: err });
+	}
+	const cursor = normalizeCatchupCursor(parsed);
+	if (!cursor) throw new Error(`Invalid iMessage catchup cursor: ${sourcePath}`);
+	return cursor;
+}
+function sanitizeCatchupFailureRetries(raw) {
+	if (!raw || typeof raw !== "object") return {};
+	const out = {};
+	for (const [guid, count] of Object.entries(raw)) if (typeof count === "number" && Number.isFinite(count) && count > 0) out[guid] = Math.floor(count);
+	return capFailureRetriesMap(out);
+}
+function shouldReplaceCatchupCursor(existingValue, incomingValue) {
+	const incoming = normalizeCatchupCursor(incomingValue);
+	if (!incoming) return false;
+	const existing = normalizeCatchupCursor(existingValue);
+	return !existing || incoming.lastSeenRowid > existing.lastSeenRowid || incoming.lastSeenRowid === existing.lastSeenRowid && incoming.lastSeenMs > existing.lastSeenMs;
+}
+function detectReplyCacheMigration(params) {
+	const stateDir = resolveMigrationStateDir(params);
+	const sourcePath = path.join(stateDir, "imessage", "reply-cache.jsonl");
+	if (!fileExists(sourcePath)) return [];
+	const plans = [];
+	plans.push({
+		kind: "plugin-state-import",
+		label: "iMessage reply short-id counter",
+		sourcePath,
+		targetPath: `plugin state:${IMESSAGE_REPLY_CACHE_COUNTER_NAMESPACE}`,
+		pluginId: "imessage",
+		namespace: IMESSAGE_REPLY_CACHE_COUNTER_NAMESPACE,
+		maxEntries: 1,
+		scopeKey: "",
+		stateDir,
+		preview: `- iMessage reply short-id counter: ${sourcePath} → plugin state (${IMESSAGE_REPLY_CACHE_COUNTER_NAMESPACE})`,
+		readEntries: () => {
+			const maxShortId = readReplyCacheMaxShortId(sourcePath);
+			return maxShortId > 0 ? [{
+				key: IMESSAGE_REPLY_CACHE_COUNTER_KEY,
+				value: { counter: maxShortId }
+			}] : [];
+		},
+		shouldReplaceExistingEntry: ({ existingValue, incomingValue }) => shouldReplaceReplyCounter(existingValue, incomingValue)
+	});
+	plans.push({
+		kind: "plugin-state-import",
+		label: "iMessage reply short-id cache",
+		sourcePath,
+		targetPath: `plugin state:${IMESSAGE_REPLY_CACHE_NAMESPACE}`,
+		pluginId: "imessage",
+		namespace: IMESSAGE_REPLY_CACHE_NAMESPACE,
+		maxEntries: IMESSAGE_REPLY_CACHE_MAX_ENTRIES,
+		scopeKey: "",
+		stateDir,
+		cleanupSource: "rename",
+		cleanupWhenEmpty: true,
+		preview: `- iMessage reply short-id cache: ${sourcePath} → plugin state (${IMESSAGE_REPLY_CACHE_NAMESPACE})`,
+		readEntries: () => listReplyCacheEntries(sourcePath)
+	});
+	return plans;
+}
+function detectSentEchoMigration(params) {
+	const stateDir = resolveMigrationStateDir(params);
+	const sourcePath = path.join(stateDir, "imessage", "sent-echoes.jsonl");
+	if (!fileExists(sourcePath)) return [];
+	return [{
+		kind: "plugin-state-import",
+		label: "iMessage sent-echo dedupe cache",
+		sourcePath,
+		targetPath: `plugin state:${IMESSAGE_SENT_ECHOES_NAMESPACE}`,
+		pluginId: "imessage",
+		namespace: IMESSAGE_SENT_ECHOES_NAMESPACE,
+		maxEntries: 256,
+		scopeKey: "",
+		stateDir,
+		cleanupSource: "rename",
+		cleanupWhenEmpty: true,
+		preview: `- iMessage sent-echo dedupe cache: ${sourcePath} → plugin state (${IMESSAGE_SENT_ECHOES_NAMESPACE})`,
+		readEntries: () => listSentEchoEntries(sourcePath)
+	}];
+}
+function detectCatchupCursorMigrations(params) {
+	const stateDir = resolveMigrationStateDir(params);
+	const accountIds = uniqueStrings([resolveDefaultIMessageAccountId(params.cfg), ...listIMessageAccountIds(params.cfg)].map((accountId) => resolveIMessageAccount({
+		cfg: params.cfg,
+		accountId
+	}).accountId));
+	const configuredPaths = new Set(accountIds.map((accountId) => resolveLegacyCatchupCursorPath(stateDir, accountId)));
+	const configuredPlans = accountIds.flatMap((accountId) => {
+		const sourcePath = resolveLegacyCatchupCursorPath(stateDir, accountId);
+		if (!fileExists(sourcePath)) return [];
+		return {
+			kind: "plugin-state-import",
+			label: "iMessage catchup cursor",
+			sourcePath,
+			targetPath: `plugin state:${IMESSAGE_CATCHUP_CURSOR_NAMESPACE}`,
+			pluginId: "imessage",
+			namespace: IMESSAGE_CATCHUP_CURSOR_NAMESPACE,
+			maxEntries: 256,
+			scopeKey: "",
+			stateDir,
+			cleanupSource: "rename",
+			preview: `- iMessage catchup cursor: ${sourcePath} → plugin state (${IMESSAGE_CATCHUP_CURSOR_NAMESPACE})`,
+			readEntries: () => {
+				const cursor = readCatchupCursor(sourcePath);
+				return [{
+					key: resolveIMessageCatchupCursorKey(accountId),
+					value: cursor
+				}];
+			},
+			shouldReplaceExistingEntry: (replaceParams) => shouldReplaceCatchupCursor(replaceParams.existingValue, replaceParams.incomingValue)
+		};
+	});
+	const orphanPlans = listLegacyCatchupCursorPaths(stateDir).filter((sourcePath) => !configuredPaths.has(sourcePath)).map((sourcePath) => ({
+		kind: "plugin-state-import",
+		label: "iMessage orphan catchup cursor",
+		sourcePath,
+		targetPath: `plugin state:${IMESSAGE_CATCHUP_CURSOR_NAMESPACE}`,
+		pluginId: "imessage",
+		namespace: IMESSAGE_CATCHUP_CURSOR_NAMESPACE,
+		maxEntries: 256,
+		scopeKey: "",
+		stateDir,
+		cleanupSource: "rename",
+		cleanupWhenEmpty: true,
+		preview: `- iMessage orphan catchup cursor: ${sourcePath} → archived legacy state`,
+		readEntries: () => []
+	}));
+	return [...configuredPlans, ...orphanPlans];
+}
+async function detectIMessageLegacyStateMigrations(params) {
+	return [
+		...detectCatchupCursorMigrations(params),
+		...detectReplyCacheMigration(params),
+		...detectSentEchoMigration(params)
+	];
+}
+//#endregion
+export { detectIMessageLegacyStateMigrations };

package/node_modules/typebox/build/format/date.d.mts

@@ -1,6 +1,6 @@
 /**
  * Returns true if the value is a ISO8601 Date component string
- * @source ajv-formats
+ * @description https://datatracker.ietf.org/doc/html/rfc3339
  * @example `2020-12-12`
  */
 export declare function IsDate(value: string): boolean;

package/node_modules/typebox/build/format/date.mjs

@@ -5,7 +5,7 @@ function IsLeapYear(year) {
 }
 /**
  * Returns true if the value is a ISO8601 Date component string
- * @source ajv-formats
+ * @description https://datatracker.ietf.org/doc/html/rfc3339
  * @example `2020-12-12`
  */
 export function IsDate(value) {

package/node_modules/typebox/build/format/date_time.d.mts

@@ -1,6 +1,6 @@
 /**
  * Returns true if the value is a ISO8601 DateTime string
- * @source ajv-formats
+ * @specification https://datatracker.ietf.org/doc/html/rfc3339
  * @example `2020-12-12T20:20:40+00:00`
  */
-export declare function IsDateTime(value: string, strictTimeZone?: boolean): boolean;
+export declare function IsDateTime(value: string): boolean;

package/node_modules/typebox/build/format/date_time.mjs

@@ -2,10 +2,10 @@ import { IsDate } from './date.mjs';
 import { IsTime } from './time.mjs';
 /**
  * Returns true if the value is a ISO8601 DateTime string
- * @source ajv-formats
+ * @specification https://datatracker.ietf.org/doc/html/rfc3339
  * @example `2020-12-12T20:20:40+00:00`
  */
-export function IsDateTime(value, strictTimeZone = true) {
+export function IsDateTime(value) {
     const dateTime = value.split(/T/i);
-    return dateTime.length === 2 && IsDate(dateTime[0]) && IsTime(dateTime[1], strictTimeZone);
+    return dateTime.length === 2 && IsDate(dateTime[0]) && IsTime(dateTime[1]);
 }

package/node_modules/typebox/build/format/email.d.mts

@@ -1,5 +1,5 @@
 /**
  * Returns true if the value is an Email
- * @specification ajv-formats
+ * @specification https://datatracker.ietf.org/doc/html/rfc5322
  */
 export declare function IsEmail(value: string): boolean;

package/node_modules/typebox/build/format/email.mjs

@@ -1,7 +1,7 @@
-const Email = /^(?!.*\.\.)[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*@[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)*$/i;
+const Email = /^(?:[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*|"(?:[^"\\]|\\.)*")@(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)*|\[(?:IPv6:[a-f0-9:]+|(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])(?:\.(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])){3})\])$/i;
 /**
  * Returns true if the value is an Email
- * @specification ajv-formats
+ * @specification https://datatracker.ietf.org/doc/html/rfc5322
  */
 export function IsEmail(value) {
     return Email.test(value);