@wirecat/cli-core 0.405.0 → 0.406.0

package/CHANGELOG.md

@@ -5,7 +5,30 @@ Notable changes to `@wirecat/cli-core` (`@wirecat/cli-messaging` up to 0.261.0,
 minor version may break callers, and says how under "Changed — may break callers". `pnpm docs:check` checks the
 shape of this file.
 
-## Unreleased
+## 0.406.0 — 24.10.2026
+
+### Added
+
+- `StoredMessages.threadMessages` lets an adapter read a provider thread from the shared message store without
+  keeping another copy. `HistoryBatch.deletions` applies chat-scoped tombstones from synced snapshots without
+  replaying those deletions as live events. `Messenger.readsComments` allows comment reads independently of
+  comment sending; unset, it keeps the existing capability behavior.
+- Speech model installation can verify existing files before reusing them (`verifyExisting`), so repair uses the shared checksum and download path.
+- Provider adapters can declare a typed answer with `answerEntity`, shared by command schemas, help and JSON field validation without changing a shared entity.
+
+### Fixed
+
+- Finite meeting inventory, project scanning and upgrade commands are available to the shared MCP catalogue. Profile permissions still apply; upgrade retains its authority grant.
+
+### Changed — may break callers
+
+- **Only canonical option spellings are accepted.** The hidden flag aliases introduced in 0.399.0 are removed: use the analysis/embedding/consent provider flags, `--claim`, `--answer-model`, `--template-mode`, `--text-file`, `--disappear-after` and the `kind:` query term. Retired flags are refused before command work.
+
+- **Shared command paths use the vocabulary.** Contacts use `info`, `events` and `aliases remove`; chat invite links use `links remove`, member checks use `check`, and join requests use `confirm` or `reject`. Metadata uses `show` and `sync`; task edits use `update`; derived tags and search indexes use `rebuild`. Discovery uses `commands info`; MCP configuration uses `mcp add` and `mcp check`.
+
+- **Explicit model and conversation commands.** Use `models list kind:audio` or `kind:text`, `models download <model>` and `models keys set/remove`. Conversation link construction is `conversations links rebuild`; vector reports and removal are `conversations embeddings status/clear`, while `conversations embed` still computes vectors. Duplicate candidates are `tasks duplicates list`. Report information is `doctor reports show`; `doctor reports create` writes the report. Bare groups only offer help. Retired spellings are refused with guidance to the canonical path; no compatibility command aliases are mounted. CLI and MCP use the same paths.
+
+- **Rename moved permission paths.** A saved key or startup override using a renamed path now stops with `configuration_error` and its exact replacement (including bot keys), before opening the store or performing the action. Canonical commands keep the migrated denial; retired CLI spellings cannot run.
 
 ## 0.405.0 — 24.10.2026
 

package/dist/botcheck/reasons.d.ts

@@ -1,4 +1,4 @@
-/** What `chats members audit` judges from a member list and the store. */
+/** What `chats members check` judges from a member list and the store. */
 export type AuditReason = "bot" | "scam" | "fake" | "deleted" | "no_photo" | "no_username" | "odd_name" | "never_wrote" | "link_first" | "burst_join" | "mass_invited";
 /** What only a look at one person adds: their profile, all their stored messages, the registries. */
 export type PersonReason = "new_account" | "no_bio" | "same_text" | "photo_recent" | RegistryReason;

package/dist/cli/analysis-choice.js

@@ -35,6 +35,6 @@ export const analysisChoice = (options, app, settings, env, keyring) => {
     const keyName = customUrl === undefined ? provider : endpointKeyName(baseUrl);
     const apiKey = embeddingKeys(app, env, keyring).read(keyName)?.key;
     if (!apiKey && customUrl === undefined)
-        throw new CliError("authentication_error", `no ${provider} key — use models text key set ${provider}`);
+        throw new CliError("authentication_error", `no ${provider} key — use models keys set ${provider}`);
     return { provider, model, baseUrl, ...(apiKey ? { apiKey } : {}) };
 };

package/dist/cli/answer-entity.d.ts

@@ -0,0 +1,5 @@
+import type { Command } from "commander";
+import type * as v from "valibot";
+/** Provider-specific wire fields must not redefine an entity shared by every CLI. */
+export declare const answerEntity: (command: Command, name: string, schema: v.GenericSchema) => Command;
+export declare const answerEntitySchema: (command: Command | undefined) => v.GenericSchema | undefined;

package/dist/cli/answer-entity.js

@@ -0,0 +1,25 @@
+import { annotate, metaOf } from "@wirecat/cli-base/commands";
+import { ENTITIES } from "../entities/index.js";
+const schemas = new WeakMap();
+/** Provider-specific wire fields must not redefine an entity shared by every CLI. */
+export const answerEntity = (command, name, schema) => {
+    if (Object.hasOwn(ENTITIES, name))
+        throw new Error(`${name} is a shared entity; use its existing schema`);
+    if (!/^[a-z][a-z0-9_]*$/.test(name))
+        throw new Error("an answer entity needs a lowercase name");
+    if (!("entries" in schema) && schema.type !== "union")
+        throw new Error("an answer entity needs an object schema or a union of object schemas");
+    schemas.set(command, { name, schema });
+    return annotate(command, { output: { entity: name } });
+};
+export const answerEntitySchema = (command) => {
+    const output = command && metaOf(command).output;
+    if (!output)
+        return undefined;
+    const name = output.view ? `${output.entity}.${output.view}` : output.entity;
+    const shared = ENTITIES[name];
+    if (shared)
+        return shared;
+    const own = schemas.get(command);
+    return own?.name === name ? own.schema : undefined;
+};

package/dist/cli/command-contract.js

@@ -1,8 +1,8 @@
 import { CliError } from "@wirecat/cli-base";
 import { describeOptions, metaOf } from "@wirecat/cli-base/commands";
 import { jsonSchemaOf } from "@wirecat/cli-base/standards";
-import { ENTITIES } from "../entities/index.js";
 import { keyForCommand } from "../sends/permissions.js";
+import { answerEntitySchema } from "./answer-entity.js";
 import { answerSchema } from "./envelope.js";
 export const SCHEMA_DIALECT = "https://json-schema.org/draft/2020-12/schema";
 /**
@@ -10,10 +10,7 @@ export const SCHEMA_DIALECT = "https://json-schema.org/draft/2020-12/schema";
  * A command that declares none answers the same envelopes with items of any shape; `--jsonl` streams the items.
  */
 export const outputOf = (command) => {
-    const output = metaOf(command).output;
-    const entity = output
-        ? ENTITIES[(output.view ? `${output.entity}.${output.view}` : output.entity)]
-        : undefined;
+    const entity = answerEntitySchema(command);
     const { $schema: _, ...schema } = jsonSchemaOf(answerSchema(entity));
     const { $schema: __, ...item } = (entity ? jsonSchemaOf(entity) : {});
     const coverage = entity ? "declared-entity" : "envelope-with-open-items";

package/dist/cli/commands-command.js

@@ -50,7 +50,10 @@ export const commandsCommand = (app) => {
             exit_codes: { ok: 0, [CRASH_CODE]: GENERIC_FAILURE, ...EXIT_CODES },
         });
     });
