@wirecat/cli-core 0.544.0 → 0.546.0

package/dist/cli/entry.d.ts

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

package/dist/cli/entry.js

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

package/dist/cli/index.d.ts

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

package/dist/cli/index.js

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

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

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

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

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

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

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

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

@@ -12,11 +12,12 @@ import { kindsOf } from "../../services/inbox.js";
 import { dateWindow } from "../../services/moment.js";
 import { destroysNothing, LOCAL_READ, LOCAL_WRITE } from "../effects.js";
 import { itemOf, listOf, renderAnswer, snakeKeys } from "../envelope.js";
-import { commandAt } from "../steps.js";
+import { commandAt, lineOf } from "../steps.js";
 import { jobsCommand } from "./backfill-command.js";
 import { messengerContext } from "./context.js";
 import { admitPassword, linesOf, openFolder, runFileFor, saveManifest, sealRun, writeChanges } from "./export-folder.js";
 import { gapsCommand } from "./gaps-command.js";
+import { historyLimitGaps } from "./history-gaps.js";
 import { messageItems } from "./message-items.js";
 import { ENCRYPT_OPTION, passwordOf } from "./password.js";
 import { storeMaintenanceCommands } from "./store-maintenance-command.js";
@@ -71,9 +72,26 @@ const statusCommand = (messenger) => annotate(new Command("status"), { output: {
     .action(async function (chat) {
     const context = messengerContext(this, messenger);
     const rows = await context.withServices((services) => services.archive.status(chat));
-    renderAnswer(this, context, listOf("store status", { items: rows.map(snakeKeys), limit: Math.max(1, rows.length), has_more: false }));
+    const skips = await context
+        .withStore((store, account) => store.chats.historySkips(account))
+        .then((all) => chat === undefined ? all : all.filter((skip) => rows.some((row) => row.chatId === skip.chatId)))
+        .catch(() => []);
+    const limited = historyLimitGaps(skips);
+    renderAnswer(this, context, listOf("store status", {
+        items: rows.map(snakeKeys),
+        limit: Math.max(1, rows.length),
+        has_more: false,
+        next: limited.next,
+        missing: limited.missing,
+    }));
     if (rows.length === 0 && context.format === "pretty")
         context.renderer.note("the store holds no messages for this profile yet");
+    if (skips.length > 0 && context.format === "pretty")
+        context.renderer.note(`history limits left out pushed history of ${skips.length} chats — \`${lineOf(this, "messages sync <chat> --full-history")}\` fetches one and keeps it in full:\n` +
+            skips
+                .slice(0, 20)
+                .map((skip) => `  ${skip.title ?? skip.chatId}  ${skip.messages} messages  ${skip.reason}`)
+                .join("\n"));
 });
 const LISTED = 20;
 /** Titles are the owner's: these lines go to a person's terminal, never into an error message. */

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

@@ -58,14 +58,17 @@ export const syncCommand = (messenger) => {
         .option("--catch-up-chunks <n>", "at most this many local vector chunks", wholeNumber)
         .option("--catch-up-messages <n>", "skip a graph rebuild larger than this many messages", wholeNumber)
         .option("--catch-up-time <duration>", "local preparation time budget, 30s by default")
+        .option("--full-history", "keep this chat's pushed history in full from now on, past the history limits (history_* settings)")
         .option("--background", "run as a job that outlives this command; `store jobs show` follows it")
         .option("--dry-run", "only estimate how many messages, requests and minutes a full fetch would still take — from the store, no request")
         .action(async function (chat) {
-        const { all, pause, sinceTime: since, last, background, dryRun: estimate, catchUp, catchUpChunks, catchUpMessages, catchUpTime, ...sizes } = this.opts();
+        const { all, pause, sinceTime: since, last, background, dryRun: estimate, catchUp, catchUpChunks, catchUpMessages, catchUpTime, fullHistory: include, ...sizes } = this.opts();
         if ((chat === undefined) === (all !== true))
             throw new CliError("validation_error", "name a chat, or --all for every chat");
         if (all && estimate)
             throw new CliError("validation_error", "--dry-run prices one chat; not with --all");
+        if (include && chat === undefined)
+            throw new CliError("validation_error", "--full-history keeps one chat: name it");
         if (all && messenger.history === "store") {
             throw new CliError("validation_error", `--all walks the messenger's chat list, and ${messenger.name ?? messenger.app.command} pushes its chats ` +
                 `instead — keep \`${lineOf(this, "serve")}\` running${messenger.historyOnDemand ? ", or name one chat" : ""}`);
@@ -164,6 +167,10 @@ export const syncCommand = (messenger) => {
             const result = await context.withServices((services) => chat === undefined ? services.archive.fetchAll(options) : services.archive.fetch(chat, options));
             if (jobId)
                 finishJob(messenger.app, jobs, jobId, { finishedAt: new Date().toISOString(), result });
+            const synced = "chat" in result ? result.chat : null;
+            const included = include && synced
+                ? await context.withStore((store, account) => store.chats.setHistoryIncluded(account, synced, true))
+                : undefined;
             const tasks = await taskRulesAfterSync(context);
             const prepared = "prepared" in result ? result.prepared : undefined;
             const unprepared = prepared && !prepared.complete && "chat" in result && result.chat !== null;
@@ -171,7 +178,11 @@ export const syncCommand = (messenger) => {
             const review = await context.withServices((services) => services.mentions.newCount(point.after));
             const toReview = review.count;
             const shown = `${toReview}${review.more ? "+" : ""}`;
-            renderAnswer(this, context, itemOf(snakeKeys(tasks && tasks.added + tasks.closed + (tasks.held ?? 0) > 0 ? { ...result, tasks } : result), {
+            renderAnswer(this, context, itemOf(snakeKeys({
+                ...result,
+                ...(tasks && tasks.added + tasks.closed + (tasks.held ?? 0) > 0 ? { tasks } : {}),
+                ...(included === undefined ? {} : { historyIncluded: included }),
+            }), {
                 next: [
                     ...(unprepared
                         ? [

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

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

package/dist/cli/messenger/context.js

@@ -231,6 +231,9 @@ export const connected = (connection, { app, provider, name, deletedWithoutChat,
             recipientIds: () => (new RecipientList(recipientsPathFor(app, settings.profile, env), app.command).read() ?? []).flatMap((recipient) => [recipient.id, ...(recipient.partnerId ? [recipient.partnerId] : [])]),
             ...(history === "store" ? { namesFromStore: savedChatId ? { savedChatId } : {} } : {}),
             ...(unreadCounts === "store" ? { countsUnread: true } : {}),
+            ...(history === "store" && settings.historyLimits
+                ? { historyLimits: settings.historyLimits, command: `${app.command} ${settings.profile}` }
+                : {}),
         });
     const passives = history === "store" && self !== null && !watching
         ? passivesOf(saving).map((passive) => listened(passive, events, renderer.warn, closeWaitMs))

package/dist/cli/messenger/history-gaps.d.ts

@@ -0,0 +1,12 @@
+import type { Missing, NextStep } from "@wirecat/cli-base/standards";
+import type { AccountKey, MessageStore, StoredHistorySkip } from "../../store/store.js";
+/**
+ * What the history limits (`history_*` settings) left out of pushed history, as `missing` and `next`: an answer read
+ * from the store must not pass for every message the messenger has.
+ */
+export declare const historyLimitGaps: (skips: StoredHistorySkip[]) => {
+    next: NextStep[];
+    missing: Missing[];
+};
+/** What the limits left out in every account an answer read, most messages first. */
+export declare const historySkipsOf: (store: Pick<MessageStore, "chats">, accounts: readonly AccountKey[]) => Promise<StoredHistorySkip[]>;

package/dist/cli/messenger/history-gaps.js

@@ -0,0 +1,41 @@
+import { nextStep } from "../steps.js";
+const SHOWN = 5;
+const reasonOf = (skip) => skip.reason === "group_too_large"
+    ? `a group of ${skip.members ?? "many"} people, not saved`
+    : `only from ${skip.keptFrom?.slice(0, 10) ?? "the window's start"}`;
+const nameOf = (skip) => skip.title ?? skip.chatId;
+/**
+ * What the history limits (`history_*` settings) left out of pushed history, as `missing` and `next`: an answer read
+ * from the store must not pass for every message the messenger has.
+ */
+export const historyLimitGaps = (skips) => {
+    const [first] = skips;
+    if (!first)
+        return { next: [], missing: [] };
+    const messages = skips.reduce((sum, skip) => sum + skip.messages, 0);
+    const listed = skips
+        .slice(0, SHOWN)
+        .map((skip) => `${nameOf(skip)} (${skip.messages}, ${reasonOf(skip)})`)
+        .join("; ");
+    const more = skips.length > SHOWN ? `; and ${skips.length - SHOWN} more — \`store status\` lists them` : "";
+    return {
+        next: [
+            {
+                ...nextStep("messages.sync", { args: { chat: first.chatId, full_history: true } }),
+                why: "fetches this chat's history and keeps it in full from now on, past the history limits",
+            },
+        ],
+        missing: [
+            {
+                field: "history_limits",
+                why: `the history limits (history_* settings) left ${messages} pushed messages of ${skips.length} chats out of ` +
+                    `the store: ${listed}${more}`,
+                step: "messages.sync",
+            },
+        ],
+    };
+};
+/** What the limits left out in every account an answer read, most messages first. */
+export const historySkipsOf = async (store, accounts) => (await Promise.all(accounts.map((account) => store.chats.historySkips(account))))
+    .flat()
+    .sort((a, b) => b.messages - a.messages);

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

@@ -18,6 +18,7 @@ import { messengerContext } from "./context.js";
 import { linksCommand } from "./conversations-command.js";
 import { downloadSubcommand } from "./download-command.js";
 import { heardItems, hearForCommand, hearingMissing, MODEL_OPTION, spokenItems, TRANSCRIBE_OPTION, } from "./hearing-command.js";
+import { historyLimitGaps } from "./history-gaps.js";
 import { cursorOf, historyQuery, historyWindow } from "./history-query.js";
 import { hideNever } from "./lacks.js";
 import { threadAnswer } from "./message-answers.js";
@@ -74,9 +75,12 @@ export const messagesCommand = (messenger) => {
             : undefined;
         // Offline, the store is the whole answer: say how much of the chat it holds. Online the messenger is read.
         const gaps = context.settings.offline
-            ? coverageGaps(await context.withStore(async (store, account) => chatCoverage(store, account, [
-                await storedChatId(messenger, chat, store, account, { includeLeft: true }),
-            ])))
+            ? await context.withStore(async (store, account) => {
+                const chatId = await storedChatId(messenger, chat, store, account, { includeLeft: true });
+                const held = coverageGaps(await chatCoverage(store, account, [chatId]));
+                const limited = historyLimitGaps((await store.chats.historySkips(account)).filter((skip) => skip.chatId === chatId));
+                return { next: [...limited.next, ...held.next], missing: [...limited.missing, ...held.missing] };
+            })
             : { next: [], missing: [] };
         renderAnswer(this, context, listOf("messages list", {
             items: messageItems(heardItems(page.items, hearing), reader),
@@ -93,9 +97,8 @@ export const messagesCommand = (messenger) => {
     annotate(list, { output: { entity: "message" }, query: history });
     const readWindow = async (command, chat, message, window) => {
         const context = messengerContext(command, messenger);
-        const target = targetOf(messenger, chat, message);
         const { found, reader } = await context.withServices(async (services) => ({
-            found: await services.messages.around(isLocator(chat) ? chat : target.chat, isLocator(chat) ? undefined : target.message, window),
+            found: await services.messages.around(chat, message?.trim(), window),
             reader: await services.messages.reader(),
         }));
         const hearing = await hearForCommand(context, messenger, found, false);
@@ -152,9 +155,8 @@ export const messagesCommand = (messenger) => {
         const requested = threadRequest(this).thread;
         if (requested) {
             const context = messengerContext(this, messenger);
-            const target = targetOf(messenger, chat, message);
             const { found, reader } = await context.withServices(async (services) => ({
-                found: await services.messages.thread(isLocator(chat) ? chat : target.chat, isLocator(chat) ? undefined : target.message, { ...requested, before, after }),
+                found: await services.messages.thread(chat, message?.trim(), { ...requested, before, after }),
                 reader: await services.messages.reader(),
             }));
             if (found.fallback)
@@ -199,19 +201,4 @@ const count = (value) => {
         throw new CliError("validation_error", `"${value}" is not a count`);
     return parsed;
 };
-/** A chat and a message id, or one locator naming both — which must be this messenger's. */
-const targetOf = (messenger, chat, message) => {
-    if (isLocator(chat)) {
-        if (message !== undefined)
-            throw new CliError("validation_error", "a locator already names the message");
-        const locator = parseLocator(chat);
-        if (locator.provider !== messenger.provider) {
-            throw new CliError("validation_error", `that locator is a ${locator.provider} message, not ${messenger.provider}`);
-        }
-        return { chat: locator.chat, message: locator.message };
-    }
-    if (message === undefined)
-        throw new CliError("validation_error", "which message? give its id after the chat");
-    return { chat, message: message.trim() };
-};
 export { sendCommand } from "./messages-send-command.js";

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

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

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

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

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

@@ -12,6 +12,7 @@ import { renderAnswer } from "../envelope.js";
 import { positiveCount } from "../paging.js";
 import { archiveSummary } from "./archive-summary.js";
 import { messengerContext } from "./context.js";
+import { historySkipsOf } from "./history-gaps.js";
 import { meaningNote, messagesAnswer, offsetOf, shownOf } from "./search-answers.js";
 import { backendOptions, backendRequest, noteServer } from "./search-backend-options.js";
 import { syncOptions, syncRequest, syncsFirst } from "./search-sync-options.js";
@@ -207,7 +208,10 @@ const searchAction = (messenger) => async function (given) {
         ...(newest ? { newest: true } : {}),
         ...(timezone === undefined ? {} : { timezone }),
     };
-    renderAnswer(this, context, messagesAnswer("search messages", found, { limit, page: page ?? 1, again }, given.join(" ")), view);
+    const skips = await context
+        .withStore((store) => historySkipsOf(store, found.coverage?.accounts ?? found.accounts ?? []))
+        .catch(() => []);
+    renderAnswer(this, context, messagesAnswer("search messages", found, { limit, page: page ?? 1, again }, given.join(" "), skips), view);
 };
 const withOffset = (page, limit) => {
     const offset = offsetOf(page, limit);

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

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

package/dist/cli/messenger/observed.js

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

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

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

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

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

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

@@ -8,6 +8,7 @@ import type { MeaningSkipped } from "../../services/messages-discovery.js";
 import type { FoundNote, NotesFoundOf } from "../../services/notes-search.js";
 import type { SearchAllItem } from "../../services/search-all.js";
 import type { MeetingSearchItem, SearchAllIncludingMeetingsFound } from "../../services/search-all-meetings.js";
+import type { StoredHistorySkip } from "../../store/store.js";
 import { type ListBody } from "../envelope.js";
 /** What a source tool's `search all` reads: never mail, which is memo's (docs/dev/TOOL-BOUNDARIES.md). */
 export declare const SOURCE_SEARCHED: readonly ["messages", "notes", "events", "meetings"];
@@ -42,10 +43,10 @@ export interface Paging {
 /** "showing 20 of 144", for the human view under a page of hits; `+` when the total is a lower bound. */
 export declare const shownOf: (shown: number, offset: number, total: SearchTotal | undefined) => string | undefined;
 /** `search messages` and `search mail`, CLI and MCP alike. */
-export declare const messagesAnswer: (command: string, found: SearchFound, { limit, page, again }: Paging, query?: string) => ListBody<MessageHitItem>;
+export declare const messagesAnswer: (command: string, found: SearchFound, { limit, page, again }: Paging, query?: string, skips?: StoredHistorySkip[]) => ListBody<MessageHitItem>;
 export declare const noteHitItem: (hit: FoundNote) => NoteHitItem;
 export declare const allHitItem: (item: SearchAllItem | MeetingSearchItem) => HitItem;
 /** `search notes`, CLI and MCP alike. */
 export declare const notesAnswer: (command: string, found: NotesFoundOf, { limit, page, again }: Paging, exact?: boolean) => ListBody<NoteHitItem>;
 /** `search all`, CLI and MCP alike. A bounded meeting scan that could not tell whether more match says so. */
-export declare const allAnswer: (command: string, found: SearchAllIncludingMeetingsFound, { limit, page, again }: Paging, exact?: boolean) => ListBody<HitItem>;
+export declare const allAnswer: (command: string, found: SearchAllIncludingMeetingsFound, { limit, page, again }: Paging, exact?: boolean, skips?: StoredHistorySkip[]) => ListBody<HitItem>;

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

@@ -7,6 +7,7 @@ import { MAX_SEARCH_OFFSET } from "../../services/messages-archive-search.js";
 import { listOf } from "../envelope.js";
 import { nextStep } from "../steps.js";
 import { archiveSummary } from "./archive-summary.js";
+import { historyLimitGaps } from "./history-gaps.js";
 /** What a source tool's `search all` reads: never mail, which is memo's (docs/dev/TOOL-BOUNDARIES.md). */
 export const SOURCE_SEARCHED = ["messages", "notes", "events", "meetings"];
 const nonEmpty = (list) => (list.length > 0 ? list : undefined);
@@ -249,8 +250,10 @@ export const shownOf = (shown, offset, total) => total === undefined || shown ==
     ? undefined
     : `showing ${offset + 1}–${offset + shown} of ${total.value}${total.relation === "gte" ? "+" : ""}`;
 /** `search messages` and `search mail`, CLI and MCP alike. */
-export const messagesAnswer = (command, found, { limit, page, again }, query = "") => {
+export const messagesAnswer = (command, found, { limit, page, again }, query = "", skips = []) => {
     const accounts = found.coverage?.accounts ?? found.accounts ?? [];
+    const gaps = gapsOf(found);
+    const limited = historyLimitGaps(skips);
     return listOf(command, {
         items: [...found.items.map((hit) => messageHitItem(hit, query)), ...pictureItems(found)],
         limit,
@@ -258,8 +261,9 @@ export const messagesAnswer = (command, found, { limit, page, again }, query = "
         page: page ?? 1,
         ...(found.total ? { total: found.total } : {}),
         ...(again ? { args: again } : {}),
-        ...gapsOf(found),
-        meta: metaOf(accounts, found.skipped, coverageGaps(found).missing.length > 0),
+        next: [...gaps.next, ...limited.next],
+        missing: [...gaps.missing, ...limited.missing],
+        meta: metaOf(accounts, found.skipped, coverageGaps(found).missing.length > 0 || skips.length > 0),
     });
 };
 /**
@@ -327,7 +331,8 @@ export const notesAnswer = (command, found, { limit, page, again }, exact = fals
     meta: metaOf(found.accounts, found.skipped),
 });
 /** `search all`, CLI and MCP alike. A bounded meeting scan that could not tell whether more match says so. */
-export const allAnswer = (command, found, { limit, page, again }, exact = false) => {
+export const allAnswer = (command, found, { limit, page, again }, exact = false, skips = []) => {
+    const limited = historyLimitGaps(skips);
     const scan = found.meetings?.complete === false ? found.meetings : undefined;
     const notes = meaningGap(found.notes?.meaningSkipped, exact);
     const messages = messageMeaningGap(found.messages?.meaningSkipped, "found_by");
@@ -351,6 +356,7 @@ export const allAnswer = (command, found, { limit, page, again }, exact = false)
             ...notes.next,
             ...messages.next.filter((step) => !notes.next.some((asked) => JSON.stringify(asked) === JSON.stringify(step))),
             ...archive.next,
+            ...limited.next,
         ],
         missing: [
             ...(scan
@@ -365,7 +371,8 @@ export const allAnswer = (command, found, { limit, page, again }, exact = false)
             ...notes.missing,
             ...messages.missing,
             ...archive.missing,
+            ...limited.missing,
         ],
-        meta: metaOf(found.accounts, found.skipped, archive.missing.length > 0),
+        meta: metaOf(found.accounts, found.skipped, archive.missing.length > 0 || skips.length > 0),
     });
 };

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

@@ -10,6 +10,7 @@ import { runsSearchCommand } from "../runs/search-command.js";
 import { commandAt } from "../steps.js";
 import { messengerContext } from "./context.js";
 import { conversationsSearchCommand } from "./conversations-command.js";
+import { historySkipsOf } from "./history-gaps.js";
 import { messagesSearchCommand } from "./messages-search-command.js";
 import { allAnswer, meaningNote, notesAnswer, offsetOf, SOURCE_SEARCHED, shownOf, } from "./search-answers.js";
 import { backendOptions, backendRequest, noteServer } from "./search-backend-options.js";
@@ -92,7 +93,8 @@ const allCommand = (messenger) => {
             ...(exact ? { exact: true } : {}),
             ...(timezone === undefined ? {} : { timezone }),
         };
-        renderAnswer(this, context, allAnswer("search all", found, { limit, page: page ?? 1, again }), () => {
+        const skips = await context.withStore((store) => historySkipsOf(store, found.accounts)).catch(() => []);
+        renderAnswer(this, context, allAnswer("search all", found, { limit, page: page ?? 1, again }, false, skips), () => {
             if (found.items.length === 0)
                 context.renderer.note(found.server && !found.server.skipped
                     ? "nothing found in the local store or on the messenger's server"

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

@@ -2,6 +2,7 @@ import type { Id } from "../../domain/models.js";
 import { type MessengerAdapter } from "../../ports/messenger.js";
 import type { MessengerTraits } from "../../ports/traits.js";
 import type { EventSink, Warn } from "../../runs/events.js";
+import { type HistoryLimits } from "../../services/history-limits.js";
 import type { AccountKey, DeletionScope, MessageStore } from "../../store/store.js";
 export interface Saving {
     account: AccountKey;
@@ -41,6 +42,10 @@ export interface Saving {
     namesFromStore?: Pick<MessengerTraits, "savedChatId">;
     /** `MessengerTraits.unreadCounts: "store"`: a message `watch` or `listen` saves raises its chat's unread count. */
     countsUnread?: boolean;
+    /** Pushed history (`feed`, `listenHistory`) outside these is not saved, and each chat records what it left out. */
+    historyLimits?: HistoryLimits;
+    /** The app command and profile, for the warning that names the command listing what the limits left out. */
+    command?: string;
 }
 /**
  * The adapter, with what each read answers written to the store. **A failed write never fails the
@@ -50,4 +55,4 @@ export interface Saving {
  * would erase what `chats list` stored. Nor are `chat` and `contact`: a card's member list is not
  * known to be whole, and `saveMembers` replaces the list.
  */
-export declare const stored: (messenger: MessengerAdapter, { account, store, warn, events, pending, announcing, deletedWithoutChat, profile, rekeyed, rekeyPacing, closing, namesFromStore, recipientIds, countsUnread, }: Saving) => MessengerAdapter;
+export declare const stored: (messenger: MessengerAdapter, { account, store, warn, events, pending, announcing, deletedWithoutChat, profile, rekeyed, rekeyPacing, closing, namesFromStore, recipientIds, countsUnread, historyLimits, command, }: Saving) => MessengerAdapter;