@wirecat/cli-core 0.409.0 → 0.411.0

package/dist/cli/index.js

@@ -32,106 +32,70 @@ 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";
 export { prepareRpcApiBody } from "./bot/api-rpc.js";
-export { botCommand } from "./bot/command.js";
 export { botContext, botWords } from "./bot/context.js";
 export { botCopy } from "./bot/copy.js";
-export { botMcpCommand } from "./bot/mcp.js";
-export { botCan, botIdOf, botMessagesCommand } from "./bot/messages.js";
+export { botCan, botIdOf } from "./bot/messages.js";
 export { BOT_ACTIONS, } from "./bot/port.js";
 export { botFiles, botsDirectory, ChatRegistry, registryProfiles } from "./bot/registry.js";
 export { BotTokenStore } from "./bot/token.js";
 export { PressLog, UpdatesCursor } from "./bot/updates.js";
 export { commandContract, SCHEMA_DIALECT } from "./command-contract.js";
-export { CONTRACT, commandsCommand } from "./commands-command.js";
-export { configCommand, refuseUnknownKey } from "./config-command.js";
+export { CONTRACT } from "./commands-command.js";
+export { refuseUnknownKey } from "./config-command.js";
 export { loadSnakeCaseConfig } from "./config-keys.js";
 export { baseContext, environmentOf, outputFor, provide, secretInputOf, } from "./context.js";
+export { addContractInfo, contractEvidence } from "./contract-evidence.js";
+export { sharedCommandTemplate } from "./contract-templates.js";
 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, grantsAuthority, isLogin, isOtherServiceCall, isStoreChange, judgedEffects, judgedTargets, LOCAL_READ, LOCAL_WRITE, logsInOrOut, NO_EFFECTS, ownerOnlyOption, REMOTE_READ, REMOTE_WRITE, reachesOtherService, refuseUnderReadOnly, } from "./effects.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, LANGUAGES, setupAtStart, systemLanguage, } from "./first-run.js";
-export { checkGuide, checkStep, guideCommand, loadScenarios, MEMO_SCENARIOS, shellProblems, } from "./guide.js";
+export { checkGuide, checkStep, loadScenarios, MEMO_SCENARIOS, shellProblems, } from "./guide.js";
 export { commandHelp, commandHelpMarkdown, commandHelpText, exampleReport, nextUsually, } from "./help/command-help.js";
 export { commandsText } from "./help/commands-text.js";
-export { firstScreen, installHelp, WIRECAT_TOOLS, } from "./help/first-screen.js";
+export { firstScreen, installHelp, WIRECAT_TOOLS } from "./help/first-screen.js";
 export { inSection, SECTIONS } from "./help/sections.js";
 export { bufferedInput, inputPolicy, MAX_BUFFERED_INPUT, MAX_SECRET_INPUT, provideInputPolicy, } from "./input-policy.js";
 export { answerFields, checkJson, entityFields, liftJson, } from "./json-fields.js";
 export { commandPath, LIST_QUERY_GUIDE, listQuery, nativeField, nativeTerms, pagedList, pageOf, queryArgument, queryHelp, queryTerms, searchText, termField, timeBounds, typedQuery, unfilteredQuery, withQuery, } from "./list-query.js";
-export { addMeetingBatchCommand, formatMeetingBatch, prepareMeetingBatch } from "./meeting-batch.js";
+export { formatMeetingBatch, prepareMeetingBatch } from "./meeting-batch.js";
 export { meetingEvidenceItem, meetingPersonContextItem } from "./meeting-evidence-answer.js";
 export { parseEvidenceFindingsJson, parseMeetingFindingsJson } from "./meeting-findings-input.js";
 export { meetingPreparationAnswer } from "./meeting-preparation-answer.js";
-export { addMeetingPreparationCommand } from "./meeting-preparation-command.js";
 export { meetingPreparationInput, readMeetingPreparation, } from "./meeting-preparation-read.js";
-export { addMeetingProjectCandidatesCommand } from "./meeting-project-candidates-command.js";
 export { readMeetingProjectCandidates } from "./meeting-project-candidates-read.js";
 export { meetingResultItem } from "./meeting-results.js";
