@leemour/max-cli 0.6.0 → 0.8.0

package/dist/mcp/session.d.ts

@@ -0,0 +1,28 @@
+import type { MaxClient } from "../client.js";
+import type { CommandContext } from "../commands/context.js";
+export interface SessionOptions {
+    /** Close the connection after this long without a call. */
+    idleMs?: number;
+    /** Log in again after this long, whatever the traffic: the chat list is what the login answered. */
+    maxAgeMs?: number;
+    now?: () => number;
+}
+/**
+ * **One connection for the whole agent session, and never for long** (`NEED-152`).
+ *
+ * The CLI logs in once per command. Here the process outlives the call, so the connection is kept
+ * between calls — and dropped after `idleMs` of quiet, after `maxAgeMs` whatever the traffic, and
+ * after any failure that may have been the connection's. The age limit is there because a login
+ * answers the chat list and the profile once; without it an agent that keeps talking would read a
+ * snapshot that never moves.
+ *
+ * Calls run **one at a time**. A client may send read-only calls in parallel, and one socket with
+ * one `seq` space is not the place to find out whether MAX minds.
+ */
+export declare class MaxSession {
+    #private;
+    constructor(context: CommandContext, { idleMs, maxAgeMs, now }?: SessionOptions);
+    use<T>(name: string, body: (client: MaxClient, release: () => Promise<void>) => Promise<T>): Promise<T>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/mcp/session.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,cAAc,CAAA;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAI5D,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oGAAoG;IACpG,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB;AAWD;;;;;;;;;;;GAWG;AACH,qBAAa,UAAU;;gBAWT,OAAO,EAAE,cAAc,EAAE,EAAE,MAAgB,EAAE,QAAkB,EAAE,GAAc,EAAE,GAAE,cAAmB;IAOlH,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAMjG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAiD7B"}

package/dist/mcp/session.js

@@ -0,0 +1,91 @@
+import { isCliError } from "@leemour/cli-core";
+import { openProfileCache } from "../cache/index.js";
+/** The caller's mistake, not the connection's — nothing about the socket is in doubt after these. */
+const HARMLESS = new Set(["validation_error", "not_found", "permission_error", "confirmation_required", "rate_limited"]);
+/**
+ * **One connection for the whole agent session, and never for long** (`NEED-152`).
+ *
+ * The CLI logs in once per command. Here the process outlives the call, so the connection is kept
+ * between calls — and dropped after `idleMs` of quiet, after `maxAgeMs` whatever the traffic, and
+ * after any failure that may have been the connection's. The age limit is there because a login
+ * answers the chat list and the profile once; without it an agent that keeps talking would read a
+ * snapshot that never moves.
+ *
+ * Calls run **one at a time**. A client may send read-only calls in parallel, and one socket with
+ * one `seq` space is not the place to find out whether MAX minds.
+ */
+export class MaxSession {
+    #context;
+    #idleMs;
+    #maxAgeMs;
+    #now;
+    #held;
+    #idle;
+    #queue = Promise.resolve();
+    #events = () => { };
+    #closed = false;
+    constructor(context, { idleMs = 120_000, maxAgeMs = 300_000, now = Date.now } = {}) {
+        this.#context = context;
+        this.#idleMs = idleMs;
+        this.#maxAgeMs = maxAgeMs;
+        this.#now = now;
+    }
+    use(name, body) {
+        const turn = this.#queue.then(() => this.#call(name, body));
+        this.#queue = turn.catch(() => { });
+        return turn;
+    }
+    async close() {
+        this.#closed = true;
+        await this.#queue;
+        await this.#release();
+    }
+    async #call(name, body) {
+        if (this.#closed)
+            throw new Error("the MCP server is shutting down");
+        clearTimeout(this.#idle);
+        try {
+            return await this.#context.run(name, async (events) => {
+                this.#events = events ?? (() => { });
+                return body(await this.#hold(), () => this.#release());
+            });
+        }
+        catch (error) {
+            if (!(isCliError(error) && HARMLESS.has(error.code)))
+                await this.#release();
+            throw error;
+        }
+        finally {
+            this.#events = () => { };
+            if (this.#held) {
+                this.#idle = setTimeout(() => void this.#release(), this.#idleMs);
+                this.#idle.unref();
+            }
+        }
+    }
+    async #hold() {
+        if (this.#held && this.#now() - this.#held.openedAt >= this.#maxAgeMs)
+            await this.#release();
+        if (this.#held)
+            return this.#held.client;
+        const { settings, renderer, createClient } = this.#context;
+        const cache = await openProfileCache(settings.profile, { onProblem: (message) => renderer.note(message) });
+        const client = createClient({ events: (event) => this.#events(event), ...(cache ? { cache } : {}) });
+        this.#held = { client, cache, openedAt: this.#now() };
+        return client;
+    }
+    async #release() {
+        clearTimeout(this.#idle);
+        const held = this.#held;
+        this.#held = undefined;
+        if (!held)
+            return;
+        try {
+            await held.client.close();
+        }
+        finally {
+            held.cache?.close();
+        }
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/mcp/session.js.map

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

package/dist/mcp/tools.d.ts

@@ -0,0 +1,15 @@
+import { type McpServer } from "@modelcontextprotocol/server";
+import type { Permission } from "../sends/permissions.js";
+import type { MaxSession } from "./session.js";
+export declare const registerTools: (server: McpServer, session: MaxSession, { allowSend, confirmSend, allowMarkRead, allowDelete, defaultLimit, profile, transcribeModel, permitted, }: {
+    allowSend: boolean;
+    confirmSend?: boolean;
+    allowMarkRead?: boolean;
+    allowDelete?: boolean;
+    defaultLimit: number;
+    profile: string;
+    transcribeModel?: string;
+    /** What the profile allows; `undefined` is everything. The guard refuses anyway — this only hides. */
+    permitted?: readonly Permission[];
+}) => void;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,SAAS,EAGf,MAAM,8BAA8B,CAAA;AAQrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAKzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAyX9C,eAAO,MAAM,aAAa,GACxB,QAAQ,SAAS,EACjB,SAAS,UAAU,EACnB,4GASG;IACD,SAAS,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,sGAAsG;IACtG,SAAS,CAAC,EAAE,SAAS,UAAU,EAAE,CAAA;CAClC,KACA,IAuCF,CAAA"}

package/dist/mcp/tools.js

@@ -0,0 +1,351 @@
+import { CliError, isCliError } from "@leemour/cli-core";
+import { isInputRequiredResult, } from "@modelcontextprotocol/server";
+import { toStandardJsonSchema } from "@valibot/to-json-schema";
+import * as v from "valibot";
+import { openProfileCache } from "../cache/index.js";
+import { DELETE_AT_ONCE } from "../client.js";
+import { sendTime } from "../config.js";
+import { maskedProfile } from "../domain/map.js";
+import { transcribe } from "../transcribe/index.js";
+import { modelsDirectory } from "../transcribe/install.js";
+import { DEFAULT_MODEL, speechModel } from "../transcribe/models.js";
+import { confirmer, sendOptions } from "./confirm.js";
+const chat = v.pipe(v.string(), v.minLength(1), v.description("chat id, or part of a chat name"));
+const message = v.pipe(v.string(), v.regex(/^\d+$/), v.description("message id"));
+const limit = v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(100), v.description("how many")));
+const page = v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.description("which page, from 1")));
+const READ = { readOnlyHint: true, destructiveHint: false, openWorldHint: true };
+const WRITE = {
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: false,
+    openWorldHint: true,
+};
+const APPROVE = { "anthropic/requiresUserInteraction": true };
+/** Typed where it is written; erased here because the SDK checks the arguments against `input` first. */
+const tool = (definition) => definition;
+/** The same envelope `--json` prints for every listing. */
+const envelope = ({ items, hasMore }, pageNumber, pageSize) => ({
+    items,
+    page: pageNumber,
+    limit: pageSize,
+    hasMore,
+});
+const window = (args, defaults) => {
+    const size = args.limit ?? defaults.limit;
+    const number = args.page ?? 1;
+    return { size, number, request: { limit: size, offset: (number - 1) * size } };
+};
+const READ_TOOLS = {
+    max_account_show: tool({
+        title: "Who this is",
+        description: "The MAX account this server is logged in as.",
+        input: v.object({}),
+        annotations: { ...READ, idempotentHint: true },
+        // Always masked: an agent has no reason to hold the owner's number (`NEED-209`).
+        answer: async (client) => maskedProfile(await client.account.me()),
+    }),
+    max_chats_list: tool({
+        title: "List chats",
+        description: "Chats the owner is in, most recent first. Use it to find a chat's id before reading or sending. " +
+            "Returns { items, page, limit, hasMore }.",
+        input: v.object({
+            search: v.optional(v.pipe(v.string(), v.minLength(3), v.description("only chats whose name contains this"))),
+            kind: v.optional(v.picklist(["dialog", "group", "channel"])),
+            unread: v.optional(v.pipe(v.boolean(), v.description("only chats with unread messages"))),
+            limit,
+            page,
+        }),
+        annotations: READ,
+        answer: async (client, { search: query, kind, unread, ...paging }, defaults) => {
+            const { size, number, request } = window(paging, defaults);
+            const found = await client.chats.list({
+                ...request,
+                ...(query === undefined ? {} : { query }),
+                ...(kind === undefined ? {} : { kind }),
+                ...(unread === true ? { unread } : {}),
+            });
+            return envelope(found, number, size);
+        },
+    }),
+    max_chats_show: tool({
+        title: "Show a chat",
+        description: "One chat: its kind, unread count, last message time and who is in it.",
+        input: v.object({ chat }),
+        annotations: READ,
+        answer: (client, args) => client.chats.show(args.chat),
+    }),
+    max_contacts_list: tool({
+        title: "List contacts",
+        description: "People the owner has a one-to-one chat with. Returns { items, page, limit, hasMore }.",
+        input: v.object({
+            search: v.optional(v.pipe(v.string(), v.minLength(3), v.description("only people whose name contains this"))),
+            order: v.optional(v.picklist(["recent", "name"])),
+            limit,
+            page,
+        }),
+        annotations: READ,
+        answer: async (client, { search: query, order, ...paging }, defaults) => {
+            const { size, number, request } = window(paging, defaults);
+            const found = await client.contacts.list({
+                ...request,
+                ...(query === undefined ? {} : { query }),
+                ...(order === undefined ? {} : { order }),
+            });
+            return envelope(found, number, size);
+        },
+    }),
+    max_contacts_show: tool({
+        title: "Show a person",
+        description: "One person and the chats shared with them.",
+        input: v.object({
+            person: v.pipe(v.string(), v.minLength(1), v.description("person id, @username, or part of a name")),
+        }),
+        annotations: READ,
+        answer: (client, args) => client.contacts.show(args.person),
+    }),
+    max_messages_scheduled: tool({
+        title: "Messages scheduled in a chat",
+        description: "Messages waiting to be sent later in a chat, soonest first, each with `scheduledFor`. " +
+            "Check here after a scheduled send ended in outcome_unknown. Cancelling is done in the MAX app.",
+        input: v.object({ chat }),
+        annotations: READ,
+        answer: async (client, args) => client.messages.scheduled(await client.chats.resolve(args.chat)),
+    }),
+    max_messages_list: tool({
+        title: "Read a chat",
+        description: "Recent messages in a chat, oldest first. Does not mark anything read. For older messages pass " +
+            "`before` = the id of the first item; for newer, `after` = the id of the last. Returns { items, page, limit, hasMore }.",
+        input: v.object({
+            chat,
+            limit,
+            before: v.optional(v.pipe(v.string(), v.description("a message id or an ISO 8601 time"))),
+            after: v.optional(v.pipe(v.string(), v.description("a message id or an ISO 8601 time; not with before"))),
+        }),
+        annotations: READ,
+        answer: async (client, args, defaults) => {
+            if (args.before !== undefined && args.after !== undefined) {
+                throw new CliError("validation_error", "before and after are two directions; give one of them");
+            }
+            const size = args.limit ?? defaults.limit;
+            const chatId = await client.chats.resolve(args.chat);
+            const anchor = args.after !== undefined
+                ? { after: client.messages.moment(args.after, "after") }
+                : args.before !== undefined
+                    ? { before: client.messages.moment(args.before, "before") }
+                    : {};
+            return envelope(await client.messages.list(chatId, { limit: size, ...anchor }), 1, size);
+        },
+    }),
+    max_messages_search: tool({
+        title: "Search messages",
+        description: "Find messages in what this machine has already read — it never asks MAX, so an empty answer means " +
+            '"not in what was read", not "never said". Returns { items, page, limit, hasMore }.',
+        input: v.object({
+            text: v.pipe(v.string(), v.minLength(3), v.description("what to look for; at least 3 characters")),
+            chat: v.optional(v.pipe(v.string(), v.regex(/^-?\d+$/), v.description("only this chat, by id"))),
+            limit,
+        }),
+        annotations: { ...READ, openWorldHint: false },
+        answer: async (client, args, defaults) => {
+            const size = args.limit ?? defaults.limit;
+            const found = await client.messages.search(args.text, {
+                limit: size,
+                ...(args.chat === undefined ? {} : { chatId: args.chat }),
+            });
+            return envelope(found, 1, size);
+        },
+    }),
+    max_messages_transcribe: tool({
+        title: "Transcribe a voice message",
+        description: "The text of one voice message, heard on the owner's machine by a local speech model; the recording goes " +
+            "nowhere. Up to a minute for five minutes of speech; asked again, it answers from the cache. Refuses when " +
+            "the model is not downloaded: the owner runs `max models audio download <id>` in a terminal.",
+        input: v.object({ chat, message }),
+        annotations: READ,
+        answer: async (client, args, { profile, transcribeModel, release }) => {
+            const model = speechModel(transcribeModel);
+            const directory = modelsDirectory();
+            const chatId = await client.chats.resolve(args.chat);
+            // Its own handle: `release` closes the session's, and the text is saved after that.
+            const cache = await openProfileCache(profile);
+            try {
+                return await transcribe(client, chatId, args.message, { model, directory, cache, release });
+            }
+            finally {
+                cache?.close();
+            }
+        },
+    }),
+    max_messages_context: tool({
+        title: "Show a message",
+        description: "One message by id, and optionally the messages either side of it, oldest first. The one asked for " +
+            "carries anchor: true.",
+        input: v.object({
+            chat,
+            message,
+            before: v.optional(v.pipe(v.number(), v.integer(), v.minValue(0), v.maxValue(100))),
+            after: v.optional(v.pipe(v.number(), v.integer(), v.minValue(0), v.maxValue(100))),
+        }),
+        annotations: READ,
+        answer: async (client, args) => {
+            const chatId = await client.chats.resolve(args.chat);
+            return {
+                items: await client.messages.around(chatId, args.message, { before: args.before ?? 0, after: args.after ?? 0 }),
+            };
+        },
+    }),
+};
+/**
+ * Registered only with `--allow-send`, so a server started without it has no way to write at all —
+ * not a refusal at call time, an absence from the list.
+ *
+ * `requiresUserInteraction` is Claude Code's: an approval dialog on every call that allow-rules do
+ * not skip. Other clients ask by `destructiveHint` or `readOnlyHint`.
+ */
+const SEND_TOOLS = {
+    max_messages_send: tool({
+        title: "Send a message",
+        description: "Send one text message as the owner. Only when the owner asked for this exact text to this exact chat. " +
+            "A name that matches several chats is refused with the candidates — pick an id, never guess. " +
+            "On outcome_unknown, retry with the cid it returns and MAX drops the duplicate. " +
+            "With `at`, MAX sends it later and the answer carries `scheduledFor`; never retry a scheduled send — " +
+            "read max_messages_scheduled instead.",
+        input: v.object({
+            chat,
+            text: v.pipe(v.string(), v.minLength(1)),
+            silent: v.optional(v.pipe(v.boolean(), v.description("deliver without a notification"))),
+            cid: v.optional(v.pipe(v.number(), v.integer(), v.description("from an earlier outcome_unknown"))),
+            at: v.optional(v.pipe(v.string(), v.description("send later: 2026-09-25T09:00 (owner's local time) or 30m, 2h, 1d; 1 minute to 1 year ahead"))),
+        }),
+        annotations: WRITE,
+        _meta: APPROVE,
+        answer: async (client, args) => {
+            const at = args.at === undefined ? undefined : sendTime(args.at);
+            const chatId = await client.chats.resolve(args.chat);
+            return client.messages.send(chatId, args.text, sendOptions(args, at));
+        },
+    }),
+    max_messages_edit: tool({
+        title: "Edit a message",
+        description: "Replace the text of one of the owner's own messages. Only when the owner asked for this exact change. " +
+            "The other person may have read the old text already. Attachments stay.",
+        input: v.object({ chat, message, text: v.pipe(v.string(), v.minLength(1)) }),
+        annotations: WRITE,
+        _meta: APPROVE,
+        answer: async (client, args) => client.messages.edit(await client.chats.resolve(args.chat), args.message, args.text),
+    }),
+    max_messages_forward: tool({
+        title: "Forward a message",
+        description: "Forward one message to another chat as the owner. Only when the owner asked for this message to this chat. " +
+            "On outcome_unknown, retry with the cid it returns and MAX drops the duplicate.",
+        input: v.object({
+            chat: v.pipe(chat, v.description("the chat the message is in")),
+            message,
+            to: v.pipe(chat, v.description("the chat to forward it to")),
+            cid: v.optional(v.pipe(v.number(), v.integer(), v.description("from an earlier outcome_unknown"))),
+        }),
+        annotations: WRITE,
+        _meta: APPROVE,
+        answer: async (client, args) => client.messages.forward(await client.chats.resolve(args.chat), args.message, await client.chats.resolve(args.to), args.cid === undefined ? {} : { cid: args.cid }),
+    }),
+    max_messages_pin: tool({
+        title: "Pin a message",
+        description: "Pin one message in a chat, replacing what was pinned. Members are not notified.",
+        input: v.object({ chat, message }),
+        annotations: WRITE,
+        _meta: APPROVE,
+        answer: async (client, args) => client.messages.pin(await client.chats.resolve(args.chat), args.message),
+    }),
+    max_messages_unpin: tool({
+        title: "Unpin a message",
+        description: "Unpin whatever message is pinned in a chat.",
+        input: v.object({ chat }),
+        annotations: WRITE,
+        _meta: APPROVE,
+        answer: async (client, args) => client.messages.pin(await client.chats.resolve(args.chat), null),
+    }),
+};
+/** Registered only with `--allow-mark-read`: the other person sees it, and `--allow-send` does not imply it. */
+/** Which profile permission each writing tool needs (`CLI-37`). */
+const TOOL_PERMISSION = {
+    max_messages_send: "send",
+    max_messages_edit: "edit",
+    max_messages_forward: "forward",
+    max_messages_pin: "pin",
+    max_messages_unpin: "pin",
+    max_chats_read: "read",
+    max_messages_delete: "delete",
+};
+const MARK_READ_TOOLS = {
+    max_chats_read: tool({
+        title: "Mark a chat read",
+        description: "Mark a chat read up to a message, or up to its newest message. The other person sees that it was read. Only when the owner asked for it.",
+        input: v.object({ chat, message: v.optional(message) }),
+        annotations: WRITE,
+        _meta: APPROVE,
+        answer: async (client, args) => client.chats.markRead(await client.chats.resolve(args.chat), args.message),
+    }),
+};
+/**
+ * Registered only with `--allow-delete`, which `--allow-send` does not imply, and only for the owner:
+ * deleting for everyone is the command's alone (`NEED-240`). The server's flag is the owner's word.
+ */
+const DELETE_TOOLS = {
+    max_messages_delete: tool({
+        title: "Delete messages for the owner",
+        description: `Delete up to ${DELETE_AT_ONCE} messages from the owner's view of a chat; the other people still see them. ` +
+            "Cannot be undone. Only when the owner asked for these exact messages to be deleted.",
+        input: v.object({ chat, messages: v.pipe(v.array(message), v.minLength(1), v.maxLength(DELETE_AT_ONCE)) }),
+        annotations: WRITE,
+        _meta: APPROVE,
+        answer: async (client, args) => client.messages.delete(await client.chats.resolve(args.chat), args.messages),
+    }),
+};
+const answered = (value) => ({
+    content: [{ type: "text", text: JSON.stringify(value) }],
+    structuredContent: value,
+});
+/** The same object the CLI prints on stderr, so an agent reads one error shape from both. */
+const failed = (error) => {
+    const body = isCliError(error)
+        ? { code: error.code, message: error.message, ...error.details }
+        : { code: "generic_failure", message: error instanceof Error ? error.message : String(error) };
+    return {
+        content: [{ type: "text", text: JSON.stringify({ error: body }) }],
+        structuredContent: { error: body },
+        isError: true,
+    };
+};
+export const registerTools = (server, session, { allowSend, confirmSend = false, allowMarkRead = false, allowDelete = false, defaultLimit, profile, transcribeModel = DEFAULT_MODEL, permitted, }) => {
+    const confirmed = confirmSend ? confirmer() : undefined;
+    const offered = {
+        ...(allowSend ? SEND_TOOLS : {}),
+        ...(allowMarkRead ? MARK_READ_TOOLS : {}),
+        ...(allowDelete ? DELETE_TOOLS : {}),
+    };
+    const tools = {
+        ...READ_TOOLS,
+        ...Object.fromEntries(Object.entries(offered).filter(([name]) => !permitted || permitted.includes(TOOL_PERMISSION[name]))),
+    };
+    for (const [name, definition] of Object.entries(tools)) {
+        server.registerTool(name, {
+            title: definition.title,
+            description: definition.description,
+            inputSchema: toStandardJsonSchema(definition.input),
+            annotations: definition.annotations,
+            ...(definition._meta ? { _meta: definition._meta } : {}),
+        }, async (args, ctx) => {
+            try {
+                const result = await session.use(name.replace(/^max_/, "mcp ").replaceAll("_", " "), (client, release) => confirmed && name === "max_messages_send"
+                    ? confirmed(client, args, ctx)
+                    : definition.answer(client, args, { limit: defaultLimit, profile, transcribeModel, release }));
+                return isInputRequiredResult(result) ? result : answered(result);
+            }
+            catch (error) {
+                return failed(error);
+            }
+        });
+    }
+};
+//# 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/program.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0D,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAA;AACxG,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAA;AAOnD,OAAO,EAAE,KAAK,WAAW,EAAW,MAAM,uBAAuB,CAAA;AAajE,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,mGAAmG;IACnG,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC7B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,eAAc,cAAmB,KAAG,OA4DjE,CAAA;AAOD;;;;;;GAMG;AACH,eAAO,MAAM,GAAG,GAAU,MAAM,MAAM,EAAE,EAAE,UAAS,UAAe,KAAG,OAAO,CAAC,MAAM,CA+DlF,CAAA"}
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,OAAO,EAEb,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAA;AAQnD,OAAO,EAAE,KAAK,WAAW,EAAW,MAAM,uBAAuB,CAAA;AAoBjE,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,mGAAmG;IACnG,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC7B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,eAAc,cAAmB,KAAG,OAqEjE,CAAA;AAOD;;;;;;GAMG;AACH,eAAO,MAAM,GAAG,GAAU,MAAM,MAAM,EAAE,EAAE,UAAS,UAAe,KAAG,OAAO,CAAC,MAAM,CAmElF,CAAA"}

package/dist/program.js

@@ -1,22 +1,30 @@
-import { CliError, exitCodeFor, GENERIC_FAILURE, processStreams } from "@leemour/cli-core";
+import { CliError, exitCodeFor, GENERIC_FAILURE, processStreams, visibleControls, } from "@leemour/cli-core";
 import { Command, CommanderError } from "commander";
 import { accountCommand } from "./commands/account.js";
 import { cacheCommand } from "./commands/cache.js";
 import { chatsCommand } from "./commands/chats.js";
 import { commandsCommand } from "./commands/commands.js";
+import { completeCommand } from "./commands/complete.js";
 import { configCommand } from "./commands/config.js";
 import { contactsCommand } from "./commands/contacts.js";
 import { provide } from "./commands/context.js";
 import { doctorCommand } from "./commands/doctor.js";
+import { exportCommand } from "./commands/export.js";
 import { inboxCommand } from "./commands/inbox.js";
+import { mcpCommand } from "./commands/mcp.js";
 import { messagesCommand } from "./commands/messages.js";
+import { modelsCommand } from "./commands/models.js";
 import { reactionsCommand } from "./commands/reactions.js";
 import { recipientsCommand } from "./commands/recipients.js";
 import { runsCommand } from "./commands/runs.js";
 import { sendsCommand } from "./commands/sends.js";
+import { serveCommand } from "./commands/serve.js";
 import { sessionCommand } from "./commands/session.js";
 import { skillCommand } from "./commands/skill.js";
+import { selfUpdateCommand } from "./commands/update.js";
+import { watchCommand } from "./commands/watch.js";
 import { commandWords, liftProfile } from "./profile.js";
+import { updateNotice } from "./update.js";
 import { VERSION } from "./version.js";
 /**
  * The command tree, built fresh on each call.
@@ -43,6 +51,8 @@ export const createProgram = ({ out, err } = {}) => {
         .option("--offline", "answer from what was recorded and never connect; fails if nothing was")
         .option("--record", "keep this run under `max runs` — ids and timings, never message content")
         .option("--no-record", "do not keep it, whatever the configuration says")
+        .option("--serve", "start `max serve` in the background if it is not running (the default)")
+        .option("--no-serve", "do not start it; log in on this command's own connection unless one is running")
         .showHelpAfterError();
     // One resource per command, one action per subcommand — `max chats list`, `max messages send`.
     // The shape `braze-cli` uses, and the reason there is no `max send`: an action is never a
@@ -52,16 +62,23 @@ export const createProgram = ({ out, err } = {}) => {
     program.addCommand(chatsCommand());
     program.addCommand(contactsCommand());
     program.addCommand(messagesCommand());
+    program.addCommand(exportCommand());
+    program.addCommand(modelsCommand());
     program.addCommand(reactionsCommand());
     program.addCommand(recipientsCommand());
     program.addCommand(sendsCommand());
     program.addCommand(inboxCommand());
+    program.addCommand(serveCommand());
+    program.addCommand(watchCommand());
     program.addCommand(configCommand());
     program.addCommand(doctorCommand());
     program.addCommand(cacheCommand());
     program.addCommand(runsCommand());
     program.addCommand(skillCommand());
     program.addCommand(commandsCommand());
+    program.addCommand(selfUpdateCommand());
+    program.addCommand(completeCommand(), { hidden: true });
+    program.addCommand(mcpCommand());
     // Depth-first: Commander does not pass `configureOutput` down to a command added with
     // `addCommand`, so `max messages --help` would write to the real terminal while the top level
     // wrote to the injected streams — and a test reading stdout would see nothing at all.
@@ -117,8 +134,12 @@ export const run = async (argv, options = {}) => {
         });
         return exitCodeFor("validation_error");
     }
+    const notice = updateNotice(rest, { tty: options.tty, environment: options.update });
     try {
         await program.parseAsync(rest, { from: "user" });
+        const line = await notice;
+        if (line)
+            streams.diagnostic(line);
         return process.exitCode === undefined ? 0 : Number(process.exitCode);
     }
     catch (error) {
@@ -148,6 +169,6 @@ export const run = async (argv, options = {}) => {
  */
 const report = (streams, options, error) => {
     const interactive = options.tty ?? process.stdout.isTTY === true;
-    streams.diagnostic(interactive ? `\u2717 ${error.message}` : JSON.stringify({ error }));
+    streams.diagnostic(interactive ? `\u2717 ${visibleControls(error.message)}` : JSON.stringify({ error }));
 };
 //# sourceMappingURL=program.js.map