@wirecat/max-cli 0.0.0 → 0.42.0

package/dist/mcp/tools.js

@@ -0,0 +1,248 @@
+import { CliError } from "@wirecat/cli-core";
+import { AI_SETTING_KEYS, personalMcpCommand, personalMcpToolKey, personalMcpTools, registerPersonalMcpSurface, rememberAccount, stored, } from "@wirecat/cli-messaging/cli";
+import { levelFor } from "@wirecat/cli-messaging/sends";
+import { openStore } from "@wirecat/cli-messaging/store";
+import * as v from "valibot";
+import { maxAdapter } from "../adapter/max-adapter.js";
+import { MAX_APP } from "../app.js";
+import { resolveSettings } from "../config.js";
+import { maxMessenger } from "../messenger.js";
+import { migrateModerationPoints } from "../moderation/points.js";
+import { assertReadable, withPermissionApproval } from "../permissions.js";
+import { maxRecord } from "../record.js";
+import { transcribe } from "../transcribe/index.js";
+import { modelsDirectory } from "../transcribe/install.js";
+import { DEFAULT_MODEL, speechModel } from "../transcribe/models.js";
+import { legacyCheckTool } from "./legacy-check.js";
+import { photoForMcp } from "./photo.js";
+import { withShared } from "./shared.js";
+const PASS = { check: () => { }, record: () => { } };
+const READ = { readOnlyHint: true, destructiveHint: false, openWorldHint: true };
+export const registerTools = (server, session, { store, defaultLimit, history, profile, permission, transcribeModel = DEFAULT_MODEL, warn = () => { }, reach, embedders, }) => {
+    const settings = () => resolveSettings({ profile, permission });
+    const adapters = new WeakMap();
+    const definitions = personalMcpTools(maxMessenger);
+    for (const name of Object.keys(definitions))
+        if (name.startsWith("topics_"))
+            delete definitions[name];
+    const rules = definitions.chats_rules_show;
+    if (rules)
+        definitions.chats_rules = { ...rules, key: "chats.rules.show" };
+    const keyOf = (name, definition) => name === "status" ? null : (personalMcpToolKey(name, definition) ?? "messages");
+    const writable = (name, definition) => {
+        const key = keyOf(name, definition);
+        if (key === null)
+            return null;
+        const own = settings();
+        assertReadable(own, key);
+        if (definition.annotations.readOnlyHint !== true && levelFor(own.permissions, key).level === "readonly")
+            throw new CliError("permission_error", `profile ${profile} does not let ${key} write`, { permission: key });
+        return key;
+    };
+    const inScope = (name, definition, work) => {
+        const key = writable(name, definition);
+        if (key === null)
+            return work();
+        if (key === "chats.moderate")
+            migrateModerationPoints(store);
+        return withPermissionApproval(key, () => key === "chats.moderate"
+            ? withPermissionApproval("messages.delete", () => withPermissionApproval("chats.members.remove", work))
+            : work());
+    };
+    const remember = () => {
+        const account = store.readState().viewerId;
+        if (!account)
+            return;
+        try {
+            rememberAccount(MAX_APP, profile, account, process.env);
+        }
+        catch {
+            // A secondary local binding must not replace a successful send or prevent store cleanup.
+            warn("could not remember the account for local archive tools");
+        }
+    };
+    const adapterFor = (client) => {
+        const adapter = maxAdapter(client, store, reach, warn);
+        adapters.set(adapter, client);
+        return adapter;
+    };
+    const offered = Object.fromEntries(Object.entries(definitions).filter(([name, definition]) => {
+        const key = keyOf(name, definition);
+        const level = key === null ? "allow" : levelFor(settings().permissions, key).level;
+        return level !== "deny" && (definition.annotations.readOnlyHint === true || level !== "readonly");
+    }));
+    const direct = offered.messages_transcribe;
+    const picture = offered.messages_photo;
+    if (picture)
+        offered.messages_photo = {
+            ...picture,
+            online: (adapter, args) => {
+                const client = adapters.get(adapter);
+                if (!client)
+                    throw new Error("MAX photo preview requires its held adapter");
+                return photoForMcp(client, {
+                    chat: String(args.chat),
+                    message: String(args.message),
+                    ...(typeof args.index === "number" ? { index: args.index } : {}),
+                }, reach);
+            },
+        };
+    if (direct)
+        offered.messages_transcribe = {
+            ...direct,
+            description: "A MAX voice message as text on this machine. Reuses a retained transcript from the same model; never downloads a model. Returns { messageId, text, model, cached? }.",
+            online: async (adapter, args, defaults) => {
+                const client = adapters.get(adapter);
+                if (!client)
+                    throw new Error("MAX transcription requires its held adapter");
+                const message = String(args.message);
+                if (!/^\d+$/.test(message))
+                    throw new CliError("validation_error", "MAX message IDs must be decimal strings");
+                const chatId = await client.chats.resolve(String(args.chat));
+                const model = speechModel(typeof args.model === "string" ? args.model : transcribeModel);
+                const record = maxRecord({ account: () => store.readState().viewerId });
+                try {
+                    const kept = await record.transcript(chatId, message);
+                    if (kept?.source === model.id)
+                        return { messageId: message, text: kept.text, model: model.id, cached: true };
+                    return await transcribe(client, chatId, message, {
+                        model,
+                        directory: modelsDirectory(),
+                        record,
+                        ...(defaults.release ? { release: defaults.release } : {}),
+                    });
+                }
+                finally {
+                    await record.close();
+                }
+            },
+        };
+    for (const [name, definition] of Object.entries(offered)) {
+        if (!definition._meta)
+            continue;
+        const metadata = { ...definition._meta };
+        delete metadata["anthropic/requiresUserInteraction"];
+        offered[name] = { ...definition, _meta: metadata };
+    }
+    const moderation = definitions.chats_moderate;
+    const level = levelFor(settings().permissions, "chats.moderate").level;
+    if (moderation && ["allow", "ask"].includes(level))
+        offered.chats_check = legacyCheckTool(session, {
+            store,
+            profile,
+            allowDangerous: false,
+            yes: true,
+            confirmSend: false,
+            scope: (work) => inScope("chats_moderate", moderation, work),
+        });
+    offered.status = {
+        title: "This server's profile and login",
+        description: "The profile, known account and offered writes. Reads local state only; never connects or prints a token.",
+        key: null,
+        input: v.strictObject({}),
+        annotations: { ...READ, idempotentHint: true },
+        local: async () => {
+            const account = store.readState().viewerId ?? null;
+            let token;
+            try {
+                token = store.tokenSource() ?? "none";
+            }
+            catch {
+                token = "unreachable";
+            }
+            return {
+                profile,
+                account,
+                viewerId: account,
+                kind: store.isBot() ? "personal + bot" : "personal",
+                token,
+                loggedInHere: store.hasLoggedIn(),
+                hasToken: store.readToken() !== undefined,
+                hasLoggedIn: account !== null,
+                writes: [
+                    ...Object.entries(offered)
+                        .filter(([, one]) => one.annotations.readOnlyHint !== true)
+                        .map(([name]) => personalMcpCommand(name)),
+                ],
+                permissions: settings().permissions,
+            };
+        },
+    };
+    const currentSettings = settings();
+    const ai = Object.fromEntries(AI_SETTING_KEYS.map((key) => [key, currentSettings[key]]));
+    registerPersonalMcpSurface(server, offered, {
+        command: "max",
+        messenger: maxMessenger,
+        defaults: {
+            limit: defaultLimit,
+            history: history ?? settings().keepFailedRuns,
+            guard: PASS,
+            settings: {
+                ...ai,
+                profile,
+                searchCatchUp: currentSettings.searchCatchUp,
+                configured: ai,
+                shared: { ...ai, speechModel: transcribeModel },
+                get permissions() {
+                    return settings().permissions;
+                },
+            },
+            env: process.env,
+            ...(embedders ? { embedders } : {}),
+        },
+        around: inScope,
+        session: {
+            use: (name, work) => session.use(name, async (client, release) => {
+                let opened;
+                const account = {
+                    provider: "max",
+                    get account() {
+                        const id = store.readState().viewerId;
+                        if (!id)
+                            throw new CliError("authentication_error", `no MAX account known for profile ${profile}`);
+                        return id;
+                    },
+                };
+                const adapter = stored(adapterFor(client), {
+                    account,
+                    store: () => (opened ??= openStore()),
+                    warn,
+                    events: () => { },
+                });
+                adapters.set(adapter, client);
+                try {
+                    return await work(adapter, release);
+                }
+                finally {
+                    remember();
+                    if (opened)
+                        await opened.then((store) => store.close(), () => { });
+                }
+            }),
+        },
+        withStore: (work, { name }) => session.local(name, async () => {
+            const account = store.readState().viewerId;
+            if (!account)
+                throw new CliError("authentication_error", `no MAX account known for profile ${profile}`);
+            const opened = await openStore();
+            try {
+                return await work(opened, { provider: "max", account });
+            }
+            finally {
+                await opened.close();
+            }
+        }),
+        withServices: (work, { name }) => session.use(name, (client, release) => withShared(client, { store, profile, warn }, async (services) => {
+            remember();
+            return work(services, async (read) => {
+                try {
+                    return await read(adapterFor(client));
+                }
+                finally {
+                    await release();
+                }
+            });
+        }, name === "mcp messages link" ? { reads: "store" } : { login: true })),
+    });
+};
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

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

