@wirecat/cli-core 0.397.0 → 0.398.0

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

@@ -58,7 +58,7 @@ const modelLine = (item, width) => `${item.default ? "*" : " "} ${item.id.padEnd
     (item.downloaded ? "downloaded" : "—".padEnd(10));
 export const modelsCommand = (messenger) => {
     const tool = `${messenger.app.command} personal`;
-    const models = annotate(new Command("models"), { mcp: false }).description("models that run on this machine");
+    const models = new Command("models").description("models that run on this machine");
     const audio = models.command("audio").description("speech models for transcribing voice messages");
     withQuery(annotate(audio.command("list"), { effects: LOCAL_READ, examples: [`${tool} models audio list`] }), MODELS_QUERY)
         .summary("speech models and their download status")
@@ -76,6 +76,7 @@ export const modelsCommand = (messenger) => {
         });
     });
     reachesOtherService(annotate(audio.command("download"), {
+        mcp: false,
         effects: FETCH,
         output: { entity: "model" },
         examples: [`${tool} models audio download parakeet-v3`],
@@ -123,6 +124,7 @@ export const modelsCommand = (messenger) => {
         });
     });
     reachesOtherService(annotate(text.command("download"), {
+        mcp: false,
         effects: FETCH,
         output: { entity: "model" },
         examples: [`${tool} models text download ${DEFAULT_TEXT_MODEL}`],
@@ -171,7 +173,7 @@ export const modelsCommand = (messenger) => {
 /** `images models`: registered with picture search, the only thing these models serve. */
 export const imageModelsCommand = (messenger) => {
     const tool = messenger.app.command;
-    const image = annotate(new Command("models"), { mcp: false }).description("models that read pictures, for `images embed` and picture search");
+    const image = new Command("models").description("models that read pictures, for `images embed` and picture search");
     withQuery(annotate(image.command("list"), { effects: LOCAL_READ, examples: [`${tool} images models list`] }), MODELS_QUERY)
         .description("the picture models, which are downloaded, and which one is the default")
         .action(async function (words) {
@@ -187,6 +189,7 @@ export const imageModelsCommand = (messenger) => {
         });
     });
     reachesOtherService(annotate(image.command("download"), {
+        mcp: false,
         effects: FETCH,
         output: { entity: "model" },
         examples: [`${tool} images models download ${DEFAULT_IMAGE_MODEL}`],

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

@@ -14,7 +14,7 @@ import { replyConsentsCommand } from "./replies-consents-command.js";
 import { addReplyEditors } from "./replies-edit-command.js";
 /** `replies`: rules that answer messages for the owner, from `serve`, and only to the people and chats the audience allows. */
 export const repliesCommand = (messenger) => {
-    const replies = annotate(new Command("replies"), { mcp: false }).description("rules that answer messages for you, kept in a file of this profile");
+    const replies = new Command("replies").description("rules that answer messages for you, kept in a file of this profile");
     if (messenger.autoReplies === false)
         replies.hook("preAction", () => {
             throw new CliError("validation_error", `${messenger.name ?? messenger.app.command} cannot send automatic replies`);

package/dist/cli/messenger/review.js

@@ -10,7 +10,7 @@ import { REMOTE_READ } from "../effects.js";
 import { renderAnswer } from "../envelope.js";
 import { queryHelp } from "../list-query.js";
 import { pointsOf } from "./catch-up.js";
-import { catchUpQuery, REVIEW_QUERY, reviewAnswer } from "./catch-up-answers.js";
+import { catchUpQuery, OFFLINE_REVIEW, REVIEW_QUERY, reviewAnswer } from "./catch-up-answers.js";
 import { messengerContext } from "./context.js";
 import { heardItems, hearForCommand, MODEL_OPTION, spokenItems, TRANSCRIBE_OPTION } from "./hearing-command.js";
 import { PARTIAL_NOTE } from "./inbox.js";
@@ -25,6 +25,7 @@ export const unansweredHours = (value, flag = "--unanswered") => value === true
  * tasks in the local store from what it read (`../../services/task-rules.ts`); nothing reaches the messenger.
  */
 export const reviewCommand = (messenger) => annotate(new Command("review"), {
+    examples: [`${messenger.app.command} personal review "date>2h"`],
     effects: REMOTE_READ,
     output: { entity: "message", view: "summary" },
     query: REVIEW_QUERY,
@@ -39,6 +40,7 @@ export const reviewCommand = (messenger) => annotate(new Command("review"), {
     .option(...TRANSCRIBE_OPTION)
     .option(...MODEL_OPTION)
     .option("--new", "what changed since the last `review --new`, a point per chat — for scheduled runs")
+    .addHelpText("after", "With --offline it reads the local store: only what was already synced, and --new keeps its point.")
     .addHelpText("after", "To mark a chat read, use `chats mark-read <chat>`. The other side sees it.")
     .action(async function (query) {
     const options = this.opts();
@@ -99,7 +101,8 @@ export const reviewCommand = (messenger) => annotate(new Command("review"), {
             .sort((a, b) => Date.parse(a.timestamp) - Date.parse(b.timestamp));
         return read.length === 0 ? "" : renderMessages(spokenItems(read, hearing), viewOf(context, messenger));
     });
-    saved?.save(found.checked ?? {});
+    if (!found.offline)
+        saved?.save(found.checked ?? {});
 });
 /** What the answer's steps do not say: a person's context for the review just shown. */
 const notes = (found, pretty, renderer) => {
@@ -111,6 +114,8 @@ const notes = (found, pretty, renderer) => {
             (found.tasks.review > 0 ? `, ${found.tasks.review} pair(s) to review — tasks duplicates` : ""));
     if (found.partial && pretty)
         renderer.warn(PARTIAL_NOTE);
+    if (found.offline && pretty)
+        renderer.warn(OFFLINE_REVIEW);
     if (found.unanswered)
         renderer.note(`questions from ${found.since} to ${found.until} still open after ${found.unanswered.olderThanHours} hours; ` +
             "an answer after the review's end is not seen");

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

@@ -61,7 +61,7 @@ const withWhen = (command) => command
  */
 export const scheduleCommand = (messenger) => {
     const { app } = messenger;
-    const command = annotate(new Command("schedule"), { mcp: false }).description(`run a ${app.command} command or an agent later or on a timer (systemd, launchd, Task Scheduler); an agent cannot send`);
+    const command = new Command("schedule").description(`run a ${app.command} command or an agent later or on a timer (systemd, launchd, Task Scheduler); an agent cannot send`);
     const prepare = (self) => {
         const context = messengerContext(self, messenger);
         const system = environmentOf(self).system ?? thisMachine();
@@ -192,7 +192,7 @@ export const scheduleCommand = (messenger) => {
                 .join("\n");
         });
     });
-    annotate(command.command("run"), { effects: REMOTE_WRITE })
+    annotate(command.command("run"), { effects: REMOTE_WRITE, mcp: false })
         .description("run a schedule now, as its timer would, and wait for it")
         .argument("<name>")
         .action(async function (name) {
@@ -216,7 +216,7 @@ export const scheduleCommand = (messenger) => {
         rmSync(file, { force: true });
         say({ name, removed: true }, [`Removed ${name}.`]);
     });
-    annotate(command.command("exec"), { effects: REMOTE_WRITE })
+    annotate(command.command("exec"), { effects: REMOTE_WRITE, mcp: false })
         .description("what a timer runs, given the schedule's file; to run one by hand, use run")
         .argument("<file>")
         .action(async function (file) {

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

@@ -36,8 +36,8 @@ const allCommand = (messenger) => {
     const command = annotate(new Command("all"), { effects: REMOTE_READ, partial: true })
         .summary("search stored messages, notes and selected meeting transcripts")
         .description((messenger.serverSearch
-        ? "search messenger messages and notes in the local store, and the messenger's server for messages " +
-            "(--backend; notes are local only)"
+        ? "search messenger messages and notes in the local store, and by default the messenger's server for " +
+            "messages too (notes are local only; --backend archive or --offline keeps it to the local store)"
         : "search messenger messages and notes in the local store") +
         ", and a meeting account's transcripts when --source names one — best match first; not mail (the separate memo CLI searches it: memo search mail), " +
         "tasks, people, memories or projects. Use it when you do not know where something was written; search messages " +

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

@@ -30,7 +30,11 @@ export { lockPath, readLock, servingProfiles } from "../../background/lock.js";
  * taken over. Started by a person, a service unit or `server start` — never by itself (NEED-9).
  */
 export const serveCommand = (messenger) => {
-    const command = annotate(new Command("serve"), { effects: REMOTE_WRITE, lifetime: "persistent" }).description("keep the local store current until stopped — what a systemd or launchd unit runs");
+    const command = annotate(new Command("serve"), {
+        effects: REMOTE_WRITE,
+        lifetime: "persistent",
+        examples: [`${messenger.app.command} personal serve`],
+    }).description("keep the local store current until stopped — what a systemd or launchd unit runs");
     command.action(async function () {
         const relay = messenger.connection === "exclusive" && process.platform !== "win32" ? serveRelay(this, messenger) : undefined;
         const context = recordDiagnostics(messengerContext(this, relay?.messenger ?? messenger), messenger.app);

package/dist/cli/messenger/serve-relay.d.ts

@@ -51,6 +51,7 @@ export declare const serveRelay: (command: Command, messenger: Messenger) => {
         scheduledSends?: boolean;
         autoReplies?: boolean;
         lacks?: readonly (keyof MessengerAdapter)[];
+        never?: readonly (keyof MessengerAdapter)[];
         deleteForMe?: boolean;
         topics?: boolean;
         topicShow?: boolean;

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

@@ -60,7 +60,7 @@ const lockProcess = (app, marker, serveArgv) => (context, system, logPath) => ({
  */
 export const serverCommand = (messenger, options = {}) => {
     const { app } = messenger;
-    const command = annotate(new Command("server"), { mcp: false })
+    const command = new Command("server")
         .summary("manage this profile's background server")
         .description(`\`${app.command} serve\` in the background: start, stop, restart, status, logs; install adds a systemd or launchd unit`);
     const marker = (profile) => `${app.envPrefix}_SERVER=${profile}`;
