@wirecat/cli-core 0.20.0 → 0.262.0

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

@@ -0,0 +1,198 @@
+import type { Command } from "commander";
+import type { AdminRight, Chat, GroupSettings, Id, Provider } from "../../domain/models.js";
+import { type SendGuard } from "../../sends/guard.js";
+import { type PaceRate } from "../../sends/pace.js";
+import { type PermissionKey } from "../../sends/permissions.js";
+import { type Override, type Services } from "../../services/index.js";
+import type { OpenRecognizer } from "../../speech/transcribe.js";
+import { type AccountKey, type DeletionScope, type MessageStore } from "../../store/store.js";
+import type { AppIdentity } from "../app.js";
+import { type BaseContext } from "../context.js";
+import { type PermissionKeyOf } from "../permission-keys.js";
+import type { EventSink } from "../runs/events.js";
+import type { GlobalFlags, ResolveOptions, Settings } from "../settings.js";
+import type { MessengerAdapter } from "./port.js";
+/** `listen` opens a connection that receives updates — only `watch` asks; the rest stay quiet. */
+export interface ConnectOptions {
+    listen?: boolean;
+    /** Fetch what arrived while nothing listened — `serve` only; `watch` starts from now. */
+    catchUp?: boolean;
+    /** The run's diagnostics, for a messenger that reports its own wire below the adapter's calls. */
+    events?: EventSink;
+}
+export interface Fetching {
+    beforeInclusive?: boolean;
+    /** Messages per history request. */
+    page: number;
+    /** The most one history request returns, where the messenger is known to cap it; a larger `--page-size` is refused. */
+    maxPageSize?: number;
+    /** The least wait between requests, as `--pause` takes it. */
+    pause: string;
+    /** Each wait drawn between `pause` and twice that, as a person scrolls rather than a clock. */
+    jitter?: boolean;
+    /** `messages sync` takes this many pages' worth of messages when `--limit` is not given. */
+    maxPages: number;
+    /**
+     * What a held stretch is keyed by: the message id, or its send time where ids pass 2^53 and do
+     * not count messages (MAX). By time, `before` reaches the adapter as an ISO time.
+     */
+    orderBy?: "id" | "time";
+}
+/** What one messenger CLI hands the shared commands. Everything else about it stays in its own code. */
+/** `messages send --spoiler` and `--caption-above`. */
+export type MediaOption = "spoiler" | "captionAbove" | "fileName";
+export interface Messenger {
+    counterFields?: readonly import("../../domain/counters.js").CounterField[];
+    app: AppIdentity;
+    provider: Provider;
+    /** The messenger's own name, as its users write it — `Telegram`, `MAX`. Defaults to the command. */
+    name?: string;
+    /** How fast one profile may ask the messenger, across processes, unless `requestsPerMinute` says otherwise. */
+    pace?: PaceRate;
+    resolveSettings: (flags: GlobalFlags, options?: ResolveOptions) => Settings;
+    /**
+     * Opens a connection for the command's profile, or throws a typed error saying how to log in.
+     * Called inside `--timeout`; the context tracks and closes what it returns.
+     */
+    connect: (command: Command, context: BaseContext, options?: ConnectOptions) => Promise<MessengerAdapter>;
+    /** The help for a `<chat>` argument, in this messenger's words. */
+    chatArgument: string;
+    /** The group settings this messenger has, as `chats update` offers them; every one when unset. */
+    groupSettings?: readonly (keyof GroupSettings)[];
+    /**
+     * The send options for attachments this messenger honours; none when unset, so an adapter that does not
+     * know a newer option is never handed one to drop.
+     */
+    mediaOptions?: readonly MediaOption[];
+    /** Whether `polls create` makes quizzes (`--quiz --correct --solution`); no when unset. */
+    pollQuiz?: boolean;
+    /** How many seconds after sending a poll may close by itself — `polls create --close-time`; none when unset. */
+    pollCloseSeconds?: readonly [min: number, max: number];
+    /** Whether `polls voters` lists who voted for what; no when unset. */
+    pollVoters?: boolean;
+    /** Whether `topics show` reads one forum topic; no when unset. */
+    topicShow?: boolean;
+    /** Whether `messages forward --topic` forwards into a forum topic; no when unset. */
+    forwardTopic?: boolean;
+    /** Whether folders take kinds of chat, skip muted, read or archived ones, exclude and pin chats; no when unset. */
+    folderRules?: boolean;
+    /** Whether the messenger reads HTML in `--html`; no when unset. */
+    html?: boolean;
+    /** Whether folder ordering is available; yes when unset. */
+    folderOrder?: boolean;
+    /** Whether `chats update --photo` sets a group's photo; no when unset. */
+    groupPhoto?: boolean;
+    /** Whether `chats media` lists a chat's media from the server; no when unset. */
+    chatMedia?: boolean;
+    /** Whether `account privacy show` and `set` read and change the account's privacy; no when unset. */
+    privacy?: boolean;
+    /** Whether `chats mute` and `unmute` exist; no when unset. */
+    chatMute?: boolean;
+    /** Whether `chats delete` and `chats clear` exist; no when unset. */
+    chatDeletion?: boolean;
+    /** Whether `messages press`, `chats start` and `chats app` exist — a bot met on the personal account; no when unset. */
+    personalBots?: boolean;
+    /** Whether `messages send --sticker` sends a sticker; no when unset. `stickers list` is a group a CLI adds itself. */
+    stickers?: boolean;
+    /** Whether shared folders can be joined; yes when unset. */
+    folderJoin?: boolean;
+    /** Whether invite links can be listed; yes when unset. */
+    inviteLinkList?: boolean;
+    /** Whether one invite link can be revoked; yes when unset. */
+    inviteLinkRevoke?: boolean;
+    /** Whether one invite link can be changed — `chats link update`; no when unset. */
+    inviteLinkUpdate?: boolean;
+    /** Whether the messenger says when an account was made — the moderation rule `newAccount`; yes when unset. */
+    knowsAccountAge?: boolean;
+    /**
+     * This messenger's invite links, which `chats moderate` judges under `invites`. Telegram's and MAX's
+     * are built in for now.
+     */
+    inviteLinks?: RegExp;
+    /** Whether people added can be shown the messages from before they came — `members add --history`; yes when unset. */
+    addsWithHistory?: boolean;
+    /** The admin rights this messenger has, as `admins add --can` offers them; every one when unset. */
+    adminRights?: readonly AdminRight[];
+    /** The chat `me` names, when the messenger has a notes-to-self chat. */
+    savedChatId?: (account: AccountKey) => Id;
+    /** The other person in a one-to-one chat, when the chat says who — a recipient list matches on it. */
+    partnerOf?: (chat: Chat) => Id | undefined;
+    /**
+     * Whether a stored chat may hold a message the messenger deleted without naming its chat. When
+     * unset, the store applies Telegram's rule.
+     */
+    deletedWithoutChat?: DeletionScope;
+    /** How `messages sync` reads this messenger's history, where Telegram's defaults do not fit it. */
+    fetching?: Fetching;
+    /**
+     * Where `chats`, `messages list|context` and `contacts` read from. `store` is for a messenger that
+     * pushes its history instead of answering for it: those reads answer from the local store, which
+     * `serve` keeps filled, and never connect; writes still do. `server` when unset.
+     */
+    history?: "server" | "store";
+    /** Whether the messenger computes a chat's statistics for its admins — `stats chats official`; no when unset. */
+    officialStats?: boolean;
+    /**
+     * Whether `search messages --backend` is offered: the adapter has `searchMessages`. `chat` when its server
+     * searches one chat at a time, so only a query that names one chat asks it. No when unset.
+     */
+    serverSearch?: boolean | "chat";
+    /** Whether this CLI's background service fetches tracked rosters daily; true when unset. */
+    tracksMembers?: boolean;
+    /** Speech model ids, most suitable first, for `messages transcribe --local`; the first is the default. */
+    speechModels?: readonly string[];
+    /** Replaces shared use cases for this messenger; its commands and MCP tools both get the replacement. */
+    services?: Override;
+    /**
+     * The send guard for a command, when the messenger's is not the profile's plain one — max-cli's
+     * background server journals what it forwards, so a command over it records only its refusals.
+     */
+    guard?: (command: Command, settings: Settings, warn: (message: string) => void) => SendGuard;
+    /** The permission key of one of this CLI's own commands, when `keyForCommand` does not know it. */
+    permissionKey?: PermissionKeyOf;
+    /** The CLI's SKILL.md, which the MCP server also serves as `<command>://skill`. */
+    skill?: URL;
+    /** What only this messenger can say about itself for `doctor`, read from disk — never a secret. */
+    diagnose?: (command: Command, context: BaseContext) => Promise<Record<string, unknown>>;
+}
+export type ReadConnection = <T>(work: (adapter: MessengerAdapter) => Promise<T>) => Promise<T>;
+export interface MessengerContext extends BaseContext {
+    profile: string;
+    stdin: NodeJS.ReadableStream & {
+        isTTY?: boolean;
+    };
+    /** The local speech recognizer, where a test hands one in. */
+    recognizer?: OpenRecognizer;
+    /** Read-only, the allow-list, the recipient list and the hourly limit — asked before every write, told after. */
+    guard: SendGuard;
+    /**
+     * Connects inside `--timeout`, and closes on every path. What the reads answer is saved to the
+     * message store, and each call is a run event.
+     */
+    withMessenger: <T>(work: (messenger: MessengerAdapter) => Promise<T>, options?: ConnectOptions) => Promise<T>;
+    /** Answers from the message store alone, for `--offline`. Never connects and needs no credentials. */
+    withStore: <T>(work: (store: MessageStore, account: AccountKey) => Promise<T>, options?: {
+        name?: string;
+    }) => Promise<T>;
+    /** The shared use cases, over a connection and a store each opened only if a service asks for it. */
+    withServices: <T>(work: (services: Services, connect?: ReadConnection) => Promise<T>, options?: {
+        name?: string;
+    }) => Promise<T>;
+}
+/**
+ * A connection as every shared reader sees it: its account remembered, each call a run event, what
+ * the reads answer saved to the store. `close` closes the connection and the store it opened. One
+ * function, so a command and an MCP tool call save and record exactly alike.
+ */
+export declare const connected: (connection: MessengerAdapter, { app, provider, name, deletedWithoutChat, pace, }: Pick<Messenger, "app" | "provider" | "name" | "deletedWithoutChat" | "pace">, { settings, env, renderer }: Pick<BaseContext, "settings" | "env" | "renderer">, events: EventSink) => {
+    adapter: MessengerAdapter;
+    close: () => Promise<void>;
+};
+/**
+ * A write to the local store alone. `deny` already stopped the command (`messengerContext`); `readonly`
+ * stops this write too. There is no question to put to the owner here, so `ask` refuses rather than
+ * writing unasked.
+ */
+export declare const refuseLocalWrite: (context: MessengerContext, command: string, permission: PermissionKey) => void;
+export declare const messengerContext: (command: Command, messenger: Messenger, resolving?: Pick<ResolveOptions, "needsProfile">) => MessengerContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/cli/messenger/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/context.ts"],"names":[],"mappings":"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"}