-export { addMeetingSeriesInventoryCommand } from "./meeting-series-inventory-command.js";
 export { readMeetingSeriesInventory } from "./meeting-series-inventory-read.js";
-export { accountCommand } from "./messenger/account-command.js";
 export { accountFileFor, profilesHere, rememberAccount } from "./messenger/accounts.js";
-export { storeCommand } from "./messenger/archive-commands.js";
-export { attachmentsCommand } from "./messenger/attachments-command.js";
-export { chatsCommand } from "./messenger/chats-command.js";
-export { markReadCommand } from "./messenger/chats-read-command.js";
-export { completeCommand } from "./messenger/complete-command.js";
-export { contactsCommand } from "./messenger/contacts-command.js";
 export { connectFor, messengerContext, } from "./messenger/context.js";
-export { conversationsCommand } from "./messenger/conversations-command.js";
-export { doctorCommand } from "./messenger/doctor-command.js";
-export { floodCommand } from "./messenger/flood-command.js";
-export { recipientsCommand, sendsCommand } from "./messenger/guard-commands.js";
-export { imagesCommand } from "./messenger/images-command.js";
-export { inboxCommand } from "./messenger/inbox.js";
 export { COMMAND_NEEDS } from "./messenger/lacks.js";
-export { httpTokenFile, mcpCommand, serverEntry } from "./messenger/mcp-command.js";
-export { mentionsCommand } from "./messenger/mentions-command.js";
+export { httpTokenFile, serverEntry } from "./messenger/mcp-command.js";
 export { messageItem } from "./messenger/message-items.js";
-export { messagesCommand, sendCommand } from "./messenger/messages-command.js";
-export { deleteCommand } from "./messenger/messages-delete-command.js";
-export { editCommand } from "./messenger/messages-edit-command.js";
-export { forwardCommand } from "./messenger/messages-forward-command.js";
-export { pinCommand, starCommands, unpinCommand } from "./messenger/messages-pin-command.js";
-export { metadataCommand } from "./messenger/metadata-command.js";
-export { modelsCommand } from "./messenger/models-command.js";
-export { pollsCommand } from "./messenger/polls-command.js";
 export { privateFiles, withSqliteSidecars } from "./messenger/private-files.js";
-export { reactionsCommand } from "./messenger/reactions-command.js";
-export { callsCommand, stickersCommand } from "./messenger/records-command.js";
-export { repliesCommand } from "./messenger/replies-command.js";
-export { reviewCommand } from "./messenger/review.js";
-export { scheduleCommand } from "./messenger/schedule-command.js";
+export { buildReport as buildDoctorReport, reportFileName as doctorReportFileName, } from "./messenger/report.js";
 export { allAnswer, allHitItem, messageHitItem, noteHitItem, } from "./messenger/search-answers.js";
-export { searchCommand } from "./messenger/search-command.js";
-export { SEARCHES_QUERY, searchesCommand } from "./messenger/searches-command.js";
-export { serveCommand, servingProfiles } from "./messenger/serve-command.js";
+export { SEARCHES_QUERY } from "./messenger/searches-command.js";
+export { servingProfiles } from "./messenger/serve-command.js";
 export { DAY_MS, FIRST_FETCH_MS, memberFetches } from "./messenger/serve-members.js";
 export { STEMS_EVERY_MS, STEMS_SLICE_MS, stemFills } from "./messenger/serve-stems.js";
-export { serverCommand, } from "./messenger/server-command.js";
-export { statsCommand } from "./messenger/stats-command.js";
 export { storeSummary } from "./messenger/store-maintenance-command.js";
 export { stored } from "./messenger/stored.js";
-export { tagsCommand } from "./messenger/tags-command.js";
-export { tasksCommand, tasksStatsCommand } from "./messenger/tasks-command.js";
-export { topicsCommand } from "./messenger/topics-command.js";
-export { watchCommand } from "./messenger/watch-command.js";
+export { MODEL_CATALOGUE_QUERY } from "./model-catalogue-command.js";
 export { window, withPaging } from "./paging.js";