package/dist/messenger.d.ts

@@ -0,0 +1,15 @@
+import type { Messenger } from "@wirecat/cli-messaging/cli";
+import type { SendGuard } from "@wirecat/cli-messaging/sends";
+import type { Command } from "commander";
+/**
+ * Over `max serve` the server reserves and journals each write it forwards, with the outcome it saw;
+ * the command checks too, and records only what it refused itself (`NEED-269`).
+ */
+export declare const overServer: (guard: SendGuard, server: () => {
+    readonly journals: boolean;
+} | undefined) => SendGuard;
+/** One subcommand of a shared command group, to sit among max's own. */
+export declare const sharedSubcommand: (group: Command, name: string) => Command;
+/** What cli-messaging's shared commands and services need from max, for the personal account. */
+export declare const maxMessenger: Messenger;
+//# sourceMappingURL=messenger.d.ts.map

package/dist/messenger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messenger.d.ts","sourceRoot":"","sources":["../src/messenger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,SAAS,EAA4B,MAAM,4BAA4B,CAAA;AAElG,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAE3E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAgBxC;;;GAGG;AACH,eAAO,MAAM,UAAU,UAAW,SAAS,UAAU,MAAM;IAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,KAAG,SAUvG,CAAA;AAED,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,UAAW,OAAO,QAAQ,MAAM,KAAG,OAI/D,CAAA;AAED,iGAAiG;AACjG,eAAO,MAAM,YAAY,EAAE,SA0H1B,CAAA"}

