@agentcomms/whatsapp 0.12.1 → 0.12.3

package/dist/cli.mjs

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { $ as renderPrune, A as CommsError, B as colorEnabled, C as checkStorePath, F as approvalsOf, G as installExitStatus, H as escapeForDisplay, I as approveChangeAtTerminal, J as nameAvailable, K as isCommsError, L as canPrompt, M as absoluteSearchPath, N as agentMarker, O as CHANNELS, P as approvalKind, Q as renderInstall, R as channelManifest, S as storeIdentity, T as expandSource, U as exemptFromUpdateGate, V as commandPathOf, W as gatedChangeAtTerminal, X as openCore, Y as nameShapeProblem, Z as paint, _ as chatRefOf, a as listChats, at as updateGateAtTerminal, b as requireAccount, c as Presenter, ct as withFileLock, d as draftMessage, et as runCommand, f as Visibility, g as requireSupportedNode, h as WhatsAppIndex, i as CHAT_KINDS, it as truncateDisplay, j as EXIT_CODES, k as CHANNEL_SERVERS, l as innerText, lt as writeResult, m as WhatsAppContext, n as whatsappStatus, nt as serverPruneChange, o as readChat, p as listKey, q as lookupName, r as probeStore, s as searchMessages, st as windowsSystemProgram, t as syncAccount, tt as serverInstallChange, ut as VERSION, v as PLATFORM, w as defaultStorePath, x as requireNamedConfig, y as newWhatsAppAccount, z as childEnvironment } from "./sync-BiO86eEl.mjs";
+import { $ as paint, A as CommsError, B as colorEnabled, C as checkStorePath, F as approvalsOf, G as gatedChangeAtTerminal, H as commandText, I as approveChangeAtTerminal, J as isCommsError, K as inlineCommand, L as canPrompt, M as absoluteSearchPath, N as agentMarker, O as CHANNELS, P as approvalKind, Q as openCore, R as channelManifest, S as storeIdentity, T as expandSource, U as escapeForDisplay, V as commandPathOf, W as exemptFromUpdateGate, X as nameAvailable, Y as lookupName, Z as nameShapeProblem, _ as chatRefOf, a as listChats, at as shellCommand, b as requireAccount, c as Presenter, ct as updateGateAtTerminal, d as draftMessage, dt as withFileLock, et as renderInstall, f as Visibility, ft as writeResult, g as requireSupportedNode, h as WhatsAppIndex, i as CHAT_KINDS, it as serverPruneChange, j as EXIT_CODES, k as CHANNEL_SERVERS, l as innerText, m as WhatsAppContext, n as whatsappStatus, nt as runCommand, o as readChat, p as listKey, pt as VERSION, q as installExitStatus, r as probeStore, rt as serverInstallChange, s as searchMessages, st as truncateDisplay, t as syncAccount, tt as renderPrune, ut as windowsSystemProgram, v as PLATFORM, w as defaultStorePath, x as requireNamedConfig, y as newWhatsAppAccount, z as childEnvironment } from "./sync-DJlsr6xq.mjs";
 import { rm } from "node:fs/promises";
 import path, { delimiter, join } from "node:path";
+import { stripVTControlCharacters } from "node:util";
 import fs, { accessSync, constants as constants$1 } from "node:fs";
 import childProcess, { spawn } from "node:child_process";
-import { stripVTControlCharacters } from "node:util";
 import process$1 from "node:process";
 import { EventEmitter } from "node:events";
 //#region ../../node_modules/.pnpm/commander@15.0.0/node_modules/commander/lib/error.js