-export { knownBeside, knownPermissionKeys, unknownPermissionKeys, } from "./permission-keys.js";
-export { asFirstWord, commandWords, liftProfile, refuseCommandName, rootOf, usableProfileName, } from "./profile.js";
+export { knownBeside, knownPermissionKeys, unknownPermissionKeys } from "./permission-keys.js";
+export { asFirstWord, commandWords, liftProfile, refuseCommandName, rootOf, usableProfileName } from "./profile.js";
 export { createProgram, run } from "./program.js";
 export { fieldsOf, projectFields } from "./result-fields.js";
-export { runsCommand } from "./runs/command.js";
 export { count, first, flag, fromFile, NONE_NAMED, plain, settingsFor, } from "./settings.js";
 export { readSetupAnswers, setupPermissionCeiling } from "./setup-answers.js";
 export { AGENTS, agentFor, screenFor } from "./setup-screen.js";
-export { skillCommand } from "./skill-command.js";
+export { accountCommand, addMeetingBatchCommand, addMeetingPreparationCommand, addMeetingProjectCandidatesCommand, addMeetingSeriesInventoryCommand, attachmentsCommand, botAdminsCommand, botCommand, botMcpCommand, botMembersCommand, botMessagesCommand, callsCommand, chatsCommand, commandsCommand, completeCommand, configCommand, contactsCommand, conversationsCommand, deleteCommand, doctorCommand, editCommand, floodCommand, forwardCommand, generatedApiCommand, guideCommand, imagesCommand, inboxCommand, markReadCommand, mcpCommand, mentionsCommand, messagesCommand, metadataCommand, modelCatalogueCommand, modelsCommand, pinCommand, pollsCommand, reactionsCommand, recipientsCommand, repliesCommand, reviewCommand, runsCommand, scheduleCommand, searchCommand, searchesCommand, sendCommand, sendsCommand, serveCommand, serverCommand, skillCommand, starCommands, statsCommand, stickersCommand, storeCommand, tagsCommand, tasksCommand, tasksStatsCommand, topicsCommand, unpinCommand, upgradeCommand, watchCommand, } from "./shared-command-exports.js";
+export { assertSharedContracts, customizeSharedCommand, hasSharedContract, overrideSharedContract, sharedContractOverrides, sharedContracts, } from "./shared-contracts.js";
 export { runnable, withSafety } from "./steps.js";
 export { changeStoreSetting, isStoreSetting, STORE_SETTINGS, storeSettings } from "./store-settings.js";
-export { restartServers, upgradeCommand } from "./upgrade-command.js";
+export { restartServers } from "./upgrade-command.js";

package/dist/cli/messenger/chat-answers.d.ts

@@ -101,7 +101,7 @@ export declare const chatShown: (account: AccountKey, card: Parameters<typeof ch
         check?: {
             [x: string]: unknown;
         } | undefined;
-    }[] | null | undefined;
+    }[] | undefined;
 }>;
 /** The lowest score `score>=n` asks for; the audit's own floor when the query names none. */
 export declare const scoreFloor: (ast: QueryAst | undefined) => number;

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