package/dist/messenger.js

@@ -0,0 +1,149 @@
+import { AI_SETTING_KEYS } from "@wirecat/cli-messaging/cli";
+import { moderationService } from "@wirecat/cli-messaging/services";
+import { maxAdapter } from "./adapter/max-adapter.js";
+import { MAX_APP } from "./app.js";
+import { environmentOf, forCommand } from "./commands/context.js";
+import { resolveSettings } from "./config.js";
+import { migrateModerationPoints } from "./moderation/points.js";
+import { askerFor, assertReadable, commandPermission, permissionKeyOf } from "./permissions.js";
+import { rootOf } from "./profile.js";
+import { maxRecord } from "./record.js";
+import { guardFor } from "./sends.js";
+import { SPEECH_MODELS } from "./transcribe/models.js";
+/** The client each command connected, so its guard can tell whether `max serve` journals for it. */
+const clients = new WeakMap();
+/**
+ * Over `max serve` the server reserves and journals each write it forwards, with the outcome it saw;
+ * the command checks too, and records only what it refused itself (`NEED-269`).
+ */
+export const overServer = (guard, server) => {
+    const ask = guard.ask;
+    return {
+        ...(ask ? { ask: (request) => ask.call(guard, request) } : {}),
+        check: (request) => guard.check(request, server() ? { reserve: false } : {}),
+        record: (entry) => {
+            const through = server();
+            if (!through || entry.outcome === "refused" || !through.journals)
+                guard.record(entry);
+        },
+    };
+};
+/** One subcommand of a shared command group, to sit among max's own. */
+export const sharedSubcommand = (group, name) => {
+    const found = group.commands.find((one) => one.name() === name);
+    if (!found)
+        throw new Error(`cli-messaging's ${group.name()} has no ${name}`);
+    return found;
+};
+/** What cli-messaging's shared commands and services need from max, for the personal account. */
+export const maxMessenger = {
+    inviteLinkList: false,
+    inviteLinkRevoke: false,
+    folderJoin: false,
+    groupPhoto: true,
+    chatMedia: true,
+    privacy: true,
+    chatMute: true,
+    chatDeletion: true,
+    personalBots: true,
+    stickers: true,
+    app: MAX_APP,
+    provider: "max",
+    counterFields: ["views", "reactions"],
+    name: "MAX",
+    chatArgument: "a chat: its id, or part of its title",
+    partnerOf: (chat) => chat.kind === "dialog" && typeof chat.providerMetadata?.partnerId === "string"
+        ? chat.providerMetadata.partnerId
+        : undefined,
+    speechModels: SPEECH_MODELS,
+    // As web.max.ru pages a chat scrolled up: 30 back from the oldest shown (`RES-9`), a person's 5–10 s
+    // apart (`NEED-216` A). MAX's ids pass 2^53, so held stretches are kept by send time.
+    fetching: { page: 30, pause: "5s", jitter: true, maxPages: 40, orderBy: "time", beforeInclusive: true },
+    // A tab makes a handful of requests at a time, then one every few seconds; MAX's limits are unpublished.
+    pace: { perMinute: 20, burst: 10 },
+    permissionKey: permissionKeyOf,
+    tracksMembers: true,
+    // Opcode 73 answers in one chat only (measured 2026-10-07).
+    serverSearch: "chat",
+    guard: (command, { profile }, warn) => {
+        const client = () => clients.get(rootOf(command));
+        const guard = overServer(guardFor(resolveSettings({ profile }), warn, askerFor(command.optsWithGlobals(), environmentOf(command)), commandPermission(command) ?? undefined), () => client()?.server);
+        return {
+            ...guard,
+            record: (entry) => {
+                const applied = client()?.takeApplied(entry.operationId) === true;
+                // MAX can acknowledge the closure before the token save or follow-up session read fails.
+                if (applied && (entry.outcome === "failed" || entry.outcome === "outcome_unknown")) {
+                    const { errorCode: _errorCode, ...done } = entry;
+                    guard.record({ ...done, outcome: "sent" });
+                }
+                else
+                    guard.record(entry);
+            },
+        };
+    },
+    resolveSettings: (flags, options = {}) => {
+        const { profile, offline, ...rest } = flags;
+        const own = resolveSettings({ ...rest, ...(profile === undefined ? {} : { profile }) }, {
+            ...(options.env === undefined ? {} : { env: options.env }),
+            ...(options.configDir === undefined ? {} : { configDir: options.configDir }),
+        });
+        return {
+            ...own,
+            offline: offline === true,
+            configured: Object.fromEntries(AI_SETTING_KEYS.map((key) => [key, own[key]])),
+            // The shared hearing reads its model as `speechModel`; max's setting is `transcribeModel`.
+            shared: {
+                ...Object.fromEntries(AI_SETTING_KEYS.map((key) => [key, own[key]])),
+                speechModel: own.transcribeModel,
+            },
+            permissions: own.permissions,
+            permissionSources: own.permissionSources,
+        };
+    },
+    services: (_base, deps) => ({
+        moderation: moderationService({
+            ...deps,
+            connection: async () => {
+                const adapter = await deps.connection();
+                return new Proxy(adapter, {
+                    get: (target, key, receiver) => key === "resolve" ? (reference) => target.chat(reference) : Reflect.get(target, key, receiver),
+                });
+            },
+        }),
+    }),
+    connect: async (command, context, { events } = {}) => {
+        const { createClient, store, reach, settings } = forCommand(command);
+        if (command.name() === "moderate")
+            migrateModerationPoints(store, context.env);
+        const record = maxRecord({ account: () => store.readState().viewerId, env: context.env });
+        try {
+            const client = createClient({
+                sends: "caller",
+                reads: (key) => assertReadable(settings, commandPermission(command) ?? key),
+                record,
+                ...(events ? { events } : {}),
+            });
+            clients.set(rootOf(command), client);
+            const adapter = maxAdapter(client, store, reach, (message) => context.renderer.note(message), {
+                reactions: command.name() !== "moderate",
+            });
+            return {
+                ...adapter,
+                close: async () => {
+                    try {
+                        await adapter.close();
+                    }
+                    finally {
+                        await record.close();
+                    }
+                },
+            };
+        }
+        catch (error) {
+            await record.close();
+            throw error;
+        }
+    },
+};
+//# sourceMappingURL=messenger.js.map

