@nikolasp98/minion 2026.7.19-dev.20260719203321 → 2026.7.19-dev.20260720032847

package/dist/plugin-sdk/index.js

@@ -7430,7 +7430,7 @@ var init_shell_env = __esmMin((() => {
 //#region src/version.ts
 var VERSION;
 var init_version$1 = __esmMin((() => {
-	VERSION = "2026.7.19-dev.20260719203321";
+	VERSION = "2026.7.19-dev.20260720032847";
 }));
 //#endregion
 //#region src/config/agent-dirs.ts
@@ -135687,6 +135687,90 @@ function historyMessageToLedgerRow(msg, ctx) {
 	};
 }
 //#endregion
+//#region src/web/inbound/history-sync.ts
+/**
+* WhatsApp history-sync progress: a pure reducer over the two Baileys events
+* that carry it (`messaging-history.set` chunks and `messaging-history.status`
+* milestones), plus our own on-demand backfill paginator counters.
+*
+* Pure on purpose: the socket wiring in ./monitor.ts is untestable, the phase
+* logic is where every trap lives (see the notes on each rule below).
+*/
+/** proto.HistorySync.HistorySyncType (baileys 7.0.0-rc11). */
+const HISTORY_SYNC_TYPE = {
+	INITIAL_BOOTSTRAP: 0,
+	INITIAL_STATUS_V3: 1,
+	FULL: 2,
+	RECENT: 3,
+	PUSH_NAME: 4,
+	NON_BLOCKING_DATA: 5,
+	ON_DEMAND: 6
+};
+function initialHistorySync(now = Date.now()) {
+	return {
+		phase: "idle",
+		progress: null,
+		explicit: false,
+		messages: 0,
+		chats: 0,
+		startedAt: null,
+		updatedAt: now
+	};
+}
+function phaseForSyncType(syncType) {
+	switch (syncType) {
+		case HISTORY_SYNC_TYPE.INITIAL_BOOTSTRAP:
+		case HISTORY_SYNC_TYPE.INITIAL_STATUS_V3: return "bootstrap";
+		case HISTORY_SYNC_TYPE.RECENT: return "recent";
+		case HISTORY_SYNC_TYPE.FULL: return "full";
+		case HISTORY_SYNC_TYPE.ON_DEMAND: return "on-demand";
+		default: return null;
+	}
+}
+function reduceHistorySync(state, event, now = Date.now()) {
+	const next = {
+		...state,
+		updatedAt: now
+	};
+	if (event.kind === "chunk") {
+		next.messages += event.messages ?? 0;
+		next.chats += event.chats ?? 0;
+		if (next.startedAt == null) next.startedAt = now;
+		if (event.progress != null) next.progress = event.progress;
+		const phase = phaseForSyncType(event.syncType);
+		if (phase) next.phase = phase;
+		else if (state.phase === "stalled" || state.phase === "idle") next.phase = "recent";
+		if (state.phase === "stalled" || state.phase === "complete") next.explicit = false;
+		return next;
+	}
+	if (event.kind === "status") {
+		next.explicit = event.explicit;
+		if (event.status === "paused") {
+			next.phase = "stalled";
+			return next;
+		}
+		if (event.syncType === HISTORY_SYNC_TYPE.INITIAL_BOOTSTRAP) {
+			next.phase = "bootstrap";
+			return next;
+		}
+		next.phase = "complete";
+		if (event.explicit) next.progress = 100;
+		return next;
+	}
+	next.backfill = {
+		requests: event.requests,
+		cap: event.cap,
+		complete: event.complete
+	};
+	if (event.complete) {
+		if (state.phase === "on-demand") {
+			next.phase = "complete";
+			next.explicit = false;
+		}
+	} else if (state.phase === "idle" || state.phase === "complete") next.phase = "on-demand";
+	return next;
+}
+//#endregion
 //#region src/web/inbound/media.ts
 init_globals();
 function unwrapMessage(message) {
@@ -136218,6 +136302,17 @@ async function monitorWebInbox(options) {
 	let lastCursorTs = Number.POSITIVE_INFINITY;
 	const BACKFILL_BATCH = 50;
 	const BACKFILL_MAX_REQUESTS = 60;
+	let historySync = initialHistorySync();
+	const pushHistorySync = (event) => {
+		historySync = reduceHistorySync(historySync, event);
+		options.onHistorySync?.(historySync);
+	};
+	const pushBackfillStatus = (complete) => pushHistorySync({
+		kind: "backfill",
+		requests: backfillRequests,
+		cap: BACKFILL_MAX_REQUESTS,
+		complete
+	});
 	const recordHistoryMessages = (messages) => {
 		if (!messages?.length) return;
 		let recorded = 0;
@@ -136240,7 +136335,11 @@ async function monitorWebInbox(options) {
 		backfillTimer = setTimeout(() => void backfillTick(), delayMs);
 	};
 	const backfillTick = async () => {
-		if (!backfillMessagesEnabled || backfillRequests >= BACKFILL_MAX_REQUESTS) return;
+		if (!backfillMessagesEnabled) return;
+		if (backfillRequests >= BACKFILL_MAX_REQUESTS) {
+			pushBackfillStatus(true);
+			return;
+		}
 		if (!backfillOldest) {
 			scheduleBackfillTick(6e3);
 			return;
@@ -136248,11 +136347,13 @@ async function monitorWebInbox(options) {
 		if (backfillOldest.ts >= lastCursorTs) {
 			if (++backfillStableRounds >= 2) {
 				inboundConsoleLog.info(`WhatsApp history backfill complete (account ${options.accountId}, ${backfillRequests} requests)`);
+				pushBackfillStatus(true);
 				return;
 			}
 		} else backfillStableRounds = 0;
 		lastCursorTs = backfillOldest.ts;
 		backfillRequests += 1;
+		pushBackfillStatus(false);
 		try {
 			await sock.fetchMessageHistory(BACKFILL_BATCH, backfillOldest.key, backfillOldest.ts);
 		} catch (err) {
@@ -136261,16 +136362,32 @@ async function monitorWebInbox(options) {
 		scheduleBackfillTick(4e3);
 	};
 	const handleHistorySet = (h) => {
+		pushHistorySync({
+			kind: "chunk",
+			syncType: h.syncType,
+			progress: h.progress,
+			messages: h.messages?.length ?? 0,
+			chats: h.chats?.length ?? 0
+		});
 		if (importContactsEnabled) runImport("history", {
 			chats: h.chats,
 			contacts: h.contacts
 		});
 		if (backfillMessagesEnabled) recordHistoryMessages(h.messages);
 	};
+	const handleHistoryStatus = (s) => {
+		pushHistorySync({
+			kind: "status",
+			syncType: Number(s.syncType),
+			status: s.status,
+			explicit: s.explicit
+		});
+	};
 	const handleContactsUpsert = (contacts) => runImport("contacts", { contacts });
 	const handleChatsUpsert = (chats) => runImport("chats", { chats });
+	sock.ev.on("messaging-history.set", handleHistorySet);
+	sock.ev.on("messaging-history.status", handleHistoryStatus);
 	if (importContactsEnabled || backfillMessagesEnabled) {
-		sock.ev.on("messaging-history.set", handleHistorySet);
 		if (importContactsEnabled) {
 			sock.ev.on("contacts.upsert", handleContactsUpsert);
 			sock.ev.on("chats.upsert", handleChatsUpsert);
@@ -136294,10 +136411,12 @@ async function monitorWebInbox(options) {
 				const messagesUpsertHandler = handleMessagesUpsert;
 				const connectionUpdateHandler = handleConnectionUpdate;
 				const historyHandler = handleHistorySet;
+				const historyStatusHandler = handleHistoryStatus;
 				const contactsHandler = handleContactsUpsert;
 				const chatsHandler = handleChatsUpsert;
 				const offImport = (fn) => {
-					if (importContactsEnabled || backfillMessagesEnabled) fn("messaging-history.set", historyHandler);
+					fn("messaging-history.set", historyHandler);
+					fn("messaging-history.status", historyStatusHandler);
 					if (importContactsEnabled) {
 						fn("contacts.upsert", contactsHandler);
 						fn("chats.upsert", chatsHandler);
@@ -138369,6 +138488,10 @@ async function monitorWebChannel(verbose, listenerFactory = monitorWebInbox, kee
 			markOnline: account.markOnline,
 			debounceMs: inboundDebounceMs,
 			shouldDebounce,
+			onHistorySync: (historySync) => {
+				status.historySync = historySync;
+				emitStatus();
+			},
 			onMessage: async (msg) => {
 				handledMessages += 1;
 				lastMessageAt = Date.now();

package/dist/plugin-sdk/web/auto-reply/types.d.ts

@@ -1,4 +1,5 @@
 import type { monitorWebInbox } from "../inbound.js";
+import type { HistorySyncState } from "../inbound/history-sync.js";
 import type { ReconnectPolicy } from "../reconnect.js";
 export type WebInboundMsg = Parameters<typeof monitorWebInbox>[0]["onMessage"] extends (msg: infer M) => unknown ? M : never;
 export type WebChannelStatus = {
@@ -15,6 +16,8 @@ export type WebChannelStatus = {
     lastMessageAt?: number | null;
     lastEventAt?: number | null;
     lastError?: string | null;
+    /** WhatsApp history-sync progress for this connection (absent = never reported). */
+    historySync?: HistorySyncState;
 };
 export type WebMonitorTuning = {
     reconnect?: Partial<ReconnectPolicy>;

package/dist/plugin-sdk/web/inbound/history-sync.d.ts

@@ -0,0 +1,61 @@
+/**
+ * WhatsApp history-sync progress: a pure reducer over the two Baileys events
+ * that carry it (`messaging-history.set` chunks and `messaging-history.status`
+ * milestones), plus our own on-demand backfill paginator counters.
+ *
+ * Pure on purpose: the socket wiring in ./monitor.ts is untestable, the phase
+ * logic is where every trap lives (see the notes on each rule below).
+ */
+/** proto.HistorySync.HistorySyncType (baileys 7.0.0-rc11). */
+export declare const HISTORY_SYNC_TYPE: {
+    readonly INITIAL_BOOTSTRAP: 0;
+    readonly INITIAL_STATUS_V3: 1;
+    readonly FULL: 2;
+    readonly RECENT: 3;
+    readonly PUSH_NAME: 4;
+    readonly NON_BLOCKING_DATA: 5;
+    readonly ON_DEMAND: 6;
+};
+export type HistorySyncPhase = "idle" | "bootstrap" | "recent" | "full" | "on-demand" | "complete" | "stalled";
+export type HistorySyncState = {
+    phase: HistorySyncPhase;
+    /** 0-100, or null when unknown → the UI must render indeterminate, never a fake fill. */
+    progress: number | null;
+    /** false = the completion/stall was inferred from silence, not reported by the server. */
+    explicit: boolean;
+    /** Cumulative for this gateway session (state is per-connection; WhatsApp does not replay history). */
+    messages: number;
+    chats: number;
+    backfill?: {
+        requests: number;
+        cap: number;
+        complete: boolean;
+    };
+    startedAt: number | null;
+    updatedAt: number;
+};
+export type HistorySyncEvent = 
+/** `messaging-history.set` — a chunk landed. */
+{
+    kind: "chunk";
+    syncType?: number | null;
+    progress?: number | null;
+    messages?: number;
+    chats?: number;
+}
+/** `messaging-history.status` — a milestone (or a 120s stall). */
+ | {
+    kind: "status";
+    syncType: number;
+    status: "complete" | "paused";
+    explicit: boolean;
+}
+/** Our own fetchMessageHistory paginator. */
+ | {
+    kind: "backfill";
+    requests: number;
+    cap: number;
+    complete: boolean;
+};
+export declare function initialHistorySync(now?: number): HistorySyncState;
+export declare function reduceHistorySync(state: HistorySyncState, event: HistorySyncEvent, now?: number): HistorySyncState;

package/dist/plugin-sdk/web/inbound/monitor.d.ts

@@ -1,3 +1,4 @@
+import { type HistorySyncState } from "./history-sync.js";
 import type { WebInboundMessage, WebListenerCloseReason } from "./types.js";
 export declare function monitorWebInbox(options: {
     verbose: boolean;
@@ -14,6 +15,8 @@ export declare function monitorWebInbox(options: {
     debounceMs?: number;
     /** Optional debounce gating predicate. */
     shouldDebounce?: (msg: WebInboundMessage) => boolean;
+    /** Called on every history-sync milestone/chunk with the latest snapshot. */
+    onHistorySync?: (state: HistorySyncState) => void;
 }): Promise<{
     readonly sendMessage: (to: string, text: string, mediaBuffer?: Buffer, mediaType?: string, sendOptions?: import("../active-listener.ts").ActiveWebSendOptions) => Promise<{
         messageId: string;

package/dist/{plugins-DLX5z0yZ.js → plugins-BMGDdQTP.js}

@@ -6,7 +6,7 @@ import "./runtime-Da615Z-K.js";
 import { c as normalizeAccountId, l as normalizeAgentId, t as DEFAULT_ACCOUNT_ID } from "./session-key-BcXqsG0l.js";
 import { u as resolveDefaultAgentId } from "./agent-scope-C31m2EYG.js";
 import { t as isTruthyEnvValue } from "./env-IZo5oHSI.js";
-import { i as loadConfig } from "./io-DdigNnzZ.js";
+import { i as loadConfig } from "./io-DDnUNk2G.js";
 import "./logging-_oKeHe0e.js";
 import fs from "node:fs";
 import path from "node:path";

package/dist/{plugins-Bkzc_vY_.js → plugins-DZlYf88C.js}

@@ -6,7 +6,7 @@ import "./runtime-Da615Z-K.js";
 import { n as isTruthyEnvValue } from "./entry.js";
 import { c as normalizeAgentId, s as normalizeAccountId, t as DEFAULT_ACCOUNT_ID } from "./session-key-DK3D9dkE.js";
 import { u as resolveDefaultAgentId } from "./agent-scope-Bg7gbuMz.js";
-import { i as loadConfig } from "./io-Bv4JCxeO.js";
+import { i as loadConfig } from "./io-B709DBGS.js";
 import "./logging-CyBpyZLp.js";
 import path from "node:path";
 import fs from "node:fs";

package/dist/{plugins-cli-DN0qkZdj.js → plugins-cli--zzna96C.js}

@@ -2,15 +2,15 @@ import { v as resolveStateDir } from "./paths-CoM-oAkW.js";
 import { C as shortenHomePath, S as shortenHomeInString, _ as resolveConfigDir, b as resolveUserPath } from "./utils-FhRSYjMj.js";
 import { r as theme } from "./theme-CDbj88LB.js";
 import { t as defaultRuntime } from "./runtime-Da615Z-K.js";
-import { i as loadConfig, l as writeConfigFile } from "./io-DdigNnzZ.js";
+import { i as loadConfig, l as writeConfigFile } from "./io-DDnUNk2G.js";
 import { m as defaultSlotIdForKey, p as applyExclusiveSlotSelection, s as resolveBundledPluginsDir, t as clearPluginManifestRegistryCache } from "./manifest-registry-BhQtdshS.js";
-import "./config-Bi4Ie6Tc.js";
+import "./config-CzUDtFkM.js";
 import { d as promptYesNo } from "./tailscale-ElLAPnGH.js";
 import { t as formatDocsLink } from "./links-XaZTa0pi.js";
 import { c as resolveArchiveKind } from "./install-safe-path-Exhg8YNu.js";
 import { i as resolvePluginInstallDir, n as installPluginFromNpmSpec, r as installPluginFromPath, t as recordPluginInstall } from "./installs-4MZCqIYC.js";
 import { t as renderTable } from "./table-DhL6PA7F.js";
-import { t as buildPluginStatusReport } from "./status-DACkUn9-.js";
+import { t as buildPluginStatusReport } from "./status-BU_dK9bN.js";
 import { n as updateNpmInstalledPlugins } from "./update-BwKC0Los.js";
 import fs from "node:fs";
 import os from "node:os";

package/dist/{plugins-cli-BRIFVX9h.js → plugins-cli-Bdk4hq3l.js}

@@ -3,14 +3,14 @@ import { g as resolveUserPath, m as resolveConfigDir, v as shortenHomeInString,
 import { r as theme } from "./theme-CDbj88LB.js";
 import { t as defaultRuntime } from "./runtime-Da615Z-K.js";
 import { m as defaultSlotIdForKey, p as applyExclusiveSlotSelection, s as resolveBundledPluginsDir, t as clearPluginManifestRegistryCache } from "./manifest-registry-ByjgBm6U.js";
-import { i as loadConfig, l as writeConfigFile } from "./io-Bv4JCxeO.js";
-import "./config-DQL_3nup.js";
+import { i as loadConfig, l as writeConfigFile } from "./io-B709DBGS.js";
+import "./config-B63j_7We.js";
 import { u as promptYesNo } from "./tailscale-DdVOGsI9.js";
 import { t as formatDocsLink } from "./links-snWstk4Z.js";
 import { c as resolveArchiveKind } from "./install-safe-path-Cm0MRa5U.js";
 import { i as resolvePluginInstallDir, n as installPluginFromNpmSpec, r as installPluginFromPath, t as recordPluginInstall } from "./installs-WGfBNsiV.js";
 import { t as renderTable } from "./table-BvCO-EDN.js";
-import { t as buildPluginStatusReport } from "./status-DXRDTPVw.js";
+import { t as buildPluginStatusReport } from "./status-9OUW-F-m.js";
 import { n as updateNpmInstalledPlugins } from "./update-9t5S0PsI.js";
 import os from "node:os";
 import path from "node:path";

package/dist/{plugins-pvn2g_yZ.js → plugins-j4H8PRaP.js}

@@ -1,7 +1,7 @@
 import { A as normalizeE164, N as resolveUserPath, d as normalizeChatChannelId, l as normalizeAnyChannelId, lt as resolveOAuthDir, p as requireActivePluginRegistry, s as CHAT_CHANNEL_ORDER, t as createSubsystemLogger } from "./subsystem-DRI1a_Xn.js";
 import { F as normalizeAccountId, I as normalizeAgentId, k as DEFAULT_ACCOUNT_ID, l as resolveDefaultAgentId } from "./agent-scope-Cpl7TgWW.js";
 import { rt as isTruthyEnvValue } from "./model-selection-DwJwoDl4.js";
-import "./io-hXRmPBqb.js";
+import "./io-QYIZW5MZ.js";
 import path from "node:path";
 import fs from "node:fs";
 import "node:fs/promises";

package/dist/{program-CjOUePkz.js → program-BGLpZD7k.js}

@@ -3,14 +3,14 @@ import { n as isRich, r as theme } from "./theme-CDbj88LB.js";
 import { t as defaultRuntime } from "./runtime-Da615Z-K.js";
 import { d as getVerboseFlag, n as isTruthyEnvValue, p as hasHelpOrVersion, s as getCommandPath } from "./entry.js";
 import { n as replaceCliName, r as resolveCliName } from "./command-format-CDJ_UHKO.js";
-import { S as VERSION } from "./io-Bv4JCxeO.js";
+import { S as VERSION } from "./io-B709DBGS.js";
 import { t as formatDocsLink } from "./links-snWstk4Z.js";
-import { n as resolveCliChannelOptions } from "./channel-options-DdeDxJ0I.js";
-import { t as getSubCliCommandsWithSubcommands } from "./register.subclis-DllJrPOF.js";
-import { a as registerProgramCommands, r as getCoreCliCommandsWithSubcommands } from "./command-registry-BMjfb8zB.js";
+import { n as resolveCliChannelOptions } from "./channel-options-DzVpFPN4.js";
+import { t as getSubCliCommandsWithSubcommands } from "./register.subclis-D9cIR7L0.js";
+import { a as registerProgramCommands, r as getCoreCliCommandsWithSubcommands } from "./command-registry-DQByY_LN.js";
 import { r as setProgramContext } from "./program-context-BM_Ldisp.js";
 import "./ports-0vV_tzNp.js";
-import { n as formatCliBannerLine, r as hasEmittedCliBanner, t as emitCliBanner } from "./banner-qUb6N-Xd.js";
+import { n as formatCliBannerLine, r as hasEmittedCliBanner, t as emitCliBanner } from "./banner-Dp2uCVaG.js";
 import { Command } from "commander";
 //#region src/cli/program/context.ts
 function createProgramContext() {
@@ -109,13 +109,13 @@ function registerPreActionHooks(program, programVersion) {
 		setVerbose(verbose);
 		if (!verbose) process.env.NODE_NO_WARNINGS ??= "1";
 		if (commandPath[0] === "doctor" || commandPath[0] === "completion") return;
-		const { ensureConfigReady } = await import("./config-guard-C-xrbJwh.js").then((n) => n.t);
+		const { ensureConfigReady } = await import("./config-guard-UM52hez4.js").then((n) => n.t);
 		await ensureConfigReady({
 			runtime: defaultRuntime,
 			commandPath
 		});
 		if (PLUGIN_REQUIRED_COMMANDS.has(commandPath[0])) {
-			const { ensurePluginRegistryLoaded } = await import("./plugin-registry-CKW-oeZs.js").then((n) => n.n);
+			const { ensurePluginRegistryLoaded } = await import("./plugin-registry-BV7F2_rq.js").then((n) => n.n);
 			ensurePluginRegistryLoaded();
 		}
 	});