@wirecat/cli-core 0.347.0 → 0.348.0

package/dist/services/chats.js

@@ -4,6 +4,7 @@ import { botCheckService } from "../botcheck/service.js";
 import { threadIdOf } from "../domain/thread.js";
 import { capability } from "../ports/messenger.js";
 import { syncsOneChat } from "../ports/traits.js";
+import { typedCommand } from "../runs/scope.js";
 import { codeOf, guardedWrite } from "../sends/guarded.js";
 import { newOperationId } from "../sends/send-id.js";
 import { CHAT_COLUMNS, queryFilter, } from "../store/store.js";
@@ -147,7 +148,7 @@ export const chatsService = (deps) => ({
         const counted = counts.length > 0 ? { ...known, memberCounts: counts } : known;
         return completeness.state === "complete" || !syncsOneChat(deps.messenger)
             ? counted
-            : { ...counted, fetch: `${deps.messenger.app.command} messages sync ${chatId}` };
+            : { ...counted, fetch: typedCommand(deps.messenger.app.command, `messages sync ${chatId}`) };
     },
     sendAs: async (chat) => {
         if (deps.offline) {
@@ -180,7 +181,7 @@ export const chatsService = (deps) => ({
             unknown,
             ...(stored?.completeness ? { completeness: stored.completeness } : {}),
             ...(stored?.completeness && stored.completeness.state !== "complete" && syncsOneChat(deps.messenger)
-                ? { fetch: `${deps.messenger.app.command} messages sync ${id}` }
+                ? { fetch: typedCommand(deps.messenger.app.command, `messages sync ${id}`) }
                 : {}),
             items,
         };

package/dist/services/conversations.js

@@ -5,6 +5,7 @@ import { linkMessages, RULES_VERSION } from "../conversations/link.js";
 import { formatLocator } from "../domain/locator.js";
 import { formatReference } from "../domain/references.js";
 import { conversation } from "../entities/conversation.js";
+import { typedCommand } from "../runs/scope.js";
 import { CONVERSATION_COLUMNS, queryFilter, } from "../store/store.js";
 import { accountStore } from "./deps.js";
 import { chatIdIn } from "./message-resolution.js";
@@ -38,7 +39,7 @@ export const conversationsService = (deps) => {
         const store = await accountStore(deps);
         return { store, chatId: await chatIdIn(deps.messenger, chat, store) };
     };
-    const notBuilt = (chatId) => new CliError("not_found", `chat ${chatId} has no conversations yet — \`${deps.messenger.app.command} conversations build --chat ${chatId}\``);
+    const notBuilt = (chatId) => new CliError("not_found", `chat ${chatId} has no conversations yet — \`${typedCommand(deps.messenger.app.command, `conversations build --chat ${chatId}`)}\``);
     return {
         build: async (chat, { maxMessages, check } = {}) => {
             check?.();

package/dist/services/deps.js

@@ -1,5 +1,6 @@
 import { CliError } from "@wirecat/cli-base";
 import { isCliFailure } from "../errors/failures.js";
+import { typedCommand } from "../runs/scope.js";
 /** The store with the running account bound: the default for a service's reads and writes. */
 export const accountStore = async (deps) => (await deps.store()).forAccount(await deps.account());
 /**
@@ -49,7 +50,7 @@ export const storeIfOpen = async (deps) => {
 /** Whether `chats`, `messages list|context` and `contacts` answer from the store instead of the messenger. */
 export const fromStore = (deps) => deps.offline || deps.reads === "store";
 /** What a store-mode read answers for a chat the store holds nothing of. */
-export const nothingStored = (messenger) => `nothing stored for this chat yet — keep \`${messenger.app.command} serve\` running`;
+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`";

package/dist/services/embeddings-maintenance.js

@@ -6,6 +6,7 @@ import { DEFAULT_TEXT_MODEL, textModel, vectorModelKey } from "../embeddings/mod
 import { remoteKey } from "../embeddings/remote.js";
 import { CONTEXT_MESSAGES, CONTEXT_MINUTES } from "../images/context/index.js";
 import { registeredImageProviders } from "../images/registry.js";
+import { typedCommand } from "../runs/scope.js";
 import { conversationsService } from "./conversations.js";
 import { storedChatId } from "./message-resolution.js";
 /** How much one run without `--chat` does at most, by default. */
@@ -16,11 +17,11 @@ const PER_SESSION = 8;
 const PER_REQUEST = 256;
 /** e5's tokenizer reads ~3.7 characters a token in Russian; 3 keeps the bound above the real count. */
 const CHARS_PER_TOKEN_AT_LEAST = 3;
-const notDownloaded = (deps, id) => new CliError("not_found", `${id} is not downloaded — \`${deps.messenger.app.command} models text download ${id}\``, {
+const notDownloaded = (deps, id) => new CliError("not_found", `${id} is not downloaded — \`${typedCommand(deps.messenger.app.command, `models text download ${id}`)}\``, {
     reason: "model.not-downloaded",
     model: id,
 });
-export const notBuiltError = (deps, chatId) => new CliError("not_found", `chat ${chatId} has no conversations yet — \`${deps.messenger.app.command} conversations build --chat ${chatId}\``);
+export const notBuiltError = (deps, chatId) => new CliError("not_found", `chat ${chatId} has no conversations yet — \`${typedCommand(deps.messenger.app.command, `conversations build --chat ${chatId}`)}\``);
 export const embeddingTarget = (deps, choice = DEFAULT_TEXT_MODEL) => {
     if (typeof choice !== "string") {
         const { remote, apiKey, concurrency = 4 } = choice;

package/dist/services/index.d.ts

@@ -156,7 +156,7 @@ export { privatePeopleService } from "./private-people.js";
 export { approveAsTask, type ProposalTaskStore, proposalSource } from "./proposal-tasks.js";
 export type { RetentionQuery, RetentionService } from "./retention.js";
 export { retentionService } from "./retention.js";
-export { RESOURCES_SEARCHED, type SearchAllFound, type SearchAllItem, type SearchAllRequest, type SearchedResource, searchAll, } from "./search-all.js";
+export { RESOURCES_SEARCHED, type SearchAllFound, type SearchAllItem, type SearchAllMessenger, type SearchAllRequest, type SearchedResource, searchAll, } from "./search-all.js";
 export { type MeetingSearchCoverage, type MeetingSearchCursor, type MeetingSearchItem, RESOURCES_SEARCHED_WITH_MEETINGS, type ResourceWithMeetings, type SearchAllIncludingMeetingsFound, type SearchAllIncludingMeetingsRequest, type SearchAllWithMeetingsRequest, searchAllIncludingMeetings, searchAllWithMeetings, } from "./search-all-meetings.js";
 export { CATCH_UP_BOUNDS, type CatchUpOptions, type CatchUpResult, catchUpSearch, validateCatchUp, } from "./search-catchup.js";
 export { accountsOfKind, listContextOf, type SearchKind } from "./search-kind.js";

package/dist/services/search-all-meetings.d.ts

@@ -1,8 +1,7 @@
 import type { SearchHit } from "../meetings/index.js";
-import type { MessengerTraits } from "../ports/traits.js";
 import type { AccountKey, MessageStore } from "../store/store.js";
 import type { SearchFound, SearchQuery } from "./messages.js";
-import { type SearchAllFound, type SearchAllItem, type SearchAllRequest, type Skipped } from "./search-all.js";
+import { type SearchAllFound, type SearchAllItem, type SearchAllMessenger, type SearchAllRequest, type Skipped } from "./search-all.js";
 export declare const RESOURCES_SEARCHED_WITH_MEETINGS: readonly ["messages", "mail", "notes", "meetings"];
 export type ResourceWithMeetings = (typeof RESOURCES_SEARCHED_WITH_MEETINGS)[number];
 export interface MeetingSearchItem {
@@ -55,7 +54,7 @@ export interface SearchAllIncludingMeetingsFound extends Omit<SearchAllFound, "i
     meetings?: MeetingSearchCoverage;
 }
 /** Opt-in fusion of the existing unified ranking and one explicitly scoped meeting archive. */
-export declare const searchAllIncludingMeetings: (store: MessageStore, account: AccountKey, request: SearchAllIncludingMeetingsRequest, messenger?: Partial<Pick<MessengerTraits, "savedChatId" | "app">>, searchMessages?: (query: SearchQuery) => Promise<SearchFound>) => Promise<SearchAllIncludingMeetingsFound>;
+export declare const searchAllIncludingMeetings: (store: MessageStore, account: AccountKey, request: SearchAllIncludingMeetingsRequest, messenger?: SearchAllMessenger, searchMessages?: (query: SearchQuery) => Promise<SearchFound>) => Promise<SearchAllIncludingMeetingsFound>;
 export interface SearchAllWithMeetingsRequest extends Omit<SearchAllIncludingMeetingsRequest, "meetingAccount"> {
     /**
      * `--source`: each kind reads the accounts the list names of it and a kind it names none of is skipped.
@@ -66,4 +65,4 @@ export interface SearchAllWithMeetingsRequest extends Omit<SearchAllIncludingMee
 /** Meetings have no index to search every account at once, so they are read only when named. */
 export declare const MEETINGS_UNNAMED = "meetings are searched only when --source names a meeting account, zoom or meetings";
 /** `search all`: every kind but meetings, unless `--source` names a meeting account. */
-export declare const searchAllWithMeetings: (store: MessageStore, account: AccountKey, request: SearchAllWithMeetingsRequest, messenger?: Partial<Pick<MessengerTraits, "savedChatId" | "app">>, searchMessages?: (query: SearchQuery) => Promise<SearchFound>) => Promise<SearchAllIncludingMeetingsFound>;
+export declare const searchAllWithMeetings: (store: MessageStore, account: AccountKey, request: SearchAllWithMeetingsRequest, messenger?: SearchAllMessenger, searchMessages?: (query: SearchQuery) => Promise<SearchFound>) => Promise<SearchAllIncludingMeetingsFound>;

package/dist/services/search-all.d.ts

@@ -81,9 +81,16 @@ export interface SearchAllRequest {
     /** The accounts `--source` chose, per kind; a kind left out reads every account of its own. */
     scope?: Partial<Record<SearchedResource, AccountKey[]>>;
 }
+export type SearchAllMessenger = Partial<Pick<MessengerTraits, "savedChatId" | "app">> & {
+    /**
+     * The tool named in a model-download hint, when it is not `app.command`: memo passes tg's identity for `group:`
+     * lists but has no `models` command. `null` names the tools that have one.
+     */
+    hintCommand?: string | null;
+};
 /**
  * `search all`: messages, mail and notes from the local store — messages also from the messenger's
  * server, as `search messages` asks it — each list best first, merged by reciprocal rank so no
  * resource's own scores have to be compared with another's.
  */
-export declare const searchAll: (store: MessageStore, account: AccountKey, request: SearchAllRequest, messenger?: Partial<Pick<MessengerTraits, "savedChatId" | "app">>, searchMessages?: (query: SearchQuery) => Promise<SearchFound>) => Promise<SearchAllFound>;
+export declare const searchAll: (store: MessageStore, account: AccountKey, request: SearchAllRequest, messenger?: SearchAllMessenger, searchMessages?: (query: SearchQuery) => Promise<SearchFound>) => Promise<SearchAllFound>;

package/dist/services/search-all.js

@@ -21,7 +21,7 @@ export const searchAll = async (store, account, request, messenger = {}, searchM
     // Each resource is read deep enough for the merged page, then the merge is cut.
     const window = offset + request.limit;
     const only = request.only ?? RESOURCES_SEARCHED;
-    const command = messenger.app?.command;
+    const command = messenger.hintCommand === undefined ? messenger.app?.command : (messenger.hintCommand ?? undefined);
     const lists = [];
     const searched = [];
     const accounts = [];

package/dist/speech/transcribe.js

@@ -1,6 +1,7 @@
 import { CliError, isCliError } from "@wirecat/cli-base";
 import { fromFile } from "../cli/settings.js";
 import { capability } from "../ports/messenger.js";
+import { typedCommand } from "../runs/scope.js";
 import { installedBytes, isInstalled, megabytes, modelPath, modelsDirectory, vadPath } from "./install.js";
 import { orderedModels, speechModel } from "./models.js";
 /** `messenger`: its own recognition (Telegram Premium). `local`: a model on this machine. `auto`: the first, then the second. */
@@ -20,7 +21,7 @@ export const choose = (messenger, settings, flags, env = process.env) => {
 };
 /** Never a download: a model is hundreds of MB, and whether to fetch one is the owner's call. */
 export const notDownloaded = (messenger, model) => new CliError("not_found", `the speech model ${model.id} is not on this machine — the owner downloads it once with ` +
-    `\`${messenger.app.command} models audio download ${model.id}\` (${megabytes(installedBytes(model))})`, { reason: "model.not-downloaded", model: model.id });
+    `\`${typedCommand(messenger.app.command, `models audio download ${model.id}`)}\` (${megabytes(installedBytes(model))})`, { reason: "model.not-downloaded", model: model.id });
 /**
  * Over an open connection: the messenger's own transcript, or the recording's bytes for a local model.
  * The model runs after the connection closes — a minute of speech should not hold a socket open.

package/dist/store/chats.d.ts

@@ -1,5 +1,5 @@
 import type { ChannelTagMatch } from "../domain/channel-tags.js";
-import type { Chat, ChatKind, Id, Page } from "../domain/models.js";
+import type { Chat, ChatKind, ChatUpdate, Id, Page } from "../domain/models.js";
 import { type ChatRekey } from "./sqlite/chat-rekey.js";
 import type { ChatMetadata } from "./sqlite/chats.js";
 import type { ChatCompleteness } from "./sqlite/completeness.js";
@@ -7,7 +7,7 @@ import type { StoreContext } from "./sqlite/open.js";
 import type { Where } from "./sqlite/query-filter.js";
 import type { AccountKey, ChatActivity, ChatStats, StoredChatFilter } from "./types.js";
 export interface ChatsStore {
-    saveChats(key: AccountKey, chats: Chat[]): Promise<void>;
+    saveChats(key: AccountKey, chats: ChatUpdate[]): Promise<void>;
     /** Newest first. `query` matches three letters or more of a title; `unread` keeps chats with unread messages. */
     chats(key: AccountKey, window: {
         limit?: number;

package/dist/store/sqlite/chats.d.ts

@@ -1,5 +1,5 @@
 import type { ChannelTagMatch } from "../../domain/channel-tags.js";
-import type { Chat, Id, Member, Page } from "../../domain/models.js";
+import type { Chat, ChatUpdate, Id, Member, Page } from "../../domain/models.js";
 import type { AccountKey, StoredChatFilter } from "../types.js";
 import type { StoreContext } from "./open.js";
 /** The chat's own id, when the store key is a chat of this account. */
@@ -7,7 +7,7 @@ export declare const chatOf: ({ orm }: StoreContext, accountKey: number, chatKey
 export declare const findChatPk: ({ orm }: StoreContext, accountKey: number, chatId: Id) => number | undefined;
 /** A chat known only from its messages, until the chat list names it. */
 export declare const chatPkFor: (context: StoreContext, accountKey: number, chatId: Id) => number;
-export declare const upsertChat: (context: StoreContext, accountKey: number, chat: Chat) => void;
+export declare const upsertChat: (context: StoreContext, accountKey: number, chat: ChatUpdate) => void;
 /** Replaces who is in the chat, whole. */
 export declare const writeMembers: (context: StoreContext, key: AccountKey, accountKey: number, chatId: Id, memberIds: Id[]) => void;
 export declare const members: ({ orm }: StoreContext, chatKey: number) => Member[];

package/dist/store/sqlite/chats.js

@@ -45,10 +45,10 @@ export const upsertChat = (context, accountKey, chat) => {
         kind: chat.kind,
         parentChatId: parent,
         scope: chat.scope ?? null,
-        title: chat.title,
-        unreadCount: chat.unreadCount,
+        title: chat.title ?? null,
+        unreadCount: chat.unreadCount ?? null,
         lastMessageAt: toMs(chat.lastMessageAt),
-        participantsCount: chat.participantsCount,
+        participantsCount: chat.participantsCount ?? null,
         metadata: mergedMetadata(stored?.metadata ?? null, chat.providerMetadata),
         membershipState: chat.membershipState ?? null,
         createdAt: now(),
@@ -60,10 +60,10 @@ export const upsertChat = (context, accountKey, chat) => {
             kind: sql `excluded.kind`,
             ...(chat.parentChatId === undefined ? {} : { parentChatId: sql `excluded.parent_chat_id` }),
             scope: sql `coalesce(excluded.scope, ${chats.scope})`,
-            title: sql `excluded.title`,
-            unreadCount: sql `excluded.unread_count`,
-            lastMessageAt: sql `excluded.last_message_at`,
-            participantsCount: sql `excluded.participants_count`,
+            ...(chat.title === undefined ? {} : { title: sql `excluded.title` }),
+            ...(chat.unreadCount === undefined ? {} : { unreadCount: sql `excluded.unread_count` }),
+            ...(chat.lastMessageAt === undefined ? {} : { lastMessageAt: sql `excluded.last_message_at` }),
+            ...(chat.participantsCount === undefined ? {} : { participantsCount: sql `excluded.participants_count` }),
             metadata: sql `excluded.metadata`,
             // A chat the list names again has been rejoined; any other state it had is kept.
             membershipState: sql `CASE WHEN excluded.membership_state IS NOT NULL THEN excluded.membership_state

package/dist/store/types.d.ts

@@ -1,6 +1,6 @@
 import type { TextRange } from "../conversations/chunks.js";
 import type { Link } from "../conversations/link.js";
-import type { Chat, ChatKind, Id, MessageHit, Provider } from "../domain/models.js";
+import type { Chat, ChatKind, ChatUpdate, Id, MessageHit, Provider } from "../domain/models.js";
 import type * as imageChunks from "./sqlite/image-chunks.js";
 import type { Where } from "./sqlite/query-filter.js";
 export type PictureInput = imageChunks.PictureInput;
@@ -82,7 +82,7 @@ export type MessageFilter = AccountMessageFilter & {
     chatId?: undefined;
 });
 export interface Delta {
-    chats?: Chat[];
+    chats?: ChatUpdate[];
     people?: PersonFacts[];
     members?: Map<Id, Id[]>;
     state?: Record<string, string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.347.0",
+  "version": "0.348.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",
@@ -202,7 +202,7 @@
     "@types/node": "^22.20.4",
     "@types/pngjs": "6.0.5",
     "@vitest/coverage-v8": "^5.0.2",
-    "@wirecat/cli-base": "0.46.0",
+    "@wirecat/cli-base": "0.47.0",
     "commander": "15.0.0",
     "cspell": "10.3.6",
     "drizzle-kit": "1.0.0-rc.4",
@@ -222,7 +222,7 @@
   },
   "peerDependencies": {
     "@napi-rs/canvas": ">=0.1.69 <2",
-    "@wirecat/cli-base": ">=0.45.0 <0.47.0",
+    "@wirecat/cli-base": ">=0.47.0 <0.48.0",
     "commander": ">=15"
   },
   "bin": {