@@ -38,7 +38,7 @@ export const chatAnswer = (account, chat) => defined({
     description: chat.description,
     invite_link: chat.link,
     settings: chat.settings ? settingsOf(chat.settings) : undefined,
-    members: chat.members === undefined ? undefined : (chat.members?.map(memberAnswer) ?? null),
+    members: chat.members?.map(memberAnswer),
 });
 export const memberAnswer = (member) => {
     const group = member;

package/dist/cli/messenger/chat-lists.d.ts

@@ -61,7 +61,7 @@ export declare const chatsList: (services: Services, query: QueryWords, paging:
         check?: {
             [x: string]: unknown;
         } | undefined;
-    }[] | null | undefined;
+    }[] | undefined;
 }>>;
 export declare const chatEvents: (services: Services, chat: string, query: QueryWords) => Promise<import("../envelope.js").ListBody<{
     chat_id: string;

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

@@ -109,6 +109,8 @@ export const chatsCommand = (messenger) => {
         "admins add": `"Book club" "Alex Example"${messenger.pickAdminRights === false ? "" : ` --can ${messenger.adminRights?.[0] ?? "info"}`}`,
         "admins remove": '"Book club" "Alex Example"',
         create: '"Book club" "Alex Example"',
+        app: '"Example Bot"',
+        start: '"Example Bot"',
         "documents list": '"Project room" --limit 10',
         events: '"Book club"',
         "folders create": '"Reading" --chat "Book club"',
@@ -125,6 +127,7 @@ export const chatsCommand = (messenger) => {
         "links list": '"Book club"',
         "links reset": '"Book club"',
         "links remove": '"Book club" https://example.com/invite/book-club',
+        "links update": '"Book club" https://example.com/invite/book-club --max-uses 25',
         "links show": '"Book club"',
         list: "--limit 10",
         "mark-read": '"Book club" --until-id 101',

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

@@ -1,5 +1,6 @@
 import { CliError } from "@wirecat/cli-base";
 import { annotate } from "@wirecat/cli-base/commands";
+import { defineQuery } from "@wirecat/cli-base/query";
 import { Command } from "commander";
 import { REGISTRIES, registriesCover } from "../../botcheck/registries.js";
 import { levelFor } from "../../sends/permissions.js";
@@ -12,7 +13,7 @@ import { readSecret } from "../../terminal/prompt.js";
 import { secretInputOf } from "../context.js";
 import { FETCH, LOCAL_WRITE, REMOTE_READ } from "../effects.js";
 import { itemOf, listOf, renderAnswer, snakeKeys } from "../envelope.js";
-import { listQuery, nativeTerms, typedQuery, withQuery } from "../list-query.js";
+import { listQuery, nativeField, nativeTerms, termField, timeBounds, typedQuery, withQuery } from "../list-query.js";
 import { positiveCount, window, withPaging } from "../paging.js";
 import { casKey } from "../registry-keys.js";
 import { commandAt, nextStep } from "../steps.js";
@@ -23,6 +24,19 @@ import { hideNever } from "./lacks.js";
 import { CONTACTS_QUERY, notesAllowed } from "./people-queries.js";
 import { privatePeopleCommands } from "./private-people-command.js";
 import { syncsFirst } from "./search-sync-options.js";
+const CONTACT_ACTIVITY_QUERY = defineQuery({
+    entity: "contact_activity",
+    backend: "native",
+    fields: [
+        termField("scope", "enum", "scope:work", { values: SCOPES }),
+        nativeField({
+            name: "at",
+            type: "time",
+            operators: ["term", "phrase", "range"],
+            example: "at:[2026-10-01 TO 2026-10-31]",
+        }),
+    ],
+});
 /** People this account has a one-to-one chat with, as the people service counts them. */
 const collect = (value, previous = []) => [...previous, value];
 export const contactsCommand = (messenger) => {
@@ -173,28 +187,24 @@ export const contactsCommand = (messenger) => {
             meta: { ...window.meta, ...(hasMore ? { truncated: true } : {}) },
         }));
     });