@@ -183,17 +183,26 @@ export const serverCommand = (messenger, options = {}) => {
         return ["--idle", idle];
     };
     const withIdle = (sub) => options.idle ? sub.option("--idle <duration>", "stop after this long with nobody using it — 15m, 1h") : sub;
-    withIdle(destroysNothing(annotate(command.command("start"), { effects: LOCAL_WRITE, examples: [`${app.command} personal server start`] }))
+    withIdle(destroysNothing(annotate(command.command("start"), {
+        effects: LOCAL_WRITE,
+        mcp: false,
+        examples: [`${app.command} personal server start`],
+    }))
         .summary("start this profile's background server")
         .description("start serve in the background — through the unit if one is installed — and answer once it connects")).action(async function () {
         await start(prepare(this), idleArgs(this));
     });
-    destroysNothing(annotate(command.command("stop"), { effects: LOCAL_WRITE, examples: [`${app.command} personal server stop`] }))
+    destroysNothing(annotate(command.command("stop"), {
+        effects: LOCAL_WRITE,
+        mcp: false,
+        examples: [`${app.command} personal server stop`],
+    }))
         .description("stop this profile's serve — through the unit if it runs under one")
         .action(async function () {
         await stop(prepare(this));
     });
     withIdle(destroysNothing(annotate(command.command("restart"), {
+        mcp: false,
         effects: LOCAL_WRITE,
         examples: [`${app.command} personal server restart`],
     })).description("stop it and start it again")).action(async function () {

package/dist/cli/messenger/store-maintenance-command.js

@@ -152,7 +152,7 @@ const copiesCommand = () => new Command("copies").description("the tables `store
     const deleted = await reading(path, (database) => deleteCopy(database, name));
     result(this, { path, deleted });
 }));
-const infoCommand = () => annotate(new Command("info"), { effects: LOCAL_READ, mcp: false })
+const infoCommand = () => annotate(new Command("info"), { effects: LOCAL_READ })
     .summary("the local archive's format, size and contents")
     .description("the store file: where it is, its size, its schema and how many rows it holds; changes nothing")
     .action(async function () {
@@ -182,7 +182,7 @@ const infoCommand = () => annotate(new Command("info"), { effects: LOCAL_READ, m
  * fetched" (NEED-399 A). Times are the chat's newest message by the messenger's list against the
  * newest message held, not `sync_ranges`: those are in message ids, which a chat list does not give.
  */
-const checkCommand = (messenger) => annotate(new Command("check"), { effects: LOCAL_READ, mcp: false })
+const checkCommand = (messenger) => annotate(new Command("check"), { effects: LOCAL_READ })
     .summary("check the local archive for problems")
     .description("whether the store is healthy — integrity, search indexes, disk, and which chats are behind")
     .action(async function () {
@@ -431,7 +431,7 @@ const buildNoteIndex = (database, note, { reset = false } = {}) => {
         note(`indexing ${pending} notes`);
     return { notesIndexed: drainNoteIndex(database, stemmerCache()) };
 };
-const reindexCommand = (messenger) => destroysNothing(annotate(new Command("reindex"), { effects: LOCAL_WRITE, mcp: false }))
+const reindexCommand = (messenger) => destroysNothing(annotate(new Command("reindex"), { effects: LOCAL_WRITE }))
     .summary("rebuild the local archive's search indexes")
     .description("rebuild the word index, its typo vocabulary, the stems, the files' word index, the notes' indexes and who took part in what, from what is stored; loses nothing")
     .action(async function () {

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

@@ -11,7 +11,11 @@ import { messengerContext } from "./context.js";
  * for a minute is a complete answer. One `MessageHit` per line with `--jsonl`; `--json` is refused,
  * because a stream is not one value. Nothing is marked read.
  */
-export const watchCommand = (messenger) => annotate(new Command("watch"), { effects: REMOTE_READ, lifetime: "persistent" })
+export const watchCommand = (messenger) => annotate(new Command("watch"), {
+    effects: REMOTE_READ,
+    lifetime: "persistent",
+    examples: [`${messenger.app.command} personal watch --jsonl --timeout 30s`],
+})
     .summary("stream new messages until interrupted or timed out")
     .description("print new messages as they arrive, until Ctrl-C or --timeout (either ends it normally)")
     .option("--events", "also edits, deletions, reactions, poll votes and chat events; every line then names its event")

package/dist/cli/runs/command.js

@@ -20,7 +20,6 @@ export const runsCommand = (app) => {
     };
     annotate(command.command("list"), {
         effects: LOCAL_READ,
-        mcp: false,
         examples: [`${app.command} runs list --limit 10`],
     })
         .description("recorded runs, newest first")
@@ -36,7 +35,7 @@ export const runsCommand = (app) => {
         if (runs.length === 0)
             renderer.note("nothing recorded — a run is kept with `--record`, or when it fails");
     });
-    annotate(command.command("show"), { effects: LOCAL_READ, mcp: false, examples: [`${app.command} runs show run-101`] })
+    annotate(command.command("show"), { effects: LOCAL_READ, examples: [`${app.command} runs show run-101`] })
         .argument("<run-id>", `an id from \`${app.command} runs list\``)
         .description("one run: what it was, how it ended, and every event it logged")
         .option("--problems", "only failed responses, warnings and crashes")
@@ -86,7 +85,7 @@ export const runsCommand = (app) => {
             since_time: options.sinceTime,
         }));
     });
-    annotate(command.command("path"), { effects: NO_EFFECTS, mcp: false, examples: [`${app.command} runs path run-101`] })
+    annotate(command.command("path"), { effects: NO_EFFECTS, examples: [`${app.command} runs path run-101`] })
         .argument("<run-id>", `an id from \`${app.command} runs list\``)
         .description("the directory holding one run")
         .action(function (id) {

package/dist/cli/skill-command.js

@@ -20,7 +20,7 @@ export const skillCommand = (app, skill) => {
     const show = command.commands.find((sub) => sub.name() === "show");
     if (show)
         annotate(show, { examples: [`${app.command} skill show`, `${app.command} skill show follow-ups`] });
-    return annotate(command, { mcp: false });
+    return command;
 };
 /** Skills this package ships for every CLI on it, printed by `skill show <name>`: `skills/` beside `dist/` and `src/`. */
 const SHARED_SKILLS = {

package/dist/domain/models.d.ts

@@ -506,6 +506,8 @@ export interface Review {
         closed: number;
         review: number;
     };
+    /** `--offline`: read from the local store, so it holds only what was already synced. */
+    offline?: true;
 }
 /** One change to who is in a chat, or to the chat itself, read from a service message. */
 export interface ChatEvent {

package/dist/services/deps.d.ts

@@ -70,7 +70,7 @@ export declare const fromStore: (deps: Pick<ServiceDeps, "offline" | "reads">) =
 export declare const nothingStored: (messenger: MessengerTraits) => string;
 /** Where a store-mode messenger's history comes from, for what it cannot do. */
 export declare const PUSHED = "this messenger's history is read from the local store";
-export declare const OFFLINE = "--offline answers only from what is kept locally: `chats list|show`, `messages list|show|context` and `contacts list|show`";
+export declare const OFFLINE = "--offline answers only from what is kept locally: `chats list|show`, `messages list|show|context`, `contacts list|show` and `review`";
 /** Over a connection that is already open — an MCP session holds one for minutes. */
 export declare const onlineDeps: (messenger: ServiceMessenger, adapter: MessengerAdapter, guard: SendGuard, where?: {
     profile?: string;

package/dist/services/deps.js

@@ -55,7 +55,7 @@ export const fromStore = (deps) => deps.offline || deps.reads === "store";
 export const nothingStored = (messenger) => `nothing stored for this chat yet — keep \`${typedCommand(messenger.app.command, "serve")}\` running`;
 /** Where a store-mode messenger's history comes from, for what it cannot do. */
 export const PUSHED = "this messenger's history is read from the local store";
-export const OFFLINE = "--offline answers only from what is kept locally: `chats list|show`, `messages list|show|context` and `contacts list|show`";
+export const OFFLINE = "--offline answers only from what is kept locally: `chats list|show`, `messages list|show|context`, `contacts list|show` and `review`";
 /** Over a connection that is already open — an MCP session holds one for minutes. */
 export const onlineDeps = (messenger, adapter, guard, where = {}) => ({
     messenger,

package/dist/services/inbox.js

@@ -234,7 +234,7 @@ export const reviewIn = async (adapter, { since, points, chat, kinds, all = fals
 };
 export const inboxService = (deps) => {
     const reader = async () => {
-        if (deps.reads === "store")
+        if (deps.reads === "store" || deps.offline)
             return storeReader(deps, await deps.store(), await deps.account());
         const connection = await deps.connection();
         return {
@@ -256,9 +256,7 @@ export const inboxService = (deps) => {
                 : newIn(from, { since, limit, all, ...only, ...(points === undefined ? {} : { points }) });
         },
         review: async (options) => {
-            if (deps.offline && deps.reads !== "store") {
-                throw new CliError("validation_error", "`review` asks the messenger what changed; with `--offline` nothing did");
-            }
+            const synced = deps.offline && deps.reads !== "store";
             let tasks;
             const found = await reviewIn(await reader(), {
                 ...options,
@@ -272,7 +270,9 @@ export const inboxService = (deps) => {
                         });
                 },
             });
-            return tasks ? { ...found, tasks } : found;
+            // What was never synced may sit before `until`, so the next review must not start there.
+            const offline = synced ? { complete: false, offline: true } : {};
+            return { ...found, ...offline, ...(tasks ? { tasks } : {}) };
         },
     };
 };

package/dist/services/search-kind.js

@@ -50,7 +50,7 @@ export const accountsOfKind = (kind, chosen, held, explicit, command = undefined
         throw new CliError("validation_error", `search mail reads mail only — \`${command === undefined ? "" : `${command} `}search messages\` searches ${explicit}`);
     const mail = (listed ? chosen : held).filter(({ provider }) => kindOf(provider) === "mail");
     if (mail.length === 0)
-        throw new CliError("not_found", "no mail in the store yet — `memo sync --mail --since-time <time>` imports it", {
+        throw new CliError("not_found", "no mail in the store yet — `memo sync --only mail --since-time <time>` imports it", {
             reason: NO_MAIL,
         });
     const address = mailAccount?.trim().toLowerCase();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.397.0",
+  "version": "0.398.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",
@@ -165,7 +165,7 @@
     "@anthropic-ai/sdk": "0.131.0",
     "@bomb.sh/tab": "0.0.22",
     "@huggingface/tokenizers": "0.2.0",
-    "@modelcontextprotocol/server": "2.1.0",
+    "@modelcontextprotocol/server": "2.3.0",
     "@resvg/resvg-js": "2.6.2",
     "@valibot/to-json-schema": "1.8.0",
     "@wirecat/cli-core-onnx": "1.0.1",