@agentcomms/resend 0.13.1 → 0.14.1

package/README.md

@@ -19,10 +19,11 @@ says this on every run.
 
 **Nothing is sent without a person.** A send is prepared, previewed — every recipient, BCC included, the reach (unique
 recipients), the From domain and whether it is verified — and approved: a yes in the conversation under the account's
-`chat` policy, or the approve command the result gives and a typed code under `confirm`. Above ten recipients, or to
-an address that arrived in mail read here, a person at a terminal approves, whatever the policy. The approval id is
-the request's `Idempotency-Key` and an `agentcomms_approval` tag; a send whose outcome is unknown is never repeated,
-only checked.
+`chat` policy, or the approve command the result gives and a typed code under `confirm` — which the agent learns of
+with `resend_send_wait`. Above ten recipients, or to an address that arrived in mail read here, a person at a terminal
+approves, whatever the policy. The approval id is the request's `Idempotency-Key` and an `agentcomms_approval` tag; a
+send whose outcome is unknown (`SEND_OUTCOME_UNKNOWN`) is never repeated, only checked, and a scheduled one is
+"accepted", never "sent", until Resend's own last event for it says so.
 
 **The key is typed by a person, at a terminal.** `agent-resend account add` reads it from a hidden prompt, or from
 `RESEND_API_KEY` in that terminal, and stores it in the system keychain. No MCP tool accepts a key: a key typed into