-    annotate(contacts.command("events"), {
+    withQuery(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")
-        .argument("<person>", "their id, @username, or part of their name")
-        .option("--scope <scope>", "only what belongs to personal or to work accounts: personal or work")
-        .option("--since-time <time>", "nothing older than this ISO 8601 time, or 2h / 1d ago")
-        .option("--until-time <time>", "through this ISO 8601 time, or 2h / 1d ago")
+        .argument("<person>", "their id, @username, or part of their name"), CONTACT_ACTIVITY_QUERY)
         .option("--limit <n>", `at most this many; ${TIMELINE_ITEMS} if not given`, positiveCount("--limit"))
         .option("--cursor <cursor>", "go on from where the last page stopped; page.next gives it, with the same filters")
-        .action(async function (person) {
-        const { scope, sinceTime, untilTime, limit, cursor } = this.opts();
+        .action(async function (person, words) {
+        const terms = nativeTerms(listQuery(typedQuery(words), CONTACT_ACTIVITY_QUERY, "contacts events"), "contacts events");
+        const scope = terms.get("scope")?.value.toLowerCase();
+        const { limit, cursor } = this.opts();
         if (scope !== undefined && !SCOPES.includes(scope))
             throw new CliError("validation_error", `--scope is personal or work, not "${scope}"`);
         const context = messengerContext(this, messenger);
-        const window = dateWindow({
-            ...(sinceTime === undefined ? {} : { sinceTime }),
-            ...(untilTime === undefined ? {} : { untilTime }),
-        });
+        const window = timeBounds(terms.get("at"));
         const found = await context.withServices((services) => services.people.timeline(person, {
             ...(scope === undefined ? {} : { scope: scope }),
             ...(window.since === undefined ? {} : { since: window.since }),
@@ -211,9 +221,7 @@ export const contactsCommand = (messenger) => {
             ...(found.cursor === undefined ? {} : { cursor: found.cursor }),
             args: {
                 person,
-                ...(scope === undefined ? {} : { scope }),
-                ...(sinceTime === undefined ? {} : { since_time: sinceTime }),
-                ...(untilTime === undefined ? {} : { until_time: untilTime }),
+                ...(words.length ? { query: typedQuery(words) } : {}),
             },
             meta: { ...window.meta, ...(pending > 0 ? { truncated: true } : {}) },
         }));

package/dist/cli/messenger/guard-commands.d.ts

@@ -1,9 +1,13 @@
 import { Command } from "commander";
+import { type SendEntry } from "../../sends/journal.js";
 import { type Messenger } from "./context.js";
 /**
  * The chats this profile may send to. Off until the first `add`; `clear` deletes it, which turns it off again. It stops
  * a model that a message talked into writing somewhere, not an agent set on getting around it.
  */
-export declare const recipientsCommand: (messenger: Messenger) => Command;
+export declare const recipientsCommand: (messenger: Messenger, options?: {
+    resolve?: "chat-card";
+}) => Command;
 /** Every attempt to send from this profile, kept whatever `--record` says. Never the text. */
 export declare const sendsCommand: (messenger: Messenger) => Command;
+export declare const sendAttemptItem: ({ sendId, operationId, ...entry }: SendEntry) => unknown;

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

@@ -15,7 +15,7 @@ import { SENDS_QUERY, sendFilter } from "./sends-query.js";
  * The chats this profile may send to. Off until the first `add`; `clear` deletes it, which turns it off again. It stops
  * a model that a message talked into writing somewhere, not an agent set on getting around it.
  */
-export const recipientsCommand = (messenger) => {
+export const recipientsCommand = (messenger, options = {}) => {
     const tool = `${messenger.app.command} personal`;
     const listFor = (profile, env) => new RecipientList(recipientsPathFor(messenger.app, profile, env), messenger.app.command);
     const command = new Command("recipients").description("the chats this profile may send to, when the list is on");
@@ -43,7 +43,8 @@ export const recipientsCommand = (messenger) => {
         .description("allow sending to this chat; the first add turns the list on")
         .action(async function (chat) {
         const context = messengerContext(this, messenger);
-        const found = await context.withMessenger((connection) => connection.resolve(chat));
+        // Some transports resolve an id without reading its title or dialog partner.
+        const found = await context.withMessenger((connection) => options.resolve === "chat-card" ? connection.chat(chat) : connection.resolve(chat));
         const partnerId = messenger.partnerOf?.(found);
         const added = await listFor(context.settings.profile, context.env).addAsync({
             id: found.id,
@@ -93,10 +94,11 @@ export const sendsCommand = (messenger) => new Command("sends").description("eve
     const from = settings.all ? 0 : (settings.page - 1) * settings.limit;
     const shown = settings.all ? entries : entries.slice(from, from + settings.limit);
     renderAnswer(this, context, pagedList("sends list", settings, {
-        items: shown.map(snakeKeys),
+        items: shown.map(sendAttemptItem),
         args: words.length ? { query: typedQuery(words) } : {},
         has_more: from + shown.length < entries.length,
     }));
     if (entries.length === 0)
         renderer.note(filter ? "no send attempts match the query" : `profile ${settings.profile} has not tried to send anything`);
 }));
+export const sendAttemptItem = ({ sendId, operationId, ...entry }) => snakeKeys({ ...entry, ...((operationId ?? sendId) === undefined ? {} : { operationId: operationId ?? sendId }) });

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

@@ -5,7 +5,10 @@ import { REMOTE_WRITE } from "../effects.js";
 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"), { effects: REMOTE_WRITE })
+export const pressCommand = (messenger) => annotate(new Command("press"), {
+    effects: REMOTE_WRITE,
+    examples: [`${messenger.app.command} personal messages press "Example Bot" 101 1`],
+})
     .description("press a bot's button under a message; the bot sees that you pressed it")
     .argument("<chat>", messenger.chatArgument)
     .argument("<message>", "the id of the message with the buttons")

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

@@ -1,7 +1,6 @@
 import { join } from "node:path";
 import { CliError } from "@wirecat/cli-base";
 import { annotate } from "@wirecat/cli-base/commands";
-import { defineQuery } from "@wirecat/cli-base/query";
 import { Command } from "commander";
 import { isTextModelInstalled, textModelsDirectory } from "../../embeddings/embed.js";
 import { embeddingKeys } from "../../embeddings/keys.js";
@@ -16,19 +15,12 @@ import { readSecret } from "../../terminal/prompt.js";
 import { baseContext, environmentOf } from "../context.js";
 import { FETCH, grantsAuthority, LOCAL_READ, LOCAL_WRITE, reachesOtherService } from "../effects.js";
 import { itemOf, listOf, renderAnswer } from "../envelope.js";
-import { listQuery, nativeTerms, termField, typedQuery, unfilteredQuery, withQuery } from "../list-query.js";
+import { listQuery, nativeTerms, typedQuery, unfilteredQuery, withQuery } from "../list-query.js";
+import { MODEL_CATALOGUE_QUERY } from "../model-catalogue-command.js";
 import { nextStep } from "../steps.js";
 /** A model list is the catalog this version ships. */
 const MODELS_QUERY = unfilteredQuery("model", modelEntity);
-const ROOT_MODELS_QUERY = defineQuery({
-    entity: "model",
-    backend: "native",
-    fields: [
-        termField("kind", "enum", "kind:audio", { values: ["audio", "text"] }),
-        termField("id", "kw", "id:e5-small"),
-        termField("downloaded", "bool", "downloaded:true"),
-    ],
-});
+const ROOT_MODELS_QUERY = MODEL_CATALOGUE_QUERY;
 /** Every model this version knows: a short, fixed list, never paged. */
 const everyModel = (command, items, next = []) => listOf(command, { items, limit: Math.max(1, items.length), has_more: false, next });
 const audioItem = (model, directory, chosen) => ({

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

@@ -22,7 +22,7 @@ const kindsOf = (typed) => {
 export const mediaCommand = (messenger) => annotate(new Command("media"), { effects: REMOTE_READ })
     .description("a chat's photos, videos, files, audio and links, from the messenger's server; reading marks nothing")
     .argument("<chat>", messenger.chatArgument)
-    .option("--type <names>", `only these kinds, comma-separated: ${MEDIA_KINDS.join(", ")}`)
+    .option("--type <type>", `only these kinds, comma-separated: ${MEDIA_KINDS.join(", ")}`)
     .option("--limit <n>", "how many to show", positiveCount("--limit"))
     .option("--cursor <cursor>", "go on from where page.next says the last page stopped")
     .action(async function (chat) {

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

@@ -1,9 +1,9 @@
 import { type RunMetadata } from "../../runs/run.js";
 import type { SendEntry } from "../../sends/journal.js";
-export interface Report {
+export interface Report<Doctor extends object = Record<string, unknown>> {
     createdAt: string;
     /** What `doctor --json` answers — versions, paths, counts and the messenger's own checks. */
-    doctor: Record<string, unknown>;
+    doctor: Doctor;
     /** The run the report is about: the one asked for, or the newest that failed. */
     run: {
         metadata: RunMetadata;
@@ -12,13 +12,25 @@ export interface Report {
     /** The newest write attempts — outcomes and ids, never text (`src/sends/journal.ts`). */
     sends: SendEntry[];
 }
+/** Optional technical context supplied by a consumer; it is redacted with the rest of the report. */
+export interface ReportContext {
+    createdAt?: never;
+    doctor?: never;
+    run?: never;
+    sends?: never;
+    version?: string;
+    runtime?: string;
+    platform?: string;
+    arch?: string;
+    profile?: string | null;
+}
 /**
  * **Everything a report holds is already free of content** — the doctor, the run log and the send
  * journal are built that way. Two things are added: every id becomes a label, and the home
- * directory is hidden, since paths name the person's account on this machine. Copied from max-cli.
+ * directory is hidden, since paths name the person's account on this machine.
  */
-export declare const buildReport: ({ doctor, runsDir, runId, command, sends, now, home, }: {
-    doctor: Record<string, unknown>;
+export declare const buildReport: <Doctor extends object, Context extends ReportContext = Record<never, never>>({ doctor, runsDir, runId, command, sends, now, home, context, eventFields, }: {
+    doctor: Doctor;
     runsDir: string;
     runId?: string;
     /** What to type to list runs, for the error when `runId` names none. */
@@ -26,7 +38,10 @@ export declare const buildReport: ({ doctor, runsDir, runId, command, sends, now
     sends: SendEntry[];
     now?: Date;
     home: string | undefined;
-}) => Report;
+    context?: Context;
+    /** Retain allowlisted recorded fields, including time and severity, for an existing consumer contract. */
+    eventFields?: "report" | "recorded";
+}) => Report<Doctor> & Omit<Context, keyof Report>;
 /**
  * Every field of a journal line that names a chat, a message or a write. A send's `operationId` is
  * its `sendId`, so one left raw would undo the other's label.

package/dist/cli/messenger/report.js

@@ -1,6 +1,7 @@
 import { createHash, randomBytes } from "node:crypto";
 import { join } from "node:path";
 import { CliError } from "@wirecat/cli-base";
+import { LOG_ATTRIBUTES } from "../../runs/log-attributes.js";
 import { findRun, listRuns, readEvents } from "../../runs/run.js";
 const RECENT_SENDS = 20;
 /** Only these fields of a run event travel; a field added later is left out until it is named here. */
@@ -18,21 +19,22 @@ const EVENT_FIELDS = [
 /**
  * **Everything a report holds is already free of content** — the doctor, the run log and the send
  * journal are built that way. Two things are added: every id becomes a label, and the home
- * directory is hidden, since paths name the person's account on this machine. Copied from max-cli.
+ * directory is hidden, since paths name the person's account on this machine.
  */
-export const buildReport = ({ doctor, runsDir, runId, command, sends, now = new Date(), home, }) => {
+export const buildReport = ({ doctor, runsDir, runId, command, sends, now = new Date(), home, context, eventFields = "report", }) => {
     const chosen = runId === undefined ? newestFailed(runsDir) : findRun(runsDir, runId);
     if (runId !== undefined && !chosen)
         throw new CliError("not_found", `no run ${runId} — \`${command} runs list\` names them`);
     const label = labeller();
     const account = doctor.account;
     const report = {
+        ...context,
         createdAt: now.toISOString(),
         doctor: {
             ...doctor,
             ...(account?.remembered ? { account: { ...account, remembered: label(account.remembered) } } : {}),
         },
-        run: chosen ? { metadata: chosen.metadata, events: readEvents(chosen.dir).map(eventOf(label)) } : null,
+        run: chosen ? { metadata: chosen.metadata, events: readEvents(chosen.dir).map(eventOf(label, eventFields)) } : null,
         sends: sends.slice(-RECENT_SENDS).map((entry) => labelled(entry, label)),
     };
     return JSON.parse(hideHome(JSON.stringify(report), home));
@@ -85,8 +87,21 @@ const labeller = () => {
     const salt = randomBytes(16);
     return (id) => `id:${createHash("sha256").update(salt).update(id).digest("hex").slice(0, 12)}`;
 };
-const eventOf = (label) => (event) => {
-    const kept = Object.fromEntries(Object.entries(event).filter(([key]) => EVENT_FIELDS.includes(key)));
+const RECORDED_FIELDS = new Set([...LOG_ATTRIBUTES, "time", "severity"]);
+const RECORDED_ID_FIELDS = new Set([
+    ...SEND_ID_FIELDS.map((key) => key.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`)),
+    "actor_id",
+    "target_id",
+]);
+const eventOf = (label, fields) => (event) => {
+    const kept = Object.fromEntries(Object.entries(event)
+        .filter(([key]) => (fields === "recorded" ? RECORDED_FIELDS.has(key) : EVENT_FIELDS.includes(key)))
+        .map(([key, value]) => [
+        key,
+        fields === "recorded" && RECORDED_ID_FIELDS.has(key) && value !== undefined && value !== null
+            ? label(String(value))
+            : value,
+    ]));
     const ids = kept.ids;
     if (typeof ids !== "object" || ids === null)
         return kept;

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

@@ -108,6 +108,10 @@ const holderOf = (command) => holderIn(environmentOf(command).env ?? process.env
 const HOLDER_HELP = "who you are for claims: a session id or a chat id; default WIRECAT_HOLDER, else Claude Code's session, else the agent's name";
 const planFrom = (options) => {
     const plan = {};
+    if (options.priority !== undefined)
+        plan.priority = options.priority;
+    if (options.parent !== undefined)
+        plan.parent = options.parent;
     if (options.category !== undefined)
         plan.category = options.category;
     if (options.title !== undefined)
@@ -190,15 +194,21 @@ export const tasksCommand = (messenger) => {
         effects: LOCAL_WRITE,
         examples: [`${tool} personal tasks update DOC-12 --title "Review draft"`],
     }))
-        .summary("set a task's title, description, due date, next check, category and assignee")
-        .description("set a task's title, description, due date, next check, category and assignee; nothing reaches the messenger")
+        .summary("update a task's text, schedule, category, assignees, priority or parent")
+        .description("update a task's text, schedule, category, assignees, priority or parent; nothing reaches the messenger")
         .argument("<task>", "the task's id or key, as tasks list shows it")
-        .option("--category <name>", `${categoryHelp}; a change is kept in the task's history`), "send Alex the API token").action(async function (id) {
+        .option("--category <name>", `${categoryHelp}; a change is kept in the task's history`)
+        .option("--priority <n>", "priority from 0 (urgent) through 4 (low)", (value) => {
+        if (!/^[0-4]$/.test(value))
+            throw new CliError("validation_error", "--priority takes 0 through 4");
+        return Number(value);
+    })
+        .option("--parent <id>", "parent task in the same project; none clears it", (value) => value === "none" ? null : value), "send Alex the API token").action(async function (id) {
         const context = messengerContext(this, messenger);
         refuseLocalWrite(context, messenger.app.command, "tasks.update");
         const plan = planFrom(this.opts());
         if (Object.keys(plan).length === 0)
-            throw new CliError("validation_error", "give at least one of --title, --description, --due, --remind-time, --category");
+            throw new CliError("validation_error", "give at least one of --title, --description, --due, --remind-time, --category, --priority, --parent");
         const planned = await context.withServices((services) => services.tasks.plan(id, plan, writerOf(this)));
         renderAnswer(this, context, itemOf(snakeKeys(planned)), () => `${card(planned)}\n`);
     });

package/dist/cli/model-catalogue-command.d.ts

@@ -0,0 +1,15 @@
+import { Command } from "commander";
+import type { AppIdentity } from "../ports/app.js";
+import { type Body } from "./envelope.js";
+export declare const MODEL_CATALOGUE_QUERY: import("@wirecat/cli-base/query").QueryRegistry;
+export interface ModelCatalogueOptions {
+    kinds: readonly ("audio" | "text")[];
+    env: () => NodeJS.ProcessEnv;
+    output: (answer: Body, command: Command) => void;
+    diagnostic: (line: string) => void;
+    jsonOption?: boolean;
+    offline?: () => boolean;
+    defaultAudio?: () => string;
+}
+/** Provider composition supplies I/O and supported kinds; parsing, receipts and download policy stay shared. */
+export declare const modelCatalogueCommand: (app: AppIdentity, options: ModelCatalogueOptions) => Command;