package/dist/messenger.js.map

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

package/dist/moderation/check.d.ts

@@ -0,0 +1,103 @@
+import type { MaxClient } from "../client.js";
+import type { GroupMember, Id, Message } from "../domain/models.js";
+import { moderationPoints } from "./points.js";
+import { type GroupRules } from "./rules.js";
+export type Action = "report" | "delete" | "remove";
+export type Outcome = "reported" | "done" | "planned" | "forbidden" | "declined" | "refused" | "failed" | "skipped";
+export interface Finding {
+    /** A message, or somebody who joined. */
+    kind: "message" | "member";
+    rule: "blocked" | "invites" | "links" | "forwards" | "flood" | "newAccount";
+    personId: Id;
+    personName: string | null;
+    messageId?: Id;
+    action: Action;
+}
+export interface CheckRow extends Finding {
+    outcome: Outcome;
+    reason?: string;
+    /** What the owner types to do it by hand, on a row that was not done. */
+    command?: string;
+}
+export interface CheckInput {
+    rules: GroupRules;
+    messages: Message[];
+    joined: GroupMember[];
+    /** The owner's admins; the owner's own messages are known by `outgoing`. */
+    answerers: ReadonlySet<Id>;
+    now: number;
+}
+/**
+ * What the rules say about what is new. Pure: nothing here talks to MAX. One finding per message —
+ * the rule with the strongest action — and one removal per person, whatever else they did.
+ */
+export declare const judge: ({ rules, messages, joined, answerers, now }: CheckInput) => Finding[];
+export interface ActOptions {
+    chatId: Id;
+    rules: GroupRules;
+    /** `--allow-dangerous` on this run: what `flag` asks for. */
+    allowDangerous: boolean;
+    dryRun: boolean;
+    maxActions: number;
+    /** Asks the owner about one action; `undefined` when nobody is there to ask. */
+    confirm?: (finding: Finding) => Promise<boolean>;
+}
+/** The two things a check may do, whoever does them: the personal account, or a bot. */
+export interface Moderator {
+    deleteMessage(chatId: Id, messageId: Id): Promise<void>;
+    removePerson(chatId: Id, personId: Id): Promise<void>;
+}
+/** The personal account: deleting is for everyone, removing leaves messages and cannot ban. */
+export declare const personal: (client: MaxClient) => Moderator;
+/**
+ * Does what the findings ask, as far as consent, the per-run limit and the guard let it. Stops
+ * acting at the first hourly-limit refusal: the rest is `skipped`, never tried.
+ */
+export declare const act: (moderator: Moderator, findings: Finding[], options: ActOptions) => Promise<CheckRow[]>;
+/** One action in words, for a prompt or a confirmation form. */
+export declare const describe: (finding: Finding) => string;
+/** Whether acting on it waits for the owner's yes. */
+export declare const needsConfirm: (rules: GroupRules, finding: Finding) => boolean;
+export interface Gathered extends Omit<CheckInput, "rules" | "now"> {
+    /** The newest message read, ISO 8601: where the next check starts. */
+    until: string | null;
+    /** More history than one check reads. */
+    more: boolean;
+    notes: string[];
+}
+/**
+ * What is new in the group since `since`: its messages, who joined (from the service messages —
+ * `add` measured, `joinByLink` assumed to name the joiner or be sent by them), who asks to join,
+ * and who the admins are.
+ */
+export declare const gather: (client: MaxClient, chatId: Id, since: number) => Promise<Gathered>;
+export declare const MAX_ACTIONS = 10;
+/** Where each chat's next check starts, ISO 8601. */
+export interface SavedPoints {
+    read(chatId: Id): string | undefined;
+    write(chatId: Id, at: string): void;
+}
+export declare const sessionPoints: typeof moderationPoints;
+export interface Prepared {
+    chatId: Id;
+    title: string | null;
+    rules: GroupRules;
+    found: Gathered;
+    findings: Finding[];
+    /** `--since` was given: the saved point is not read, and not moved. */
+    explicit: boolean;
+    notes: string[];
+}
+/** Reads and judges; changes nothing. `since` overrides the group's saved point. */
+export declare const prepare: (client: MaxClient, { points, profile, chat, since }: {
+    points: SavedPoints;
+    profile: string;
+    chat: string;
+    since?: number;
+}) => Promise<Prepared>;
+/** Acts on what `prepare` found, moves the group's saved point, and says what is left. */
+export declare const finish: (moderator: Moderator, points: SavedPoints, prepared: Prepared, options: Omit<ActOptions, "chatId" | "rules">) => Promise<{
+    rows: CheckRow[];
+    notes: string[];
+}>;
+//# sourceMappingURL=check.d.ts.map

package/dist/moderation/check.d.ts.map

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