@wirecat/max-cli 0.55.0 → 0.57.0

package/dist/mcp/tools.d.ts

@@ -1,19 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/server";
-import { type PersonalMcpDefaults } from "@wirecat/cli-core/cli";
-import type { Reach } from "../download.js";
-import type { SessionStore } from "../session/store.js";
-import type { MaxSession } from "./session.js";
-interface Options {
-    store: SessionStore;
-    defaultLimit: number;
-    history?: boolean;
-    profile: string;
-    permission?: string[];
-    transcribeModel?: string;
-    warn?: (message: string) => void;
-    reach?: Reach;
-    embedders?: PersonalMcpDefaults["embedders"];
-}
-export declare const registerTools: (server: McpServer, session: MaxSession, { store, defaultLimit, history, profile, permission, transcribeModel, warn, reach, embedders, }: Options) => void;
-export {};
-//# sourceMappingURL=tools.d.ts.map

package/dist/mcp/tools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAE7D,OAAO,EAGL,KAAK,mBAAmB,EASzB,MAAM,uBAAuB,CAAA;AAQ9B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAM3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAMvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAM9C,UAAU,OAAO;IACf,KAAK,EAAE,YAAY,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,SAAS,CAAC,EAAE,mBAAmB,CAAC,WAAW,CAAC,CAAA;CAK7C;AAED,eAAO,MAAM,aAAa,WAChB,SAAS,WACR,UAAU,mGAWhB,OAAO,KACT,IAiPF,CAAA"}

package/dist/mcp/tools.js

@@ -1,257 +0,0 @@
-import { CliError } from "@wirecat/cli-base";
-import { AI_SETTING_KEYS, itemOf, personalMcpCommand, personalMcpToolKey, personalMcpTools, registerPersonalMcpSurface, rememberAccount, stored, } from "@wirecat/cli-core/cli";
-import { levelFor } from "@wirecat/cli-core/sends";
-import { openStore } from "@wirecat/cli-core/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");
-        }
-    };
-    // cli-core asks for the account before a write; a profile that never logged in has none until LOGIN answers.
-    const knowAccount = async (client) => {
-        if (store.readState().viewerId === undefined)
-            await client.connect();
-    };
-    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. Answers item { message_id, text, pending, via, model }.",
-            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);
-                    const text = kept?.source === model.id
-                        ? kept.text
-                        : (await transcribe(client, chatId, message, {
-                            model,
-                            directory: modelsDirectory(),
-                            record,
-                            ...(defaults.release ? { release: defaults.release } : {}),
-                        })).text;
-                    return itemOf({ message_id: message, text, pending: false, via: "local", model: model.id });
-                }
-                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 itemOf({
-                profile,
-                account,
-                kind: store.isBot() ? "personal + bot" : "personal",
-                token,
-                logged_in_here: store.hasLoggedIn(),
-                has_token: store.readToken() !== undefined,
-                has_logged_in: 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) => {
-                await knowAccount(client);
-                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, async (client, release) => {
-            await knowAccount(client);
-            return 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

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

package/dist/moderation/check.d.ts

@@ -1,103 +0,0 @@
-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

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