@@ -96,6 +97,7 @@ terminal), `approve` (under `confirm`, a person at a terminal) and `mcp` (it sta
 | `agent-resend send prepare` | `resend_send_prepare` |
 | `agent-resend send execute <approvalId>` | `resend_send_execute` |
 | `agent-resend send status <approvalId>` | `resend_send_status` |
+| `agent-resend send wait <approvalId>` | `resend_send_wait` |
 | `agent-resend scheduled list` | `resend_scheduled_list` |
 | `agent-resend scheduled cancel <id>` | `resend_scheduled_cancel` |
 | `agent-resend approve <approvalId>` | — a person at a terminal, with the command the result gives |

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { B as UPDATE_CHECK_CHILD_COMMAND, C as policyChange, D as sendPolicyOf, Dt as VERSION, E as removeAccountChange, F as CHANNEL_SERVERS, G as canPrompt, H as approvalKind, I as CommsError, J as cliHandoffs, L as EXIT_CODES, N as checkNewName, O as showAccount, Q as exemptFromUpdateGate, R as PATH_OPTIONS, S as policyApprovalRefusal, St as RESEND_CALLER, T as policyWanted, U as approvalsOf, V as agentMarker, W as approveChangeAtTerminal, X as commandPathOf, Y as colorEnabled, Z as escapeForDisplay, _ as runDoctor, _t as truncateDisplay, a as revokeSendApproval, at as paint, b as listAccounts, bt as writeResult, c as downloadReceived, ct as renderInstall, d as listReceived, dt as runCommand, et as gatedChangeAtTerminal, f as listScheduled, ft as runUpdateCheckChild, g as showSentEmail, h as showReceived, ht as terminalUpdateHooks, i as prepareSend, it as openCore, k as ResendContext, l as getMetrics, lt as renderPrune, m as listSuppressions, mt as serverPruneChange, n as executeSend, nt as handoffSentenceToFill, o as sendStatus, ot as pathOverridesFromCliOptions, p as listSentEmails, pt as serverInstallChange, r as finishSendApproval, rt as installExitStatus, s as cancelScheduledChange, st as refuseUnclaimedApproval, t as beginSendApproval, tt as handoffSentence, u as listDomains, ut as resolvePaths, v as addAccountChange, vt as updateGateAtTerminal, w as policyReport, x as modeOf, y as inspectKey, z as SEND_LOOKUP } from "./send-DtBNDnE4.mjs";
+import { $ as exemptFromUpdateGate, B as UPDATE_CHECK_CHILD_COMMAND, C as policyChange, D as sendPolicyOf, E as removeAccountChange, Et as writeResult, F as CHANNEL_SERVERS, G as canPrompt, H as approvalsOf, I as CommsError, J as cliHandoffs, L as EXIT_CODES, N as checkNewName, Nt as VERSION, O as showAccount, Ot as RESEND_CALLER, Q as escapeForDisplay, R as PATH_OPTIONS, S as policyApprovalRefusal, T as policyWanted, Tt as wholeNumber, U as approveChangeAtTerminal, V as agentMarker, W as approveRefusedHint, X as commandPathOf, Y as colorEnabled, Z as describeFenceReport, _ as runDoctor, _t as serverPruneChange, a as revokeSendApproval, at as kindOf, b as listAccounts, bt as truncateDisplay, c as downloadReceived, ct as pathOverridesFromCliOptions, d as listReceived, dt as renderInstall, f as listScheduled, ft as renderPrune, g as showSentEmail, gt as serverInstallChange, h as showReceived, ht as runUpdateCheckChild, i as prepareSend, it as installExitStatus, k as ResendContext, l as getMetrics, lt as refuseUnclaimedApproval, m as listSuppressions, mt as runCommand, n as executeSend, nt as handoffSentence, o as sendStatus, ot as openCore, p as listSentEmails, pt as resolvePaths, r as finishSendApproval, rt as handoffSentenceToFill, s as cancelScheduledChange, st as paint, t as beginSendApproval, tt as gatedChangeAtTerminal, u as listDomains, ut as renderApprovalWait, v as addAccountChange, vt as terminalUpdateHooks, w as policyReport, wt as waitForApproval, x as modeOf, xt as updateGateAtTerminal, y as inspectKey, z as SEND_LOOKUP } from "./send-D0xGQynj.mjs";
 import path from "node:path";
 import { createInterface } from "node:readline/promises";
 import { stripVTControlCharacters } from "node:util";
@@ -3089,7 +3089,8 @@ function renderPolicy(report) {
 	return [
 		`${report.name}: ${report.mode} mode, send policy ${report.sendPolicy}${report.sendPolicyFrom === "default" ? " (the machine default)" : ""}`,
 		`Changes to it are approved under the machine's change policy: ${report.changePolicy}.`,
-		`A send to more than ${report.confirmAboveRecipients} people needs a person at a terminal, whatever the policy.`
+		`A send to more than ${report.confirmAboveRecipients} people needs a person at a terminal, whatever the policy.`,
+		...report.fenced === void 0 ? [] : describeFenceReport(report.fenced)
 	].join("\n");
 }
 function renderDoctor(result, color) {
@@ -3115,15 +3116,22 @@ function renderRead(result, color) {
 function renderPrepared(result) {
 	return `${result.preview}\n\nNext: ${escapeForDisplay(result.nextStep)}`;
 }
+/**
+* What Resend's acceptance means (`said`), with its id when it gave one: a scheduled send is accepted for its time and
+* never called sent; one with no id says so, and names none.
+*/
 function renderSent(result) {
-	const sent = result.state === "scheduled" ? `Scheduled for ${result.scheduledAt ?? "?"} as ${result.resendId}, to ${truncateDisplay(result.to.join(", "), 200)}.` : `Sent as ${result.resendId}, to ${truncateDisplay(result.to.join(", "), 200)}.`;
+	const to = truncateDisplay(result.to.join(", "), 200);
+	const said = `${result.said.charAt(0).toUpperCase()}${result.said.slice(1)}`;
+	const sent = result.resendId === void 0 ? result.state === "scheduled" ? `${said} — scheduled for ${result.scheduledAt ?? "?"}, to ${to}.` : `${said} — to ${to}.` : result.state === "scheduled" ? `${said}, as ${result.resendId}, to ${to}.` : `Sent as ${result.resendId}, to ${to}.`;
 	return result.note ? `${sent}\nNote: ${escapeForDisplay(result.note)}.` : sent;
 }
 function renderStatus(result) {
 	return `${result.approvalId}: ${escapeForDisplay(result.verdict)}`;
 }
 function renderCancelled(result) {
-	return `Cancelled ${result.id} (${result.recipients} recipient(s)). It cannot be rescheduled.`;
+	const cancelled = `Cancelled ${result.id} (${result.recipients} recipient(s)). It cannot be rescheduled.`;
+	return result.hint ? `${cancelled}\nNote: ${escapeForDisplay(result.hint)}` : cancelled;
 }
 //#endregion
 //#region src/cli/program.ts
@@ -3234,8 +3242,9 @@ is out: update first, or put it off (the stop names both commands) · 64 usage
 				noInput: false,
 				streams,
 				approvals: approvalsOf(command),
-				approvalClaim: path.join(" ") === "send status" ? SEND_LOOKUP : void 0,
+				approvalClaim: path.join(" ") === "send status" ? SEND_LOOKUP : path.join(" ") === "send wait" ? { lookup: true } : void 0,
 				...terminalUpdateHooks(core, env, {
+					channel: "resend",
 					output: output(),
 					streams
 				})
@@ -3266,6 +3275,7 @@ is out: update first, or put it off (the stop names both commands) · 64 usage
 	* after the program, which core locates as Resend's own and runs again with `--approval <id>`.
 	*/
 	const changeAt = (context, change, flags, rerun) => gatedChangeAtTerminal(context.core, change, {
+		channel: "resend",
 		approvalId: flags.approval === void 0 ? void 0 : String(flags.approval),
 		env,
 		output: output(),
@@ -3430,6 +3440,17 @@ is out: update first, or put it off (the stop names both commands) · 64 usage
 		const status = await sendStatus(context, String(flags.account), approvalId);
 		writeResult(status, output(), renderStatus, streams);
 	}));
+	send.command("wait <approvalId>").description("wait for an approval to be usable or finished, and say where it stands — it only looks, and never sends").option("--wait-seconds <n>", `how long to wait: 30 when left out, 300 at most, 0 for the status now`).action(act(async (context, _options, approvalId, flags) => {
+		const result = await waitForApproval(context.core, approvalId, {
+			waitSeconds: wholeNumber(flags.waitSeconds, {
+				name: "--wait-seconds",
+				min: 0,
+				max: 300
+			}),
+			channel: "resend"
+		});
+		writeResult(result, output(), renderApprovalWait, streams);
+	}));
 	const scheduled = program.command("scheduled").description("emails waiting to be sent at a later time");
 	accountOption(scheduled.command("list")).description("scheduled emails among the most recent 300 sent").action(act(async (context, options, flags) => {
 		const result = await listScheduled(context, String(flags.account));
@@ -3449,12 +3470,12 @@ is out: update first, or put it off (the stop names both commands) · 64 usage
 		const marker = agentMarker(env);
 		const approve = context.handoffs.own(["approve", approvalId]);
 		if (marker) throw new CommsError("APPROVAL_REQUIRED", "only a person can approve a send or a change, not an agent", {
-			hint: handoffSentence(approve, (command) => `Ask the user to run ${command} in their own terminal.`),
+			hint: approveRefusedHint(context.handoffs, approvalId),
 			details: { marker }
 		});
 		if (!canPrompt(env, streams, { json: options.json })) throw new CommsError("APPROVAL_REQUIRED", "approving needs an interactive terminal", { hint: handoffSentence(approve, (command) => `Run ${command} directly in a terminal.`) });
 		const pending = await context.core.approvals.get(approvalId);
-		if (pending && approvalKind(pending) === "change") {
+		if (kindOf(pending) === "change") {
 			const outcome = await approveChangeAtTerminal(context.core, approvalId, env, {
 				json: options.json,
 				color: options.color,
@@ -3476,7 +3497,7 @@ is out: update first, or put it off (the stop names both commands) · 64 usage
 	}));
 	const mcp = program.command("mcp").description("run the MCP server on stdio, for a coding agent to connect to").option("--account <name>", "pin the server to one account; every tool then acts on it and no other").action(async (flags) => {
 		ran = true;
-		const startResendStdioServer = deps.startMcp ?? (await import("./stdio-entry-CUFTANFM.mjs")).startResendStdioServer;
+		const startResendStdioServer = deps.startMcp ?? (await import("./stdio-entry-CtSxbgFr.mjs")).startResendStdioServer;
 		const core = coreForInvocation();
 		await startResendStdioServer({
 			...deps,