@ghostlytools/cli 1.3.0 → 1.3.1

package/README.md

@@ -127,7 +127,7 @@ The rows are in alphabetical order of their first command, and every command of
 | `group edit <group> <message> [text… \| --text <text> \| --stdin] [--mention <member>]… [--force]` | Replace the text of a message you sent to the group (`<message>` is the `messageId` `group send` gave). Every member sees it in place, marked edited; mentions whose `@name` is still in the text stay, `--mention` adds more. Answers `{group, messageId, edits, sent, edges}`; `--wait sent` and `--timeout` as for `group send`. The text the message already has is no edit: `sent: false, unchanged: true`. A private group's members whose edge is down get it when it opens, a community's with the catch-up; a member on an older app keeps the old text |
 | `group hub <group> <member> [--pin \| --exclude \| --auto]` | Past 16 members: pin a member as a hub, keep one from being a hub, or leave it to their app (a daemon offers itself) |
 | `group invite <group> <chat>`, `group remove <group> <member>`, `group admin <group> <member>` | Membership, for the admin (each prints the group; `--show-secret` for its link) |
-| `group leave <group>`, `group forget <group> --yes`, `group accept\|decline <group>` | Membership |
+| `group leave <group> --yes`, `group forget <group> --yes`, `group accept\|decline <group>` | Membership. Leaving deletes the group's history and files on this device, so it asks for `--yes` (`confirm`, exit 5, without it), as `group forget` does; forget also deletes a group you were removed from, which keeps its history. An admin's leave hands the role to a member who is online and names them: `{left, admin: {key, name}}` |
 | `group list [--show-secret]`, `group show <group> [--show-secret]`, `group history <group>` | Groups, members, history; a message names its author (`member` key, `nick` from the roster, or the name an author no longer in it had). The entry link prints as `<hidden>` without `--show-secret` |
 | `group react <group> <message> <emoji> [--remove]` | React to a group's message. `refused` when the profile is not a member any more |
 | `group rename <group> <name>` | A new name, for the admin (1 to 64 characters on one line); the picture stays. Members see it once it reaches them; until then, and on apps from before names, the group keeps the name it had when they got in |
@@ -159,7 +159,7 @@ The rows are in alphabetical order of their first command, and every command of
 | `status` | The profile, its chats, whether WebRTC and calls run, the last event seq |
 | `store sign <index> --key <file> [--out <dir>]` | Sign a store index (WISP 1200 · Stores) with the store key file (kept offline; made when missing and the index names no `key`): writes `ghostly-store.json`, canonical, and `ghostly-store.sig` beside the index or in `--out`. Refused, with the reason, when a client would refuse the index (`expires` more than 90 days ahead, a bad field), or when the index already there, signed by the same key, has a higher `sequence` (`rollback`) or the same one with other content (`equivocation`) |
 | `task send <chat\|group> --title <title> [--status s] [--progress n \| --steps a/b] [--step "…"] [--item state:text]… [--pr-url url --pr-number n --additions n --deletions n --files n --pr-state s --pr-checks c] [--branch b] [--tag label]… [--parent task] [--link url]… [--id id] [--json json\|-\|file] [--force]`, `task update <chat\|group> <task> [fields…]` | A task card for a bot's work (WISP 405 · Status Cards): a title, a status (queued, running, blocked, done, failed, cancelled), progress, the step it is on, up to 20 steps or log lines (`--item done:Codec`; a lowercase word before the colon must be an item state: pending, running, done, failed or skipped) and its pull request, shown as a small card that apps without cards read as text. Optional, and ignored by apps from before them: where the pull request stands (`--pr-state draft`, `open`, `merged` or `closed`; an open one puts the task in the board's Review column) and its checks (`--pr-checks passing`, `failing` or `pending`), up to 3 tags of 24 characters (`--tag core --tag web`; an update's tags replace the card's), and `--parent <task>`, a task of yours in the same chat that this one is a part of (sent first; its parts stack under it on the board). `send` prints the task's id and message; `update` merges the fields given over the card (an update's `--item` list replaces the card's: give all of them) and edits its message, at most once per 2.5 s (sooner updates merge into the next). `--json` takes the whole card; `null` in it removes a field. Only the CLI sends cards: the app shows them |