@@ -2994,12 +2994,17 @@ const WHATSAPP_MCP = {
 function refuseAnAgent(context, command, what) {
 	const marker = agentMarker(context.env);
 	if (marker !== null || context.surface !== "cli") throw new CommsError("LOOSENING_REFUSED", `only a person ${what}`, {
-		hint: `Ask the person to run \`agent-whatsapp ${command}\` in their own terminal.`,
+		hint: `Ask the person to run ${inlineCommand(command)} in their own terminal.`,
 		...marker === null ? {} : { details: { marker } }
 	});
 }
 async function addAccount(context, request) {
-	refuseAnAgent(context, `add ${request.name}`, "chooses which WhatsApp store an agent may read");
+	refuseAnAgent(context, shellCommand([
+		"agent-whatsapp",
+		"add",
+		request.name,
+		...request.source === void 0 ? [] : ["--source", request.source]
+	], context.platform), "chooses which WhatsApp store an agent may read");
 	const problem = nameShapeProblem(request.name, PLATFORM);
 	if (problem) throw new CommsError("USAGE", problem);
 	const isDefault = request.source === void 0;
@@ -3013,7 +3018,11 @@ async function addAccount(context, request) {
 	const refuseTaken = (config) => {
 		requireNamedConfig(config);
 		const free = nameAvailable(config, "account", request.name, PLATFORM);
-		if (!free.ok) throw lookupName(config, "account", request.name)?.platform === "whatsapp" ? new CommsError("USAGE", `"${request.name}" is already added`, { hint: `Remove it first with \`agent-whatsapp remove ${request.name}\` to point it at another store.` }) : free.error;
+		if (!free.ok) throw lookupName(config, "account", request.name)?.platform === "whatsapp" ? new CommsError("USAGE", `"${request.name}" is already added`, { hint: `Remove it first with ${inlineCommand(shellCommand([
+			"agent-whatsapp",
+			"remove",
+			request.name
+		], context.platform))} to point it at another store.` }) : free.error;
 		for (const [name, other] of Object.entries(config.accounts)) {
 			if (other.platform !== "whatsapp") continue;
 			if (context.storeOf(other).path === path || other.workspace === identity.workspace) throw new CommsError("USAGE", `that store is already added, as "${name}"`, { hint: "One name per message store." });
@@ -3043,7 +3052,12 @@ async function addAccount(context, request) {
 			default: isDefault,
 			id: account.workspace
 		},
-		next: `agent-whatsapp sync --account ${request.name}`
+		next: commandText(shellCommand([
+			"agent-whatsapp",
+			"sync",
+			"--account",
+			request.name
+		], context.platform))
 	};
 }
 /**
@@ -3052,8 +3066,12 @@ async function addAccount(context, request) {
 */
 const REMOVE_WAIT_MS = 6e4;
 async function removeAccount(context, request) {
-	refuseAnAgent(context, `remove ${request.name}`, "removes a WhatsApp account");
-	const { account } = requireAccount(await context.config(), request.name);
+	refuseAnAgent(context, shellCommand([
+		"agent-whatsapp",
+		"remove",
+		request.name
+	], context.platform), "removes a WhatsApp account");
+	const { account } = requireAccount(await context.config(), request.name, context.platform);
 	await withFileLock(context.syncLock(account), async () => {
 		await context.core.config.update((config) => {
 			if (lookupName(config, "account", request.name)?.id !== account.id) throw new CommsError("TRANSIENT", `"${request.name}" changed while it was being removed`, { hint: "Nothing was removed. Run it again." });
@@ -3097,7 +3115,7 @@ function effectOf(lists) {
 async function named(context, name, account, chatId) {
 	let index;
 	try {
-		index = await WhatsAppIndex.open(context.accountDir(account), name, new Visibility(void 0));
+		index = await WhatsAppIndex.open(context.accountDir(account), name, new Visibility(void 0), context.platform);
 	} catch (error) {
 		if (!isCommsError(error) || error.details?.reason !== "NOT_SYNCED") throw error;
 		return {
@@ -3118,7 +3136,12 @@ async function named(context, name, account, chatId) {
 }
 /** The one path every list change takes: the person check first, before any input is read. */
 async function change(context, command, request, next) {
-	refuseAnAgent(context, command, "changes which chats an agent may see");
+	refuseAnAgent(context, shellCommand([
+		"agent-whatsapp",
+		command,
+		...request.chat === void 0 ? [] : [request.chat],
+		...request.account === void 0 ? [] : ["--account", request.account]
+	], context.platform), "changes which chats an agent may see");
 	const chatId = request.chat === void 0 ? void 0 : chatRefOf(request.chat, { international: true }).id;
 	const { name, account } = await context.account(request.account);
 	const { before, after } = await context.lists.update(account.id, (lists) => next(lists, chatId));
@@ -3128,7 +3151,12 @@ async function change(context, command, request, next) {
 		deny: [...after.deny],
 		changed: JSON.stringify(before) !== JSON.stringify(after),
 		effect: effectOf(after),
-		next: `agent-whatsapp sync --account ${name}`,
+		next: commandText(shellCommand([
+			"agent-whatsapp",
+			"sync",
+			"--account",
+			name
+		], context.platform)),
 		...chatId === void 0 ? {} : await named(context, name, account, chatId)
 	};
 }
@@ -3215,7 +3243,7 @@ function renderAdded(result, color) {
 function renderRemoved(result, color) {
 	return `${paint(color, "green", "Removed")} ${result.account}, and its local index. WhatsApp's own store was not touched.`;
 }
-function renderStatus(result, color) {
+function renderStatus(result, color, platform = process.platform) {
 	const lines = [];
 	if (result.accounts.length === 0) lines.push(`No WhatsApp account yet. ${result.setup ?? ""}`);
 	for (const account of result.accounts) {
@@ -3229,7 +3257,12 @@ function renderStatus(result, color) {
 			lines.push(`  index   ${account.index.chats} chats, ${account.index.messages} messages, ${account.index.media} with media, ${account.index.statusChats} status-update chat(s) · synced ${account.index.indexedAt}`);
 			if (account.index.unattributedStatus > 0) lines.push(`          ${unattributed(account.index.unattributedStatus)}`);
 			for (const entry of account.index.degraded) lines.push(paint(color, "dim", `          without ${entry.part}: ${entry.costs}`));
-		} else lines.push(`  index   not synced yet — agent-whatsapp sync --account ${account.account}`);
+		} else lines.push(`  index   not synced yet — ${commandText(shellCommand([
+			"agent-whatsapp",
+			"sync",
+			"--account",
+			account.account
+		], platform))}`);
 	}
 	lines.push("", paint(color, "dim", `Reads: ${result.reads}.`), paint(color, "dim", `Sends: ${result.sends}.`));
 	return lines.join("\n");
@@ -3338,6 +3371,7 @@ async function run(argv, deps = {}) {
 		stdin: process.stdin
 	};
 	const env = deps.env ?? process.env;
+	const platform = deps.platform ?? process.platform;
 	const open = deps.open ?? openLink;
 	const program = new Command();
 	let exitCode = 0;
@@ -3365,7 +3399,8 @@ a macOS dialog may be waiting) · 77 permission needed (macOS privacy) · 78 con
 		const options = program.opts();
 		return {
 			json: Boolean(options.json),
-			color: colorEnabled(env, streams.stdout, options.color)
+			color: colorEnabled(env, streams.stdout, options.color),
+			platform
 		};
 	};
 	/**
@@ -3451,7 +3486,7 @@ a macOS dialog may be waiting) · 77 permission needed (macOS privacy) · 78 con
 			account: flags.account === void 0 ? void 0 : String(flags.account),
 			check: flags.check !== false
 		});
-		writeResult(result, options, () => renderStatus(result, options.color), streams);
+		writeResult(result, options, () => renderStatus(result, options.color, context.platform), streams);
 	}));
 	accountOption(program.command("sync")).description("copy WhatsApp's store privately, check it, and rebuild the local index from the copy").action(act(async (context, options, flags) => {
 		const result = await syncAccount(context, { account: String(flags.account) });
@@ -3509,16 +3544,25 @@ a macOS dialog may be waiting) · 77 permission needed (macOS privacy) · 78 con
 	program.command("approve <approvalId>").description("approve a change at this terminal — registering or pruning this server — by reading it and typing the code back; WhatsApp never sends, so there is no message to approve").action(act(async (context, options, approvalId) => {
 		const marker = agentMarker(env);
 		if (marker) throw new CommsError("APPROVAL_REQUIRED", "only a person can approve a change, not an agent", {
-			hint: `Ask the person to run \`agent-whatsapp approve ${approvalId}\` in their own terminal.`,
+			hint: `Ask the person to run ${inlineCommand(shellCommand([
+				"agent-whatsapp",
+				"approve",
+				approvalId
+			], context.platform))} in their own terminal.`,
 			details: { marker }
 		});
-		if (!canPrompt(env, streams, { json: options.json })) throw new CommsError("APPROVAL_REQUIRED", "approving a change needs an interactive terminal", { hint: `Run \`agent-whatsapp approve ${approvalId}\` directly in a terminal.` });
+		if (!canPrompt(env, streams, { json: options.json })) throw new CommsError("APPROVAL_REQUIRED", "approving a change needs an interactive terminal", { hint: `Run ${inlineCommand(shellCommand([
+			"agent-whatsapp",
+			"approve",
+			approvalId
+		], context.platform))} directly in a terminal.` });
 		const pending = await context.core.approvals.get(approvalId);
 		if (!pending) throw new CommsError("NOT_FOUND", `no approval ${approvalId}`, { hint: "It may have expired, been used, or been cancelled. Prepare the change again." });
 		if (approvalKind(pending) !== "change") throw new CommsError("USAGE", `approval ${approvalId} is for a send, and WhatsApp never sends`, { hint: `Approve it with the command that prepared it — ${sendApproveCommands()} — not this one.` });
 		const outcome = await approveChangeAtTerminal(context.core, approvalId, env, {
 			json: options.json,
-			color: options.color
+			color: options.color,
+			platform: context.platform
 		}, streams);
 		streams.stdout.write(outcome.state === "approved" ? "Approved. This command approves; the change is applied by the command that prepared it.\n" : "Cancelled. Nothing was changed.\n");
 	}));
@@ -3534,9 +3578,9 @@ a macOS dialog may be waiting) · 77 permission needed (macOS privacy) · 78 con
 		ran = true;
 		exitCode = await runCommand(output(), async () => {
 			requireSupportedNode();
-			const { startWhatsAppStdioServer } = await import("./stdio-entry-BznXKJaK.mjs");
-			await startWhatsAppStdioServer({
+			await (deps.startMcp ?? (await import("./stdio-entry-CAM7LpPv.mjs")).startWhatsAppStdioServer)({
 				env,
+				platform,
 				...flags.account ? { account: String(flags.account) } : {}
 			});
 		}, streams);
@@ -3559,7 +3603,7 @@ a macOS dialog may be waiting) · 77 permission needed (macOS privacy) · 78 con
 		const launcher = flags.launcher;
 		const name = flags.name;
 		await context.migration();
-		const again = [
+		const again = shellCommand([
 			"agent-whatsapp",
 			"mcp",
 			"install",
@@ -3570,7 +3614,7 @@ a macOS dialog may be waiting) · 77 permission needed (macOS privacy) · 78 con
 			...launcher !== void 0 ? ["--launcher", launcher] : [],
 			...flags.verify === false ? ["--no-verify"] : [],
 			...flags.force === true ? ["--force"] : []
-		].join(" ");
+		], context.platform);
 		const result = await changeAt(context, serverInstallChange(context.core, env, {
 			channel: "whatsapp",
 			client: flags.client,
@@ -3590,7 +3634,12 @@ a macOS dialog may be waiting) · 77 permission needed (macOS privacy) · 78 con
 			channel: "whatsapp",
 			dryRun: flags.dryRun === true,
 			includePrinted: flags.includePrinted === true
-		}, WHATSAPP_MCP), flags, `agent-whatsapp mcp prune${flags.includePrinted === true ? " --include-printed" : ""}`);
+		}, WHATSAPP_MCP), flags, shellCommand([
+			"agent-whatsapp",
+			"mcp",
+			"prune",
+			...flags.includePrinted === true ? ["--include-printed"] : []
+		], context.platform));
 		writeResult(result, output(), () => renderPrune(result, options.color), streams);
 	}));
 	try {

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { u as composeDraft, ut as VERSION } from "./sync-BiO86eEl.mjs";
-import { t as createWhatsAppMcpServer } from "./server-BHwKQeXq.mjs";
+import { pt as VERSION, u as composeDraft } from "./sync-DJlsr6xq.mjs";
+import { t as createWhatsAppMcpServer } from "./server-B1EmZ6FZ.mjs";
 //#region src/index.ts
 /**
 * The library entry of `@agentcomms/whatsapp`.

package/dist/{server-BHwKQeXq.mjs → server-B1EmZ6FZ.mjs}

@@ -1,4 +1,4 @@
-import { D as strictToolArguments, E as UNTRUSTED_NOTICE, a as listChats, d as draftMessage, i as CHAT_KINDS, m as WhatsAppContext, n as whatsappStatus, o as readChat, ot as updateToolGate, rt as toCommsError, s as searchMessages, t as syncAccount, ut as VERSION } from "./sync-BiO86eEl.mjs";
+import { D as strictToolArguments, E as UNTRUSTED_NOTICE, a as listChats, d as draftMessage, i as CHAT_KINDS, lt as updateToolGate, m as WhatsAppContext, n as whatsappStatus, o as readChat, ot as toCommsError, pt as VERSION, s as searchMessages, t as syncAccount } from "./sync-DJlsr6xq.mjs";
 import { c as boolean, h as number, x as string } from "./schemas-DiGKNDNq.mjs";
 import { t as McpServer } from "./mcp-DXXb3Vv3-Co5BzjYe.mjs";
 //#region src/mcp/server.ts

package/dist/{stdio-entry-BznXKJaK.mjs → stdio-entry-CAM7LpPv.mjs}

@@ -1,4 +1,4 @@
-import { t as createWhatsAppMcpServer } from "./server-BHwKQeXq.mjs";
+import { t as createWhatsAppMcpServer } from "./server-B1EmZ6FZ.mjs";
 //#region src/mcp/stdio-entry.ts
 /**
 * Starting the stdio server. On stdio, stdout is the protocol, so the console is redirected to stderr first — the