@wirecat/cli-core 0.421.0 → 0.423.0

package/dist/mcp/surface.js

@@ -62,10 +62,16 @@ export const registerCommands = (server, prefix, commands, errors,
 /** Throws the refusal of a command left out because the lock or a level stops it, so the agent learns why. */
 withheld) => {
     const byNormal = new Map(Object.keys(commands).map((command) => [normal(command), command]));
+    // No AppIdentity reaches here; only a messenger's catalogue has `messages` commands.
+    const messenger = Object.keys(commands).some((command) => command.split(" ")[0] === "messages");
+    const tasks = messenger ? '"unread", "send message", "chat members"' : '"list", "show", "change a setting"';
+    const sample = messenger
+        ? "messages list"
+        : (Object.entries(commands).find(([, one]) => !one.writes)?.[0] ?? Object.keys(commands)[0] ?? "");
     server.registerTool(`${prefix}_tools_search`, {
         outputSchema: toStandardJsonSchema(v.looseObject({})),
         title: "Find a command",
-        description: `Find the command for a task — "unread", "send message", "chat members" — before calling ` +
+        description: `Find the command for a task — ${tasks} — before calling ` +
             `${prefix}_read or ${prefix}_write with it. Each match gives its command, whether it writes, its arguments and the shape of its answer. ` +
             "With no words, lists every command and title, without arguments.",
         inputSchema: toStandardJsonSchema(v.strictObject({ query: v.optional(v.pipe(v.string(), v.description("words that describe the task"))) })),
@@ -122,7 +128,7 @@ withheld) => {
         }
     };
     const call = v.strictObject({
-        command: v.pipe(v.string(), v.minLength(1), v.description(`a command ${prefix}_tools_search returned: "messages list"`)),
+        command: v.pipe(v.string(), v.minLength(1), v.description(`a command ${prefix}_tools_search returned: "${sample}"`)),
         arguments: v.optional(v.pipe(v.record(v.string(), v.unknown()), v.description("that command's arguments"))),
     });
     server.registerTool(`${prefix}_read`, {
@@ -136,7 +142,7 @@ withheld) => {
         server.registerTool(`${prefix}_write`, {
             outputSchema: toStandardJsonSchema(ANSWER),
             title: "Run a writing command",
-            description: `Run one command that changes something — sends, edits, deletes, joins — with the arguments ${prefix}_tools_search showed. ${UNTRUSTED}`,
+            description: `Run one command that changes something — ${messenger ? "sends, edits, deletes, joins" : "creates, edits, deletes"} — with the arguments ${prefix}_tools_search showed. ${UNTRUSTED}`,
             inputSchema: toStandardJsonSchema(call),
             annotations: WRITE,
         }, runner(true));

package/dist/meetings/mcp/index.d.ts

@@ -38,7 +38,6 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -54,11 +53,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -76,11 +75,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -102,6 +101,7 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -188,7 +188,6 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -204,11 +203,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -226,11 +225,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -252,6 +251,7 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -338,7 +338,6 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -354,11 +353,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -376,11 +375,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -402,6 +401,7 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -488,7 +488,6 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -504,11 +503,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -526,11 +525,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -552,6 +551,7 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -638,7 +638,6 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -654,11 +653,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -676,11 +675,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -702,6 +701,7 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;

package/dist/models/settings.d.ts

@@ -7,16 +7,10 @@ export declare const modelSettingsShape: v.RecordSchema<v.SchemaWithPipe<readonl
     readonly base_url: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "use an HTTP/S endpoint without credentials, query or fragment">]>, undefined>;
 }, undefined>, undefined>;
 export type ModelSettings = v.InferOutput<typeof modelSettingsShape>;
-export declare const resolveModelSettings: (prefix: string, layers: readonly (readonly [string, Readonly<Record<string, unknown>> | undefined])[], env: NodeJS.ProcessEnv, legacy: {
-    values: Record<string, unknown>;
-    sources: Record<string, string>;
-}) => {
+export declare const resolveModelSettings: (prefix: string, layers: readonly (readonly [string, Readonly<Record<string, unknown>> | undefined])[], env: NodeJS.ProcessEnv) => {
     models: ModelSettings;
     sources: Record<string, string>;
 };
 export declare const modelTarget: (settings: {
     models?: ModelSettings;
-    analysisProvider?: string;
-    analysisModel?: string;
-    analysisBaseUrl?: string;
 }, purpose: string) => ModelTarget | undefined;

package/dist/models/settings.js

@@ -7,7 +7,7 @@ export const modelSettingsShape = v.record(v.pipe(v.string(), v.regex(/^[a-z][a-
     model: v.optional(v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(200))),
     base_url: v.optional(v.pipe(v.string(), v.check((value) => endpoint(value), "use an HTTP/S endpoint without credentials, query or fragment"))),
 }));
-export const resolveModelSettings = (prefix, layers, env, legacy) => {
+export const resolveModelSettings = (prefix, layers, env) => {
     const configured = layers.map(([from, scope]) => [from, (scope?.models ?? {})]);
     const purposes = new Set([
         "default",
@@ -26,21 +26,12 @@ export const resolveModelSettings = (prefix, layers, env, legacy) => {
         const resolved = {};
         for (const field of MODEL_FIELDS) {
             const variable = `${prefix}_MODELS_${purpose.replaceAll("-", "_").toUpperCase()}_${field.toUpperCase()}`;
-            const legacyKey = { provider: "analysisProvider", model: "analysisModel", base_url: "analysisBaseUrl" }[field];
             const candidates = [
                 [variable, env[variable]?.trim() || undefined],
                 ...configured.map(([from, model]) => [
                     `${from}: models.${purpose}.${field}`,
                     model[purpose]?.[field],
                 ]),
-                ...(purpose === "analysis" && legacy.sources[legacyKey] !== "default"
-                    ? [
-                        [
-                            legacy.sources[legacyKey] ?? "legacy analysis setting",
-                            legacy.values[legacyKey] === "agent" ? "off" : legacy.values[legacyKey],
-                        ],
-                    ]
-                    : []),
                 ...(purpose === "default"
                     ? []
                     : [
@@ -69,14 +60,6 @@ export const resolveModelSettings = (prefix, layers, env, legacy) => {
 };
 export const modelTarget = (settings, purpose) => {
     const configured = { ...settings.models?.default, ...settings.models?.[purpose] };
-    if (purpose === "analysis" &&
-        configured.provider === undefined &&
-        settings.analysisProvider &&
-        settings.analysisProvider !== "agent") {
-        configured.provider = settings.analysisProvider;
-        configured.model ??= settings.analysisModel;
-        configured.base_url ??= settings.analysisBaseUrl;
-    }
     if (configured.provider === undefined || configured.provider === "off")
         return undefined;
     if (!configured.model)

package/dist/ports/app.d.ts

@@ -19,6 +19,12 @@ export interface AppIdentity {
      * can stem in place of English and the system's language; the person still confirms, since the choice is shared.
      */
     contentLanguages?: readonly string[];
+    /**
+     * `false` for a CLI that is not a messenger — notes, files, a calendar. The shared help, `config`, `commands info`
+     * and MCP text then name its own commands and leave out chats, messages and senders. Unset means a messenger, so
+     * tg, max and wa print what they always did.
+     */
+    messenger?: boolean;
     /** Error reasons and detail keys of its own — max's `max_code`, tg's `migrated_chat_id` — kept in every error it prints. */
     errors?: AppErrors;
 }

package/dist/search/account-list.js

@@ -34,12 +34,12 @@ const heldOf = (stored, running) => [
     { provider: "notes", account: INTERNAL_NOTES, name: null, kind: "notes" },
     ...stored
         .filter(({ provider }) => isFolderProvider(provider))
-        .map(({ id, name, provider }) => ({
+        .map(({ id, name, provider, account }) => ({
         provider: "notes",
         account: String(id),
         name,
         kind: "notes",
-        folder: provider,
+        stored: { provider, account },
     })),
     ...stored
         .filter(({ provider }) => isDocumentAccountProvider(provider))
@@ -78,8 +78,11 @@ const accountOf = (prefix, ref, held, context) => {
         if (stored)
             return stored;
     }
-    const ofProvider = held.filter((one) => one.provider === provider);
-    const byId = ofProvider.find(({ account }) => account === ref || account === ref.toLowerCase());
+    const folder = isFolderProvider(provider);
+    const ofProvider = folder
+        ? storedAs(held, { provider, account: "" })
+        : held.filter((one) => one.provider === provider);
+    const byId = ofProvider.find(({ account, stored }) => account === ref || account === ref.toLowerCase() || (folder && stored?.account === ref.toUpperCase()));
     if (byId)
         return byId;
     const keyed = (key) => ofProvider.find(({ account }) => account === key.account) ?? {
@@ -132,10 +135,8 @@ const accountsOfWord = (word, held, context) => {
         Object.values(recorded).every((key) => isFolderProvider(key.provider) || isDocumentAccountProvider(key.provider)))
         return Object.keys(recorded).map((profile) => accountOf(word, profile, held, context));
     const provider = providerOf(word, held, context);
-    if (isDocumentAccountProvider(provider))
+    if (isDocumentAccountProvider(provider) || isFolderProvider(provider))
         return storedAs(held, { provider, account: "" });
-    if (isFolderProvider(provider))
-        return held.filter(({ folder }) => folder === provider);
     return held.filter((one) => one.provider === provider);
 };
 const keyOf = ({ provider, account }) => `${provider}\u0000${account}`;

package/dist/search/dictionary.d.ts

@@ -1,10 +1,7 @@
+import { type Language } from "./languages.js";
 /** The Hunspell dictionary that tells a real word from a garbled one, for each language the store stems. */
-export declare const DICTIONARIES: {
-    readonly russian: "dictionary-ru";
-    readonly english: "dictionary-en";
-    readonly spanish: "dictionary-es";
-};
-export type DictionaryLanguage = keyof typeof DICTIONARIES;
+export declare const DICTIONARIES: Record<Language, string>;
+export type DictionaryLanguage = Language;
 /**
  * `known`: whether a folded word the index stores is real in one of `languages` that write in its alphabet.
  * `covers`: whether any of them does; without one, a garbled spelling cannot be told from a real word.

package/dist/search/dictionary.js

@@ -1,7 +1,8 @@
 import { readFileSync } from "node:fs";
 import { fold } from "../store/normalize.js";
+import { LANGUAGES } from "./languages.js";
 /** The Hunspell dictionary that tells a real word from a garbled one, for each language the store stems. */
-export const DICTIONARIES = { russian: "dictionary-ru", english: "dictionary-en", spanish: "dictionary-es" };
+export const DICTIONARIES = Object.fromEntries(LANGUAGES.map(({ name, dictionary }) => [name, dictionary]));
 /** `fold`, without Unicode normalisation for plain Russian letters: it would double the time Russian loads in. */
 const folded = (word) => /^[а-яё'-]*$/.test(word) ? word.replaceAll("ё", "е").replaceAll("й", "и") : fold(word);
 const loaded = new Map();

package/dist/search/languages.d.ts

@@ -0,0 +1,28 @@
+/** The languages search can stem and spell-check. Adding one here needs its Snowball stemmer in `stem.ts`. */
+export declare const LANGUAGES: readonly [{
+    readonly name: "russian";
+    readonly code: "ru";
+    readonly label: "Russian";
+    readonly script: "cyrillic";
+    readonly dictionary: "dictionary-ru";
+}, {
+    readonly name: "english";
+    readonly code: "en";
+    readonly label: "English";
+    readonly script: "latin";
+    readonly dictionary: "dictionary-en";
+}, {
+    readonly name: "spanish";
+    readonly code: "es";
+    readonly label: "Spanish";
+    readonly script: "latin";
+    readonly dictionary: "dictionary-es";
+}];
+type Entry = (typeof LANGUAGES)[number];
+export type Language = Entry["name"];
+export type Script = Entry["script"];
+export type LanguageOf<S extends Script> = Extract<Entry, {
+    script: S;
+}>["name"];
+export declare const languagesOf: <S extends Script>(script: S) => LanguageOf<S>[];
+export {};

package/dist/search/languages.js

@@ -0,0 +1,7 @@
+/** The languages search can stem and spell-check. Adding one here needs its Snowball stemmer in `stem.ts`. */
+export const LANGUAGES = [
+    { name: "russian", code: "ru", label: "Russian", script: "cyrillic", dictionary: "dictionary-ru" },
+    { name: "english", code: "en", label: "English", script: "latin", dictionary: "dictionary-en" },
+    { name: "spanish", code: "es", label: "Spanish", script: "latin", dictionary: "dictionary-es" },
+];
+export const languagesOf = (script) => LANGUAGES.filter((one) => one.script === script).map(({ name }) => name);

package/dist/search/stem.d.ts

@@ -1,9 +1,10 @@
+import { type LanguageOf } from "./languages.js";
 /** The version of the vendored files in `./snowball/`; `bin/snowball-update` regenerates them. */
 export declare const SNOWBALL_VERSION = "3.1.1";
-export declare const CYRILLIC_STEMMERS: readonly ["russian", "none"];
-export declare const LATIN_STEMMERS: readonly ["spanish", "english", "none"];
-export type CyrillicStemmer = (typeof CYRILLIC_STEMMERS)[number];
-export type LatinStemmer = (typeof LATIN_STEMMERS)[number];
+export type CyrillicStemmer = LanguageOf<"cyrillic"> | "none";
+export type LatinStemmer = LanguageOf<"latin"> | "none";
+export declare const CYRILLIC_STEMMERS: readonly CyrillicStemmer[];
+export declare const LATIN_STEMMERS: readonly LatinStemmer[];
 /** `latin` is one stemmer, `none`, or several joined by commas in alphabetical order (`english,spanish`). */
 export type Stemmers = {
     cyrillic: CyrillicStemmer;

package/dist/search/stem.js

@@ -1,12 +1,13 @@
 import { CliError } from "@wirecat/cli-base";
 import { normalize } from "../store/normalize.js";
+import { languagesOf } from "./languages.js";
 import EnglishStemmer from "./snowball/english-stemmer.js";
 import RussianStemmer from "./snowball/russian-stemmer.js";
 import SpanishStemmer from "./snowball/spanish-stemmer.js";
 /** The version of the vendored files in `./snowball/`; `bin/snowball-update` regenerates them. */
 export const SNOWBALL_VERSION = "3.1.1";
-export const CYRILLIC_STEMMERS = ["russian", "none"];
-export const LATIN_STEMMERS = ["spanish", "english", "none"];
+export const CYRILLIC_STEMMERS = [...languagesOf("cyrillic"), "none"];
+export const LATIN_STEMMERS = [...languagesOf("latin"), "none"];
 export const DEFAULT_STEMMERS = { cyrillic: "russian", latin: "english,spanish" };
 /**
  * Raised with every change to `DEFAULT_STEMMERS`. A default saved in the store carries it, so a newer build

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.421.0",
+  "version": "0.423.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",