-    command.addCommand(annotate(new Command("schema"), { effects: NO_EFFECTS })
+    command.addCommand(annotate(new Command("info"), {
+        effects: NO_EFFECTS,
+        examples: [`${app.command} commands info messages list`],
+    })
         .description("one command's argv and result schemas, effects, permissions and retry guidance")
         .argument("<path...>", "one command path, for example: stats messages show")
         .action(function (path) {

package/dist/cli/effects.js

@@ -124,7 +124,7 @@ export const ownerOnlyOption = (flags, description) => annotateOption(new Option
 export const judgedEffects = (effects) => effects && { remote: effects.remote, local: "none" };
 /**
  * An unasked step is judged stricter than a retry: only a fetch's local write is incidental. A command that reads
- * nothing remotely and writes here (`server restart`, `store reindex`) is the whole point of the step, so it waits
+ * nothing remotely and writes here (`server restart`, `store rebuild`) is the whole point of the step, so it waits
  * to be asked (RISK-1211).
  */
 const judgedStepEffects = (effects) => effects?.remote === "none" ? effects : judgedEffects(effects);

package/dist/cli/embedding-choice.d.ts

@@ -10,7 +10,7 @@ export interface ModelOptions {
     dims?: number;
     concurrency?: number;
 }
-/** A local model id, or a remote model with its key from `models text key set`. */
+/** A local model id, or a remote model with its key from `models keys set`. */
 export declare const embeddingChoice: ({ model, provider, embeddingProvider, baseUrl, dims, concurrency }: ModelOptions, app: AppIdentity, settings: AISettings, env: NodeJS.ProcessEnv, { needKey, keyring }?: {
     needKey?: boolean;
     keyring?: KeyringStore | undefined;

package/dist/cli/embedding-choice.js

@@ -5,7 +5,7 @@ import { DEFAULT_TEXT_MODEL } from "../embeddings/models.js";
 import { isLocal, remoteModel } from "../embeddings/remote.js";
 import { readOnlyLockOf, readOnlyRefusal } from "../ports/app.js";
 import { typedCommand } from "../runs/scope.js";
-/** A local model id, or a remote model with its key from `models text key set`. */
+/** A local model id, or a remote model with its key from `models keys set`. */
 export const embeddingChoice = ({ model, provider, embeddingProvider, baseUrl, dims, concurrency }, app, settings, env, { needKey = true, keyring } = {}) => {
     if (embeddingProvider !== undefined && provider !== undefined)
         throw new CliError("validation_error", "give --embedding-provider or its legacy --provider spelling, not both");
@@ -34,7 +34,7 @@ export const embeddingChoice = ({ model, provider, embeddingProvider, baseUrl, d
     const keyName = baseUrl === undefined ? "openai" : endpointKeyName(baseUrl);
     const key = embeddingKeys(app, env, keyring).read(keyName)?.key;
     if (!key && needKey && baseUrl === undefined) {
-        throw new CliError("authentication_error", `no OpenAI key — \`${typedCommand(app.command, "models text key set openai")}\`, or OPENAI_API_KEY`);
+        throw new CliError("authentication_error", `no OpenAI key — \`${typedCommand(app.command, "models keys set openai")}\`, or OPENAI_API_KEY`);
     }
     return { remote, ...(key ? { apiKey: key } : {}), ...(concurrency ? { concurrency } : {}) };
 };

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

@@ -112,8 +112,8 @@ const returnsOf = (command) => {
     const noun = (output.view ? `${output.entity} ${output.view}` : output.entity).replaceAll("_", " ");
     const more = fields.length > 8 ? `, and ${fields.length - 8} more` : "";
     const root = rootOf(command);
-    const schema = commandAt(root, "commands schema")
-        ? `; every field: ${root.name()} commands schema ${commandPathOf(command).join(" ")}`
+    const schema = commandAt(root, "commands info")
+        ? `; every field: ${root.name()} commands info ${commandPathOf(command).join(" ")}`
         : "";
     return `${noun} — ${fields.slice(0, 8).join(", ")}${more}${schema}`;
 };

package/dist/cli/index.d.ts

@@ -33,6 +33,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 { type AgentPolicy, type AgentTask, type EvaluationResult, evaluateAgent, type Observation, } from "./agent-evaluation.js";
+export { answerEntity } from "./answer-entity.js";
 export { botAdminsCommand, botMembersCommand } from "./bot/admins.js";
 export { type ApiCommandInput, type ApiCommands, generatedApiCommand } from "./bot/api.js";
 export { apiFlagOf, apiJson, apiOptionKey, apiPlainJson, checkApiBody, checkApiParameter, parseApiJson, readApiBody, } from "./bot/api-input.js";

package/dist/cli/index.js

@@ -28,6 +28,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 { evaluateAgent, } from "./agent-evaluation.js";
+export { answerEntity } from "./answer-entity.js";
 export { botAdminsCommand, botMembersCommand } from "./bot/admins.js";
 export { generatedApiCommand } from "./bot/api.js";
 export { apiFlagOf, apiJson, apiOptionKey, apiPlainJson, checkApiBody, checkApiParameter, parseApiJson, readApiBody, } from "./bot/api-input.js";

package/dist/cli/json-fields.js

@@ -1,6 +1,7 @@
 import { CliError } from "@wirecat/cli-base";
 import { metaOf } from "@wirecat/cli-base/commands";
 import { ENTITIES } from "../entities/index.js";
+import { answerEntitySchema } from "./answer-entity.js";
 const declaredEntity = (command) => {
     const output = command ? metaOf(command).output : undefined;
     return output && (output.view ? `${output.entity}.${output.view}` : output.entity);
@@ -37,8 +38,7 @@ export const answerFields = (command, resolve) => {
     const own = resolve?.(command);
     if (own !== undefined)
         return [...own];
-    const name = declaredEntity(command);
-    const schema = name === undefined ? undefined : ENTITIES[name];
+    const schema = answerEntitySchema(command);
     return schemaFields(schema);
 };
 const PATHS = /^[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)*(,[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)*)*$/;

package/dist/cli/meeting-project-candidates-command.js

@@ -31,7 +31,6 @@ export const addMeetingProjectCandidatesCommand = (program, deps) => {
         cursor: options.cursor,
     }, deps.signal()))), {
         origin: "handwritten",
-        mcp: false,
         effects: LOCAL_READ,
         output: { entity: "meeting_project_candidates" },
         examples: [`${program.name()} meetings projects scan meeting:1/2 --json`],

package/dist/cli/meeting-series-inventory-command.js

@@ -31,7 +31,6 @@ export const addMeetingSeriesInventoryCommand = (program, deps) => {
         origin: "handwritten",
         effects: REMOTE_READ,
         offline: false,
-        mcp: false,
         output: { entity: "meeting_series_inventory" },
         examples: [`${program.name()} meetings scheduled --json`],
     });

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

@@ -69,14 +69,8 @@ const updateCommand = (messenger) => {
         update.option("--remove-photo", "take its photo away; not with --photo");
     for (const key of keys) {
         const option = new Option(`--${SETTING_FLAGS[key][0]}`, SETTING_FLAGS[key][1]);
-        if (key === "disappearingSeconds")
-            option.conflicts("disappearTime");
         update.addOption(option);
     }
-    if (keys.includes("disappearingSeconds"))
-        update.addOption(new Option("--disappear-time <duration|off>", "compatibility alias for --disappear-after")
-            .hideHelp()
-            .conflicts("disappearAfter"));
     return update.action(async function (chat) {
         const context = messengerContext(this, messenger);
         const { title, description, photo, removePhoto, ...rest } = this.opts();
@@ -92,7 +86,7 @@ const updateCommand = (messenger) => {
     });
 };
 const linkCommand = (messenger) => {
-    const link = new Command("link").description("a group's invite link");
+    const link = new Command("links").description("a group's invite link");
     annotate(link.command("show"), { output: { entity: "chat_invite" }, effects: REMOTE_READ })
         .description("the invite link, if you may see it")
         .argument("<chat>", messenger.chatArgument)
@@ -132,10 +126,13 @@ const linkCommand = (messenger) => {
             ].join("  ")));
         }));
     if (messenger.inviteLinkRevoke !== false)
-        link.addCommand(annotate(new Command("revoke"), { output: { entity: "chat_invite_change" }, effects: REMOTE_WRITE })
+        link.addCommand(annotate(new Command("remove"), {
+            output: { entity: "chat_invite_change" },
+            effects: REMOTE_WRITE,
+        })
             .description("stop one link; for the group's own link, the answer is the new one")
             .argument("<chat>", messenger.chatArgument)
-            .argument("<link>", "the link, as `chats link list` shows it")
+            .argument("<link>", "the link, as `chats links list` shows it")
             .action(async function (chat, link) {
             const context = messengerContext(this, messenger);
             renderItem(this, context, await context.withServices((services) => services.admin.revokeLink(chat, link)));
@@ -144,7 +141,7 @@ const linkCommand = (messenger) => {
         link.addCommand(annotate(new Command("update"), { output: { entity: "chat_invite_change" }, effects: REMOTE_WRITE })
             .description("change one of your invite links, the group's own one too")
             .argument("<chat>", messenger.chatArgument)
-            .argument("<link>", "the link, as `chats link list` shows it")
+            .argument("<link>", "the link, as `chats links list` shows it")
             .option("--approval", "who joins by it asks first, and an admin lets them in; it then has no use limit")
             .option("--no-approval", "anyone with it joins at once")
             .option("--expire-time <time>", "it stops working then: 2026-09-25T09:00 (local time), or 30m, 2h, 7d from now; `never` takes the expiry away")
@@ -219,11 +216,14 @@ const requestsCommand = (messenger) => {
     }));
     const everyone = messenger.joinRequestsAll !== false;
     const byLink = everyone && messenger.joinRequestsByLink !== false;
-    for (const [verb, accept, help] of [
-        ["accept", true, "let them in; the group sees them join"],
-        ["decline", false, "turn the request away"],
+    for (const [accept, help] of [
+        [true, "let them in; the group sees them join"],
+        [false, "turn the request away"],
     ]) {
-        const answer = annotate(new Command(verb), { output: { entity: "chat_request_change" }, effects: REMOTE_WRITE })
+        const answer = annotate(new Command(accept ? "confirm" : "reject"), {
+            output: { entity: "chat_request_change" },
+            effects: REMOTE_WRITE,
+        })
             .description(help)
             .argument("<chat>", messenger.chatArgument)
             .argument(everyone ? "[person]" : "<person>", "who asked: an id from `chats requests list`");

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

@@ -38,7 +38,7 @@ export const storeCommand = (messenger) => {
         "copies delete": "messages_copy_1",
         decrypt: "./backup.enc --output ./restored.db",
         export: '"Book club" --output ./messages.jsonl',
-        "gaps plan": '"Book club"',
+        "gaps show": '"Book club"',
         "gaps repair": '"Book club" --limit 100',
         info: "",
         "jobs cancel": "job-101",
@@ -47,7 +47,7 @@ export const storeCommand = (messenger) => {
         "jobs retry": "--failed",
         "jobs show": "",
         migrate: "",
-        reindex: "",
+        rebuild: "",
         repair: "--dry-run",
         reset: "",
         restore: "./backup.db",

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

@@ -27,7 +27,7 @@ const count = (value) => {
 const line = ({ status, ref, attachment, name, chars }) => `${status}  ${ref} #${attachment}${name ? `  ${name}` : ""}${chars === undefined ? "" : `  (${chars} characters)`}`;
 const summary = (run) => [
     `${run.extracted} extracted`,
-    run.needsAgent ? `${run.needsAgent} for an agent to read (attachments text set)` : "",
+    run.needsAgent ? `${run.needsAgent} for an agent to read (attachments update)` : "",
     run.failed ? `${run.failed} unreadable` : "",
     run.unchanged ? `${run.unchanged} unchanged` : "",
     run.notDownloaded ? `${run.notDownloaded} not downloaded (--download)` : "",
@@ -172,12 +172,11 @@ const showCommand = (messenger) => annotate(new Command("show"), {
         stop.release();
     }
 });
-const textCommand = (messenger) => {
-    const text = new Command("text").description("the text of one file, as an agent read it");
-    readsStdin(annotate(text.command("set"), {
+const textUpdateCommand = (messenger) => {
+    const update = readsStdin(annotate(new Command("update"), {
         output: { entity: "attachment_text_change" },
         effects: LOCAL_WRITE,
-        examples: [`${messenger.app.command} personal attachments text set "Book club" 101 --text-file ./transcript.txt`],
+        examples: [`${messenger.app.command} personal attachments update "Book club" 101 --text-file ./transcript.txt`],
     }), {
         name: "text",
         description: "the text of the file",
@@ -190,7 +189,7 @@ const textCommand = (messenger) => {
         .addOption(ownerOnlyOption("--text-file <path>", "read the text from this file; - or none reads stdin"))
         .action(async function (chat, message) {
         const context = messengerContext(this, messenger);
-        refuseLocalWrite(context, messenger.app.command, "attachments.text.set");
+        refuseLocalWrite(context, messenger.app.command, "attachments.update");
         const { attachment, textFile } = this.opts();
         const given = textFile === undefined || textFile === "-" ? await readAll(context.stdin) : readFileSync(textFile, "utf8");
         const done = await context.withServices((services) => services.attachments.setText({
@@ -201,7 +200,7 @@ const textCommand = (messenger) => {
         }));
         renderAnswer(this, context, itemOf(snakeKeys(done)), () => `${done.ref} #${done.attachment}  ${done.chars} characters kept\n`);
     });
-    return text;
+    return update;
 };
 /** Files of stored messages: what is in them, for `content:` in a search. Nothing here is sent. */
 export const attachmentsCommand = (messenger) => {
@@ -211,7 +210,7 @@ export const attachmentsCommand = (messenger) => {
         .addCommand(extractCommand(messenger))
         .addCommand(listCommand(messenger))
         .addCommand(showCommand(messenger))
-        .addCommand(textCommand(messenger));
+        .addCommand(textUpdateCommand(messenger));
     addMediaArchiveCommands(attachments, messenger);
     return attachments;
 };

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

@@ -107,7 +107,7 @@ export const syncCommand = (messenger) => {
         if (prepare) {
             validateCatchUpBounds(preparation);
             refuseLocalWrite(context, messenger.app.command, "conversations.links");
-            refuseLocalWrite(context, messenger.app.command, "conversations.embed");
+            refuseLocalWrite(context, messenger.app.command, "conversations.embeddings");
         }
         if (background) {
             const named = chat ?? ALL_CHATS;

package/dist/cli/messenger/chat-answers.js

@@ -182,19 +182,19 @@ export const chatShown = (account, card) => {
 };
 /** The lowest score `score>=n` asks for; the audit's own floor when the query names none. */
 export const scoreFloor = (ast) => {
-    const term = nativeTerms(ast, "chats members audit").get("score");
+    const term = nativeTerms(ast, "chats members check").get("score");
     if (!term)
         return AUDIT_MIN_SCORE;
     const upper = term.operator === "range" ? (term.upper ?? "*") : term.value;
     if (term.operator !== "range" || upper !== "*")
         queryError("query.unsupported-operator", term.span, "score takes a lower bound: score>=3", {
-            command: "chats members audit",
+            command: "chats members check",
             guide: LIST_QUERY_GUIDE,
         });
     const floor = Number(term.value);
     return Math.ceil(term.lower_inclusive === false ? floor + 1 : floor);
 };
-export const auditAnswer = (audit) => wholeList("chats members audit", audit.items.map(memberAnswer), {
+export const auditAnswer = (audit) => wholeList("chats members check", audit.items.map(memberAnswer), {
     ...(audit.more ? { meta: { truncated: true } } : {}),
     ...(audit.completeness && audit.completeness.state !== "complete"
         ? {

package/dist/cli/messenger/chat-lists.js

@@ -45,16 +45,16 @@ export const membersHistory = async (services, chat, query) => {
     });
 };
 export const membersAudit = async (services, chat, query, options) => {
-    const minScore = scoreFloor(listQuery(typedQuery(query), AUDIT_QUERY, "chats members audit"));
+    const minScore = scoreFloor(listQuery(typedQuery(query), AUDIT_QUERY, "chats members check"));
     const audit = await services.chats.audit(chat, { ...options, minScore });
     return { audit, body: auditAnswer(audit) };
 };
 /** The source takes a count but no offset, so page n reads n pages and shows the last. */
 export const inviteLinks = async (services, chat, query, { limit, page }) => {
-    const terms = nativeTerms(listQuery(typedQuery(query), LINKS_QUERY, "chats link list"), "chats link list");
+    const terms = nativeTerms(listQuery(typedQuery(query), LINKS_QUERY, "chats links list"), "chats links list");
     const revoked = terms.get("revoked")?.value.toLowerCase() === "true";
     const found = await services.admin.links(chat, { limit: limit * page, revoked });
-    return listOf("chats link list", {
+    return listOf("chats links list", {
         items: found.items.slice((page - 1) * limit).map(inviteLinkAnswer),
         limit,
         has_more: found.hasMore,

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

@@ -121,22 +121,22 @@ export const chatsCommand = (messenger) => {
         inspect: "https://example.com/invite/book-club",
         join: "https://example.com/invite/book-club",
         leave: '"Book club"',
-        "link create": '"Book club"',
-        "link list": '"Book club"',
-        "link reset": '"Book club"',
-        "link revoke": '"Book club" https://example.com/invite/book-club',
-        "link show": '"Book club"',
+        "links create": '"Book club"',
+        "links list": '"Book club"',
+        "links reset": '"Book club"',
+        "links remove": '"Book club" https://example.com/invite/book-club',
+        "links show": '"Book club"',
         list: "--limit 10",
         "mark-read": '"Book club" --until-id 101',
         "members add": '"Book club" "Alex Example"',
-        "members audit": '"Book club"',
+        "members check": '"Book club"',
         "members fetch": '"Book club"',
         "members history": '"Book club"',
         "members list": '"Book club"',
         "members remove": '"Book club" "Alex Example"',
         moderate: '"Book club" --dry-run',
-        "requests accept": '"Book club" "Alex Example"',
-        "requests decline": '"Book club" "Alex Example"',
+        "requests confirm": '"Book club" "Alex Example"',
+        "requests reject": '"Book club" "Alex Example"',
         "requests list": '"Book club"',
         "rules set": '"Book club" links report',
         "rules show": '"Book club"',

package/dist/cli/messenger/chats-members-command.js

@@ -23,7 +23,7 @@ export const membersCommand = (messenger) => {
         const body = await context.withServices((services) => membersList(services, chat, context.settings));
         renderAnswer(this, context, body, lines(({ id, name, username, role }) => [id, name ?? "", username ? `@${username}` : "", role ?? ""].join("  ")));
     }));
-    members.addCommand(withQuery(annotate(annotate(new Command("audit"), { effects: REMOTE_READ, offline: false })
+    members.addCommand(withQuery(annotate(annotate(new Command("check"), { effects: REMOTE_READ, offline: false })
         .summary("members that look like bots, with reasons")
         .description("members that look like bots, each with its reasons — read from the member list and the local store; " +
         "never one request per person, and it removes nobody")

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

@@ -69,7 +69,7 @@ export const contactsCommand = (messenger) => {
         }));
         renderAnswer(this, context, itemOf(contactAnswer(account, card)));
     }));
-    annotate(contacts.command("profile"), { effects: REMOTE_READ, output: { entity: "contact_profile" } })
+    annotate(contacts.command("info"), { effects: REMOTE_READ, output: { entity: "contact_profile" } })
         .summary("a person's profile from the messenger")
         .description("everything the messenger says about one person — handles, flags, last seen, when they registered — and " +
         "how many of their messages the store holds in each chat you share, the first and the last, and the " +
@@ -173,7 +173,10 @@ export const contactsCommand = (messenger) => {
             meta: { ...window.meta, ...(hasMore ? { truncated: true } : {}) },
         }));
     });
-    annotate(contacts.command("timeline"), { effects: REMOTE_READ, output: { entity: "contact_activity" } })
+    annotate(contacts.command("events"), {
+        effects: REMOTE_READ,
+        output: { entity: "contact_activity" },
+    })
         .summary("one person's activity across their linked identities")
         .description("everything one person took part in, in every messenger linked to them — messages they wrote or were " +
         "mentioned in, chats, mail, meetings, tasks — newest first, from the store; never connects")
@@ -200,7 +203,7 @@ export const contactsCommand = (messenger) => {
             ...(cursor === undefined ? {} : { cursor }),
         }));
         const { items, hasMore, limits, pending } = found;
-        renderAnswer(this, context, listOf("contacts timeline", {
+        renderAnswer(this, context, listOf("contacts events", {
             items: items.map(snakeKeys),
             limit: limits.items,
             has_more: hasMore,
@@ -292,8 +295,8 @@ export const contactsCommand = (messenger) => {
         contacts.addCommand(command);
     const examples = {
         add: '"Alex Example"',
-        "alias rm": '"Alex Example"',
-        "alias set": '"Alex Example" "Reading partner"',
+        "aliases remove": '"Alex Example"',
+        "aliases set": '"Alex Example" "Reading partner"',
         block: '"Alex Example"',
         check: '"Alex Example"',
         context: '"Alex Example" --limit 10',
@@ -306,12 +309,12 @@ export const contactsCommand = (messenger) => {
         "notes list": '"Alex Example"',
         "notes remove": '"Alex Example" 1',
         "notes show": '"Alex Example" 1',
-        profile: '"Alex Example"',
+        info: '"Alex Example"',
         remove: '"Alex Example"',
         rename: '"Alex Example" Alex Example',
         show: '"Alex Example"',
         sync: "",
-        timeline: '"Alex Example" --limit 10',
+        events: '"Alex Example" --limit 10',
         unblock: '"Alex Example"',
         unlink: '"Alex Example"',
     };

package/dist/cli/messenger/context.d.ts

@@ -1,5 +1,5 @@
 import type { Command } from "commander";
-import type { AdminRight, GroupSettingKey, Id, Message, PollVote, PrivacyKey, Provider } from "../../domain/models.js";
+import type { AdminRight, GroupSettingKey, Id, Message, Page, PollVote, PrivacyKey, Provider } from "../../domain/models.js";
 import type { MessengerAdapter } from "../../ports/messenger.js";
 import type { EventSink, Warn } from "../../runs/events.js";
 import { type Asker, type SendGuard } from "../../sends/guard.js";
@@ -18,6 +18,11 @@ import type { GlobalFlags, ResolveOptions, Settings } from "../settings.js";
  */
 export interface StoredMessages {
     message(chatId: Id, messageId: Id): Promise<Message | undefined>;
+    /** Stored messages in one provider thread, oldest first within the newest page. No remote fetch. */
+    threadMessages?(chatId: Id, threadId: Id, window: {
+        limit: number;
+        before?: Id;
+    }): Promise<Page<Message>>;
     /** The newest message from someone else in the chat, older than `before` when it is given. */
     newestIncoming(chatId: Id, before?: Id): Promise<Message | undefined>;
     /** The newest message in the chat sent at `at` or earlier; without `at`, the oldest one held. */
@@ -148,20 +153,22 @@ export interface Messenger extends ServiceMessenger {
     stickerFileBytes?: number;
     /** Whether shared folders can be joined; yes when unset. */
     folderJoin?: boolean;
-    /** Whether another invite link can be made — `chats link create`; yes when unset. */
+    /** Whether another invite link can be made — `chats links create`; yes when unset. */
     inviteLinkCreate?: boolean;
     /** Whether invite links can be listed; yes when unset. */
     inviteLinkList?: boolean;
     /** Whether one invite link can be revoked; yes when unset. */
     inviteLinkRevoke?: boolean;
-    /** Whether one invite link can be changed — `chats link update`; no when unset. */
+    /** Whether one invite link can be changed — `chats links update`; no when unset. */
     inviteLinkUpdate?: boolean;
-    /** Whether every pending join request is answered at once — `chats requests accept --all`; yes when unset. */
+    /** Whether every pending join request is answered at once — `chats requests confirm --all`; yes when unset. */
     joinRequestsAll?: boolean;
     /** Whether `--all` can take only the requests made by one invite link — `--link`; yes when unset. */
     joinRequestsByLink?: boolean;
     /** Whether a channel post can be commented on — `messages send --comment-to`; yes when unset. */
     channelComments?: boolean;
+    /** Whether comments can be read independently of sending; inherits channelComments when unset. */
+    readsComments?: boolean;
     /** Whether people added can be shown the messages from before they came — `members add --history`; yes when unset. */
     addsWithHistory?: boolean;
     /** The admin rights this messenger has, as `admins add --can` offers them; every one when unset. */

package/dist/cli/messenger/context.js

@@ -40,6 +40,12 @@ export const storedMessages = (provider, store, account) => {
             const at = key();
             return at && (await store()).messages.message(at, messageId, { chatId });
         },
+        threadMessages: async (chatId, threadId, window) => {
+            const owner = key();
+            return owner
+                ? (await store()).messages.messages(owner, chatId, { ...window, threadId })
+                : { items: [], hasMore: false };
+        },
         newestIncoming: async (chatId, before) => {
             const at = key();
             if (!at)

package/dist/cli/messenger/conversation-examples.js

@@ -2,13 +2,14 @@ import { annotate } from "@wirecat/cli-base/commands";
 import { commandAt } from "../steps.js";
 export const conversationExamples = (root, tool) => {
     const examples = {
-        "batches next": '--chat "Book club"',
+        "batches show": '--chat "Book club"',
         "batches status": '--chat "Book club"',
-        build: '--chat "Book club"',
+        "links rebuild": '--chat "Book club"',
         "consents list": "",
-        "consents revoke": '--chat "Book club"',
-        "embed clear": '--chat "Book club"',
-        "embed status": '--chat "Book club"',
+        "consents remove": '--chat "Book club"',
+        embed: '--chat "Book club"',
+        "embeddings clear": '--chat "Book club"',
+        "embeddings status": '--chat "Book club"',
         "links add": '--batch "$batch"',
         "links clear": '--chat "Book club"',
         list: '"Book club"',
@@ -21,5 +22,5 @@ export const conversationExamples = (root, tool) => {
         if (command)
             annotate(command, { examples: [`${tool} personal conversations ${path} ${args}`.trimEnd()] });
     }
-    commandAt(root, "links add")?.addHelpText("after", "\nSet batch to the id from conversations batches next; supply the JSON answer to that batch on stdin.\n");
+    commandAt(root, "links add")?.addHelpText("after", "\nSet batch to the id from conversations batches show; supply the JSON answer to that batch on stdin.\n");
 };

package/dist/cli/messenger/conversations-command.d.ts

@@ -1,9 +1,5 @@
 import { Command } from "commander";
 import { type Messenger } from "./context.js";
-/**
- * `conversations`: the threads inside a group chat, found by rules over the stored messages — replies,
- * mentions, one sender's messages in a row. From the store alone; nothing is built until asked (phase 3).
- */
 export declare const conversationsCommand: (messenger: Messenger) => Command;
 /** `messages links`: why a message sits where it does in its conversation. */
 export declare const linksCommand: (messenger: Messenger) => Command;