@wirecat/cli-core 0.545.0 → 0.546.0

package/dist/cli/entry.d.ts

@@ -58,3 +58,5 @@ export interface CliEntry {
  * output still flushes.
  */
 export declare const startCli: (entry: CliEntry) => Promise<void>;
+/** Opens `url` in the system browser, or in `browser` when given; resolves once the browser has started. */
+export declare const openBrowser: (url: string, browser?: string, io?: Pick<EntryIo, "platform" | "spawn">) => Promise<void>;

package/dist/cli/entry.js

@@ -88,7 +88,7 @@ export const startCli = async (entry) => {
             });
             return /^(y|yes)$/i.test(answer.trim());
         },
-        openBrowser: (url, browser) => openBrowser(io, url, browser),
+        openBrowser: (url, browser) => openBrowser(url, browser, io),
         outputClosed: () => closed,
     };
     let code;
@@ -138,7 +138,8 @@ const commanderExit = (error) => {
         return 0;
     return code === "commander.help" ? 2 : undefined;
 };
-const openBrowser = (io, url, browser) => {
+/** Opens `url` in the system browser, or in `browser` when given; resolves once the browser has started. */
+export const openBrowser = (url, browser, io = { platform: process.platform, spawn }) => {
     const [command, prefix] = browser !== undefined
         ? [browser, []]
         : io.platform === "darwin"

package/dist/cli/index.d.ts

@@ -39,6 +39,7 @@ export { unanswered } from "../services/questions.js";
 export { openRequestTask } from "../services/task-rules.js";
 export { TASK_PAIR_QUERY, TASK_QUERY } from "../services/tasks.js";
 export { answerStdinOption, type Need, type SignInSteps, type SignInStepsOptions, signInSteps, } from "../terminal/sign-in-steps.js";
+export { liftOptionsAfterDashes } from "./after-dashes.js";
 export { type AgentPolicy, type AgentTask, type EvaluationResult, evaluateAgent, type Observation, } from "./agent-evaluation.js";
 export { answerEntity } from "./answer-entity.js";
 export { type AppDoctorOptions, appDoctorReport } from "./app-doctor-command.js";
@@ -67,7 +68,7 @@ export { type Closeable, withDeadline } from "./deadline.js";
 export { DEFAULT_CONFIG, ensureDefaultConfig } from "./default-config.js";
 export { DISCOVERY_DESCRIPTIONS } from "./discovery-descriptions.js";
 export { changesAuthority, changesAuthorityAt, changesAuthorityNow, destroysNothing, FETCH, fetchesOnly, fetchesOnlyAt, grantsAuthority, isLogin, isOtherServiceCall, isStoreChange, judgedEffects, judgedTargets, LOCAL_READ, LOCAL_WRITE, logsInOrOut, NO_EFFECTS, ownerOnlyOption, previewFlag, REMOTE_READ, REMOTE_WRITE, reachesOtherService, readsOverMcp, readsOverMcpAt, refuseUnderReadOnly, storeChangeRefusal, writesFileOnlyWith, } from "./effects.js";
-export { type CliEntry, type EntryContext, type EntryIo, startCli } from "./entry.js";
+export { type CliEntry, type EntryContext, type EntryIo, openBrowser, startCli } from "./entry.js";
 export { type AnswerOutput, answerSchema, type Body, type ItemBody, isBody, itemAnswer, itemOf, jsonlRecords, judgedAnswer, type ListBody, type ListInput, listOf, metaNow, printItem, renderAnswer, sealed, snakeKeys, snakeKeysKeeping, } from "./envelope.js";
 export { withAbort } from "./execution.js";
 export { askSetupQuestions, asksAtStart, type FirstRun, type FirstRunIo, setupAtStart, systemLanguage, } from "./first-run.js";

package/dist/cli/index.js

@@ -34,6 +34,7 @@ export { unanswered } from "../services/questions.js";
 export { openRequestTask } from "../services/task-rules.js";
 export { TASK_PAIR_QUERY, TASK_QUERY } from "../services/tasks.js";
 export { answerStdinOption, signInSteps, } from "../terminal/sign-in-steps.js";
+export { liftOptionsAfterDashes } from "./after-dashes.js";
 export { evaluateAgent, } from "./agent-evaluation.js";
 export { answerEntity } from "./answer-entity.js";
 export { appDoctorReport } from "./app-doctor-command.js";
@@ -59,7 +60,7 @@ export { withDeadline } from "./deadline.js";
 export { DEFAULT_CONFIG, ensureDefaultConfig } from "./default-config.js";
 export { DISCOVERY_DESCRIPTIONS } from "./discovery-descriptions.js";
 export { changesAuthority, changesAuthorityAt, changesAuthorityNow, destroysNothing, FETCH, fetchesOnly, fetchesOnlyAt, grantsAuthority, isLogin, isOtherServiceCall, isStoreChange, judgedEffects, judgedTargets, LOCAL_READ, LOCAL_WRITE, logsInOrOut, NO_EFFECTS, ownerOnlyOption, previewFlag, REMOTE_READ, REMOTE_WRITE, reachesOtherService, readsOverMcp, readsOverMcpAt, refuseUnderReadOnly, storeChangeRefusal, writesFileOnlyWith, } from "./effects.js";
-export { startCli } from "./entry.js";
+export { openBrowser, startCli } from "./entry.js";
 export { answerSchema, isBody, itemAnswer, itemOf, jsonlRecords, judgedAnswer, listOf, metaNow, printItem, renderAnswer, sealed, snakeKeys, snakeKeysKeeping, } from "./envelope.js";
 export { withAbort } from "./execution.js";
 export { askSetupQuestions, asksAtStart, setupAtStart, systemLanguage, } from "./first-run.js";

package/dist/cli/messenger/admin-commands.js

@@ -247,7 +247,11 @@ const requestsCommand = (messenger) => {
 };
 /** `chats create`, `join`, `leave`, `update` and `link`: the help text is max-cli's, the one both tools say (standard, help rule 2). */
 export const groupCommands = (messenger) => [
-    annotate(new Command("create"), { output: { entity: "chat_group_change" }, effects: REMOTE_WRITE })
+    annotate(new Command("create"), {
+        output: { entity: "chat_group_change" },
+        effects: REMOTE_WRITE,
+        literal_after_dashes: true,
+    })
         .description("create a group or a channel; the people added are told")
         .argument("<title>", "the group's name")
         .argument("[person...]", "people to add: an id, or part of a name")

package/dist/cli/messenger/admin-contacts-command.js

@@ -30,7 +30,11 @@ export const contactWriteCommands = (messenger) => {
         const done = await context.withServices((services) => services.people[name](person));
         renderAnswer(this, context, itemOf(snakeKeys(done)));
     }));
-    const rename = annotate(new Command("rename"), { effects: REMOTE_WRITE, output: { entity: "contact_update" } })
+    const rename = annotate(new Command("rename"), {
+        effects: REMOTE_WRITE,
+        output: { entity: "contact_update" },
+        literal_after_dashes: true,
+    })
         .summary("change a contact's name in the messenger address book")
         .description("rename the contact in the messenger address book; use contacts alias for a private local name")
         .argument("<person>", PERSON)

package/dist/cli/messenger/admin-folders-command.js

@@ -57,7 +57,11 @@ export const foldersCommand = (messenger) => {
         const found = await context.withServices((services) => services.folders.show(folder));
         renderAnswer(this, context, itemOf(folderAnswer(found)));
     }));
