@wirecat/cli-core 0.397.0 → 0.399.0

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;
@@ -77,6 +78,7 @@ export declare const serveRelay: (command: Command, messenger: Messenger) => {
         inviteLinkRevoke?: boolean;
         inviteLinkUpdate?: boolean;
         joinRequestsAll?: boolean;
+        joinRequestsByLink?: boolean;
         channelComments?: boolean;
         addsWithHistory?: boolean;
         adminRights?: readonly import("../../domain/models.js").AdminRight[];

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/stats-command.js

@@ -49,7 +49,7 @@ export const statsCommand = (messenger, loadRenderer = chartRenderer) => {
         .description("a chart's data from a chat's statistics, and optionally a dark SVG or PNG image")
         .argument("<chat>", messenger.chatArgument)
         .option("--chart-kind <messages|active|membership>", "what to draw: messages, active authors, or joins and leaves", chartKindOf, "messages")
-        .option("--by <day|week>", "one point per calendar day or week (weeks start on Monday)", chartPeriodOf, "day")
+        .option("--by <group>", "one point per calendar day or week (weeks start on Monday)", chartPeriodOf, "day")
         .option("--since-time <time>", `ISO 8601, or 2h / 1d ago; ${EVENTS_DAYS} days ago if not given`)
         .option("--timezone <zone>", "the IANA timezone for calendar days")
         .option("--output <file>", "write a dark image to a new .svg or .png file")

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/tags-command.js

@@ -1,6 +1,6 @@
 import { CliError } from "@wirecat/cli-base";
 import { annotate } from "@wirecat/cli-base/commands";
-import { Command } from "commander";
+import { Command, Option } from "commander";
 import { TAGGING_QUERY } from "../../services/tags.js";
 import { changesStore, FETCH, LOCAL_READ, LOCAL_WRITE } from "../effects.js";
 import { itemOf, renderAnswer, snakeKeys } from "../envelope.js";
@@ -23,7 +23,7 @@ const describe = ({ type, chatId, personId, messageId, taskId }) => type === "ch
 const line = (one) => `${one.tag}  ${one.type}  ${one.name ?? ""} (${one.target})`;
 const sourceOf = (value) => {
     if (value !== "manual" && value !== "auto")
-        throw new CliError("validation_error", "--source takes manual or auto");
+        throw new CliError("validation_error", "--claim takes manual or auto");
     return value;
 };
 /** The owner's labels, in the local store only: `tag:` in a search finds what they label. */
@@ -35,7 +35,7 @@ export const tagsCommand = (messenger) => {
     changesStore(annotate(tags.command("auto"), { effects: FETCH, examples: [`${tool} tags auto --chat "Book club" --dry-run`] }))
         .description("derive local group/channel tags from cached metadata using keyword rules")
         .option("--chat <chat>", "a stored group/channel; repeat to select several", (value, previous) => [...previous, value], [])
-        .option("--limit <number>", "process at most 1–500 chats", positiveCount("--limit"), 50)
+        .option("--limit <n>", "process at most 1–500 chats", positiveCount("--limit"), 50)
         .option("--sync-first", "read current descriptions from the messenger before classifying")
         .option("--dry-run", "preview cached classification without changing the store")
         .action(async function () {
@@ -62,12 +62,18 @@ export const tagsCommand = (messenger) => {
         effects: LOCAL_WRITE,
         examples: [`${tool} tags remove reading --chat "Book club"`],
     }).description("take tags off one chat, person, message or task"), messenger, "untag")
-        .option("--source <manual|auto>", "remove only this ownership claim", sourceOf)
+        .addOption(new Option("--claim <claim>", "remove only this ownership claim: manual or auto")
+        .argParser(sourceOf)
+        .conflicts("source"))
+        .addOption(new Option("--source <manual|auto>", "compatibility alias for --claim")
+        .argParser(sourceOf)
+        .hideHelp()
+        .conflicts("claim"))
         .action(async function (given) {
         const context = messengerContext(this, messenger);
         refuseLocalWrite(context, messenger.app.command, "tags.remove");
         const target = this.opts();
-        const done = await context.withServices((services) => services.tags.remove(target, given, this.opts().source));
+        const done = await context.withServices((services) => services.tags.remove(target, given, this.opts().claim ?? this.opts().source));
         renderAnswer(this, context, itemOf(snakeKeys(done)), () => done.removed.length ? `${describe(done.target)}: ${done.removed.join(", ")} removed\n` : "");
         if (done.unchanged.length && context.format === "pretty")
             context.renderer.note(`not there: ${done.unchanged.join(", ")}`);

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

@@ -17,7 +17,7 @@ export const transcribeSubcommand = (messages, messenger) => annotate(messages.c
     .argument("<chat>", messenger.chatArgument)
     .argument("<message>", "the id of a voice message")
     .option("--local", "use the model on this machine, never the messenger")
-    .option("--model <id>", "which downloaded model; implies --local (`models audio list`)")
+    .option("--model <model>", "which downloaded model; implies --local (`models audio list`)")
     .action(async function (chat, messageId) {
     const context = messengerContext(this, messenger);
     const choice = {

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/mcp/prompts.js

@@ -42,9 +42,15 @@ export const registerPrompts = (server, { command, name }) => {
             ?.split(",")
             .map((one) => one.trim())
             .filter((one) => one.length > 0);
+        const query = [
+            kinds?.length ? `kind:${JSON.stringify(kinds.join(","))}` : "",
+            mode === undefined || mode === "unread" || mode === "new" ? "" : after(mode),
+        ]
+            .filter(Boolean)
+            .join(" ");
         const args = {
-            ...(kinds?.length ? { kind: kinds.join(",") } : {}),
-            ...(mode === undefined || mode === "unread" ? {} : mode === "new" ? { new: true } : { query: after(mode) }),
+            ...(query ? { query } : {}),
+            ...(mode === "new" ? { new: true } : {}),
         };
         return asked([
             `Catch me up on ${name}. Call ${call(`${command}_read`, "inbox", args)} once.`,

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.399.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",
@@ -207,7 +207,7 @@
     "@types/node": "^22.20.4",
     "@types/pngjs": "6.0.5",
     "@vitest/coverage-v8": "^5.0.2",
-    "@wirecat/cli-base": "0.50.1",
+    "@wirecat/cli-base": "0.50.2",
     "commander": "15.0.0",
     "cspell": "10.3.6",
     "drizzle-kit": "1.0.0-rc.4",
@@ -227,7 +227,7 @@
   },
   "peerDependencies": {
     "@napi-rs/canvas": ">=0.1.69 <2",
-    "@wirecat/cli-base": ">=0.50.1 <0.51.0",
+    "@wirecat/cli-base": ">=0.50.2 <0.51.0",
     "commander": ">=15"
   },
   "bin": {