-| `typing <chat> [--kind typing\|recording\|thinking] [--status "<text>"] [--for s] [--stop]` | Show the contact you are writing, recording or thinking, or a short status line in its place ("Transcribing your audio…", 40 characters, no links): live chats only, it holds 6 s there; `--for s` keeps it on that long (up to 600 s; a one-shot stays that long); a new kind or status shows at once; a message to the chat or `--stop` ends it |
+| `typing <chat> [--kind typing\|recording\|thinking] [--status "<text>"] [--for s] [--stop]` | Show the contact you are writing, recording or thinking, or a short status line in its place ("Transcribing your audio…", 40 characters, no links): live chats only, it holds 6 s there; `--for s` keeps it on that long (up to 600 s; a one-shot stays that long once the chat is live, and stops with `live: false` when it is not live within 15 s); a new kind or status shows at once; a message to the chat or `--stop` ends it |
 | `usage send [<chat\|group>] [--all] --left <percent> [--window "5 h"] [--resets <time>] [--label Claude] [--account <name>] [--also week=80@<time>]… [--used n --limit n] [--id id] [--json json\|-\|file] [--force]` | How much of a quota the bot has left (WISP 405 § Usage): the percent (or `--used` of `--limit`), what it is of, the account, the window, when it resets, and up to 3 other windows (`--also week=80@2026-10-10T00:00:00Z`). The app shows a small meter on the chat's row and in its header, amber under 20%, red under 5%, muted once 6 h old or past the reset. One card per chat: the first report sends it, later ones edit it in place (quiet, paced as `task update`'s); each report is whole, so a field it leaves out goes. `--all` reports to every 1:1 chat with a contact. See [docs/AI-AGENTS.md](../../docs/AI-AGENTS.md#reporting-usage) for where a bot gets its numbers |
 | `version` | This CLI's version, `{"version":"…"}` (also `ghostly --version`) |
 | `wallet create <type> [--network testnet] [--provider id] [--value name=value]… [--stdin] [--invite code] [--api-key key]` | A wallet: `cashu`, `lightning` (a card: its source's form in `--value`), `arkade`, `spark` (on Mainnet, `--api-key` is your Breez API key), `bitcoin` (BDK), `fedimint` (`--invite` is the federation's invite code), `usdt`. With `--stdin`, secret fields come as `name=value` lines on stdin (`api-key=…` too), out of `ps` and the shell's history |
@@ -280,6 +280,8 @@ chat (`chat list`, `chat show`, `chat rename`, …) and `engine getState` print
 - A message's `timestamp` is its place in the history, which `chat history` and `group history` are ordered by: when
   this profile sent it, or when it arrived here. A received message also has `sentAt`, the time its sender's clock
   said, which orders nothing (a clock can be wrong).
+- A message's `from` is `me`, `peer`, or `system` for a group's own line in `group history` (`event`: created, joined,
+  renamed, …; the stream says it as `group.event`): nobody wrote it, whatever `member` key it carries.
 - `seq` grows by one per event in the profile, across restarts; `id` is the same whenever the same fact is reported.
   Dedupe by `id`; resume with `--since <seq>`, or let `--cursor <file>` remember the last event handled.
 - Types: `daemon.started`, `chat.created`, `chat.removed`, `chat.renamed`, `chat.pairing` (`stage`: publishing,
@@ -321,7 +323,8 @@ chat (`chat list`, `chat show`, `chat rename`, …) and `engine getState` print
 - Pins (WISP 400 § Pinned message): `chat.pinned` (with `chat`) and `group.pinned` (with `group`) when someone else pins
   or unpins: `{messageId, ref, by, removed}`, with `messageId` the message's id here (null when it is not here, or
   unpinned), `ref` the id both sides know it by, and `by` `peer` or a member key.
-- `--type message.received` keeps one type; `--type message.` (or `message.*`) a family.
+- `--type message.received` keeps one type; `--type message` (or `message.`, `message.*`) a family. A family deeper
+  down ends in "." (`group.typing.`): `group.message` is that type alone.
 - `--from <chat|key>` and `--group <group>` (again for more): an allowlist. Only the chats (id, prefix, name, or the
   contact's `peer` key, which also matches a chat made later) and groups named get through; any other chat's or
   group's event stops before `--exec`, `--webhook` and stdout (the message stays in the chat; the cursor moves past
@@ -396,6 +399,9 @@ with no framing:
   rest of it, then plays padded.
 - Barge-in: `ghostly call flush` (or `call.flush` on the socket API) drops everything queued, at once. Stop writing
   before you flush.
+- A call that ended unanswered (you hung up while it rang, or it rang out) is followed by the next one in that chat
+  no sooner than 2 s later: `call start` refuses sooner with `busy` and `details.retryAfterMs`. The contact's app
+  would not ring a call that comes that fast after a missed one.
 - The socket exists from `call start`/`call answer`, so the program may connect before the media is up. One program
   at a time: a new connection replaces the old one. When the call ends, the program reads EOF and the socket is
   removed.

package/dist/assets/{api-CrxVxtY1.js → api-Dq2QXQDk.js}

@@ -1,14 +1,14 @@
-import { $ as appRef, E as voicePeaksOf, Ft as toBase64Url, L as cardLine, N as STATUS_CARD_LIMITS, Nt as randomBytes$1, P as appCardId, S as baseMime, T as parseVoiceMeta, _t as LIMITS, b as PLAYABLE_AUDIO, it as isAppRef, m as readImageMeta, t as GROUP_FILE_LIMITS, v as sanitizeFileName, x as VOICE_LIMITS, y as sanitizeMime, z as checkStatusCard } from "./groupFiles-DBbjOLuD.js";
-import { Da as AWAITING_PEER_MS, Dr as TYPING_REFRESH_MS, Er as TYPING_KINDS, Fi as identityStatement, Ma as GhostlyHttpError, ac as MAX_AVATAR_LENGTH, at as groupName, kr as sanitizeTypingStatus, ls as inviteLink, m as APP_PERMISSIONS, oc as sanitizeAvatar, qr as APP_DATA_MAX_BYTES, y as isAppUrl } from "./src-DhfGgAUu.js";
+import { Bo as LIMITS, Br as TYPING_REFRESH_MS, Hr as sanitizeTypingStatus, Io as GhostlyHttpError, Ji as identityStatement, Qa as cardLine, Xa as appCardId, Ya as STATUS_CARD_LIMITS, Zn as GROUP_FILE_LIMITS, _a as VOICE_LIMITS, _l as randomBytes$1, at as groupName, ba as parseVoiceMeta, do as appRef, eo as checkStatusCard, fa as readImageMeta, ga as PLAYABLE_AUDIO, gc as inviteLink, ha as sanitizeMime, ho as isAppRef, jo as AWAITING_PEER_MS, m as APP_PERMISSIONS, ma as sanitizeFileName, ml as sanitizeAvatar, oi as APP_DATA_MAX_BYTES, pl as MAX_AVATAR_LENGTH, va as baseMime, vc as ownInviteRefusal, vl as toBase64Url, xa as voicePeaksOf, y as isAppUrl, zr as TYPING_KINDS } from "./src-DDzSERyc.js";
 import { c as fileStore } from "./idb-B5L8wuOm.js";
-import { O as waitingGroupFile, T as removeStored, ct as iceServerProblem, i as groupOfFile, k as IDENTITY_PROVIDERS, l as replyRef, lt as iceServerSetting, n as groupFileId, v as paymentNetwork } from "./groupFiles-BNTSDaoq.js";
+import { O as waitingGroupFile, T as removeStored, U as iceServerProblem, W as iceServerSetting, i as groupOfFile, l as replyRef, n as groupFileId, v as paymentNetwork } from "./groupFiles-IEUW3DQz.js";
 import { f as FILE_BYTES_STEP, o as fileBytes, s as fileBytesOf } from "./fileBytes-Di7VZtmU.js";
-import { a as waitForEdit, c as findSecret, i as pressable, n as buttonsCard, o as waitForGroupFrame, s as waitForMessage, t as BUTTON_METHODS } from "./buttons-CX1pKB0j.js";
-import { i as ENGINE_READS, n as withStoredIds, r as ENGINE_METHODS } from "./turnRefs-ChEfgbSX.js";
-import { t as CliError } from "./errors-my6VJR_0.js";
-import { _ as str, a as findChat, c as groupOf, d as messageOf, f as node, g as state, h as sentAt, i as chatOrGroup, l as inviteTaken, m as oneOf, n as bool, o as findChatOrGroup, p as num, r as chatOf, s as findGroup, u as list, v as waitForState } from "./apiKit-CajiDxdK.js";
-import { t as BACKUP_METHODS } from "./backup-BAMi2lAq.js";
-import { o as checkedBundle } from "./apps-CbfiCSIw.js";
+import { t as IDENTITY_PROVIDERS } from "./registry-DlAKO0Fy.js";
+import { a as waitForEdit, c as findSecret, i as pressable, n as buttonsCard, o as waitForGroupFrame, s as waitForMessage, t as BUTTON_METHODS } from "./buttons-CvNBzh2S.js";
+import { i as ENGINE_READS, n as withStoredIds, r as ENGINE_METHODS } from "./turnRefs-B87dtrHM.js";
+import { t as CliError } from "./errors-DO5z6h_l.js";
+import { _ as str, a as findChat, c as groupOf, d as messageOf, f as node, g as state, h as sentAt, i as chatOrGroup, l as inviteTaken, m as oneOf, n as bool, o as findChatOrGroup, p as num, r as chatOf, s as findGroup, u as list, v as waitForState } from "./apiKit-CA2x5GJF.js";
+import { t as BACKUP_METHODS } from "./backup-CnMN2oUK.js";
+import { o as checkedBundle } from "./apps-BxV9i_Y4.js";
 import { generateMnemonic } from "@scure/bip39";
 import { wordlist } from "@scure/bip39/wordlists/english.js";
 import { openAsBlob, readFileSync, renameSync, writeFileSync } from "node:fs";
@@ -76,6 +76,41 @@ function keepTyping(ctx, target, ms, word = {}) {
 		map.set(key, end);
 	});
 }
