@wirecat/cli-core 0.408.0 → 0.409.0

package/CHANGELOG.md

@@ -5,6 +5,16 @@ 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.
 
+## 0.409.0 — 24.10.2026
+
+### Added
+
+- **Shared lists declare typed queries, including bots, schedules, forum topics, calls and stickers.** Stored bot chats, recipients, send history,
+  profiles and schedules filter at their native readers; forum title terms go to the provider. Message predicates
+  require `--offline` and run in SQLite before the limit, reporting interpreted time bounds. Provider lists that
+  accept no filters refuse terms before connecting, instead of filtering an incomplete response. Existing empty
+  queries keep their previous behavior. Shared list-result contracts include the template schema for provider CLIs.
+
 ## 0.408.0 — 24.10.2026
 
 ### Fixed

package/dist/background/schedules.d.ts

@@ -75,7 +75,7 @@ export declare const scheduledRuns: (state: string) => {
     job: string;
     last: LastRun | undefined;
 }[];
-export declare const listSchedules: (state: string) => Schedule[];
+export declare const listSchedules: (state: string, filter?: Partial<Pick<Schedule, "name" | "kind">>) => Schedule[];
 export declare const describeWhen: (when: When) => string;
 /** How one operating system starts `argv` at the schedule's times. Every timer runs the same thing: `<cli> schedule exec <file>`. */
 export interface Timer {

package/dist/background/schedules.js

@@ -98,11 +98,13 @@ export const scheduledRuns = (state) => {
         return [];
     }
 };
-export const listSchedules = (state) => existsSync(schedulesDir(state))
+export const listSchedules = (state, filter = {}) => existsSync(schedulesDir(state))
     ? readdirSync(schedulesDir(state))
         .map((name) => scheduleFile(state, name))
         .filter((file) => existsSync(file))
         .map(readSchedule)
+        .filter((schedule) => (filter.name === undefined || schedule.name === filter.name) &&
+        (filter.kind === undefined || schedule.kind === filter.kind))
         .sort((a, b) => a.name.localeCompare(b.name))
     : [];
 export const describeWhen = (when) => "every" in when

package/dist/cli/bot/admins.js

@@ -6,10 +6,12 @@ import { guardedWrite } from "../../sends/guarded.js";
 import { newOperationId } from "../../sends/send-id.js";
 import { REMOTE_READ, REMOTE_WRITE } from "../effects.js";
 import { renderAnswer, snakeKeys } from "../envelope.js";
+import { listQuery, typedQuery, withQuery } from "../list-query.js";
 import { rightsOf } from "../messenger/admin-commands.js";
 import { renderItem, wholeList } from "../messenger/chat-answers.js";
 import { botContext, online } from "./context.js";
 import { botExamples } from "./examples.js";
+import { BOT_ADMINS_QUERY } from "./list-queries.js";
 import { botCan } from "./messages.js";
 const CHAT = "a chat id, or the title of a chat this bot has seen";
 const PERSON = "the person's user id";
