@nikolasp98/minion 2026.6.13-dev.20260616005057 → 2026.6.14-dev

package/dist/bundled/boot-md/handler.js

@@ -10623,7 +10623,7 @@ var init_dotenv = __esmMin((() => {
 //#region src/version.ts
 var VERSION;
 var init_version$1 = __esmMin((() => {
-	VERSION = "2026.6.13-dev.20260616005057";
+	VERSION = "2026.6.14-dev";
 }));
 //#endregion
 //#region src/config/agent-dirs.ts
@@ -15731,7 +15731,8 @@ var init_zod_schema = __esmMin((() => {
 			channelHealthCheckMinutes: z.number().int().min(0).optional(),
 			messageLedger: z.object({
 				enabled: z.boolean().optional(),
-				dbPath: z.string().optional()
+				dbPath: z.string().optional(),
+				importContacts: z.boolean().optional()
 			}).strict().optional(),
 			memorySync: z.object({ enabled: z.boolean().optional() }).strict().optional(),
 			personalAgentObservations: z.object({
@@ -62286,7 +62287,7 @@ function normalizeLedgerRecord(input) {
 	const metadata = { ...input.metadata && typeof input.metadata === "object" ? input.metadata : {} };
 	for (const [key, value] of Object.entries(input)) if (!KNOWN_KEYS.has(key) && value !== void 0) metadata[key] = value;
 	return {
-		clientId: randomUUID(),
+		clientId: str(input.clientId) ?? randomUUID(),
 		direction: input.direction === "outbound" ? "outbound" : "inbound",
 		channel: input.channel,
 		accountId: str(input.accountId),
@@ -62309,6 +62310,7 @@ function normalizeLedgerRecord(input) {
 var KNOWN_KEYS, str, bool;
 var init_message_ledger_types = __esmMin((() => {
 	KNOWN_KEYS = new Set([
+		"clientId",
 		"direction",
 		"channel",
 		"accountId",
@@ -115147,6 +115149,10 @@ async function createWaSocket(printQr, verbose, opts = {}) {
 	maybeRestoreCredsFromBackup(authDir);
 	const { state, saveCreds } = await useMultiFileAuthState(authDir);
 	const { version } = await fetchLatestBaileysVersion();
+	let syncFullHistory = false;
+	try {
+		syncFullHistory = loadConfig().gateway?.messageLedger?.importContacts === true;
+	} catch {}
 	const sock = makeWASocket({
 		auth: {
 			creds: state.creds,
@@ -115160,7 +115166,7 @@ async function createWaSocket(printQr, verbose, opts = {}) {
 			"cli",
 			VERSION
 		],
-		syncFullHistory: false,
+		syncFullHistory,
 		markOnlineOnConnect: false
 	});
 	sock.ev.on("creds.update", () => enqueueSaveCreds(authDir, saveCreds, sessionLogger));
@@ -115286,6 +115292,7 @@ function formatError(err) {
 var log$6, credsSaveQueue;
 var init_session = __esmMin((() => {
 	init_command_format();
+	init_config$4();
 	init_logging$1();
 	init_chat_trace();
 	init_subsystem();
@@ -115748,6 +115755,76 @@ var init_fire_message_inbound = __esmMin((() => {
 	init_hook_runner_global();
 }));
 //#endregion
+//#region src/web/inbound/history-import.ts
+/** Coerce a Baileys conversationTimestamp (number | Long-like) to ms, or null. */
+function tsToMs(value) {
+	if (typeof value === "number" && Number.isFinite(value)) return value * 1e3;
+	if (value && typeof value === "object" && typeof value.toNumber === "function") {
+		const n = value.toNumber();
+		return Number.isFinite(n) ? n * 1e3 : null;
+	}
+	return null;
+}
+function contactName(c) {
+	return (c.name || c.notify || c.verifiedName || c.username || "").trim() || void 0;
+}
+/**
+* Record one idempotent inbound shell row per importable 1:1 person, drawn from
+* the union of `contacts` and `chats`. Returns the number of distinct people
+* recorded this call.
+*/
+function importWhatsAppPeopleToLedger(args) {
+	const e164Of = (jid) => jid ? args.jidToE164(jid) : null;
+	const names = /* @__PURE__ */ new Map();
+	for (const c of args.contacts ?? []) {
+		const e164 = e164Of(c.phoneNumber) ?? e164Of(c.id);
+		if (!e164) continue;
+		const nm = contactName(c);
+		if (nm) names.set(e164, nm);
+	}
+	const people = /* @__PURE__ */ new Map();
+	const consider = (jid, explicitName, ts) => {
+		if (jid && args.isGroupJid(jid)) return;
+		const e164 = e164Of(jid);
+		if (!e164) return;
+		if (args.selfE164 && e164 === args.selfE164) return;
+		const name = explicitName || names.get(e164);
+		const cur = people.get(e164);
+		if (cur) {
+			if (!cur.name && name) cur.name = name;
+			if (cur.ts == null && ts != null) cur.ts = ts;
+		} else people.set(e164, {
+			name,
+			ts
+		});
+	};
+	for (const c of args.contacts ?? []) consider(c.phoneNumber || c.id, contactName(c), null);
+	for (const chat of args.chats ?? []) consider(chat.id, typeof chat.name === "string" ? chat.name.trim() : void 0, tsToMs(chat.conversationTimestamp));
+	let imported = 0;
+	for (const [e164, p] of people) {
+		args.record({
+			clientId: `wa-import:${args.accountId}:${e164}`,
+			direction: "inbound",
+			channel: "whatsapp",
+			accountId: args.accountId,
+			chatId: e164,
+			senderId: e164,
+			senderName: p.name,
+			isGroup: false,
+			isBot: false,
+			occurredAt: p.ts ?? args.now ?? Date.now(),
+			messageId: `wa-import:${e164}`,
+			metadata: {
+				imported: true,
+				source: "whatsapp-history"
+			}
+		});
+		imported++;
+	}
+	return { imported };
+}
+var init_history_import = __esmMin((() => {}));
+//#endregion
 //#region src/web/inbound/access-control.ts
 async function checkInboundAccessControl(params) {
 	const cfg = loadConfig();
@@ -116323,18 +116400,69 @@ async function monitorWebInbox(options) {
 		}
 	};
 	sock.ev.on("connection.update", handleConnectionUpdate);
+	const importContactsEnabled = (() => {
+		try {
+			const cfg = loadConfig();
+			return cfg.gateway?.messageLedger?.enabled === true && cfg.gateway?.messageLedger?.importContacts === true;
+		} catch {
+			return false;
+		}
+	})();
+	const runImport = (label, payload) => {
+		try {
+			const { imported } = importWhatsAppPeopleToLedger({
+				chats: payload.chats ?? [],
+				contacts: payload.contacts ?? [],
+				accountId: options.accountId,
+				selfE164,
+				record,
+				jidToE164: (jid) => jidToE164(jid),
+				isGroupJid: (jid) => isJidGroup(jid) === true
+			});
+			if (imported > 0) inboundConsoleLog.info(`Imported ${imported} WhatsApp ${label} as CRM contact rows (account ${options.accountId})`);
+		} catch (err) {
+			inboundLogger.error({ error: String(err) }, "whatsapp contact import failed");
+		}
+	};
+	const handleHistorySet = (h) => runImport("history", {
+		chats: h.chats,
+		contacts: h.contacts
+	});
+	const handleContactsUpsert = (contacts) => runImport("contacts", { contacts });
+	const handleChatsUpsert = (chats) => runImport("chats", { chats });
+	if (importContactsEnabled) {
+		sock.ev.on("messaging-history.set", handleHistorySet);
+		sock.ev.on("contacts.upsert", handleContactsUpsert);
+		sock.ev.on("chats.upsert", handleChatsUpsert);
+		Promise.resolve().then(() => sock.resyncAppState([
+			"critical_unblock_low",
+			"regular_high",
+			"regular_low",
+			"regular"
+		], true)).catch((err) => inboundLogger.warn({ error: String(err) }, "whatsapp resyncAppState for contact import failed"));
+	}
 	return {
 		close: async () => {
 			try {
 				const ev = sock.ev;
 				const messagesUpsertHandler = handleMessagesUpsert;
 				const connectionUpdateHandler = handleConnectionUpdate;
+				const historyHandler = handleHistorySet;
+				const contactsHandler = handleContactsUpsert;
+				const chatsHandler = handleChatsUpsert;
+				const offImport = (fn) => {
+					fn("messaging-history.set", historyHandler);
+					fn("contacts.upsert", contactsHandler);
+					fn("chats.upsert", chatsHandler);
+				};
 				if (typeof ev.off === "function") {
 					ev.off("messages.upsert", messagesUpsertHandler);
 					ev.off("connection.update", connectionUpdateHandler);
+					if (importContactsEnabled) offImport(ev.off);
 				} else if (typeof ev.removeListener === "function") {
 					ev.removeListener("messages.upsert", messagesUpsertHandler);
 					ev.removeListener("connection.update", connectionUpdateHandler);
+					if (importContactsEnabled) offImport(ev.removeListener);
 				}
 				sock.ws?.close();
 			} catch (err) {
@@ -116369,6 +116497,9 @@ var init_monitor$1 = __esmMin((() => {
 	init_store$2();
 	init_hook_runner_global();
 	init_utils$2();
+	init_config$4();
+	init_message_ledger();
+	init_history_import();
 	init_session();
 	init_access_control();
 	init_dedupe();

package/dist/bundled/kg-message-sync/handler.js

@@ -2533,7 +2533,7 @@ var init_shell_env = __esmMin((() => {
 //#region src/version.ts
 var VERSION;
 var init_version$1 = __esmMin((() => {
-	VERSION = "2026.6.13-dev.20260616005057";
+	VERSION = "2026.6.14-dev";
 }));
 //#endregion
 //#region src/routing/session-key.ts
@@ -7959,7 +7959,8 @@ var init_zod_schema = __esmMin((() => {
 			channelHealthCheckMinutes: z.number().int().min(0).optional(),
 			messageLedger: z.object({
 				enabled: z.boolean().optional(),
-				dbPath: z.string().optional()
+				dbPath: z.string().optional(),
+				importContacts: z.boolean().optional()
 			}).strict().optional(),
 			memorySync: z.object({ enabled: z.boolean().optional() }).strict().optional(),
 			personalAgentObservations: z.object({

package/dist/{call-D6dWC0ix.js → call-BH1OgnGt.js}

@@ -1,7 +1,7 @@
 import { c as resolveConfigPath, f as resolveGatewayPort, v as resolveStateDir } from "./paths-Ce170Tex.js";
 import { S as shortenHomeInString, b as resolveUserPath, c as ensureDir, t as CONFIG_DIR } from "./utils-DsgtGH3c.js";
-import { i as loadConfig } from "./io-D-A50eEY.js";
-import "./config-BuakXn6K.js";
+import { i as loadConfig } from "./io-DWhsHb_h.js";
+import "./config-CJnHZ6tT.js";
 import { n as pickPrimaryTailnetIPv4 } from "./tailnet-C0DLwT7t.js";
 import { l as pickPrimaryLanIPv4 } from "./ws-D1BO6u3O.js";
 import { h as GATEWAY_CLIENT_NAMES, m as GATEWAY_CLIENT_MODES } from "./message-channel-_gH8UHtd.js";

package/dist/{call-CYh-D_wt.js → call-DaiN21tT.js}

@@ -1,7 +1,7 @@
 import { c as resolveConfigPath, f as resolveGatewayPort, v as resolveStateDir } from "./paths-aEg9UgoF.js";
 import { H as CONFIG_DIR, J as ensureDir, at as shortenHomeInString, rt as resolveUserPath } from "./entry.js";
-import { i as loadConfig } from "./io-CVtEEw15.js";
-import "./config-LTmlN5Qb.js";
+import { i as loadConfig } from "./io-D2T0KwYe.js";
+import "./config-ULIrsUrF.js";
 import { Kt as loadOrCreateDeviceIdentity, Wt as normalizeFingerprint, t as GatewayClient } from "./client-DaLwaG9G.js";
 import { n as pickPrimaryTailnetIPv4 } from "./tailnet-C0DLwT7t.js";
 import { h as GATEWAY_CLIENT_NAMES, m as GATEWAY_CLIENT_MODES } from "./message-channel-C02KGm4w.js";

package/dist/{call-CxVJ6r_M.js → call-lVSGXvNm.js}

@@ -1,6 +1,6 @@
 import { F as shortenHomeInString, N as resolveUserPath, S as CONFIG_DIR, T as ensureDir$1, at as resolveConfigPath, st as resolveGatewayPort, ut as resolveStateDir } from "./subsystem-Bz8lTz2g.js";
 import { a as logError, i as logDebug } from "./exec-DWwKe_AW.js";
-import { n as loadConfig } from "./config-CC7cX9PE.js";
+import { n as loadConfig } from "./config-Bad23vig.js";
 import { h as GATEWAY_CLIENT_NAMES, m as GATEWAY_CLIENT_MODES, p as GATEWAY_CLIENT_IDS, t as INPUT_PROVENANCE_KIND_VALUES } from "./input-provenance-BUf7opno.js";
 import { a as pickPrimaryLanIPv4, o as pickPrimaryTailnetIPv4, t as rawDataToString } from "./ws-ue1BYjxz.js";
 import path from "node:path";

package/dist/canvas-host/a2ui/.bundle.hash

@@ -1 +1 @@
-d7449df5742427d0b200000bb764ada7b871593f211d28faa2c3c7e0a65cae0b
+350aea2d8d97396fae07adf96f8f98b2a19c6ef8ee41c654d914d7d488267c69

package/dist/{canvas-tool-D7KYTzsF.js → canvas-tool-BCySjCkU.js}

@@ -1,8 +1,8 @@
 import { d as imageMimeFromFormat } from "./image-ops-QvmG4zb9.js";
 import { i as resolveImageSanitizationLimits } from "./tool-images-BeP6oYp4.js";
 import { i as jsonResult, n as imageResult, s as readStringParam } from "./common-BHzo6lXS.js";
-import { n as readGatewayCallOptions, t as callGatewayTool } from "./gateway-DAjyboqT.js";
-import { n as resolveNodeId } from "./nodes-utils-DSvzVR8T.js";
+import { n as readGatewayCallOptions, t as callGatewayTool } from "./gateway-CzCJQJHj.js";
+import { n as resolveNodeId } from "./nodes-utils-ESP44qeB.js";
 import { i as stringEnum, r as optionalStringEnum } from "./typebox-BbVstVJp.js";
 import { i as writeBase64ToFile } from "./nodes-camera-D9xN7NhX.js";
 import { n as parseCanvasSnapshotPayload, t as canvasSnapshotTempPath } from "./nodes-canvas-3iYablGd.js";

package/dist/{canvas-tool-BBPLEYfd.js → canvas-tool-b9umP1PL.js}

@@ -1,8 +1,8 @@
 import { d as imageMimeFromFormat } from "./image-ops-BGSWtWRb.js";
 import { i as resolveImageSanitizationLimits } from "./tool-images-QJzlaPLn.js";
 import { i as jsonResult, n as imageResult, s as readStringParam } from "./common-CRD8HhuP.js";
-import { n as readGatewayCallOptions, t as callGatewayTool } from "./gateway-D8CGtxOO.js";
-import { n as resolveNodeId } from "./nodes-utils-BJoSjLjl.js";
+import { n as readGatewayCallOptions, t as callGatewayTool } from "./gateway-CHsNxUxJ.js";
+import { n as resolveNodeId } from "./nodes-utils-DnVqS0gT.js";
 import { i as stringEnum, r as optionalStringEnum } from "./typebox-BbVstVJp.js";
 import { i as writeBase64ToFile } from "./nodes-camera-BwnQZUse.js";
 import { n as parseCanvasSnapshotPayload, t as canvasSnapshotTempPath } from "./nodes-canvas-BzP5Wb0Z.js";

package/dist/{channel-options-ULpXvAFC.js → channel-options-BhSTHUdE.js}

@@ -1,7 +1,7 @@
 import { S as CHAT_CHANNEL_ORDER, n as isTruthyEnvValue } from "./entry.js";
 import { n as listChannelPlugins } from "./plugins-irMKpl65.js";
 import { r as listChannelPluginCatalogEntries } from "./catalog-DKtdSX5i.js";
-import { t as ensurePluginRegistryLoaded } from "./plugin-registry-5E05Vw-j.js";
+import { t as ensurePluginRegistryLoaded } from "./plugin-registry-C7Y1ktn8.js";
 //#region src/cli/channel-options.ts
 function dedupe(values) {
 	const seen = /* @__PURE__ */ new Set();

package/dist/{channel-options-Bx9eGkuS.js → channel-options-ZnqM-XwR.js}

@@ -2,7 +2,7 @@ import { f as CHAT_CHANNEL_ORDER } from "./subsystem-Cnn1-kOi.js";
 import { t as isTruthyEnvValue } from "./env-Ceu1fF46.js";
 import { n as listChannelPlugins } from "./plugins-DQY2DPZw.js";
 import { r as listChannelPluginCatalogEntries } from "./catalog-gQ7yZnqz.js";
-import { t as ensurePluginRegistryLoaded } from "./plugin-registry-AV888_M1.js";
+import { t as ensurePluginRegistryLoaded } from "./plugin-registry-DG11DxET.js";
 //#region src/cli/channel-options.ts
 function dedupe(values) {
 	const seen = /* @__PURE__ */ new Set();

package/dist/{channel-web-B_kMFvFL.js → channel-web-mnjuaCAM.js}

@@ -1,16 +1,16 @@
 import { v as resolveStateDir } from "./paths-Ce170Tex.js";
 import { E as toWhatsappJid, F as shouldLogVerbose, L as getChildLogger, M as logVerbose, V as toPinoLikeLogger, b as resolveUserPath, c as ensureDir, h as normalizeE164, l as escapeRegExp, m as jidToE164, p as isSelfChatMode, r as clamp, w as sleep, y as resolveJidToE164 } from "./utils-DsgtGH3c.js";
-import { A as parseActivationCommand, Ar as normalizeMediaAttachments, Bn as normalizeMentionText, Cn as sanitizeOutboundText, Dn as resolveInboundDebounceMs, En as createInboundDebouncer, Fn as shouldComputeCommandAuthorized, Fr as registerUnhandledRejectionHandler, Kr as finalizeInboundContext, Mr as isAudioAttachment, Nr as isImageAttachment, On as formatInboundEnvelope, Or as buildProviderRegistry, Pn as hasControlCommand, Tn as createDedupeCache, _n as record, jr as runCapability, k as normalizeGroupActivation, kn as resolveEnvelopeFormatOptions, kr as createMediaAttachmentCache, nr as resolveAckReaction, or as resolveIdentityNamePrefix, sr as resolveMessagePrefix, t as getReplyFromConfig, un as buildPairingReply, vn as shouldAckReactionForWhatsApp, wr as enqueueSystemEvent, yn as dispatchReplyWithBufferedBlockDispatcher, zn as buildMentionRegexes } from "./reply-Dqrd2V9O.js";
+import { A as parseActivationCommand, Ar as normalizeMediaAttachments, Bn as normalizeMentionText, Cn as sanitizeOutboundText, Dn as resolveInboundDebounceMs, En as createInboundDebouncer, Fn as shouldComputeCommandAuthorized, Fr as registerUnhandledRejectionHandler, Kr as finalizeInboundContext, Mr as isAudioAttachment, Nr as isImageAttachment, On as formatInboundEnvelope, Or as buildProviderRegistry, Pn as hasControlCommand, Tn as createDedupeCache, _n as record, jr as runCapability, k as normalizeGroupActivation, kn as resolveEnvelopeFormatOptions, kr as createMediaAttachmentCache, nr as resolveAckReaction, or as resolveIdentityNamePrefix, sr as resolveMessagePrefix, t as getReplyFromConfig, un as buildPairingReply, vn as shouldAckReactionForWhatsApp, wr as enqueueSystemEvent, yn as dispatchReplyWithBufferedBlockDispatcher, zn as buildMentionRegexes } from "./reply-D0CQyMj1.js";
 import { F as triggerInternalHook, G as isInstantCommand, N as createInternalHookEvent, t as createSubsystemLogger } from "./subsystem-Cnn1-kOi.js";
 import { t as defaultRuntime } from "./runtime-Da615Z-K.js";
 import { i as buildAgentMainSessionKey, l as normalizeAgentId, o as buildGroupHistoryKey, r as DEFAULT_MAIN_KEY, t as DEFAULT_ACCOUNT_ID } from "./session-key-BcXqsG0l.js";
 import "./exec-ByW9LeFK.js";
 import { i as resolveAgentDir, l as resolveAgentWorkspaceDir, u as resolveDefaultAgentId } from "./agent-scope-D_1ZJVsc.js";
 import { t as formatCliCommand } from "./command-format-slIqNG4J.js";
-import { S as VERSION, i as loadConfig } from "./io-D-A50eEY.js";
-import "./config-BuakXn6K.js";
+import { S as VERSION, i as loadConfig } from "./io-DWhsHb_h.js";
+import "./config-CJnHZ6tT.js";
 import { c as resolveWhatsAppAccount, d as readCredsJsonRaw, f as readWebSelfId, h as resolveWebCredsPath, l as getWebAuthAgeMs, m as resolveWebCredsBackupPath, p as resolveDefaultWebAuthDir, u as maybeRestoreCredsFromBackup } from "./plugins-DQY2DPZw.js";
-import { K as resolveChannelGroupPolicy, X as resolveGroupSessionKey, a as loadSessionStore, l as updateLastRoute, o as readSessionUpdatedAt, q as resolveChannelGroupRequireMention, s as recordSessionMetaFromInbound } from "./sessions-C1gkxVIX.js";
+import { K as resolveChannelGroupPolicy, X as resolveGroupSessionKey, a as loadSessionStore, l as updateLastRoute, o as readSessionUpdatedAt, q as resolveChannelGroupRequireMention, s as recordSessionMetaFromInbound } from "./sessions-DYp3Y72l.js";
 import { r as require_tool_display } from "./tool-display-ByuoRPis.js";
 import { r as saveMediaBuffer } from "./store-BNyzv0EM.js";
 import "./logging-BlQyBIpf.js";
@@ -18,8 +18,8 @@ import { c as resolveStorePath } from "./paths-Ds2czhyU.js";
 import { n as loadWebMedia, r as getAgentScopedMediaLocalRoots } from "./load-COfKYLII.js";
 import "./tokens-DRSqc0S5.js";
 import "./lanes-D8quZPN3.js";
-import { c as resolveAgentRoute, s as buildAgentSessionKey } from "./targets-CHPM-77r.js";
-import { g as getGlobalHookRunner } from "./reply-payloads-COhF33IG.js";
+import { c as resolveAgentRoute, s as buildAgentSessionKey } from "./targets-ClLWbDD3.js";
+import { g as getGlobalHookRunner } from "./reply-payloads-CSe-fnoQ.js";
 import { a as traceGatewayEvent, i as traceChatEvent, r as traceChannelEvent, t as deriveTraceId } from "./chat-trace-B7hAMbQe.js";
 import { c as chunkMarkdownTextWithMode, d as resolveChunkMode, f as resolveTextChunkLimit, i as resolveMarkdownTableMode } from "./ir-BymCrWXa.js";
 import { n as recordChannelActivity } from "./channel-activity-mLVM0GeJ.js";
@@ -28,7 +28,7 @@ import { i as readChannelAllowFromStore, o as upsertChannelPairingRequest } from
 import { r as formatDurationPrecise } from "./format-duration-DxxnRZtB.js";
 import "./heartbeat-visibility-CCq47bb-.js";
 import { n as resolveDisclosureConfig, t as maybeInjectDisclosure } from "./ai-disclosure-CZzBEeaK.js";
-import { a as computeBackoff, i as recordPendingHistoryEntryIfEnabled, n as resolveChannelSenderIdentity, o as sleepWithAbort, r as buildHistoryContextFromEntries, t as createReplyPrefixOptions } from "./reply-prefix-CNleAyhT.js";
+import { a as computeBackoff, i as recordPendingHistoryEntryIfEnabled, n as resolveChannelSenderIdentity, o as sleepWithAbort, r as buildHistoryContextFromEntries, t as createReplyPrefixOptions } from "./reply-prefix-Dc5AW5Xm.js";
 import { n as toLocationContext, t as formatLocationText } from "./location-CeGoW_QS.js";
 import fs from "node:fs";
 import os from "node:os";
@@ -320,6 +320,10 @@ async function createWaSocket(printQr, verbose, opts = {}) {
 	maybeRestoreCredsFromBackup(authDir);
 	const { state, saveCreds } = await useMultiFileAuthState(authDir);
 	const { version } = await fetchLatestBaileysVersion();
+	let syncFullHistory = false;
+	try {
+		syncFullHistory = loadConfig().gateway?.messageLedger?.importContacts === true;
+	} catch {}
 	const sock = makeWASocket({
 		auth: {
 			creds: state.creds,
@@ -333,7 +337,7 @@ async function createWaSocket(printQr, verbose, opts = {}) {
 			"cli",
 			VERSION
 		],
-		syncFullHistory: false,
+		syncFullHistory,
 		markOnlineOnConnect: false
 	});
 	sock.ev.on("creds.update", () => enqueueSaveCreds(authDir, saveCreds, sessionLogger));
@@ -797,6 +801,75 @@ function fireInboundTriggerHook(event) {
 	})).catch(() => {});
 }
 //#endregion
+//#region src/web/inbound/history-import.ts
+/** Coerce a Baileys conversationTimestamp (number | Long-like) to ms, or null. */
+function tsToMs(value) {
+	if (typeof value === "number" && Number.isFinite(value)) return value * 1e3;
+	if (value && typeof value === "object" && typeof value.toNumber === "function") {
+		const n = value.toNumber();
+		return Number.isFinite(n) ? n * 1e3 : null;
+	}
+	return null;
+}
+function contactName(c) {
+	return (c.name || c.notify || c.verifiedName || c.username || "").trim() || void 0;
+}
+/**
+* Record one idempotent inbound shell row per importable 1:1 person, drawn from
+* the union of `contacts` and `chats`. Returns the number of distinct people
+* recorded this call.
+*/
+function importWhatsAppPeopleToLedger(args) {
+	const e164Of = (jid) => jid ? args.jidToE164(jid) : null;
+	const names = /* @__PURE__ */ new Map();
+	for (const c of args.contacts ?? []) {
+		const e164 = e164Of(c.phoneNumber) ?? e164Of(c.id);
+		if (!e164) continue;
+		const nm = contactName(c);
+		if (nm) names.set(e164, nm);
+	}
+	const people = /* @__PURE__ */ new Map();
+	const consider = (jid, explicitName, ts) => {
+		if (jid && args.isGroupJid(jid)) return;
+		const e164 = e164Of(jid);
+		if (!e164) return;
+		if (args.selfE164 && e164 === args.selfE164) return;
+		const name = explicitName || names.get(e164);
+		const cur = people.get(e164);
+		if (cur) {
+			if (!cur.name && name) cur.name = name;
+			if (cur.ts == null && ts != null) cur.ts = ts;
+		} else people.set(e164, {
+			name,
+			ts
+		});
+	};
+	for (const c of args.contacts ?? []) consider(c.phoneNumber || c.id, contactName(c), null);
+	for (const chat of args.chats ?? []) consider(chat.id, typeof chat.name === "string" ? chat.name.trim() : void 0, tsToMs(chat.conversationTimestamp));
+	let imported = 0;
+	for (const [e164, p] of people) {
+		args.record({
+			clientId: `wa-import:${args.accountId}:${e164}`,
+			direction: "inbound",
+			channel: "whatsapp",
+			accountId: args.accountId,
+			chatId: e164,
+			senderId: e164,
+			senderName: p.name,
+			isGroup: false,
+			isBot: false,
+			occurredAt: p.ts ?? args.now ?? Date.now(),
+			messageId: `wa-import:${e164}`,
+			metadata: {
+				imported: true,
+				source: "whatsapp-history"
+			}
+		});
+		imported++;
+	}
+	return { imported };
+}
+//#endregion
 //#region src/web/inbound/access-control.ts
 const PAIRING_REPLY_HISTORY_GRACE_MS = 3e4;
 async function checkInboundAccessControl(params) {
@@ -1356,18 +1429,69 @@ async function monitorWebInbox(options) {
 		}
 	};
 	sock.ev.on("connection.update", handleConnectionUpdate);
+	const importContactsEnabled = (() => {
+		try {
+			const cfg = loadConfig();
+			return cfg.gateway?.messageLedger?.enabled === true && cfg.gateway?.messageLedger?.importContacts === true;
+		} catch {
+			return false;
+		}
+	})();
+	const runImport = (label, payload) => {
+		try {
+			const { imported } = importWhatsAppPeopleToLedger({
+				chats: payload.chats ?? [],
+				contacts: payload.contacts ?? [],
+				accountId: options.accountId,
+				selfE164,
+				record,
+				jidToE164: (jid) => jidToE164(jid),
+				isGroupJid: (jid) => isJidGroup(jid) === true
+			});
+			if (imported > 0) inboundConsoleLog.info(`Imported ${imported} WhatsApp ${label} as CRM contact rows (account ${options.accountId})`);
+		} catch (err) {
+			inboundLogger.error({ error: String(err) }, "whatsapp contact import failed");
+		}
+	};
+	const handleHistorySet = (h) => runImport("history", {
+		chats: h.chats,
+		contacts: h.contacts
+	});
+	const handleContactsUpsert = (contacts) => runImport("contacts", { contacts });
+	const handleChatsUpsert = (chats) => runImport("chats", { chats });
+	if (importContactsEnabled) {
+		sock.ev.on("messaging-history.set", handleHistorySet);
+		sock.ev.on("contacts.upsert", handleContactsUpsert);
+		sock.ev.on("chats.upsert", handleChatsUpsert);
+		Promise.resolve().then(() => sock.resyncAppState([
+			"critical_unblock_low",
+			"regular_high",
+			"regular_low",
+			"regular"
+		], true)).catch((err) => inboundLogger.warn({ error: String(err) }, "whatsapp resyncAppState for contact import failed"));
+	}
 	return {
 		close: async () => {
 			try {
 				const ev = sock.ev;
 				const messagesUpsertHandler = handleMessagesUpsert;
 				const connectionUpdateHandler = handleConnectionUpdate;
+				const historyHandler = handleHistorySet;
+				const contactsHandler = handleContactsUpsert;
+				const chatsHandler = handleChatsUpsert;
+				const offImport = (fn) => {
+					fn("messaging-history.set", historyHandler);
+					fn("contacts.upsert", contactsHandler);
+					fn("chats.upsert", chatsHandler);
+				};
 				if (typeof ev.off === "function") {
 					ev.off("messages.upsert", messagesUpsertHandler);
 					ev.off("connection.update", connectionUpdateHandler);
+					if (importContactsEnabled) offImport(ev.off);
 				} else if (typeof ev.removeListener === "function") {
 					ev.removeListener("messages.upsert", messagesUpsertHandler);
 					ev.removeListener("connection.update", connectionUpdateHandler);
+					if (importContactsEnabled) offImport(ev.removeListener);
 				}
 				sock.ws?.close();
 			} catch (err) {

package/dist/{channels-cli-9_3iWykD.js → channels-cli-1YxtVy6F.js}

@@ -4,10 +4,10 @@ import { C as loadAuthProfileStore } from "./auth-profiles-CmddgW77.js";
 import { t as formatCliCommand } from "./command-format-D86vQ65E.js";
 import { s as normalizeAccountId$1 } from "./session-key-DK3D9dkE.js";
 import { l as resolveAgentWorkspaceDir, u as resolveDefaultAgentId } from "./agent-scope-BP7xXcTE.js";
-import { i as loadConfig, l as writeConfigFile, o as readConfigFileSnapshot } from "./io-CVtEEw15.js";
-import "./config-LTmlN5Qb.js";
-import { n as callGateway } from "./call-CYh-D_wt.js";
-import { Ct as formatUsageReportLines, St as loadProviderUsageSummary } from "./subagent-registry-CI2lz1B1.js";
+import { i as loadConfig, l as writeConfigFile, o as readConfigFileSnapshot } from "./io-D2T0KwYe.js";
+import "./config-ULIrsUrF.js";
+import { n as callGateway } from "./call-DaiN21tT.js";
+import { Ct as formatUsageReportLines, St as loadProviderUsageSummary } from "./subagent-registry-C4Xeveht.js";
 import { n as listChannelPlugins, r as normalizeChannelId, t as getChannelPlugin, u as resolveTelegramAccount } from "./plugins-irMKpl65.js";
 import "./logging-D43UWj1X.js";
 import { n as formatTimeAgo } from "./format-relative-Bjc3l98W.js";
@@ -18,18 +18,18 @@ import { t as formatHelpExamples } from "./help-format-ojnmvhbK.js";
 import { n as withProgress } from "./progress-aPiVORh8.js";
 import { n as resolveMessageChannelSelection } from "./channel-selection-Bzg2Xpo4.js";
 import { t as parseDiscordTarget } from "./targets-CWUrImUS.js";
-import { n as fetchChannelPermissionsDiscord } from "./send-BQPSwhBT.js";
+import { n as fetchChannelPermissionsDiscord } from "./send-Dy5OuEh7.js";
 import { t as hasExplicitOptions } from "./command-options-Dhjl7AMa.js";
 import { r as listChannelPluginCatalogEntries } from "./catalog-DKtdSX5i.js";
 import { t as createClackPrompter } from "./clack-prompter-Bv8LAi9a.js";
 import { t as resolveChannelDefaultAccountId } from "./helpers-HNAIOJ_3.js";
-import { i as reloadOnboardingPluginRegistry, n as setupChannels, r as ensureOnboardingPluginInstalled } from "./onboard-channels-6p1gbH80.js";
-import "./onboard-channels-rJhMZ8AM.js";
-import { t as requireValidConfigSnapshot } from "./config-validation-TmO1WOdo.js";
+import { i as reloadOnboardingPluginRegistry, n as setupChannels, r as ensureOnboardingPluginInstalled } from "./onboard-channels-CUT7TFAB.js";
+import "./onboard-channels-B1odq8Pa.js";
+import { t as requireValidConfigSnapshot } from "./config-validation-BKuA0mkd.js";
 import { t as buildChannelAccountSnapshot } from "./status-Dg720jp3.js";
 import { t as parseLogLine } from "./parse-log-line-CYJzHJac.js";
 import { t as collectChannelStatusIssues } from "./channels-status-issues-dgNXBa3W.js";
-import { t as formatCliChannelOptions } from "./channel-options-ULpXvAFC.js";
+import { t as formatCliChannelOptions } from "./channel-options-BhSTHUdE.js";
 import os from "node:os";
 import path from "node:path";
 import fs from "node:fs/promises";

package/dist/{channels-cli-BUo7AzlY.js → channels-cli-DRBRx9Nm.js}

@@ -1,18 +1,18 @@
 import { v as resolveStateDir } from "./paths-Ce170Tex.js";
 import { O as danger, P as setVerbose, f as isRecord, z as getResolvedLoggerSettings } from "./utils-DsgtGH3c.js";
 import { r as theme } from "./theme-CDbj88LB.js";
-import { M as formatUsageReportLines, j as loadProviderUsageSummary } from "./reply-Dqrd2V9O.js";
+import { M as formatUsageReportLines, j as loadProviderUsageSummary } from "./reply-D0CQyMj1.js";
 import "./subsystem-Cnn1-kOi.js";
 import { t as defaultRuntime } from "./runtime-Da615Z-K.js";
 import { c as normalizeAccountId$1 } from "./session-key-BcXqsG0l.js";
 import { l as resolveAgentWorkspaceDir, u as resolveDefaultAgentId } from "./agent-scope-D_1ZJVsc.js";
 import { Mt as loadAuthProfileStore } from "./model-selection-DXz1sR0t.js";
 import { t as formatCliCommand } from "./command-format-slIqNG4J.js";
-import { i as loadConfig, l as writeConfigFile, o as readConfigFileSnapshot } from "./io-D-A50eEY.js";
-import "./config-BuakXn6K.js";
+import { i as loadConfig, l as writeConfigFile, o as readConfigFileSnapshot } from "./io-DWhsHb_h.js";
+import "./config-CJnHZ6tT.js";
 import { _ as resolveTelegramAccount, n as listChannelPlugins, r as normalizeChannelId, t as getChannelPlugin } from "./plugins-DQY2DPZw.js";
 import "./logging-BlQyBIpf.js";
-import { n as callGateway } from "./call-D6dWC0ix.js";
+import { n as callGateway } from "./call-BH1OgnGt.js";
 import { n as formatTimeAgo } from "./format-relative-Bjc3l98W.js";
 import { t as formatDocsLink } from "./links-C1xb6h4b.js";
 import { n as runCommandWithRuntime } from "./cli-utils-Cg2c3XDf.js";
@@ -20,16 +20,16 @@ import { t as formatHelpExamples } from "./help-format-D20I7z1G.js";
 import { n as withProgress } from "./progress-8_pqhNaq.js";
 import { t as createSlackWebClient } from "./client-B0alQSqy.js";
 import { r as listChannelPluginCatalogEntries } from "./catalog-gQ7yZnqz.js";
-import { t as formatCliChannelOptions } from "./channel-options-Bx9eGkuS.js";
+import { t as formatCliChannelOptions } from "./channel-options-ZnqM-XwR.js";
 import { n as resolveMessageChannelSelection } from "./channel-selection-ERVd9FwM.js";
 import { t as parseDiscordTarget } from "./targets-xl8bNEbc.js";
-import { n as fetchChannelPermissionsDiscord } from "./send-z4xPCsJY.js";
+import { n as fetchChannelPermissionsDiscord } from "./send-CCuZYSz3.js";
 import { t as hasExplicitOptions } from "./command-options-Dhjl7AMa.js";
 import { t as createClackPrompter } from "./clack-prompter-BhwvSSDO.js";
 import { t as resolveChannelDefaultAccountId } from "./helpers-BcEbnHmz.js";
-import { i as reloadOnboardingPluginRegistry, n as setupChannels, r as ensureOnboardingPluginInstalled } from "./onboard-channels-CVnYH8gu.js";
-import "./onboard-channels-DCwvYauq.js";
-import { t as requireValidConfigSnapshot } from "./config-validation-DRKfuI2k.js";
+import { i as reloadOnboardingPluginRegistry, n as setupChannels, r as ensureOnboardingPluginInstalled } from "./onboard-channels-Bc0EWbkF.js";
+import "./onboard-channels-DOws7yCU.js";
+import { t as requireValidConfigSnapshot } from "./config-validation-UxIy2sWe.js";
 import { t as buildChannelAccountSnapshot } from "./status-Dg720jp3.js";
 import { t as parseLogLine } from "./parse-log-line-CYJzHJac.js";
 import { t as collectChannelStatusIssues } from "./channels-status-issues-YebWHOdm.js";

package/dist/{chrome-DfAapwDD.js → chrome-CZH2epNE.js}

@@ -1,6 +1,6 @@
 import { S as CONFIG_DIR, t as createSubsystemLogger } from "./subsystem-Bz8lTz2g.js";
 import "./exec-DWwKe_AW.js";
-import { n as loadConfig } from "./config-CC7cX9PE.js";
+import { n as loadConfig } from "./config-Bad23vig.js";
 import { r as isErrno } from "./errors-DInjg6Ku.js";
 import { i as isPrivateOrLoopbackAddress, n as isLoopbackAddress, r as isLoopbackHost, t as rawDataToString } from "./ws-ue1BYjxz.js";
 import path from "node:path";

package/dist/{chrome-4OyRismj.js → chrome-CayJQXHk.js}

@@ -1,7 +1,7 @@
 import { t as CONFIG_DIR } from "./utils-DsgtGH3c.js";
 import { t as createSubsystemLogger } from "./subsystem-Cnn1-kOi.js";
-import { i as loadConfig } from "./io-D-A50eEY.js";
-import "./config-BuakXn6K.js";
+import { i as loadConfig } from "./io-DWhsHb_h.js";
+import "./config-CJnHZ6tT.js";
 import { i as isPrivateOrLoopbackAddress, n as isLoopbackAddress, r as isLoopbackHost, t as rawDataToString } from "./ws-D1BO6u3O.js";
 import { r as ensurePortAvailable } from "./ports-Cwx06Uji.js";
 import fs from "node:fs";

package/dist/{chrome-CdpueVZf.js → chrome-Kb-zN-1U.js}

@@ -1,6 +1,6 @@
 import { H as CONFIG_DIR, o as createSubsystemLogger } from "./entry.js";
-import { i as loadConfig } from "./io-CVtEEw15.js";
-import "./config-LTmlN5Qb.js";
+import { i as loadConfig } from "./io-D2T0KwYe.js";
+import "./config-ULIrsUrF.js";
 import { n as isLoopbackHost, p as rawDataToString, r as isPrivateOrLoopbackAddress, t as isLoopbackAddress } from "./net-C0W-QK7p.js";
 import { t as ensurePortAvailable } from "./ports-CWP9QmS6.js";
 import { execFileSync, spawn } from "node:child_process";

package/dist/{clawbot-cli-DukEajNp.js → clawbot-cli-C5wgbNjN.js}

@@ -1,4 +1,4 @@
-import { registerQrCli } from "./qr-cli-D9TLooTU.js";
+import { registerQrCli } from "./qr-cli-CNBJBiSg.js";
 //#region src/cli/clawbot-cli.ts
 function registerClawbotCli(program) {
 	registerQrCli(program.command("clawbot").description("Legacy clawbot command aliases"));