-    folders.addCommand(withRules(annotate(new Command("create"), { output: { entity: "chat_folder_change" }, effects: REMOTE_WRITE })
+    folders.addCommand(withRules(annotate(new Command("create"), {
+        output: { entity: "chat_folder_change" },
+        effects: REMOTE_WRITE,
+        literal_after_dashes: true,
+    })
         .description("create a chat folder")
         .argument("<title>", "the folder's name; the app may refuse a long one")
         .option("--chat <chat>", "a chat to put in it, by id or name; repeat it for more", collect), messenger, false).action(async function (title) {

package/dist/cli/messenger/complete-command.js

@@ -20,6 +20,7 @@ const SHELLS = ["zsh", "bash", "fish", "powershell"];
  * exists — no store, no names — and nothing goes to stderr: a shell shows whatever it is given.
  */
 export const completeCommand = (messenger, config, options = {}) => annotate(new Command("complete"), {
+    literal_after_dashes: true,
     effects: LOCAL_READ,
     mcp: false,
     examples: [`${messenger.app.command} complete zsh`],

package/dist/cli/messenger/messages-command.js

@@ -97,9 +97,8 @@ export const messagesCommand = (messenger) => {
     annotate(list, { output: { entity: "message" }, query: history });
     const readWindow = async (command, chat, message, window) => {
         const context = messengerContext(command, messenger);
-        const target = targetOf(messenger, chat, message);
         const { found, reader } = await context.withServices(async (services) => ({
-            found: await services.messages.around(isLocator(chat) ? chat : target.chat, isLocator(chat) ? undefined : target.message, window),
+            found: await services.messages.around(chat, message?.trim(), window),
             reader: await services.messages.reader(),
         }));
         const hearing = await hearForCommand(context, messenger, found, false);
@@ -156,9 +155,8 @@ export const messagesCommand = (messenger) => {
         const requested = threadRequest(this).thread;
         if (requested) {
             const context = messengerContext(this, messenger);
-            const target = targetOf(messenger, chat, message);
             const { found, reader } = await context.withServices(async (services) => ({
-                found: await services.messages.thread(isLocator(chat) ? chat : target.chat, isLocator(chat) ? undefined : target.message, { ...requested, before, after }),
+                found: await services.messages.thread(chat, message?.trim(), { ...requested, before, after }),
                 reader: await services.messages.reader(),
             }));
             if (found.fallback)
@@ -203,19 +201,4 @@ const count = (value) => {
         throw new CliError("validation_error", `"${value}" is not a count`);
     return parsed;
 };
-/** A chat and a message id, or one locator naming both — which must be this messenger's. */
-const targetOf = (messenger, chat, message) => {
-    if (isLocator(chat)) {
-        if (message !== undefined)
-            throw new CliError("validation_error", "a locator already names the message");
-        const locator = parseLocator(chat);
-        if (locator.provider !== messenger.provider) {
-            throw new CliError("validation_error", `that locator is a ${locator.provider} message, not ${messenger.provider}`);
-        }
-        return { chat: locator.chat, message: locator.message };
-    }
-    if (message === undefined)
-        throw new CliError("validation_error", "which message? give its id after the chat");
-    return { chat, message: message.trim() };
-};
 export { sendCommand } from "./messages-send-command.js";

package/dist/cli/messenger/messages-edit-command.js

@@ -9,6 +9,7 @@ import { HTML_HELP } from "./messages-send-command.js";
 import { readAll } from "./stdin.js";
 export const editCommand = (messenger) => {
     const edit = annotate(new Command("edit"), {
+        literal_after_dashes: true,
         examples: [`${messenger.app.command} personal messages edit "Book club" 101 "The meeting starts at 11."`],
         effects: REMOTE_WRITE,
         output: { entity: "message_write" },

package/dist/cli/messenger/messages-press-command.js

@@ -6,6 +6,7 @@ import { itemOf, renderAnswer, snakeKeys } from "../envelope.js";
 import { messengerContext } from "./context.js";
 /** `messages press` — one of a bot's callback buttons; the bot sees who pressed it. */
 export const pressCommand = (messenger) => annotate(new Command("press"), {
+    literal_after_dashes: true,
     effects: REMOTE_WRITE,
     examples: [`${messenger.app.command} personal messages press "Example Bot" 101 1`],
 })

package/dist/cli/messenger/messages-send-command.js

@@ -20,6 +20,7 @@ const collect = (value, previous) => [...previous, value];
 const repeatable = (flags, description) => new Option(flags, description).argParser(collect).default([], "none");
 export const sendCommand = (messenger) => {
     const send = annotate(new Command("send"), {
+        literal_after_dashes: true,
         examples: [`${messenger.app.command} personal messages send "Book club" "The meeting starts at 10."`],
         effects: REMOTE_WRITE,
         output: { entity: messenger.drafts === true ? "message_send" : "message_write" },

package/dist/cli/messenger/observed.js

@@ -42,9 +42,9 @@ export const observed = (messenger, events) => {
     };
     const counted = async (operation, onItem, work, count) => {
         const counts = {};
-        await timed(operation, {}, () => work((item) => {
+        await timed(operation, {}, () => work((item, ...rest) => {
             count(item, counts);
-            return onItem(item);
+            return onItem(item, ...rest);
         }), () => ({ counts }));
     };
     const mint = messenger.newSendId;

package/dist/cli/messenger/polls-command.js

@@ -110,6 +110,7 @@ export const pollsCommand = (messenger) => {
             renderAnswer(this, context, itemOf(snakeKeys(closed)));
         });
     const create = annotate(polls.command("create"), {
+        literal_after_dashes: true,
         output: { entity: "message_write" },
         effects: REMOTE_WRITE,
         examples: [`${messenger.app.command} personal polls create "Book club" "Which day?" Monday Tuesday`],

package/dist/cli/messenger/private-people-command.js

@@ -14,7 +14,11 @@ const NOTES_QUERY = unfilteredQuery("contact_note", contactNote);
 const everyNote = (command, items) => listOf(command, { items, limit: Math.max(1, items.length), has_more: false });
 export const privatePeopleCommands = (messenger) => {
     const alias = new Command("aliases").description("a private local display name in the selected account");
-    annotate(alias.command("set"), { effects: LOCAL_WRITE, output: { entity: "contact_alias" } })
+    annotate(alias.command("set"), {
+        effects: LOCAL_WRITE,
+        output: { entity: "contact_alias" },
+        literal_after_dashes: true,
+    })
         .description("your own name for a person in this account; kept on this machine, never sent")
         .argument("<person>", "the person's id, reference or known name")
         .argument("<alias>", "the private name to use for this person")

package/dist/cli/messenger/stored.js

@@ -1,9 +1,10 @@
 import { CliError } from "@wirecat/cli-base";
+import { chatReferenceOf, ensureAccount } from "../../domain/ref-arguments.js";
 import { capability, throughWrapper, } from "../../ports/messenger.js";
 import { foldName, isId, pickPerson } from "../../resolve.js";
 import { codeOf } from "../../sends/guarded.js";
 import { limitBatch } from "../../services/history-limits.js";
-import { chatIdIn } from "../../services/message-resolution.js";
+import { chatIdIn, profilesOnAccount } from "../../services/message-resolution.js";
 const REKEY_PACING = { lockMs: 50, pauseMs: 25 };
 /**
  * The adapter, with what each read answers written to the store. **A failed write never fails the
@@ -201,12 +202,12 @@ export const stored = (messenger, { account, store, warn, events, pending, annou
                 pending?.delete(saving);
                 rekeysOnly.delete(saving);
             });
-            void onBatch(batch);
+            void onBatch(batch, saving);
             return saving;
         };
     };
     // A method not listed here saves nothing and passes through; a lane that should save adds its line.
-    return throughWrapper(messenger, {
+    const wrapped = throughWrapper(messenger, {
         ...(messenger.forumState
             ? {
                 forumState: async (chatId) => {
@@ -465,6 +466,58 @@ export const stored = (messenger, { account, store, warn, events, pending, annou
             return sent;
         },
     });
+    const chatOf = async (typed) => {
+        const named = chatReferenceOf(typed, account.provider);
+        if (!named)
+            return typed;
+        let known;
+        try {
+            known = account.account;
+        }
+        catch { }
+        await ensureAccount(named, { account: known, ...(profile ? { profile: profile.name } : {}) }, async (other) => {
+            const opened = await store();
+            return opened && profilesOnAccount(opened, profile?.app, account.provider)(other);
+        });
+        return named.chat;
+    };
+    return withChatReferences(wrapped, chatOf);
+};
+/** The adapter methods whose first argument is a chat as typed: an id, a title, or a `chat:` or `msg:` reference. */
+const TYPED_CHAT = [
+    "resolve",
+    "chat",
+    "history",
+    "around",
+    "historyAfter",
+    "historyBefore",
+    "historyFrom",
+    "topics",
+    "topic",
+    "topicHistory",
+    "download",
+    "transcribe",
+    "scheduled",
+    "admins",
+    "chatEvents",
+    "leave",
+    "group",
+    "officialChatStats",
+];
+/**
+ * A reference is read here, not in each adapter: an adapter resolves a typed chat as an id or a title, and would take
+ * `chat:max/…` for a title. One of another account is refused before the messenger is asked.
+ */
+const withChatReferences = (adapter, chatOf) => {
+    const methods = adapter;
+    const own = Object.fromEntries(TYPED_CHAT.flatMap((name) => {
+        const method = methods[name];
+        if (typeof method !== "function")
+            return [];
+        const call = async (typed, ...rest) => method.call(adapter, await chatOf(typed), ...rest);
+        return [[name, call]];
+    }));
+    return throughWrapper(adapter, own);
 };
 /**
  * A write is saved under the chat the messenger answered, not the one typed: WhatsApp answers a re-keyed person's

package/dist/cli/messenger/topics-command.js

@@ -68,7 +68,7 @@ export const topicsCommand = (messenger) => {
         const done = await context.withServices((services) => services.topics.enable(chat, { upgrade: this.opts().upgrade === true }));
         renderAnswer(this, context, itemOf(snakeKeys(done)));
     });
-    annotate(topics.command("create"), { effects: REMOTE_WRITE })
+    annotate(topics.command("create"), { effects: REMOTE_WRITE, literal_after_dashes: true })
         .description("create a named topic in an existing forum; never enable or upgrade a group implicitly")
         .argument("<chat>", messenger.chatArgument)
         .argument("<title>", "the topic title, at most 128 UTF-8 bytes")

package/dist/cli/program.js

@@ -13,6 +13,7 @@ import { recorded, wasSettled } from "../runs/recording.js";
 import { runContextOf } from "../runs/run-context.js";
 import { processRun, useAsProcessRun } from "../runs/scope.js";
 import { AUTHORITY_KEY, BOT_API_KEY, isBotApi, keyForCommand } from "../sends/permissions.js";
+import { liftOptionsAfterDashes } from "./after-dashes.js";
 import { logParsedArgv, logVersion } from "./argv-log.js";
 import { commandAvailability } from "./command-availability.js";
 import { commandPathOf } from "./command-contract.js";
@@ -135,15 +136,16 @@ export const run = async (argv, definition, options = {}) => {
         useAsProcessRun(outer);
     }
 };
+const isMachine = (words) => words.some((word) => word === "--json" || word.startsWith("--json=") || word === "--jsonl");
 const runOnce = async (argv, definition, options) => {
     const streams = options.streams ?? processStreams;
     if (!options.streams)
         quietBrokenPipes();
     const delimiter = argv.indexOf("--");
     const flags = argv.slice(0, delimiter < 0 ? undefined : delimiter);
-    const machine = flags.some((word) => word === "--json" || word.startsWith("--json=") || word === "--jsonl");
-    const debug = flags.includes("--debug");
-    const reporting = machine ? { ...options, tty: false } : options;
+    let machine = isMachine(flags);
+    let debug = flags.includes("--debug");
+    let reporting = machine ? { ...options, tty: false } : options;
     const control = execution(streams, { maxOutputBytes: 0 });
     let restoreInput;
     let signalExit;
@@ -439,12 +441,21 @@ const runOnce = async (argv, definition, options) => {
     forEachCommand(program, (child) => child.exitOverride());
     // Before commander, not inside it: commander has no hook that runs before it decides which
     // subcommand it is looking at.
-    const { profile, rest: lifted } = liftProfile(argv, commandWords(program), valuedOptions(program));
+    const profiled = liftProfile(argv, commandWords(program), valuedOptions(program));
+    const { profile } = profiled;
+    // An agent's call builds its own argv, with its values after `--` on purpose: none of them may become an option.
+    const lifted = options.agent
+        ? profiled.rest
+        : liftOptionsAfterDashes(profiled.rest, (words) => commandAt(program, commandPath(program, words)));
+    const liftedEnd = lifted.indexOf("--");
+    const liftedFlags = lifted.slice(0, liftedEnd < 0 ? undefined : liftedEnd);
+    machine ||= isMachine(liftedFlags);
+    debug ||= liftedFlags.includes("--debug");
+    reporting = machine ? { ...options, tty: false } : options;
     // `wa 'chats list' --help` reads "chats list" as a profile and prints the root help with exit 0.
     try {
         // Only before `--`: what follows is a positional, an agent's text among them, never a command word.
-        const end = lifted.indexOf("--");
-        for (const words of [flags, end < 0 ? lifted : lifted.slice(0, end)])
+        for (const words of [flags, liftedFlags])
             refuseJoinedPath(program, words.filter((word) => !word.startsWith("-")), profile !== undefined && !/\s/.test(profile) ? [profile] : []);
     }
     catch (failure) {

package/dist/cli/schedule/schedule-command.js

@@ -110,6 +110,7 @@ export const scheduleCommandFor = ({ app, context: contextOf }) => {
         return { context, system, state, say, timer, environment, save };
     };
     withWhen(grantsAuthority(annotate(command.command("command"), {
+        literal_after_dashes: true,
         effects: LOCAL_WRITE,
         examples: [
             `${app.command} personal schedule command health --every 1h -- doctor`,

package/dist/domain/message-link.d.ts

@@ -24,13 +24,16 @@ export type MessageLink = MessagePermalink & {
     files?: FileLink[];
 };
 export declare const fileLinks: (attachments: readonly Attachment[]) => FileLink[];
+/** A chat and a message id, or one reference naming both; a reference's account is for the caller to check. */
 export declare const messageLinkTarget: (reference: string, message: string | undefined, provider: string) => {
     chat: string;
     message: string;
     account: string;
+    text: string;
 } | {
     chat: string;
     message: string;
     account: undefined;
+    text: string;
 };
 export declare const validatePermalink: (link: MessagePermalink) => MessagePermalink;

package/dist/domain/message-link.js

@@ -1,6 +1,6 @@
 import { CliError } from "@wirecat/cli-base";
 import { hitFiles } from "./attachments.js";
-import { isLocator, parseLocator } from "./locator.js";
+import { chatReferenceOf } from "./ref-arguments.js";
 export const fileLinks = (attachments) => hitFiles(attachments).map(({ position, kind, name }) => ({
     position,
     kind,
@@ -8,28 +8,23 @@ export const fileLinks = (attachments) => hitFiles(attachments).map(({ position,
     url: null,
     reason: "unsupported_provider",
 }));
+/** A chat and a message id, or one reference naming both; a reference's account is for the caller to check. */
 export const messageLinkTarget = (reference, message, provider) => {
-    if (isLocator(reference)) {
+    const named = chatReferenceOf(reference, provider, "message");
+    if (named?.message !== undefined) {
         if (message !== undefined)
             throw new CliError("validation_error", "a locator already names the message");
-        let target;
-        try {
-            target = parseLocator(reference);
-        }
-        catch {
-            throw new CliError("validation_error", "expected msg:<provider>/<account>/<chat>/<message>");
-        }
-        if (target.provider !== provider)
-            throw new CliError("validation_error", "that locator belongs to another messenger");
-        validMessageId(target.message);
-        return { chat: target.chat, message: target.message, account: target.account };
+        validMessageId(named.message);
+        return { chat: named.chat, message: named.message, account: named.account, text: named.text };
     }
     if (message === undefined)
         throw new CliError("validation_error", "which message? give its id after the chat");
     validMessageId(message);
+    if (named)
+        return { chat: named.chat, message, account: named.account, text: named.text };
     if (!reference.trim())
         throw new CliError("validation_error", "which chat? give its id or title");
-    return { chat: reference, message, account: undefined };
+    return { chat: reference, message, account: undefined, text: reference };
 };
 const validMessageId = (id) => {
     if (!id ||

package/dist/domain/money-words.d.ts

@@ -0,0 +1,11 @@
+import type { TaskCategory } from "./task-categories.js";
+/**
+ * Verb classes for reading money in a chat, matched by stem as task categories are. A stem cannot tell the imperative
+ * from the past tense (`оплати`, `оплатил` → `оплат`) or from a promise (`pagué`, `pagaré` → `pag`), so a stem that
+ * several classes share is listed once, under the request, and a word only counts where its stem is its own. The
+ * signal that reads these keeps the sender's side (owner or other) to decide the direction.
+ */
+export declare const MONEY_REQUEST = "money-request";
+export declare const MONEY_DONE = "money-done";
+export declare const PROMISE = "promise";
+export declare const MONEY_WORDS: readonly TaskCategory[];

package/dist/domain/money-words.js

@@ -0,0 +1,38 @@
+/**
+ * Verb classes for reading money in a chat, matched by stem as task categories are. A stem cannot tell the imperative
+ * from the past tense (`оплати`, `оплатил` → `оплат`) or from a promise (`pagué`, `pagaré` → `pag`), so a stem that
+ * several classes share is listed once, under the request, and a word only counts where its stem is its own. The
+ * signal that reads these keeps the sender's side (owner or other) to decide the direction.
+ */
+export const MONEY_REQUEST = "money-request";
+export const MONEY_DONE = "money-done";
+export const PROMISE = "promise";
+export const MONEY_WORDS = [
+    {
+        name: MONEY_REQUEST,
+        meaning: "asks for a payment or sends an invoice",
+        triggers: {
+            en: ["pay", "send", "transfer", "invoice", "owe", "refund", "remit"],
+            ru: ["переведи", "оплати", "заплати", "вышли", "отправь", "скинь", "верни", "счёт", "выстави", "должен"],
+            es: ["envía", "transfiere", "factura", "debes", "devuelve", "abona"],
+        },
+    },
+    {
+        name: MONEY_DONE,
+        meaning: "says a payment was made or received",
+        triggers: {
+            en: ["paid", "sent", "received", "settled"],
+            ru: ["перевёл", "перевела", "выслал", "вернул", "скинул", "получил", "получила"],
+            es: ["recibido"],
+        },
+    },
+    {
+        name: PROMISE,
+        meaning: "promises to pay or send later",
+        triggers: {
+            en: ["promise", "promised", "guarantee"],
+            ru: ["оплачу", "заплачу", "отправлю", "обещаю", "гарантирую"],
+            es: ["prometo", "transferiré", "devolveré"],
+        },
+    },
+];

package/dist/domain/providers.d.ts

@@ -11,6 +11,8 @@ export interface ProviderEntry {
 }
 /** The seed: what cli-core knows before any CLI has written its entry into the store. */
 export declare const PROVIDERS: readonly ProviderEntry[];
+/** How a text names a provider to a person: `MAX`, not `max`. */
+export declare const providerLabel: (provider: Provider) => string;
 /**
  * A notes folder is an `accounts` row of one of these providers; people call every one `notes`. `obsidian` is a vault,
  * `local` a plain folder (store version 32). `folder` is what they were before, and what Drive's stand-in folders and

package/dist/domain/providers.js

@@ -3,11 +3,11 @@ import { CliError } from "@wirecat/cli-base";
 export const KINDS = ["messages", "mail", "notes", "documents", "meetings", "events"];
 /** The seed: what cli-core knows before any CLI has written its entry into the store. */
 export const PROVIDERS = [
-    { name: "telegram", kind: "messages", aliases: ["tg"] },
+    { name: "telegram", kind: "messages", aliases: ["tg"], command: "tg" },
     { name: "telegram-bot", kind: "messages", aliases: ["tg-bot"] },
-    { name: "max", kind: "messages", aliases: [] },
+    { name: "max", kind: "messages", aliases: [], command: "max" },
     { name: "max-bot", kind: "messages", aliases: [] },
-    { name: "whatsapp", kind: "messages", aliases: ["wa"] },
+    { name: "whatsapp", kind: "messages", aliases: ["wa"], command: "wa" },
     { name: "whatsapp-bot", kind: "messages", aliases: ["wa-bot"] },
     { name: "email", kind: "mail", aliases: [] },
     { name: "notes", kind: "notes", aliases: [] },
@@ -15,6 +15,18 @@ export const PROVIDERS = [
     { name: "obsidian", kind: "notes", aliases: [] },
     { name: "zoom", kind: "meetings", aliases: [] },
 ];
+const LABELS = {
+    telegram: "Telegram",
+    "telegram-bot": "Telegram bot",
+    max: "MAX",
+    "max-bot": "MAX bot",
+    whatsapp: "WhatsApp",
+    "whatsapp-bot": "WhatsApp bot",
+    "google-drive": "Google Drive",
+    email: "mail",
+};
+/** How a text names a provider to a person: `MAX`, not `max`. */
+export const providerLabel = (provider) => LABELS[provider] ?? provider;
 /**
  * A notes folder is an `accounts` row of one of these providers; people call every one `notes`. `obsidian` is a vault,
  * `local` a plain folder (store version 32). `folder` is what they were before, and what Drive's stand-in folders and

package/dist/domain/ref-arguments.d.ts

@@ -0,0 +1,31 @@
+import { CliError } from "@wirecat/cli-base";
+import type { Id, Provider } from "./models.js";
+/** A `chat:` or `msg:` reference given where a messenger command takes a chat or a message. */
+export interface ChatReference {
+    text: string;
+    provider: Provider;
+    account: Id;
+    chat: Id;
+    message?: Id;
+}
+/** The account a reference must belong to; `account` is `undefined` while this profile's is not known yet. */
+export interface RefScope {
+    account: Id | undefined;
+    profile?: string;
+}
+/** The profiles of this app the store saw on an account; `undefined` when that cannot be told. */
+export type ProfilesOn = (account: Id) => Promise<readonly string[] | undefined>;
+/**
+ * The chat or message a reference names, when `text` is one of this provider's; `undefined` for text that is no
+ * reference, which stays an id or a title. Another kind or another messenger is refused, never read as a title.
+ */
+export declare const chatReferenceOf: (text: string, provider: Provider, takes?: "chat" | "message") => ChatReference | undefined;
+/**
+ * The identity a `contact:` reference names, when it is one of this provider's; `undefined` for any other text. A
+ * `person:` reference is the store's person, which the callers that take one read before this.
+ */
+export declare const contactReferenceOf: (text: string, provider: Provider | undefined) => Id | undefined;
+/** The refusal of another account's reference: switching to it silently would read or send as somebody else. */
+export declare const wrongAccount: (reference: Pick<ChatReference, "text" | "account">, scope: RefScope, profiles?: readonly string[]) => CliError;
+/** Refuses a reference of another account than the scope's, naming the profiles that have it. */
+export declare const ensureAccount: (reference: Pick<ChatReference, "text" | "account">, scope: RefScope, profilesOn?: ProfilesOn) => Promise<void>;