+/** How long a one-shot's `--for` waits for its chat or group to be live: a fresh one-shot connects first. */
+var ONE_SHOT_LIVE_GRACE_MS = 15e3;
+/**
+* A one-shot's `--for` (it holds the profile while it runs): kept the whole time once the chat or group is live, as a
+* daemon keeps it; ended when it is not live within `ONE_SHOT_LIVE_GRACE_MS`, since nobody would see it, and `--stop`
+* or a send from another shell could not end it.
+*/
+async function keepOneShot(ctx, target, kept, live) {
+	let stop = () => {};
+	const cameLive = new Promise((resolve) => {
+		if (live(state(ctx))) return resolve(true);
+		const timer = setTimeout(() => {
+			off();
+			resolve(false);
+		}, ONE_SHOT_LIVE_GRACE_MS);
+		const off = ctx.hub.onState((next) => {
+			if (live(next)) {
+				clearTimeout(timer);
+				off();
+				resolve(true);
+			}
+		});
+		stop = () => {
+			clearTimeout(timer);
+			off();
+			resolve(true);
+		};
+	});
+	if (await Promise.race([kept.then(() => true), cameLive])) {
+		stop();
+		await kept;
+		return;
+	}
+	endTyping(ctx, target, false);
+}
 /** Ends a kept `--for` in the chat or group; `tell`: and says this side stopped. Whether one was kept. */
 function endTyping(ctx, target, tell) {
 	const end = keepersOf(ctx).get(keyOf(target));
@@ -755,9 +790,12 @@ var FILE_METHODS = {
 		const fileId = str(params, "file", true);
 		const { linkId, where } = fileChat(ctx, params, fileId);
 		const action = oneOf(params, "action", ACTIONS, "accept");
+		const refuseAllHere = async () => {
+			if ((state(ctx).transfers[fileId] ?? (await fileStore.get(fileId).catch(() => void 0))?.transfer)?.state === "done") throw new CliError("refused", action === "accept" || action === "request" || action === "resume" ? "Nothing to ask for: the file is all here" : "Nothing to stop: the file is all here");
+		};
 		if ("group" in where) {
 			if (action === "resend") throw new CliError("bad_request", "A group's file is downloaded (file accept) or asked for again (file request)");
-			if ((state(ctx).transfers[fileId] ?? (await fileStore.get(fileId).catch(() => void 0))?.transfer)?.state === "done") throw new CliError("refused", action === "accept" || action === "request" || action === "resume" ? "Nothing to ask for: the file is all here" : "Nothing to stop: the file is all here");
+			await refuseAllHere();
 			try {
 				await node(ctx).fileAction({
 					linkId,
@@ -780,7 +818,7 @@ var FILE_METHODS = {
 			const transfer = state(ctx).transfers[fileId];
 			if (!transfer || transfer.state === "done") throw new CliError("refused", outgoing ? "Nothing to send again: it arrived whole" : "Nothing to ask for: the file is all here");
 			if (transfer.state === "failed" && (!outgoing || !transfer.retry)) throw new CliError("refused", `It ended: ${transfer.error ?? "failed"}`);
-		}
+		} else await refuseAllHere();
 		await node(ctx).fileAction({
 			linkId,
 			fileId,
@@ -842,7 +880,7 @@ var FILE_METHODS = {
 		const stored = await fileStore.get(fileId);
 		if (!stored?.metadata) throw new CliError("not_found", `No file ${fileId}`);
 		if (stored.leftOut) throw new CliError("not_found", "Not in this backup: the light backup this profile was restored from left the file out");
-		const transfer = state(ctx).transfers[fileId] ?? stored.transfer;
+		const transfer = stored.direction === "out" ? void 0 : state(ctx).transfers[fileId] ?? stored.transfer;
 		if (transfer && transfer.state !== "done") throw new CliError("unavailable", `The file is not all here yet (${transfer.transferred} of ${transfer.size} bytes)`);
 		const target = str(params, "path") ? resolve(str(params, "path", true)) : join(resolve(str(params, "dir") ?? "."), saveName(stored.metadata.name));
 		const flags = bool(params, "force") ? "w" : "wx";
@@ -850,7 +888,9 @@ var FILE_METHODS = {
 		try {
 			out = await open(target, flags, 384);
 		} catch (error) {
-			if (error.code === "EEXIST") throw new CliError("confirm", `${target} exists: pass force (--force) to replace it`);
+			const code = error.code;
+			if ((code === "EEXIST" || code === "EISDIR") && (await stat(target).catch(() => void 0))?.isDirectory()) throw new CliError("bad_request", `${target} is a folder: name a file, or use dir (--dir ${target})`);
+			if (code === "EEXIST") throw new CliError("confirm", `${target} exists: pass force (--force) to replace it`);
 			throw error;
 		}
 		let written = 0, complete = false;
@@ -1431,7 +1471,7 @@ function messageJson(message) {
 	return {
 		id: message.id,
 		chat: message.linkId,
-		from: message.sender,
+		from: message.event ? "system" : message.sender,
 		text: message.text,
 		timestamp: message.timestamp,
 		...message.sentAt !== void 0 ? { sentAt: message.sentAt } : {},
@@ -2613,6 +2653,33 @@ var CHAT_METHODS = [
 * them as unavailable; creating one is refused before the engine is asked.
 */
 var NODE_GAPS = { bark: "Bark's SDK ships a browser build only: its WebAssembly needs a browser window. Use it from the app." };
+/** Sources the engine lists that live in a browser page (`window.webln`): a headless Ghostly never offers them. */
+var BROWSER_SOURCES = /* @__PURE__ */ new Set(["webln"]);
+/** The sources of an offer a headless Ghostly can connect. */
+var nodeSources = (offer) => offer?.providers?.filter((p) => !BROWSER_SOURCES.has(p.id));
+/**
+* What `wallet create` was given checked against the offer's own form, before the engine is asked: a source, a field
+* or a flag left out, or one the wallet does not take, is the person's value, said naming the flag. Before, the engine
+* refused it in the app's words ("Enter connection uri", "Nothing was saved; try again") as `engine`, or the flag was
+* dropped without a word.
+*/
+function createChecked(type, n, offer, provider, values, params) {
+	if (type !== "lightning" && type !== "bitcoin") {
+		if (provider || Object.keys(values).length) throw new CliError("usage", `--provider and --value name a lightning or bitcoin source: not with ${type}`);
+		if (offer?.needs === "invite" && !str(params, "invite")?.trim()) throw new CliError("bad_request", `${type} needs --invite <fed11…>`);
+		if (offer?.needs === "apiKey" && !str(params, "apiKey")?.trim()) throw new CliError("bad_request", `${type} on ${n} needs --api-key <key> (or api-key=… on --stdin)`);
+		return;
+	}
+	const sources = nodeSources(offer);
+	if (!sources?.length) return;
+	if (!provider) throw new CliError("bad_request", `${type} needs --provider: one of ${sources.map((p) => p.id).join(", ")} (ghostly wallet list)`);
+	const source = sources.find((p) => p.id === provider);
+	if (!source) throw new CliError("bad_request", `No ${type} source ${JSON.stringify(provider)} on ${n} (ghostly wallet list)`);
+	const unknown = Object.keys(values).find((name) => !source.fields.some((f) => f.name === name));
+	if (unknown) throw new CliError("bad_request", `${provider} takes no --value ${unknown}: ${source.fields.length ? `its fields are ${source.fields.map((f) => f.name).join(", ")}` : "it has no fields"}`);
+	const missing = source.fields.find((f) => !f.optional && !f.defaults?.[n] && !values[f.name]?.trim());
+	if (missing) throw new CliError("bad_request", `${provider} needs --value ${missing.name}=<${missing.options?.map((o) => o.value).join("|") ?? missing.placeholder ?? missing.label.toLowerCase()}>`);
+}
 var network = (params, fallback = "testnet") => oneOf(params, "network", NETWORKS, fallback);
 /** `confirmedReal` for the engine: only when the caller confirmed real money, and only then. */
 var real = (params) => bool(params, "confirmReal") ? { confirmedReal: true } : {};
@@ -2775,7 +2842,7 @@ var WALLET_METHODS = Object.fromEntries(Object.entries({
 					exists: !!o.exists,
 					several: !!o.several,
 					needs: o.needs ?? null,
-					...o.providers ? { providers: o.providers.map((p) => ({
+					...o.providers ? { providers: nodeSources(o).map((p) => ({
 						id: p.id,
 						label: p.label,
 						fields: p.fields.map((f) => ({
@@ -2799,14 +2866,13 @@ var WALLET_METHODS = Object.fromEntries(Object.entries({
 		const raw = params.values ?? {};
 		if (!raw || typeof raw !== "object" || Array.isArray(raw) || Object.values(raw).some((v) => typeof v !== "string")) throw new CliError("bad_request", "values must be an object of strings");
 		Object.assign(values, raw);
-		const provider = str(params, "provider");
-		const offered = state(ctx).wallet.offers?.find((o) => o.type === type && o.network === n)?.providers;
-		if (provider && offered && !offered.some((p) => p.id === provider)) throw new CliError("bad_request", `No ${type} source ${JSON.stringify(provider)} on ${n} (ghostly wallet list)`);
-		if (type === "bitcoin" && (provider ?? "bdk") === "bdk" && !values.mnemonic) values.mnemonic = generateMnemonic(wordlist, 128);
+		const provider = str(params, "provider") ?? (type === "bitcoin" ? "bdk" : void 0);
+		if (type === "bitcoin" && provider === "bdk" && !values.mnemonic) values.mnemonic = generateMnemonic(wordlist, 128);
+		createChecked(type, n, state(ctx).wallet.offers?.find((o) => o.type === type && o.network === n), provider, values, params);
 		return walletJson(await node(ctx).walletCreate({
 			type,
 			network: n,
-			...provider ? { providerId: provider } : type === "bitcoin" ? { providerId: "bdk" } : {},
+			...provider ? { providerId: provider } : {},
 			...Object.keys(values).length ? { values } : {},
 			...str(params, "invite") ? { invite: str(params, "invite") } : {},
 			...str(params, "apiKey") ? { apiKey: str(params, "apiKey") } : {}
@@ -3159,6 +3225,20 @@ var SETTABLE = {
 	autoDownloads: "boolean",
 	serveFiles: "boolean"
 };
+/**
+* A relay address the engine refuses (node.ts `updateSettings`, irohWeb.ts, hyperdhtRelay.ts): the person's value, so
+* `bad_request` named by its key, in a terminal's words ("give", not the app's "Enter"). Before, `engine` (exit 1). A
+* wrong scheme ("Use an https:// relay address") too.
+*/
+function relayRefused(error, patch) {
+	if (!(error instanceof Error) || !/^(?:Enter (?:at least one|a) relay address|Not a relay address|Use an? \S+ relay address)\b/.test(error.message)) return error;
+	const keys = [
+		"relays",
+		"irohRelays",
+		"hyperdhtRelay"
+	].filter((key) => Object.hasOwn(patch, key));
+	return new CliError("bad_request", `${keys.join(", ") || "relays"}: ${error.message.replace(/^Enter /, "give ").replace(/^(Not|Use) /, (word) => word.toLowerCase())}`);
+}
 var TRANSPORT_NAMES = {
 	auto: "auto",
 	dht: "dht",
@@ -3320,7 +3400,9 @@ var METHODS = {
 			}
 			patch[key] = value;
 		}
-		await node(ctx).updateSettings({ settings: patch });
+		await node(ctx).updateSettings({ settings: patch }).catch((error) => {
+			throw relayRefused(error, patch);
+		});
 		return {
 			...redactSettings(state(ctx).settings),
 			...warning ? { warning } : {}
@@ -3357,8 +3439,9 @@ var METHODS = {
 		try {
 			({linkId} = await node(ctx).joinLink({ inviteCode: invite }));
 		} catch (error) {
+			const own = ownInviteRefusal(error);
+			if (own) throw new CliError("refused", "This is your own invite. Share it with a contact; they join with it.", own.linkId ? { chat: own.linkId } : void 0);
 			const message = error instanceof Error ? error.message : String(error);
-			if (/own invite/i.test(message)) throw new CliError("refused", message);
 			if (/does not look like/i.test(message)) throw new CliError("bad_request", message);
 			throw error;
 		}
@@ -3375,18 +3458,18 @@ var METHODS = {
 		return { chats: state(ctx).links.map((link) => chatJson(link, showSecret)).sort((a, b) => b.lastMessageAt - a.lastMessageAt || b.createdAt - a.createdAt) };
 	},
 	async "chat.get"(ctx, params) {
-		const link = chatOf(ctx, params);
+		const link = chatNotGroup(ctx, params, "group show");
 		return {
 			...chatDetailsJson(link, bool(params, "showSecret")),
 			heldUntil: holdOf(ctx, link.id)
 		};
 	},
 	async "chat.history"(ctx, params) {
-		const link = chatOf(ctx, params);
+		const link = chatNotGroup(ctx, params, "group history");
 		return historyOf(ctx, link.id, params, (m) => chatMessageJson(m, link));
 	},
 	async "chat.send"(ctx, params) {
-		const link = chatOf(ctx, params);
+		const link = chatNotGroup(ctx, params, "group send", "[text...]");
 		const text = str(params, "text", true);
 		checkTextSize(text);
 		if (!bool(params, "force")) {
@@ -3430,7 +3513,7 @@ var METHODS = {
 	* once the chat is live and both apps offer edit/1; `--wait confirmed` waits for the contact to confirm it.
 	*/
 	async "chat.edit"(ctx, params) {
-		const link = chatOf(ctx, params);
+		const link = chatNotGroup(ctx, params, "group edit", "<message> <text...>");
 		const messageId = str(params, "message", true);
 		const text = str(params, "text", true);
 		if (!bool(params, "force")) {
@@ -3461,10 +3544,11 @@ var METHODS = {
 	* WISP 401 § Typing: said on the live session only, and a start only while `sendTyping` is on; it holds 6 s there.
 	* `kind` (typing, recording, thinking) and `status` (a short line, e.g. "Transcribing your audio…") say what this
 	* side is doing; a new one reaches the contact at once.
-	* `for`: kept that many seconds (a one-shot stays that long), until a message to the chat or a stop.
+	* `for`: kept that many seconds (a one-shot stays that long once the chat is live, and stops when it is not live
+	* within `ONE_SHOT_LIVE_GRACE_MS`), until a message to the chat or a stop.
 	*/
 	async "chat.typing"(ctx, params) {
-		const link = chatOf(ctx, params);
+		const link = chatNotGroup(ctx, params, "group typing");
 		const typing = !bool(params, "stop");
 		const { kind, status } = typingWord(params, typing);
 		const word = {
@@ -3484,20 +3568,21 @@ var METHODS = {
 		});
 		const until = seconds ? Date.now() + seconds * 1e3 : null;
 		const kept = seconds ? keepTyping(ctx, { linkId: link.id }, seconds * 1e3, word) : null;
-		if (kept && ctx.mode === "one-shot") await kept;
+		const open = (s) => s.links.find((l) => l.id === link.id)?.dataLink === "open";
+		if (kept && ctx.mode === "one-shot") await keepOneShot(ctx, { linkId: link.id }, kept, open);
 		return {
 			chat: link.id,
 			typing,
 			...typing ? { kind } : {},
 			...status ? { status } : {},
-			live: link.dataLink === "open",
+			live: open(state(ctx)),
 			sendTyping: state(ctx).settings.sendTyping !== false,
 			...until ? { until } : {}
 		};
 	},
 	/** WISP 400 § Reactions: one emoji per person per message, a new one replaces mine; `remove` takes mine back. */
 	async "chat.react"(ctx, params) {
-		const link = notAGroup(ctx, params, () => chatOf(ctx, params), "group react", "<message> <emoji>");
+		const link = chatNotGroup(ctx, params, "group react", "<message> <emoji>");
 		return {
 			chat: link.id,
 			...await react(ctx, link.id, params)
@@ -3594,7 +3679,10 @@ var METHODS = {
 	async "chat.retry"(ctx, params) {
 		const link = chatOf(ctx, params);
 		const messageId = str(params, "message", true);
-		if (!await node(ctx).getMessage(link.id, messageId)) throw new CliError("not_found", `No message ${messageId} in this chat`);
+		const message = await node(ctx).getMessage(link.id, messageId);
+		if (!message) throw new CliError("not_found", `No message ${messageId} in this chat`);
+		if (message.sender !== "me") throw new CliError("not_found", `No message ${messageId} of yours in this chat: only your own messages are sent again`);
+		if (message.delivery === "delivered") throw new CliError("refused", "Nothing to send again: it was delivered");
 		await node(ctx).retryMessage({
 			linkId: link.id,
 			messageId
@@ -3627,7 +3715,7 @@ var METHODS = {
 		return details;
 	},
 	async "chat.rename"(ctx, params) {
-		const link = chatOf(ctx, params);
+		const link = chatNotGroup(ctx, params, "group rename", "<name...>");
 		await node(ctx).renameLink({
 			linkId: link.id,
 			label: str(params, "name") ?? ""
@@ -3635,7 +3723,7 @@ var METHODS = {
 		return chatJson(findChat(state(ctx).links, link.id));
 	},
 	async "chat.remove"(ctx, params) {
-		const link = chatOf(ctx, params);
+		const link = chatNotGroup(ctx, params, "group forget", "--yes");
 		if (!bool(params, "yes")) throw new CliError("confirm", "Removing a chat deletes its keys and history on this device; pass yes (--yes) to go on");
 		await node(ctx).removeLink({ linkId: link.id });
 		return { removed: link.id };
@@ -3866,21 +3954,30 @@ var METHODS = {
 		sayTyping(ctx, target, typing, word);
 		const until = seconds ? Date.now() + seconds * 1e3 : null;
 		const kept = seconds ? keepTyping(ctx, target, seconds * 1e3, word) : null;
-		if (kept && ctx.mode === "one-shot") await kept;
+		const reached = (s) => (s.groups.find((g) => g.id === group.id) ?? group).members.filter((m) => !m.me && m.online && !m.viaHub).length;
+		if (kept && ctx.mode === "one-shot") await keepOneShot(ctx, target, kept, (s) => reached(s) > 0);
 		return {
 			group: group.id,
 			typing,
 			...typing ? { kind } : {},
 			...status ? { status } : {},
-			reached: group.members.filter((m) => !m.me && m.online && !m.viaHub).length,
+			reached: reached(state(ctx)),
 			sendTyping: state(ctx).settings.sendTyping !== false,
 			...until ? { until } : {}
 		};
 	},
 	async "group.leave"(ctx, params) {
 		const group = groupOf(ctx, params);
-		await node(ctx).leaveGroup({ groupId: group.id });
-		return { left: group.id };
+		if (!bool(params, "yes")) throw new CliError("confirm", "Leaving a group deletes its history and files on this device; pass yes (--yes) to go on");
+		const { admin } = await node(ctx).leaveGroup({ groupId: group.id });
+		const next = admin ? group.members.find((m) => m.key === admin) : void 0;
+		return {
+			left: group.id,
+			...admin ? { admin: {
+				key: admin,
+				name: next?.nick ?? null
+			} } : {}
+		};
 	},
 	async "group.forget"(ctx, params) {
 		const group = groupOf(ctx, params);
@@ -3992,9 +4089,13 @@ function notAGroup(ctx, params, chat, command, rest) {
 			throw error;
 		}
 		const shown = /^[\w.:-]+$/.test(ref) ? ref : JSON.stringify(ref);
-		throw new CliError("not_found", `${JSON.stringify(ref)} is a group, not a chat: ghostly ${command} ${shown} ${rest}`, { group: group.id });
+		throw new CliError("not_found", `${JSON.stringify(ref)} is a group, not a chat: ghostly ${command} ${shown}${rest ? ` ${rest}` : ""}`, { group: group.id });
 	}
 }
+/** The chat a chat command with a group twin names: a group's name says so, with `command`, the twin (see `notAGroup`). */
+function chatNotGroup(ctx, params, command, rest = "") {
+	return notAGroup(ctx, params, () => chatOf(ctx, params), command, rest);
+}
 /**
 * An edit the engine refused. A message that is not in the chat or group at all is `not_found` (exit 3), naming the id
 * to give, as `button update` and `task update` do; before, a mistyped or lost id read "Only your own text messages
@@ -4068,4 +4169,4 @@ async function callApi(ctx, method, params = {}) {
 //#endregion
 export { flushCardUpdates as _, hideStateSecrets as a, paymentJson as c, nodeLocalFetch as d, chatJson as f, resumeHolds as g, groupMessageJson as h, groupSendRefused as i, reportAppFrames as l, groupJson as m, SETTABLE as n, mentionsFor as o, chatMessageJson as p, callApi as r, redactSettings as s, API_METHODS as t, servedApps as u };
 
-//# sourceMappingURL=api-CrxVxtY1.js.map
+//# sourceMappingURL=api-Dq2QXQDk.js.map