@@ -24,10 +26,10 @@ const personOf = (typed) => {
 export const botAdminsCommand = (bot) => {
     const offered = bot.adminRights ?? ADMIN_RIGHTS;
     const command = new Command("admins").description("the admins of a chat the bot is an admin in");
-    annotate(command.command("list"), { effects: REMOTE_READ, examples: botExamples(bot, "chats admins list Team") })
+    withQuery(annotate(command.command("list"), { effects: REMOTE_READ, examples: botExamples(bot, "chats admins list Team") })
         .description("the chat's admins and what each may do")
-        .argument("<chat>", CHAT)
-        .action(async function (chat) {
+        .argument("<chat>", CHAT), BOT_ADMINS_QUERY).action(async function (chat, words) {
+        listQuery(typedQuery(words), BOT_ADMINS_QUERY, "bot chats admins list");
         const context = online(botContext(this, bot), this);
         const ref = context.chatRef(chat);
         await context.run(async (events) => {

package/dist/cli/bot/command.js

@@ -6,10 +6,14 @@ import { guardedWrite } from "../../sends/guarded.js";
 import { newOperationId } from "../../sends/send-id.js";
 import { grantsAuthority, LOCAL_READ, LOCAL_WRITE, REMOTE_READ, REMOTE_WRITE } from "../effects.js";
 import { itemOf, renderAnswer, snakeKeys } from "../envelope.js";
+import { withQuery } from "../list-query.js";
 import { renderItem, wholeList } from "../messenger/chat-answers.js";
+import { RECIPIENTS_QUERY, recipientFilter } from "../messenger/recipients-query.js";
+import { SENDS_QUERY, sendFilter } from "../messenger/sends-query.js";
 import { botAdminsCommand, botMembersCommand } from "./admins.js";
 import { botContext, online } from "./context.js";
 import { botExamples } from "./examples.js";
+import { BOT_CHATS_QUERY, BOT_PROFILES_QUERY, botChatFilter, botProfileName } from "./list-queries.js";
 import { botMcpCommand } from "./mcp.js";
 import { botCan, botIdOf, botMessagesCommand } from "./messages.js";
 import { botModerateCommand, botRulesCommand } from "./moderation.js";
@@ -114,11 +118,12 @@ const meCommand = (bot) => annotate(new Command("me"), { effects: REMOTE_READ, e
         }
     });
 });
-const listCommand = (bot, tokenVariable) => annotate(new Command("list"), { effects: LOCAL_READ, examples: botExamples(bot, "list", "list --check") })
+const listCommand = (bot, tokenVariable) => withQuery(annotate(new Command("list"), { effects: LOCAL_READ, examples: botExamples(bot, "list", "list --check") }), BOT_PROFILES_QUERY)
     .description(`every name on this machine that has a bot token; --check asks ${bot.name ?? "the messenger"} which bot each is`)
     .summary("every bot profile on this machine; --check asks which bot each is")
     .option("--check", "ask the messenger who each bot is, with its token")
-    .action(async function () {
+    .action(async function (words) {
+    const wanted = botProfileName(words);
     const context = botContext(this, bot);
     const check = this.opts().check === true;
     if (check)
@@ -132,6 +137,8 @@ const listCommand = (bot, tokenVariable) => annotate(new Command("list"), { effe
         }
         const rows = [];
         for (const name of names) {
+            if (wanted !== undefined && name !== wanted)
+                continue;
             const tokens = bot.tokenStore?.(this, name) ??
                 new BotTokenStore({
                     app: bot.app,
@@ -161,11 +168,12 @@ const recipientsCommand = (bot) => {
     const command = new Command("recipients")
         .description("the chats this bot may write to; with no list, every chat — `clear` removes the list")
         .summary("the chats this bot may write to; with no list, every chat");
-    annotate(command.command("list"), { effects: LOCAL_READ, examples: botExamples(bot, "recipients list") })
+    withQuery(annotate(command.command("list"), { effects: LOCAL_READ, examples: botExamples(bot, "recipients list") }), RECIPIENTS_QUERY)
         .description("the chats on the list, or nothing when there is no list")
-        .action(async function () {
+        .action(async function (words) {
+        const filter = recipientFilter(words, "bot recipients list");
         const context = botContext(this, bot);
-        await context.run(async () => renderAnswer(this, context, wholeList("bot recipients list", (context.recipients().read() ?? []).map(snakeKeys))));
+        await context.run(async () => renderAnswer(this, context, wholeList("bot recipients list", context.recipients().list(filter).items.map(snakeKeys))));
     });
     grantsAuthority(annotate(command.command("add"), {
         effects: LOCAL_WRITE,
@@ -203,21 +211,23 @@ const recipientsCommand = (bot) => {
 const sendsCommand = (bot) => new Command("sends")
     .description("what this bot sent, edited and deleted from this machine — ids and outcomes, never text")
     .summary("what this bot sent, edited and deleted from here — never the text")
-    .addCommand(annotate(new Command("list"), { effects: LOCAL_READ, examples: botExamples(bot, "sends list") })
+    .addCommand(withQuery(annotate(new Command("list"), { effects: LOCAL_READ, examples: botExamples(bot, "sends list") }), SENDS_QUERY)
     .description("every send, edit and delete this bot made from this machine, with its outcome")
-    .action(async function () {
+    .action(async function (words) {
+    const filter = sendFilter(words, "bot sends list");
     const context = botContext(this, bot);
-    await context.run(async () => renderAnswer(this, context, wholeList("bot sends list", context.journal().entries().map(snakeKeys))));
+    await context.run(async () => renderAnswer(this, context, wholeList("bot sends list", context.journal().entries(filter).map(snakeKeys))));
 }));
 const chatsCommand = (bot) => {
     const command = new Command("chats")
         .description(`the chats this bot is in — ${bot.name ?? "the messenger"} gives a bot no list of them, so \`list\` shows the ones it has seen`)
         .summary("the chats this bot is in, and what it does there");
-    annotate(command.command("list"), { effects: REMOTE_READ, examples: botExamples(bot, "chats list") })
+    withQuery(annotate(command.command("list"), { effects: REMOTE_READ, examples: botExamples(bot, "chats list") }), BOT_CHATS_QUERY)
         .description(`chats this bot has seen on this machine — not a complete list from ${bot.name ?? "the messenger"}`)
-        .action(async function () {
+        .action(async function (words) {
+        const filter = botChatFilter(words);
         const context = botContext(this, bot);
-        await context.run(async () => renderAnswer(this, context, wholeList("bot chats list", context.registry.list().map(snakeKeys))));
+        await context.run(async () => renderAnswer(this, context, wholeList("bot chats list", context.registry.list(filter).map(snakeKeys))));
     });
     annotate(command.command("show"), { effects: REMOTE_READ, examples: botExamples(bot, "chats show Team") })
         .description(`one chat from ${bot.name ?? "the messenger"}, and remember it`)

package/dist/cli/bot/list-queries.d.ts

@@ -0,0 +1,27 @@
+import { type QueryRegistry } from "@wirecat/cli-base/query";
+import { type QueryWords } from "../list-query.js";
+import type { SeenChat } from "./registry.js";
+export declare const BOT_PROFILES_QUERY: QueryRegistry;
+export declare const botProfileName: (words: QueryWords) => string | undefined;
+export declare const BOT_CHATS_QUERY: QueryRegistry;
+export declare const botChatFilter: (words: QueryWords) => Partial<Pick<SeenChat, "id" | "title" | "kind">>;
+export declare const BOT_MESSAGES_QUERY: QueryRegistry;
+export declare const botMessageWindow: (words: QueryWords) => {
+    window: {
+        before?: string | undefined;
+        since?: string | undefined;
+        threadId?: string | undefined;
+        outgoing?: boolean | undefined;
+        starred?: boolean | undefined;
+    };
+    meta: {
+        timezone: string;
+        window: {
+            since?: string;
+            until?: string;
+        };
+    } | undefined;
+};
+export declare const BOT_ADMINS_QUERY: QueryRegistry;
+export declare const BOT_MENU_QUERY: QueryRegistry;
+export declare const BOT_WEBHOOKS_QUERY: QueryRegistry;

package/dist/cli/bot/list-queries.js

@@ -0,0 +1,83 @@
+import { queryError, queryFieldsOf } from "@wirecat/cli-base/query";
+import { botAdmin, botMenuEntry, botProfile, botSeenChat, botWebhook, message } from "../../entities/index.js";
+import { listQuery, nativeTerms, queryTerms, timeBounds, typedQuery, unfilteredQuery, } from "../list-query.js";
+const termsOnly = (registry) => ({
+    ...registry,
+    fields: registry.fields.map((field) => field.native
+        ? {
+            ...field,
+            operators: field.operators.filter((operator) => operator === "term" || operator === "phrase"),
+        }
+        : field),
+});
+export const BOT_PROFILES_QUERY = termsOnly({
+    entity: "bot_profile",
+    backend: "native",
+    fields: queryFieldsOf(botProfile, { native: ["name"], examples: { name: "name:sales" } }),
+});
+export const botProfileName = (words) => queryTerms(words, BOT_PROFILES_QUERY, "bot list").get("name");
+export const BOT_CHATS_QUERY = termsOnly({
+    entity: "bot_seen_chat",
+    backend: "native",
+    fields: queryFieldsOf(botSeenChat, {
+        native: ["id", "title", "kind"],
+        examples: { id: "id:7", title: 'title:"Book club"', kind: "kind:group" },
+    }),
+});
+export const botChatFilter = (words) => {
+    const terms = queryTerms(words, BOT_CHATS_QUERY, "bot chats list");
+    const id = terms.get("id"), title = terms.get("title");
+    const kind = botSeenChat.entries.kind.wrapped.options.find((value) => value === terms.get("kind"));
+    return {
+        ...(id === undefined ? {} : { id }),
+        ...(title === undefined ? {} : { title }),
+        ...(kind === undefined ? {} : { kind }),
+    };
+};
+export const BOT_MESSAGES_QUERY = {
+    entity: "message",
+    backend: "native",
+    fields: queryFieldsOf(message, {
+        native: ["id", "timestamp", "thread_id", "outgoing", "starred"],
+        examples: {
+            id: "id<42",
+            timestamp: "timestamp>2026-10-01",
+            thread_id: "thread_id:12",
+            outgoing: "outgoing:false",
+            starred: "starred:true",
+        },
+    }).map((field) => {
+        if (field.name === "id" || field.name === "timestamp")
+            return { ...field, operators: ["range"] };
+        return field.native ? { ...field, operators: ["term"] } : field;
+    }),
+};
+export const botMessageWindow = (words) => {
+    const command = "bot messages list";
+    const terms = nativeTerms(listQuery(typedQuery(words), BOT_MESSAGES_QUERY, command), command);
+    const id = terms.get("id");
+    if (id && (id.value !== "*" || !id.upper || id.upper === "*" || id.upper_inclusive !== false))
+        queryError("query.unsupported-operator", id.span, "id takes an exclusive upper bound here: id<42", { command });
+    const timestamp = terms.get("timestamp");
+    const bounds = timeBounds(timestamp);
+    if (timestamp && (bounds.since === undefined || bounds.until !== undefined))
+        queryError("query.unsupported-operator", timestamp.span, "timestamp takes a lower bound here: timestamp>7d", {
+            command,
+        });
+    const topic = terms.get("thread_id")?.value;
+    const outgoing = terms.get("outgoing")?.value.toLowerCase();
+    const starred = terms.get("starred")?.value.toLowerCase();
+    return {
+        window: {
+            ...(id?.upper === undefined ? {} : { before: id.upper }),
+            ...(bounds.since === undefined ? {} : { since: new Date(bounds.since).toISOString() }),
+            ...(topic === undefined ? {} : { threadId: topic }),
+            ...(outgoing === undefined ? {} : { outgoing: outgoing === "true" }),
+            ...(starred === undefined ? {} : { starred: starred === "true" }),
+        },
+        meta: bounds.meta,
+    };
+};
+export const BOT_ADMINS_QUERY = unfilteredQuery("bot_admin", botAdmin);
+export const BOT_MENU_QUERY = unfilteredQuery("bot_menu_entry", botMenuEntry);
+export const BOT_WEBHOOKS_QUERY = unfilteredQuery("bot_webhook", botWebhook);

package/dist/cli/bot/messages.js

@@ -9,12 +9,14 @@ import { readAttachments } from "../../sends/upload.js";
 import { environmentOf } from "../context.js";
 import { ownerOnlyOption, REMOTE_READ, REMOTE_WRITE } from "../effects.js";
 import { itemOf, renderAnswer, snakeKeys } from "../envelope.js";
+import { typedQuery, withQuery } from "../list-query.js";
 import { wholeList } from "../messenger/chat-answers.js";
 import { messageItem } from "../messenger/message-items.js";
 import { readAll } from "../messenger/stdin.js";
 import { positiveCount } from "../paging.js";
 import { botContext } from "./context.js";
 import { botExamples } from "./examples.js";
+import { BOT_MESSAGES_QUERY, botMessageWindow } from "./list-queries.js";
 /** The adapter's `method`, or a refusal naming what this messenger's bot cannot do. */
 export const botCan = (adapter, method, bot, what) => {
     const found = adapter[method];
@@ -32,10 +34,10 @@ export const botIdOf = async (context, adapter) => {
     context.registry.rememberBot(id);
     return id;
 };
-const show = (command, context, bot, botId, messages, one = false) => {
+const show = (command, context, bot, botId, messages, one = false, meta) => {
     const reader = context.copy.accountOf(botId);
     const items = messages.map((message) => messageItem(message, reader));
-    renderAnswer(command, context, one && items[0] ? itemOf(items[0]) : wholeList("bot messages list", items), () => renderMessages(messages, {
+    renderAnswer(command, context, one && items[0] ? itemOf(items[0]) : { ...wholeList("bot messages list", items), ...(meta ? { meta } : {}) }, () => renderMessages(messages, {
         color: context.color,
         verbosity: context.settings.detail,
         senderColors: context.settings.senderColors,
@@ -124,33 +126,37 @@ const sendCommand = (bot) => annotate(new Command("send"), {
         renderAnswer(this, context, written(context, botId, { operationId }, message));
     });
 });
-const listCommand = (bot) => annotate(new Command("list"), { effects: REMOTE_READ, examples: botExamples(bot, "messages list Team --limit 20") })
+const listCommand = (bot) => withQuery(annotate(new Command("list"), { effects: REMOTE_READ, examples: botExamples(bot, "messages list Team --limit 20") })
     .description(`the latest messages in a chat; where ${bot.name ?? "the messenger"} gives a bot no history, and with --offline, ` +
     "the ones this bot has seen on this machine")
     .summary("the latest messages in a chat")
-    .argument("<chat>", "a chat id, user:<id> for a person, or the title of a chat this bot has seen")
+    .argument("<chat>", "a chat id, user:<id> for a person, or the title of a chat this bot has seen"), BOT_MESSAGES_QUERY)
+    .addHelpText("after", "\nQueries filter the stored copy before limiting results; add --offline. The Bot API does not accept these filters.")
     .option("--limit <n>", "how many, the newest", positiveCount("--limit"))
-    .action(async function (chat) {
+    .action(async function (chat, words) {
+    const narrowed = botMessageWindow(words);
     const context = botContext(this, bot);
+    if (typedQuery(words).trim() && !context.settings.offline)
+        throw new CliError("validation_error", "bot message queries filter the local copy; add --offline");
     const ref = context.chatRef(chat);
     const limit = this.opts().limit ?? context.settings.limit;
     await context.run(async (events) => {
         const fromCopy = async (botId) => {
-            const page = await context.copy.read((store) => store.messages.messages(context.copy.accountOf(botId), ref, { limit }));
+            const page = await context.copy.read((store) => store.messages.messages(context.copy.accountOf(botId), ref, { limit, ...narrowed.window }));
             return page.items;
         };
         if (context.settings.offline) {
             const botId = context.registry.botId();
             if (!botId)
                 throw nothingKept(context);
-            show(this, context, bot, botId, await fromCopy(botId));
+            show(this, context, bot, botId, await fromCopy(botId), false, narrowed.meta);
             return;
         }
         const adapter = await context.authenticated({ events });
         const botId = await botIdOf(context, adapter);
         if (!adapter.history) {
             context.renderer.note(`${bot.name ?? "the messenger"} gives a bot no history: these are the messages it kept`);
-            show(this, context, bot, botId, await fromCopy(botId));
+            show(this, context, bot, botId, await fromCopy(botId), false, narrowed.meta);
             return;
         }
         const messages = await adapter.history(ref, { limit });

package/dist/cli/bot/registry.d.ts

@@ -24,7 +24,7 @@ export declare const botFiles: (app: AppIdentity, profile: string, env?: NodeJS.
 export declare class ChatRegistry {
     #private;
     constructor(app: AppIdentity, profile: string, env?: NodeJS.ProcessEnv);
-    list(): SeenChat[];
+    list(filter?: Partial<Pick<SeenChat, "id" | "title" | "kind">>): SeenChat[];
     /** The bot's own user id, once any command has learned it — the key its messages are stored under. */
     botId(): string | undefined;
     rememberBot(id: string): void;

package/dist/cli/bot/registry.js

@@ -26,9 +26,11 @@ export class ChatRegistry {
     constructor(app, profile, env = process.env) {
         this.#path = botFiles(app, profile, env).registry;
     }
-    list() {
+    list(filter = {}) {
         const { chats } = this.#read();
-        return Array.isArray(chats) ? chats : [];
+        return (Array.isArray(chats) ? chats : []).filter((chat) => (filter.id === undefined || chat.id === filter.id) &&
+            (filter.kind === undefined || chat.kind === filter.kind) &&
+            (filter.title === undefined || chat.title?.toLocaleLowerCase() === filter.title?.toLocaleLowerCase()));
     }
     /** The bot's own user id, once any command has learned it — the key its messages are stored under. */
     botId() {

package/dist/cli/bot/setup.js

@@ -5,9 +5,11 @@ import { guardedWrite } from "../../sends/guarded.js";
 import { newOperationId } from "../../sends/send-id.js";
 import { REMOTE_READ, REMOTE_WRITE } from "../effects.js";
 import { itemOf, renderAnswer, snakeKeys } from "../envelope.js";
+import { listQuery, typedQuery, withQuery } from "../list-query.js";
 import { wholeList } from "../messenger/chat-answers.js";
 import { botContext, online } from "./context.js";
 import { botExamples } from "./examples.js";
+import { BOT_MENU_QUERY, BOT_WEBHOOKS_QUERY } from "./list-queries.js";
 import { botCan } from "./messages.js";
 import { botFiles } from "./registry.js";
 import { PressLog } from "./updates.js";
@@ -31,9 +33,10 @@ const botWrite = (context, key, write) => guardedWrite(context.guard(), { operat
 /** `bot commands`: the menu people see when they type `/`. */
 export const botMenuCommand = (bot) => {
     const command = new Command("commands").description("the bot's command menu — what people see after /");
-    annotate(command.command("list"), { effects: REMOTE_READ, examples: botExamples(bot, "commands list") })
+    withQuery(annotate(command.command("list"), { effects: REMOTE_READ, examples: botExamples(bot, "commands list") }), BOT_MENU_QUERY)
         .description("the commands in the menu now")
-        .action(async function () {
+        .action(async function (words) {
+        listQuery(typedQuery(words), BOT_MENU_QUERY, "bot commands list");
         const context = online(botContext(this, bot), this);
         await context.run(async (events) => {
             const adapter = await context.authenticated({ events });
@@ -111,9 +114,10 @@ export const botWebhooksCommand = (bot) => {
     const command = new Command("webhooks")
         .description("where the messenger pushes this bot's updates — while one is set, `bot watch` gets nothing")
         .summary("where the messenger pushes this bot's updates");
-    annotate(command.command("list"), { effects: REMOTE_READ, examples: botExamples(bot, "webhooks list") })
+    withQuery(annotate(command.command("list"), { effects: REMOTE_READ, examples: botExamples(bot, "webhooks list") }), BOT_WEBHOOKS_QUERY)
         .description("the webhooks this bot has")
-        .action(async function () {
+        .action(async function (words) {
+        listQuery(typedQuery(words), BOT_WEBHOOKS_QUERY, "bot webhooks list");
         const context = online(botContext(this, bot), this);
         await context.run(async (events) => {
             const adapter = await context.authenticated({ events });

package/dist/cli/index.d.ts

@@ -1,5 +1,6 @@
 export { AI_ENTRIES, AI_SETTING_KEYS, type AISettings, resolveAISettings } from "../analysis/settings.js";
 export { parseDuration } from "../domain/duration.js";
+export { botTemplate } from "../entities/list-results.js";
 export { syncProgress } from "../entities/store-records.js";
 export { isCliFailure, isCommanderFailure } from "../errors/failures.js";
 export { type AppErrors, failureContext } from "../errors/reasons.js";

package/dist/cli/index.js

@@ -1,5 +1,6 @@
 export { AI_ENTRIES, AI_SETTING_KEYS, resolveAISettings } from "../analysis/settings.js";
 export { parseDuration } from "../domain/duration.js";
+export { botTemplate } from "../entities/list-results.js";
 export { syncProgress } from "../entities/store-records.js";
 export { isCliFailure, isCommanderFailure } from "../errors/failures.js";
 export { failureContext } from "../errors/reasons.js";

package/dist/cli/messenger/list-result-queries.d.ts

@@ -0,0 +1,9 @@
+import { type QueryRegistry } from "@wirecat/cli-base/query";
+import type { Schedule } from "../../background/schedules.js";
+import { type QueryWords } from "../list-query.js";
+export declare const SCHEDULES_QUERY: QueryRegistry;
+export declare const scheduleFilter: (words: QueryWords) => Partial<Pick<Schedule, "name" | "kind">>;
+export declare const TOPICS_QUERY: QueryRegistry;
+export declare const topicTitle: (words: QueryWords) => string | undefined;
+export declare const CALLS_QUERY: QueryRegistry;
+export declare const STICKERS_QUERY: QueryRegistry;

package/dist/cli/messenger/list-result-queries.js

@@ -0,0 +1,30 @@
+import { queryFieldsOf } from "@wirecat/cli-base/query";
+import { callRecord, scheduledJob, stickerInventory, topic } from "../../entities/index.js";
+import { queryTerms, unfilteredQuery } from "../list-query.js";
+const termsOnly = (registry) => ({
+    ...registry,
+    fields: registry.fields.map((field) => field.native
+        ? { ...field, operators: field.operators.filter((operator) => operator === "term" || operator === "phrase") }
+        : field),
+});
+export const SCHEDULES_QUERY = termsOnly({
+    entity: "scheduled_job",
+    backend: "native",
+    fields: queryFieldsOf(scheduledJob, {
+        native: ["name", "kind"],
+        examples: { name: "name:daily", kind: "kind:command" },
+    }),
+});
+export const scheduleFilter = (words) => {
+    const terms = queryTerms(words, SCHEDULES_QUERY, "schedule list");
+    const name = terms.get("name"), kind = terms.get("kind");
+    return { ...(name === undefined ? {} : { name }), ...(kind === "agent" || kind === "command" ? { kind } : {}) };
+};
+export const TOPICS_QUERY = termsOnly({
+    entity: "topic",
+    backend: "native",
+    fields: queryFieldsOf(topic, { native: ["title"], examples: { title: 'title:"Book club"' } }),
+});
+export const topicTitle = (words) => queryTerms(words, TOPICS_QUERY, "topics list").get("title");
+export const CALLS_QUERY = unfilteredQuery("call_record", callRecord);
+export const STICKERS_QUERY = unfilteredQuery("sticker_inventory", stickerInventory);

package/dist/cli/messenger/recipients-query.d.ts

@@ -2,4 +2,4 @@ import { type QueryRegistry } from "@wirecat/cli-base/query";
 import type { RecipientFilter } from "../../sends/recipients.js";
 import { type QueryWords } from "../list-query.js";
 export declare const RECIPIENTS_QUERY: QueryRegistry;
-export declare const recipientFilter: (words: QueryWords) => RecipientFilter;
+export declare const recipientFilter: (words: QueryWords, command?: string) => RecipientFilter;

package/dist/cli/messenger/recipients-query.js

@@ -11,8 +11,8 @@ export const RECIPIENTS_QUERY = {
         ? { ...field, operators: field.operators.filter((operator) => operator === "term" || operator === "phrase") }
         : field),
 };
-export const recipientFilter = (words) => {
-    const terms = queryTerms(words, RECIPIENTS_QUERY, "recipients list");
+export const recipientFilter = (words, command = "recipients list") => {
+    const terms = queryTerms(words, RECIPIENTS_QUERY, command);
     const id = terms.get("id"), title = terms.get("title");
     return { ...(id === undefined ? {} : { id }), ...(title === undefined ? {} : { title }) };
 };

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

@@ -6,8 +6,10 @@ import { sendTime } from "../../domain/send-time.js";
 import { capability } from "../../ports/messenger.js";
 import { ownerOnlyOption, REMOTE_READ, REMOTE_WRITE } from "../effects.js";
 import { itemOf, listOf, renderAnswer, snakeKeys } from "../envelope.js";
+import { listQuery, typedQuery, withQuery } from "../list-query.js";
 import { positiveCount } from "../paging.js";
 import { messengerContext } from "./context.js";
+import { CALLS_QUERY, STICKERS_QUERY } from "./list-result-queries.js";
 const kindsOf = (typed) => {
     const kinds = typed === undefined ? [...MEDIA_KINDS] : typed.split(",").map((kind) => kind.trim());
     for (const kind of kinds) {
@@ -49,10 +51,14 @@ export const mediaCommand = (messenger) => annotate(new Command("media"), { effe
 /** `stickers list` — the sets the account added, or one set's stickers with the ids `messages send --sticker` takes. */
 export const stickersCommand = (messenger) => {
     const stickers = new Command("stickers").description("the stickers the account has added");
-    annotate(stickers.command("list"), { effects: REMOTE_READ })
+    withQuery(annotate(stickers.command("list"), {
+        effects: REMOTE_READ,
+        examples: [`${messenger.app.command} personal stickers list`],
+    }), STICKERS_QUERY)
         .description("sticker sets, or with --set the stickers in one; reading changes nothing")
         .option("--set <id>", "the stickers in this set")
-        .action(async function () {
+        .action(async function (words) {
+        listQuery(typedQuery(words), STICKERS_QUERY, "stickers list");
         const context = messengerContext(this, messenger);
         const { set } = this.opts();
         const items = await context.withMessenger((adapter) => set === undefined
@@ -69,10 +75,14 @@ export const stickersCommand = (messenger) => {
 /** `calls list` — the account's call history, newest first. */
 export const callsCommand = (messenger) => {
     const calls = new Command("calls").description("the account's calls");
-    annotate(calls.command("list"), { effects: REMOTE_READ })
+    withQuery(annotate(calls.command("list"), {
+        effects: REMOTE_READ,
+        examples: [`${messenger.app.command} personal calls list`],
+    }), CALLS_QUERY)
         .description("calls made and received, newest first; reading changes nothing")
         .option("--limit <n>", "how many to show", positiveCount("--limit"))
-        .action(async function () {
+        .action(async function (words) {
+        listQuery(typedQuery(words), CALLS_QUERY, "calls list");
         const context = messengerContext(this, messenger);
         const limit = context.settings.limit;
         const page = await context.withMessenger((adapter) => capability(adapter, "calls", "list calls")({ limit }));

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

@@ -13,8 +13,10 @@ import { storePath } from "../../store/path.js";
 import { environmentOf, setExitCode } from "../context.js";
 import { grantsAuthority, LOCAL_READ, LOCAL_WRITE, REMOTE_WRITE } from "../effects.js";
 import { itemOf, listOf, renderAnswer, snakeKeys } from "../envelope.js";
+import { withQuery } from "../list-query.js";
 import { lineOf } from "../steps.js";
 import { messengerContext } from "./context.js";
+import { SCHEDULES_QUERY, scheduleFilter } from "./list-result-queries.js";
 /** Each run of an agent is a paid model call that reads chats; keeping the store current is `serve`'s job. */
 const AGENT_MINIMUM_MINUTES = 60;
 const COMMAND_MINIMUM_MINUTES = 1;
@@ -156,11 +158,12 @@ export const scheduleCommand = (messenger) => {
             createdAt: new Date().toISOString(),
         });
     });
-    annotate(command.command("list"), { effects: LOCAL_READ })
+    withQuery(annotate(command.command("list"), { effects: LOCAL_READ }), SCHEDULES_QUERY)
         .description("the schedules, when they run and how their last run went")
-        .action(function () {
+        .action(function (words) {
+        const filter = scheduleFilter(words);
         const { context, state } = prepare(this);
-        const rows = listSchedules(state).map((schedule) => ({
+        const rows = listSchedules(state, filter).map((schedule) => ({
             name: schedule.name,
             kind: schedule.kind,
             when: describeWhen(schedule.when),

package/dist/cli/messenger/sends-query.d.ts

@@ -2,4 +2,4 @@ import { type QueryRegistry } from "@wirecat/cli-base/query";
 import type { SendFilter } from "../../sends/journal.js";
 import { type QueryWords } from "../list-query.js";
 export declare const SENDS_QUERY: QueryRegistry;
-export declare const sendFilter: (words: QueryWords) => SendFilter | undefined;
+export declare const sendFilter: (words: QueryWords, command?: string) => SendFilter | undefined;

package/dist/cli/messenger/sends-query.js

@@ -17,8 +17,8 @@ export const SENDS_QUERY = {
         ? { ...field, operators: field.operators.filter((operator) => operator === "term" || operator === "phrase") }
         : field),
 };
-export const sendFilter = (words) => {
-    const terms = queryTerms(words, SENDS_QUERY, "sends list");
+export const sendFilter = (words, command = "sends list") => {
+    const terms = queryTerms(words, SENDS_QUERY, command);
     if (terms.size === 0)
         return undefined;
     const outcome = sendAttempt.entries.outcome.options.find((value) => value === terms.get("outcome"));

package/dist/cli/messenger/store-maintenance-command.d.ts

@@ -3,9 +3,9 @@ import type { CacheDatabase } from "../../store/driver.js";
 import type { Messenger } from "./context.js";
 /** `doctor`'s short summary of the store. Must answer for a broken file, so an error is a field. */
 export declare const storeSummary: (env: NodeJS.ProcessEnv) => Promise<{
-    error?: undefined;
     path: string;
     exists: boolean;
+    error?: undefined;
 } | {
     path: string;
     exists: boolean;

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

@@ -4,22 +4,26 @@ import { Command } from "commander";
 import { capability } from "../../ports/messenger.js";
 import { ownerOnlyOption, REMOTE_READ, REMOTE_WRITE } from "../effects.js";
 import { itemOf, listOf, renderAnswer, snakeKeys } from "../envelope.js";
+import { typedQuery, withQuery } from "../list-query.js";
 import { window, withPaging } from "../paging.js";
 import { lines, pageOf, topicAnswer } from "./chat-answers.js";
 import { messengerContext } from "./context.js";
-const listed = (messenger) => async function (chat) {
-    const [, query] = this.args;
+import { TOPICS_QUERY, topicTitle } from "./list-result-queries.js";
+const listed = (messenger) => async function (chat, value) {
+    const searching = this.name() === "topics";
+    const words = !searching && Array.isArray(value) ? value : [];
+    const query = searching && typeof value === "string" ? value : topicTitle(words);
     const context = messengerContext(this, messenger);
     if (context.settings.offline) {
         throw new CliError("validation_error", "`topics` asks the messenger; not with --offline");
     }
     const wanted = { ...window(context.settings), ...(query ? { search: query } : {}) };
     const found = await context.withMessenger((adapter) => capability(adapter, "topics", "list forum topics")(chat, wanted));
-    const command = query === undefined ? "topics list" : "search topics";
+    const command = searching ? "search topics" : "topics list";
     renderAnswer(this, context, listOf(command, {
         items: found.items.map(topicAnswer),
         ...pageOf(context.settings, found),
-        args: { chat, ...(query === undefined ? {} : { text: query }) },
+        args: { chat, ...(searching ? { text: query } : typedQuery(words) ? { query: typedQuery(words) } : {}) },
     }), lines(({ id, title, closed, pinned, unread_count }) => [id, title, closed ? "closed" : "", pinned ? "pinned" : "", unread_count ? `${unread_count} unread` : ""].join("  ")));
 };
 /** `search topics`: a forum group's topics whose title matches, asked of the messenger. */
@@ -30,9 +34,9 @@ export const topicsSearchCommand = (messenger) => withPaging(annotate(new Comman
 /** `topics list` and the writes — a forum group's topics, with the ids its messages carry as `threadId`. */
 export const topicsCommand = (messenger) => {
     const topics = annotate(new Command("topics"), { offline: false }).description("the topics of a forum group");
-    topics.addCommand(withPaging(annotate(new Command("list"), { effects: REMOTE_READ })
+    topics.addCommand(withQuery(withPaging(annotate(new Command("list"), { effects: REMOTE_READ })
         .description("a forum group's topics, newest activity first")
-        .argument("<chat>", messenger.chatArgument)).action(listed(messenger)));
+        .argument("<chat>", messenger.chatArgument)), TOPICS_QUERY).action(listed(messenger)));
     if (messenger.topicShow)
         annotate(topics.command("show"), { effects: REMOTE_READ })
             .description("one forum topic: its title, state and last activity")

package/dist/entities/index.d.ts

@@ -39,6 +39,7 @@ import { imageEmbedding } from "./image-embedding.js";
 import { inviteLink } from "./invite-link.js";
 import { job } from "./job.js";
 import { joinRequest } from "./join-request.js";
+import { botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, callRecord, scheduledJob, stickerInventory } from "./list-results.js";
 import { messageEvent, serveSummary, watchedMessage, watchItem } from "./listener.js";
 import { mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer } from "./media-archive.js";
 import { meeting } from "./meeting.js";
@@ -84,7 +85,7 @@ import { topic } from "./topic.js";
  * subset of its fields, never a renamed one. Commands move onto these one by one; until then, a schema
  * is the target, not a description of today's output.
  */
-export { account, accountChange, accountPrivacy, accountPrivacyChange, accountProfile, accountSession, adminReport, agenda, analysisConsent, analysisConsentRevocation, attachment, attachmentBytes, attachmentExtraction, attachmentTextChange, automaticTags, cachedChatMetadata, chart, chat, chatAdminChange, chatArchive, chatEvent, chatFolderChange, chatFolderOrder, chatFolderRemoval, chatGroupChange, chatInspection, chatInvite, chatInviteChange, chatMembersChange, chatMembersFetch, chatMetadata, chatMetadataRefresh, chatModeration, chatMuting, chatPin, chatRead, chatRemoval, chatRequestChange, chatRules, chatSender, chatStats, chatTracking, chatUnread, contact, contactActivity, contactAlias, contactCheck, contactContext, contactImport, contactLookup, contactNote, contactNoteRemoval, contactPreparation, contactProfile, contactStateChange, contactSync, contactUpdate, conversation, conversationBatch, conversationBatchStatus, conversationBuildResult, conversationChange, conversationDetails, conversationEmbedding, conversationEmbeddingStatus, conversationHit, conversationPreparation, conversationReadiness, counterRefresh, counters, document, documentLink, endedAccountSessions, evidence, evidencePacket, fact, folder, hit, identity, imageEmbedding, inviteLink, job, joinRequest, linkedPerson, mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, mention, mentionDecision, mentionDetails, mentionDomain, mentionRebuild, message, messageContext, messageCounts, messageDeletion, messageDownload, messageEvent, messageLink, messageLinks, messagePin, messageStar, messageSync, messageTranscript, messageWrite, model, modelKey, note, officialStats, person, place, poll, pollChange, pollVote, ranking, reactionChange, recipient, recipientAdded, recipientChange, recipientOff, recipientRemoved, recordedRun, reference, relationship, removedModelKey, retention, runDetails, runHit, runLocation, savedSearch, searchHistoryClear, sendAttempt, serveSummary, storeBackup, storeChatStatus, storeCheck, storeClear, storeCopyRemoval, storeDecrypt, storedModelKey, storeExport, storeGapPlan, storeGapRepair, storeInfo, storeJobCancel, storeJobClear, storeJobDetails, storeJobRetry, storeMigration, storeReindex, storeRepair, storeReset, storeRestore, tagChange, tagging, task, taskCard, taskCategories, taskClosed, taskCreated, taskLinks, taskMerge, taskPair, taskScan, taskSimilar, taskStats, taskUnmerge, topic, trackedChat, trackedChatHistory, watchedMessage, watchItem, };
+export { account, accountChange, accountPrivacy, accountPrivacyChange, accountProfile, accountSession, adminReport, agenda, analysisConsent, analysisConsentRevocation, attachment, attachmentBytes, attachmentExtraction, attachmentTextChange, automaticTags, botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, cachedChatMetadata, callRecord, chart, chat, chatAdminChange, chatArchive, chatEvent, chatFolderChange, chatFolderOrder, chatFolderRemoval, chatGroupChange, chatInspection, chatInvite, chatInviteChange, chatMembersChange, chatMembersFetch, chatMetadata, chatMetadataRefresh, chatModeration, chatMuting, chatPin, chatRead, chatRemoval, chatRequestChange, chatRules, chatSender, chatStats, chatTracking, chatUnread, contact, contactActivity, contactAlias, contactCheck, contactContext, contactImport, contactLookup, contactNote, contactNoteRemoval, contactPreparation, contactProfile, contactStateChange, contactSync, contactUpdate, conversation, conversationBatch, conversationBatchStatus, conversationBuildResult, conversationChange, conversationDetails, conversationEmbedding, conversationEmbeddingStatus, conversationHit, conversationPreparation, conversationReadiness, counterRefresh, counters, document, documentLink, endedAccountSessions, evidence, evidencePacket, fact, folder, hit, identity, imageEmbedding, inviteLink, job, joinRequest, linkedPerson, mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, mention, mentionDecision, mentionDetails, mentionDomain, mentionRebuild, message, messageContext, messageCounts, messageDeletion, messageDownload, messageEvent, messageLink, messageLinks, messagePin, messageStar, messageSync, messageTranscript, messageWrite, model, modelKey, note, officialStats, person, place, poll, pollChange, pollVote, ranking, reactionChange, recipient, recipientAdded, recipientChange, recipientOff, recipientRemoved, recordedRun, reference, relationship, removedModelKey, retention, runDetails, runHit, runLocation, savedSearch, scheduledJob, searchHistoryClear, sendAttempt, serveSummary, stickerInventory, storeBackup, storeChatStatus, storeCheck, storeClear, storeCopyRemoval, storeDecrypt, storedModelKey, storeExport, storeGapPlan, storeGapRepair, storeInfo, storeJobCancel, storeJobClear, storeJobDetails, storeJobRetry, storeMigration, storeReindex, storeRepair, storeReset, storeRestore, tagChange, tagging, task, taskCard, taskCategories, taskClosed, taskCreated, taskLinks, taskMerge, taskPair, taskScan, taskSimilar, taskStats, taskUnmerge, topic, trackedChat, trackedChatHistory, watchedMessage, watchItem, };
 export declare const ENTITIES: {
     readonly meeting_ingestion: v.StrictObjectSchema<{
         readonly meetings: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
@@ -4741,6 +4742,88 @@ export declare const ENTITIES: {
         readonly account: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
         readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     }, undefined>;
+    readonly bot_profile: v.StrictObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly token: v.StringSchema<undefined>;
+        readonly bot: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+        readonly problem: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>;
+    readonly bot_template: v.StrictObjectSchema<{
+        readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly status: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly language: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly category: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>;
+    readonly bot_seen_chat: v.StrictObjectSchema<{
+        readonly title: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly kind: v.OptionalSchema<v.PicklistSchema<["dialog", "group", "channel", "saved", "unknown"], undefined>, undefined>;
+        readonly unread_count: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>, undefined>;
+        readonly unread_mentions: v.OptionalSchema<v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>, undefined>;
+        readonly last_message_at: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>, undefined>;
+        readonly participants_count: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>, undefined>;
+        readonly muted: v.OptionalSchema<v.OptionalSchema<v.BooleanSchema<undefined>, undefined>, undefined>;
+        readonly archived: v.OptionalSchema<v.OptionalSchema<v.BooleanSchema<undefined>, undefined>, undefined>;
+        readonly marked_unread: v.OptionalSchema<v.OptionalSchema<v.BooleanSchema<undefined>, undefined>, undefined>;
+        readonly membership_state: v.OptionalSchema<v.OptionalSchema<v.PicklistSchema<["joined", "left", "public", "imported", "archived", "external"], undefined>, undefined>, undefined>;
+        readonly scope: v.OptionalSchema<v.OptionalSchema<v.PicklistSchema<["personal", "work"], undefined>, undefined>, undefined>;
+        readonly provider_metadata: v.OptionalSchema<v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>, undefined>;
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly parent_chat_id: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, undefined>;
+        readonly muted_until: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>, undefined>;
+        readonly first_seen_at: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
+        readonly last_seen_at: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
+    }, undefined>;
+    readonly bot_admin: v.StrictObjectSchema<{
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly username: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly role: v.PicklistSchema<["owner", "admin"], undefined>;
+        readonly rights: v.ArraySchema<v.PicklistSchema<["read", "members", "admins", "info", "pin", "link", "post", "edit", "delete"], undefined>, undefined>;
+        readonly title: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>;
+    readonly bot_menu_entry: v.StrictObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>;
+    readonly bot_webhook: v.StrictObjectSchema<{
+        readonly url: v.StringSchema<undefined>;
+        readonly types: v.NullableSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+    }, undefined>;
+    readonly scheduled_job: v.StrictObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly kind: v.PicklistSchema<["command", "agent"], undefined>;
+        readonly when: v.StringSchema<undefined>;
+        readonly last: v.NullableSchema<v.StrictObjectSchema<{
+            readonly at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+            readonly exit_code: v.NumberSchema<undefined>;
+            readonly output: v.StringSchema<undefined>;
+            readonly trace_id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly reason: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly error_code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly failing_since: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
+            readonly failures: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+    }, undefined>;
+    readonly call_record: v.StrictObjectSchema<{
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly chat_id: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+        readonly caller_id: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+        readonly direction: v.PicklistSchema<["incoming", "outgoing"], undefined>;
+        readonly outcome: v.PicklistSchema<["answered", "missed", "declined"], undefined>;
+        readonly kind: v.PicklistSchema<["audio", "video"], undefined>;
+        readonly at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+        readonly duration_seconds: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    }, undefined>;
+    readonly sticker_inventory: v.StrictObjectSchema<{
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly count: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly link: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly set_id: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, undefined>;
+        readonly emoji: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly url: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    }, undefined>;
     readonly note: v.StrictObjectSchema<{
         readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
         readonly kind: v.OptionalSchema<v.PicklistSchema<["note", "document"], undefined>, undefined>;

package/dist/entities/index.js

@@ -41,6 +41,7 @@ import { imageEmbedding } from "./image-embedding.js";
 import { inviteLink } from "./invite-link.js";
 import { job } from "./job.js";
 import { joinRequest } from "./join-request.js";
+import { botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, callRecord, scheduledJob, stickerInventory, } from "./list-results.js";
 import { messageEvent, serveSummary, watchedMessage, watchItem } from "./listener.js";
 import { mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer } from "./media-archive.js";
 import { event, meeting, meetingDetails, meetingHit, meetingLink, meetingParticipants, meetingPassage, meetingProjectEvidence, meetingReview, meetingSpeaker, meetingStats, meetingSummary, meetingTranscript, } from "./meeting.js";
@@ -90,7 +91,7 @@ import { topic } from "./topic.js";
  * subset of its fields, never a renamed one. Commands move onto these one by one; until then, a schema
  * is the target, not a description of today's output.
  */
-export { account, accountChange, accountPrivacy, accountPrivacyChange, accountProfile, accountSession, adminReport, agenda, analysisConsent, analysisConsentRevocation, attachment, attachmentBytes, attachmentExtraction, attachmentTextChange, automaticTags, cachedChatMetadata, chart, chat, chatAdminChange, chatArchive, chatEvent, chatFolderChange, chatFolderOrder, chatFolderRemoval, chatGroupChange, chatInspection, chatInvite, chatInviteChange, chatMembersChange, chatMembersFetch, chatMetadata, chatMetadataRefresh, chatModeration, chatMuting, chatPin, chatRead, chatRemoval, chatRequestChange, chatRules, chatSender, chatStats, chatTracking, chatUnread, contact, contactActivity, contactAlias, contactCheck, contactContext, contactImport, contactLookup, contactNote, contactNoteRemoval, contactPreparation, contactProfile, contactStateChange, contactSync, contactUpdate, conversation, conversationBatch, conversationBatchStatus, conversationBuildResult, conversationChange, conversationDetails, conversationEmbedding, conversationEmbeddingStatus, conversationHit, conversationPreparation, conversationReadiness, counterRefresh, counters, document, documentLink, endedAccountSessions, evidence, evidencePacket, fact, folder, hit, identity, imageEmbedding, inviteLink, job, joinRequest, linkedPerson, mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, mention, mentionDecision, mentionDetails, mentionDomain, mentionRebuild, message, messageContext, messageCounts, messageDeletion, messageDownload, messageEvent, messageLink, messageLinks, messagePin, messageStar, messageSync, messageTranscript, messageWrite, model, modelKey, note, officialStats, person, place, poll, pollChange, pollVote, ranking, reactionChange, recipient, recipientAdded, recipientChange, recipientOff, recipientRemoved, recordedRun, reference, relationship, removedModelKey, retention, runDetails, runHit, runLocation, savedSearch, searchHistoryClear, sendAttempt, serveSummary, storeBackup, storeChatStatus, storeCheck, storeClear, storeCopyRemoval, storeDecrypt, storedModelKey, storeExport, storeGapPlan, storeGapRepair, storeInfo, storeJobCancel, storeJobClear, storeJobDetails, storeJobRetry, storeMigration, storeReindex, storeRepair, storeReset, storeRestore, tagChange, tagging, task, taskCard, taskCategories, taskClosed, taskCreated, taskLinks, taskMerge, taskPair, taskScan, taskSimilar, taskStats, taskUnmerge, topic, trackedChat, trackedChatHistory, watchedMessage, watchItem, };
+export { account, accountChange, accountPrivacy, accountPrivacyChange, accountProfile, accountSession, adminReport, agenda, analysisConsent, analysisConsentRevocation, attachment, attachmentBytes, attachmentExtraction, attachmentTextChange, automaticTags, botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, cachedChatMetadata, callRecord, chart, chat, chatAdminChange, chatArchive, chatEvent, chatFolderChange, chatFolderOrder, chatFolderRemoval, chatGroupChange, chatInspection, chatInvite, chatInviteChange, chatMembersChange, chatMembersFetch, chatMetadata, chatMetadataRefresh, chatModeration, chatMuting, chatPin, chatRead, chatRemoval, chatRequestChange, chatRules, chatSender, chatStats, chatTracking, chatUnread, contact, contactActivity, contactAlias, contactCheck, contactContext, contactImport, contactLookup, contactNote, contactNoteRemoval, contactPreparation, contactProfile, contactStateChange, contactSync, contactUpdate, conversation, conversationBatch, conversationBatchStatus, conversationBuildResult, conversationChange, conversationDetails, conversationEmbedding, conversationEmbeddingStatus, conversationHit, conversationPreparation, conversationReadiness, counterRefresh, counters, document, documentLink, endedAccountSessions, evidence, evidencePacket, fact, folder, hit, identity, imageEmbedding, inviteLink, job, joinRequest, linkedPerson, mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, mention, mentionDecision, mentionDetails, mentionDomain, mentionRebuild, message, messageContext, messageCounts, messageDeletion, messageDownload, messageEvent, messageLink, messageLinks, messagePin, messageStar, messageSync, messageTranscript, messageWrite, model, modelKey, note, officialStats, person, place, poll, pollChange, pollVote, ranking, reactionChange, recipient, recipientAdded, recipientChange, recipientOff, recipientRemoved, recordedRun, reference, relationship, removedModelKey, retention, runDetails, runHit, runLocation, savedSearch, scheduledJob, searchHistoryClear, sendAttempt, serveSummary, stickerInventory, storeBackup, storeChatStatus, storeCheck, storeClear, storeCopyRemoval, storeDecrypt, storedModelKey, storeExport, storeGapPlan, storeGapRepair, storeInfo, storeJobCancel, storeJobClear, storeJobDetails, storeJobRetry, storeMigration, storeReindex, storeRepair, storeReset, storeRestore, tagChange, tagging, task, taskCard, taskCategories, taskClosed, taskCreated, taskLinks, taskMerge, taskPair, taskScan, taskSimilar, taskStats, taskUnmerge, topic, trackedChat, trackedChatHistory, watchedMessage, watchItem, };
 export const ENTITIES = {
     sync_progress: syncProgress,
     ...MEETING_RESULT_ENTITIES,
@@ -166,6 +167,15 @@ export const ENTITIES = {
     account_privacy: accountPrivacy,
     account_privacy_change: accountPrivacyChange,
     account_profile: accountProfile,
+    bot_profile: botProfile,
+    bot_template: botTemplate,
+    bot_seen_chat: botSeenChat,
+    bot_admin: botAdmin,
+    bot_menu_entry: botMenuEntry,
+    bot_webhook: botWebhook,
+    scheduled_job: scheduledJob,
+    call_record: callRecord,
+    sticker_inventory: stickerInventory,
     note,
     "note.hit": v.pick(note, [
         "kind",

package/dist/entities/list-results.d.ts

@@ -0,0 +1,83 @@
+import * as v from "valibot";
+export declare const botProfile: v.StrictObjectSchema<{
+    readonly name: v.StringSchema<undefined>;
+    readonly token: v.StringSchema<undefined>;
+    readonly bot: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+    readonly problem: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export declare const botSeenChat: v.StrictObjectSchema<{
+    readonly title: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    readonly kind: v.OptionalSchema<v.PicklistSchema<["dialog", "group", "channel", "saved", "unknown"], undefined>, undefined>;
+    readonly unread_count: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>, undefined>;
+    readonly unread_mentions: v.OptionalSchema<v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>, undefined>;
+    readonly last_message_at: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>, undefined>;
+    readonly participants_count: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>, undefined>;
+    readonly muted: v.OptionalSchema<v.OptionalSchema<v.BooleanSchema<undefined>, undefined>, undefined>;
+    readonly archived: v.OptionalSchema<v.OptionalSchema<v.BooleanSchema<undefined>, undefined>, undefined>;
+    readonly marked_unread: v.OptionalSchema<v.OptionalSchema<v.BooleanSchema<undefined>, undefined>, undefined>;
+    readonly membership_state: v.OptionalSchema<v.OptionalSchema<v.PicklistSchema<["joined", "left", "public", "imported", "archived", "external"], undefined>, undefined>, undefined>;
+    readonly scope: v.OptionalSchema<v.OptionalSchema<v.PicklistSchema<["personal", "work"], undefined>, undefined>, undefined>;
+    readonly provider_metadata: v.OptionalSchema<v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>, undefined>;
+    readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly parent_chat_id: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, undefined>;
+    readonly muted_until: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>, undefined>;
+    readonly first_seen_at: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
+    readonly last_seen_at: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
+}, undefined>;
+export declare const botAdmin: v.StrictObjectSchema<{
+    readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly username: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly role: v.PicklistSchema<["owner", "admin"], undefined>;
+    readonly rights: v.ArraySchema<v.PicklistSchema<["read", "members", "admins", "info", "pin", "link", "post", "edit", "delete"], undefined>, undefined>;
+    readonly title: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export declare const botMenuEntry: v.StrictObjectSchema<{
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export declare const botWebhook: v.StrictObjectSchema<{
+    readonly url: v.StringSchema<undefined>;
+    readonly types: v.NullableSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+}, undefined>;
+export declare const scheduledJob: v.StrictObjectSchema<{
+    readonly name: v.StringSchema<undefined>;
+    readonly kind: v.PicklistSchema<["command", "agent"], undefined>;
+    readonly when: v.StringSchema<undefined>;
+    readonly last: v.NullableSchema<v.StrictObjectSchema<{
+        readonly at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+        readonly exit_code: v.NumberSchema<undefined>;
+        readonly output: v.StringSchema<undefined>;
+        readonly trace_id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly reason: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly error_code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly failing_since: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
+        readonly failures: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+export declare const botTemplate: v.StrictObjectSchema<{
+    readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly status: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly language: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly category: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export declare const callRecord: v.StrictObjectSchema<{
+    readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly chat_id: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+    readonly caller_id: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+    readonly direction: v.PicklistSchema<["incoming", "outgoing"], undefined>;
+    readonly outcome: v.PicklistSchema<["answered", "missed", "declined"], undefined>;
+    readonly kind: v.PicklistSchema<["audio", "video"], undefined>;
+    readonly at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+    readonly duration_seconds: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+}, undefined>;
+export declare const stickerInventory: v.StrictObjectSchema<{
+    readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly count: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    readonly link: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    readonly set_id: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, undefined>;
+    readonly emoji: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+    readonly url: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+}, undefined>;

package/dist/entities/list-results.js

@@ -0,0 +1,69 @@
+import * as v from "valibot";
+import { chat } from "./chat.js";
+import { id, text, time } from "./fields.js";
+export const botProfile = v.strictObject({
+    name: text,
+    token: text,
+    bot: v.optional(text),
+    id: v.optional(id),
+    problem: v.optional(text),
+});
+export const botSeenChat = v.strictObject({
+    ...v.partial(v.omit(chat, ["ref", "provider", "account", "description", "invite_link", "settings", "members"]))
+        .entries,
+    id,
+    parent_chat_id: v.optional(v.nullable(id)),
+    muted_until: v.optional(v.nullable(time)),
+    first_seen_at: v.optional(time),
+    last_seen_at: v.optional(time),
+});
+export const botAdmin = v.strictObject({
+    id,
+    name: v.nullable(text),
+    username: v.nullable(text),
+    role: v.picklist(["owner", "admin"]),
+    rights: v.array(v.picklist(["read", "members", "admins", "info", "pin", "link", "post", "edit", "delete"])),
+    title: v.nullable(text),
+});
+export const botMenuEntry = v.strictObject({ name: text, description: v.nullable(text) });
+export const botWebhook = v.strictObject({ url: text, types: v.nullable(v.array(text)) });
+export const scheduledJob = v.strictObject({
+    name: text,
+    kind: v.picklist(["command", "agent"]),
+    when: text,
+    last: v.nullable(v.strictObject({
+        at: time,
+        exit_code: v.number(),
+        output: text,
+        trace_id: v.optional(text),
+        reason: v.optional(text),
+        error_code: v.optional(text),
+        failing_since: v.optional(time),
+        failures: v.optional(v.number()),
+    })),
+});
+export const botTemplate = v.strictObject({
+    name: v.nullable(text),
+    status: v.nullable(text),
+    language: v.nullable(text),
+    category: v.nullable(text),
+});
+export const callRecord = v.strictObject({
+    id,
+    chat_id: v.nullable(id),
+    caller_id: v.nullable(id),
+    direction: v.picklist(["incoming", "outgoing"]),
+    outcome: v.picklist(["answered", "missed", "declined"]),
+    kind: v.picklist(["audio", "video"]),
+    at: time,
+    duration_seconds: v.nullable(v.number()),
+});
+export const stickerInventory = v.strictObject({
+    id,
+    title: v.optional(text),
+    count: v.optional(v.number()),
+    link: v.optional(v.nullable(text)),
+    set_id: v.optional(v.nullable(id)),
+    emoji: v.optional(v.array(text)),
+    url: v.optional(v.nullable(text)),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.408.0",
+  "version": "0.409.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",