package/dist/cli/messenger/context.js

@@ -0,0 +1,244 @@
+import { CliError } from "@wirecat/cli-base";
+import { servingProfiles } from "../../background/lock.js";
+import { FloodMemory, floodPathFor } from "../../sends/flood.js";
+import { guardFor } from "../../sends/guard.js";
+import { DEFAULT_PACE, Pacer, pacePathFor } from "../../sends/pace.js";
+import { assertStatsPermissionsCurrent, levelFor, readKeysForCommand, } from "../../sends/permissions.js";
+import { OFFLINE, servicesFor } from "../../services/index.js";
+import { openStore } from "../../store/store.js";
+import { baseContext, environmentOf } from "../context.js";
+import { knownPermissionKeys, unknownPermissionKeys } from "../permission-keys.js";
+import { recalledAccount, rememberAccount } from "./accounts.js";
+import { terminalAsker } from "./ask.js";
+import { flooded } from "./flooded.js";
+import { observed } from "./observed.js";
+import { stored } from "./stored.js";
+/** Long enough for a local write; a store that hangs must not keep the process alive. */
+const SAVES_WAIT_MS = 5_000;
+/** Whether every save finished within `ms`. Saves never reject: `stored` turns a failure into a warning. */
+const settled = async (pending, ms) => {
+    if (pending.size === 0)
+        return true;
+    let timer;
+    const late = new Promise((resolve) => {
+        timer = setTimeout(() => resolve(false), ms);
+    });
+    try {
+        return await Promise.race([Promise.all([...pending]).then(() => true), late]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+};
+/**
+ * A connection as every shared reader sees it: its account remembered, each call a run event, what
+ * the reads answer saved to the store. `close` closes the connection and the store it opened. One
+ * function, so a command and an MCP tool call save and record exactly alike.
+ */
+export const connected = (connection, { app, provider, name, deletedWithoutChat, pace, }, { settings, env, renderer }, events) => {
+    const self = connection.self();
+    if (self !== null)
+        rememberAccount(app, settings.profile, self, env);
+    const memory = new FloodMemory(floodPathFor(app, settings.profile, env));
+    const rate = {
+        ...DEFAULT_PACE,
+        ...pace,
+        ...(settings.requestsPerMinute === undefined ? {} : { perMinute: settings.requestsPerMinute }),
+    };
+    const pacer = new Pacer(pacePathFor(app, settings.profile, env), rate);
+    const adapter = observed(flooded(connection, memory, { name: name ?? app.command, warn: renderer.warn, pacer }), events);
+    let store;
+    const pending = new Set();
+    return {
+        adapter: self === null
+            ? adapter
+            : stored(adapter, {
+                account: { provider, account: self },
+                profile: { app: app.command, name: settings.profile },
+                store: () => {
+                    store ??= openStore({ env, command: app.command });
+                    return store;
+                },
+                warn: renderer.warn,
+                events,
+                pending,
+                ...(deletedWithoutChat ? { deletedWithoutChat } : {}),
+            }),
+        close: async () => {
+            try {
+                await connection.close();
+            }
+            finally {
+                try {
+                    if (!(await settled(pending, SAVES_WAIT_MS))) {
+                        events({ event: "warning", code: "store_not_written", operation: "close" });
+                        renderer.warn("not saved to the local store: the last messages were still being written at exit");
+                    }
+                }
+                finally {
+                    if (store)
+                        await (await store.catch(() => undefined))?.close();
+                }
+            }
+        },
+    };
+};
+const unrecorded = (messenger, profile) => new CliError("not_found", messenger.history === "store"
+    ? `nothing recorded for profile "${profile}" yet — run \`${messenger.app.command} serve\` or ` +
+        `\`${messenger.app.command} watch\` once to fill the local store`
+    : `nothing recorded for profile "${profile}" yet — run the command once without --offline`);
+/** NEED-506 A: without it, an agent cannot tell a quiet chat from a store nothing keeps up to date. */
+const warnUnserved = async (messenger, profile, { env, renderer }, store) => {
+    if (servingProfiles(messenger.app, env).includes(profile))
+        return;
+    const account = recalledAccount(messenger.app, messenger.provider, profile, env);
+    if (!account)
+        return;
+    const newest = (await store.chatStats(account))
+        .map((one) => one.newestAt)
+        .reduce((latest, at) => (at !== null && (latest === null || at > latest) ? at : latest), null);
+    renderer.warn(`no \`${messenger.app.command} serve\` keeps profile "${profile}" up to date — ` +
+        (newest === null ? "the local store holds no messages yet" : `the newest stored message is from ${newest}`));
+};
+/** The words of a command below the program, `["messages", "list"]` — the profile word is not one of them. */
+const pathOf = (command) => {
+    const words = [];
+    for (let at = command; at?.parent; at = at.parent)
+        words.unshift(at.name());
+    return words;
+};
+/** `deny` stops a read too, before anything connects: what the profile may not see is never fetched. */
+const refuseDenied = (command, settings) => {
+    assertStatsPermissionsCurrent(pathOf(command), settings.permissions);
+    for (const key of readKeysForCommand(pathOf(command))) {
+        const { level, key: named } = levelFor(settings.permissions, key);
+        if (level !== "deny")
+            continue;
+        throw new CliError("permission_error", `profile ${settings.profile} denies ${key} (permissions.${named} is deny, from the ` +
+            `${settings.permissionSources[named ?? ""] ?? "default"})`, { permission: key });
+    }
+};
+/**
+ * A write to the local store alone. `deny` already stopped the command (`messengerContext`); `readonly`
+ * stops this write too. There is no question to put to the owner here, so `ask` refuses rather than
+ * writing unasked.
+ */
+export const refuseLocalWrite = (context, command, permission) => {
+    const { settings } = context;
+    const { level, key } = levelFor(settings.permissions, permission);
+    if (level === "allow")
+        return;
+    throw new CliError(level === "ask" ? "confirmation_required" : "permission_error", `profile ${settings.profile} does not let ${permission} write (permissions.${key} is ${level}, from the ` +
+        `${settings.permissionSources[key ?? ""] ?? "default"}); to allow it: ` +
+        `${command} ${settings.profile} config set permissions.${permission} allow`, { permission });
+};
+export const messengerContext = (command, messenger, resolving = {}) => {
+    const { app, provider } = messenger;
+    const base = baseContext(command, (flags, options) => messenger.resolveSettings(flags, { ...options, ...resolving }));
+    const { profile } = base.settings;
+    refuseDenied(command, base.settings);
+    for (const key of unknownPermissionKeys(base.settings.permissions, knownPermissionKeys(command, messenger.permissionKey))) {
+        base.renderer.warn(`permissions.${key} names no command and does nothing — \`config unset permissions.${key}\``);
+    }
+    const guard = messenger.guard?.(command, base.settings, base.renderer.warn) ??
+        guardFor(app, base.settings, base.renderer.warn, base.env, terminalAsker(command));
+    return {
+        ...base,
+        profile,
+        stdin: environmentOf(command).stdin ?? process.stdin,
+        ...(environmentOf(command).recognizer ? { recognizer: environmentOf(command).recognizer } : {}),
+        guard,
+        withMessenger: (work, options = {}) => base.run(async (events) => {
+            if (base.settings.offline)
+                throw new CliError("validation_error", OFFLINE);
+            const connection = await messenger.connect(command, base, { ...options, events });
+            base.track(connection);
+            const { adapter, close } = connected(connection, messenger, base, events);
+            try {
+                return await work(adapter);
+            }
+            finally {
+                await close();
+            }
+        }, { unbounded: options.listen === true }),
+        withStore: (work, { name } = {}) => base.run(async () => {
+            const account = recalledAccount(app, provider, profile, base.env);
+            if (!account)
+                throw unrecorded(messenger, profile);
+            const store = await openStore({ env: base.env, command: app.command });
+            try {
+                return await work(store, account);
+            }
+            finally {
+                await store.close();
+            }
+        }, name === undefined ? {} : { name }),
+        withServices: (work, { name } = {}) => base.run(async (events) => {
+            let held;
+            let store;
+            let released;
+            const releaseConnection = () => (released ??= held?.close() ?? Promise.resolve());
+            const deps = {
+                messenger,
+                profile,
+                env: base.env,
+                offline: base.settings.offline,
+                reads: messenger.history ?? "server",
+                // Turning recording off by name (--no-record, or record: false) keeps no search history either.
+                history: base.settings.keepFailedRuns,
+                searchCatchUp: base.settings.searchCatchUp,
+                guard,
+                connection: async () => {
+                    if (base.settings.offline)
+                        throw new CliError("validation_error", OFFLINE);
+                    if (released)
+                        throw new CliError("validation_error", "the read connection has already been released");
+                    if (!held) {
+                        const connection = await messenger.connect(command, base, { events });
+                        if (released) {
+                            await connection.close();
+                            throw new CliError("validation_error", "the read connection has already been released");
+                        }
+                        base.track(connection);
+                        held = connected(connection, messenger, base, events);
+                    }
+                    return held.adapter;
+                },
+                account: async () => {
+                    const account = recalledAccount(app, provider, profile, base.env);
+                    if (!account)
+                        throw unrecorded(messenger, profile);
+                    return account;
+                },
+                store: () => {
+                    store ??= openStore({ env: base.env, command: app.command }).then(async (opened) => {
+                        if (messenger.history === "store")
+                            await warnUnserved(messenger, profile, base, opened);
+                        return opened;
+                    });
+                    return store;
+                },
+            };
+            try {
+                return await work(servicesFor(deps), async (read) => {
+                    try {
+                        return await read(await deps.connection());
+                    }
+                    finally {
+                        await releaseConnection();
+                    }
+                });
+            }
+            finally {
+                try {
+                    await releaseConnection();
+                }
+                finally {
+                    if (store)
+                        await (await store.catch(() => undefined))?.close();
+                }
+            }
+        }, name === undefined ? {} : { name }),
+    };
+};
+//# sourceMappingURL=context.js.map

package/dist/cli/messenger/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/cli/messenger/context.ts"],"names":[],"mappings":"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"}

package/dist/cli/messenger/conversations-command.d.ts

@@ -0,0 +1,12 @@
+import { Command } from "commander";
+import { type Messenger } from "./context.js";
+/**
+ * `conversations`: the threads inside a group chat, found by rules over the stored messages — replies,
+ * mentions, one sender's messages in a row. From the store alone; nothing is built until asked (phase 3).
+ */
+export declare const conversationsCommand: (messenger: Messenger) => Command;
+/** `messages links`: why a message sits where it does in its conversation. */
+export declare const linksCommand: (messenger: Messenger) => Command;
+/** `search conversations`: the conversations nearest to a query, in meaning and in words. */
+export declare const conversationsSearchCommand: (messenger: Messenger) => Command;
+//# sourceMappingURL=conversations-command.d.ts.map

package/dist/cli/messenger/conversations-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/conversations-command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAuBnC,OAAO,EAAE,KAAK,SAAS,EAA6D,MAAM,cAAc,CAAA;AAIxG;;;GAGG;AACH,eAAO,MAAM,oBAAoB,cAAe,SAAS,KAAG,OAme3D,CAAA;AAiKD,8EAA8E;AAC9E,eAAO,MAAM,YAAY,cAAe,SAAS,KAAG,OAwB9C,CAAA;AAoDN,6FAA6F;AAC7F,eAAO,MAAM,0BAA0B,cAAe,SAAS,KAAG,OA+G5D,CAAA"}