@wirecat/max-cli 0.0.0-stage → 0.42.0

package/dist/commands/serve.js

@@ -0,0 +1,79 @@
+import { writeFileSync } from "node:fs";
+import { CliError } from "@wirecat/cli-core";
+import { holdLock, lockPath, releaseLock } from "@wirecat/cli-messaging/background";
+import { Command, Option } from "commander";
+import { MAX_APP } from "../app.js";
+import { parseDuration } from "../config.js";
+import { asFirstWord } from "../profile.js";
+import { MaxServer, refusedLogin } from "../server/server.js";
+import { refusedPath } from "../server/start.js";
+import { VERSION } from "../version.js";
+import { forCommand } from "./context.js";
+import { serveMembers } from "./serve-members.js";
+import { serveStems } from "./serve-stems.js";
+/**
+ * `max serve` — stays up, holding one logged-in connection, until Ctrl-C (`MAX-16`).
+ *
+ * Typed by hand it runs in the foreground until stopped. **Any command that needs MAX starts one
+ * in the background when none is running** (`serve` setting, `--no-serve` to decline), and that
+ * one is given `--idle`, so it does not outlive the work that started it.
+ */
+export const serveCommand = () => new Command("serve")
+    .description("stay connected to MAX and stream new messages to `max watch`, until Ctrl-C")
+    .option("--idle <duration>", "stop after this long with nobody using it — 15m, 1h is 60m")
+    .addOption(new Option("--started-by-command").hideHelp())
+    .action(async function () {
+    const { idle, startedByCommand = false } = this.opts();
+    const { renderer, settings, store, run, format, streams, track } = forCommand(this);
+    const idleMs = idle === undefined ? undefined : parseDuration(idle, "--idle");
+    await run("serve", async (events) => {
+        const note = (line) => format === "pretty"
+            ? renderer.note(line)
+            : streams.diagnostic(JSON.stringify({ time: new Date().toISOString(), note: line }));
+        const server = new MaxServer({
+            store,
+            members: (client) => serveMembers({ client, store, note }),
+            // Unwatched — a log file, systemd — each line says when, or "connecting again in 60s" means nothing.
+            note,
+            ...(events ? { events } : {}),
+            ...(settings.timeoutMs ? { timeoutMs: settings.timeoutMs } : {}),
+            ...(idleMs === undefined ? {} : { idleMs }),
+            startedByCommand,
+        });
+        track({
+            close: async () => {
+                const settled = server.done.catch(() => { });
+                await server.stop(new CliError("cancelled", "serve stopped by command cancellation"));
+                await settled;
+            },
+        });
+        const stop = () => void server.stop();
+        process.once("SIGINT", stop);
+        process.once("SIGTERM", stop);
+        // Not how max finds its server — the socket is — but what the shared store commands look for.
+        const lock = lockPath(MAX_APP, store.profile, process.env);
+        const startedAt = new Date().toISOString();
+        const stems = serveStems({ note });
+        try {
+            await server.start();
+            stems.start();
+            holdLock(lock, { pid: process.pid, startedAt, listeningAt: new Date().toISOString(), version: VERSION });
+            renderer.note(`connected — \`max ${asFirstWord(settings.profile)}watch\` in another terminal shows new messages`);
+            await server.done;
+        }
+        catch (error) {
+            await server.stop();
+            if (refusedLogin(error)) {
+                writeFileSync(refusedPath(store), `${new Date().toISOString()}\n`, { mode: 0o600 });
+            }
+            throw error;
+        }
+        finally {
+            await stems.stop().catch(() => note("filling search stems could not close its store"));
+            releaseLock(lock);
+            process.off("SIGINT", stop);
+            process.off("SIGTERM", stop);
+        }
+    });
+});
+//# sourceMappingURL=serve.js.map

package/dist/commands/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAA;AACnF,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAY,EAAE,CACxC,IAAI,OAAO,CAAC,OAAO,CAAC;KACjB,WAAW,CAAC,4EAA4E,CAAC;KACzF,MAAM,CAAC,mBAAmB,EAAE,4DAA4D,CAAC;KACzF,SAAS,CAAC,IAAI,MAAM,CAAC,sBAAsB,CAAC,CAAC,QAAQ,EAAE,CAAC;KACxD,MAAM,CAAC,KAAK;IACX,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC,IAAI,EAAiD,CAAA;IACrG,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;IACnF,MAAM,MAAM,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAE7E,MAAM,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAClC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAC5B,MAAM,KAAK,QAAQ;YACjB,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YACrB,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QACxF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;YAC3B,KAAK;YACL,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YAC1D,qGAAqG;YACrG,IAAI;YACJ,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;YAC3C,gBAAgB;SACjB,CAAC,CAAA;QACF,KAAK,CAAC;YACJ,KAAK,EAAE,KAAK,IAAI,EAAE;gBAChB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;gBAC3C,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,WAAW,EAAE,uCAAuC,CAAC,CAAC,CAAA;gBACrF,MAAM,OAAO,CAAA;YACf,CAAC;SACF,CAAC,CAAA;QAEF,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAA;QACrC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QAC5B,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QAC7B,8FAA8F;QAC9F,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;QAC1D,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,CAAA;QAClC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;YACpB,KAAK,CAAC,KAAK,EAAE,CAAA;YACb,QAAQ,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;YACxG,QAAQ,CAAC,IAAI,CACX,qBAAqB,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,gDAAgD,CACnG,CAAA;YACD,MAAM,MAAM,CAAC,IAAI,CAAA;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;YACnB,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxB,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;YACrF,CAAC;YACD,MAAM,KAAK,CAAA;QACb,CAAC;gBAAS,CAAC;YACT,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC,CAAA;YACtF,WAAW,CAAC,IAAI,CAAC,CAAA;YACjB,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;YAC3B,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QAC9B,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/commands/server.d.ts

@@ -0,0 +1,16 @@
+import { type ServerOptions } from "@wirecat/cli-messaging/cli";
+import type { Command } from "commander";
+import { SessionStore } from "../session/store.js";
+/**
+ * The exit codes of a login MAX refused (`refusedLogin`). A unit that restarted on them would log in
+ * again every 30 s, each one counted against the account.
+ */
+export declare const NO_RESTART_ON: number[];
+/**
+ * max's server is found and stopped through its socket, not a lock file: whoever binds the socket is
+ * the profile's one server, and it says itself whether a command started it.
+ */
+export declare const maxServerOptions: (storeFor?: (profile: string, env: NodeJS.ProcessEnv) => SessionStore) => ServerOptions;
+/** `max server` — the shared group; `max serve` stays the foreground form a unit runs (`CLI-38`). */
+export declare const serverCommand: () => Command;
+//# sourceMappingURL=server.d.ts.map

package/dist/commands/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/commands/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAwC,MAAM,4BAA4B,CAAA;AACrG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAIxC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElD;;;GAGG;AACH,eAAO,MAAM,aAAa,UAAyF,CAAA;AAEnH;;;GAGG;AACH,eAAO,MAAM,gBAAgB,cACjB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,YAAY,KAElE,aAkCD,CAAA;AAEF,qGAAqG;AACrG,eAAO,MAAM,aAAa,QAAO,OAAgE,CAAA"}

package/dist/commands/server.js

@@ -0,0 +1,51 @@
+import { CliError, exitCodeFor } from "@wirecat/cli-core";
+import { serverCommand as sharedServerCommand } from "@wirecat/cli-messaging/cli";
+import { maxMessenger } from "../messenger.js";
+import { serverStatus, stopServer } from "../server/server-connection.js";
+import { logPath, startInBackground } from "../server/start.js";
+import { SessionStore } from "../session/store.js";
+/**
+ * The exit codes of a login MAX refused (`refusedLogin`). A unit that restarted on them would log in
+ * again every 30 s, each one counted against the account.
+ */
+export const NO_RESTART_ON = ["authentication_error", "rate_limited", "provider_error"].map(exitCodeFor);
+/**
+ * max's server is found and stopped through its socket, not a lock file: whoever binds the socket is
+ * the profile's one server, and it says itself whether a command started it.
+ */
+export const maxServerOptions = (storeFor = (profile, env) => new SessionStore({ profile, env })) => ({
+    process: ({ profile, env }) => {
+        const store = storeFor(profile, env);
+        return {
+            probe: async () => {
+                const status = await serverStatus(store.socketPath());
+                if (typeof status?.pid !== "number")
+                    return undefined;
+                return {
+                    pid: status.pid,
+                    startedAt: typeof status.startedAt === "string" ? status.startedAt : new Date().toISOString(),
+                    connected: status.connected === true,
+                    ...(typeof status.version === "string" ? { version: status.version } : {}),
+                    byCommand: status.byHand !== true,
+                };
+            },
+            launch: (args, extra) => {
+                const pid = startInBackground(store, { serveArgs: args, env: extra });
+                if (pid === undefined) {
+                    throw new CliError("validation_error", "no session to start with, or a server is already being started — try again");
+                }
+                return pid;
+            },
+            stop: async () => {
+                await stopServer(store.socketPath(), { force: true });
+            },
+        };
+    },
+    logPath: ({ profile, env }) => logPath(storeFor(profile, env)),
+    serveArgv: ["--no-record", "serve"],
+    idle: true,
+    unit: { purpose: "hold this profile's one connection to MAX", noRestartOn: NO_RESTART_ON },
+});
+/** `max server` — the shared group; `max serve` stays the foreground form a unit runs (`CLI-38`). */
+export const serverCommand = () => sharedServerCommand(maxMessenger, maxServerOptions());
+//# sourceMappingURL=server.js.map

package/dist/commands/server.js.map

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

package/dist/commands/session.d.ts

@@ -0,0 +1,15 @@
+import { Command } from "commander";
+import { type MaxClientOptions } from "../client.js";
+import { type CommandContext } from "./context.js";
+export declare const TERMS_NOTICE: string;
+export declare const sessionCommand: () => Command;
+declare const METHODS: readonly ["token", "qr", "qr-chrome", "sms"];
+export type Method = (typeof METHODS)[number];
+export declare const startSession: (context: CommandContext, method: Method, events: MaxClientOptions["events"]) => Promise<{
+    profile: import("@wirecat/cli-messaging").Profile;
+    stored: boolean;
+    method: "qr" | "qr-chrome" | "sms" | "token";
+    firstLogin: boolean;
+}>;
+export {};
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/commands/session.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,OAAO,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAkB,KAAK,gBAAgB,EAAqB,MAAM,cAAc,CAAA;AAOvF,OAAO,EAAE,KAAK,cAAc,EAAc,MAAM,cAAc,CAAA;AAG9D,eAAO,MAAM,YAAY,QAGb,CAAA;AAEZ,eAAO,MAAM,cAAc,QAAO,OA8EjC,CAAA;AAkBD,QAAA,MAAM,OAAO,YAAI,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,CAAU,CAAA;AAC5D,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAA;AAE7C,eAAO,MAAM,YAAY,YAAmB,cAAc,UAAU,MAAM,UAAU,gBAAgB,CAAC,QAAQ,CAAC;;;;;EA6B7G,CAAA"}

package/dist/commands/session.js

@@ -0,0 +1,169 @@
+import { CliError, indent } from "@wirecat/cli-core";
+import { annotate } from "@wirecat/cli-core/commands";
+import { Argument, Command } from "commander";
+import { refuseWhilePaused } from "../client.js";
+import { maskedProfile } from "../domain/map.js";
+import { commandWords, refuseCommandName, rootOf } from "../profile.js";
+import { stopServer } from "../server/server-connection.js";
+import { adoptToken } from "../session/adopt.js";
+import { serveQrPage } from "../session/browser.js";
+import { terminalQr } from "../session/qr-terminal.js";
+import { forCommand } from "./context.js";
+// NEED-149: gentle on purpose — it asks for ordinary use alongside, and does not cite blocked accounts.
+export const TERMS_NOTICE = [
+    "max is not the official MAX app, and the MAX terms do not allow automated programs (legal.max.ru/ps, 4.3.7).",
+    "Keep using MAX as usual in the browser or on your phone alongside it. More: docs/security.md",
+].join("\n");
+export const sessionCommand = () => {
+    const command = new Command("session").description("the stored MAX session for this profile");
+    /**
+     * Four ways to a token, and one way to keep it: whatever produced the token, it reaches the
+     * keyring only once MAX has accepted it (`adoptToken`).
+     *
+     * - `token` — pasted, or piped: `pass show max | max session start`. The default, and the escape
+     *   hatch when a login meets a captcha or an unusual second factor.
+     * - `qr` — our own connection asks MAX for the code; it is drawn here, or opened in the default
+     *   browser when the terminal is too narrow for it.
+     * - `qr-chrome`, `sms` — web.max.ru itself does the login, in a Chromium-family browser with a
+     *   throwaway profile, and we read the token it stores. MAX sees its own web client. SMS has no
+     *   other door: asked over our socket, MAX demands a captcha only the page can solve (2026-09-24).
+     *
+     * **A token is never an argument.** argv is read by `ps` and kept by shell history.
+     */
+    command
+        .command("start")
+        .description("log this profile in to MAX")
+        .addHelpText("after", "\nFirst time: run `max setup --agent codex` for guided login and agent setup.\n" +
+        "Examples:\n  max session start qr          Scan a QR with MAX on your phone\n" +
+        "  max session start qr-chrome   Log in through web.max.ru in Chromium\n" +
+        "  max session start sms         Enter your phone number in that browser\n" +
+        "  max work session start        Import a token at a hidden prompt\n" +
+        "\nAn interrupted first setup can be resumed with `max setup`.\n" +
+        "For an expired session, explicitly log in again with `max session start qr`.\n" +
+        "Agents: read `max skill show` before login. QR/browser login needs a local terminal.\n" +
+        "Never put tokens or passwords in command arguments.\n")
+        .addArgument(new Argument("[method]", "token (pasted or piped), qr, qr-chrome or sms").choices(METHODS).default("token"))
+        .action(async function (method) {
+        const context = forCommand(this);
+        const { renderer, run } = context;
+        refuseCommandName(context.settings.profile, commandWords(rootOf(this)));
+        await run("session start", async (events) => {
+            const { firstLogin, ...answer } = await startSession(context, method, events);
+            renderer.result(answer);
+            renderer.success(`logged in as ${answer.profile.name ?? answer.profile.id}`);
+            if (firstLogin)
+                renderer.note(TERMS_NOTICE);
+            if (await context.shareServer())
+                renderer.note("`max serve` is up on the new session");
+        });
+    });
+    /**
+     * Ends the session on MAX's side (LOGOUT, opcode 20), then forgets it here, as `tg session end` does
+     * (`NEED-821` A). A token copied from a browser tab is that tab's session, so the tab is logged out too.
+     */
+    annotate(command.command("end"), { mutates: true })
+        .description("log this profile out on MAX's side and forget the session here")
+        .action(async function () {
+        const { renderer, store, run, createClient } = forCommand(this);
+        await run("session end", async (events) => {
+            if (store.readToken() === undefined) {
+                renderer.result({ profile: store.profile, forgotten: false, revokedOnServer: false });
+                renderer.note(`there was no session for "${store.profile}"`);
+                return;
+            }
+            // A server still logged in with the forgotten session would keep using it.
+            const server = await stopServer(store.socketPath());
+            if (server === "refused") {
+                renderer.note("a `max serve` you started by hand is still running with that session — Ctrl-C it");
+            }
+            const revokedOnServer = await logOut(createClient({ events }));
+            const had = store.forget();
+            renderer.result({ profile: store.profile, forgotten: had, revokedOnServer });
+            renderer.success(`logged "${store.profile}" out of MAX and forgot the session here`);
+        });
+    });
+    return command;
+};
+/** A token MAX no longer accepts is as logged out as it gets; anything else keeps the session, to try again. */
+const logOut = async (client) => {
+    try {
+        await client.logout();
+        return true;
+    }
+    catch (error) {
+        if (error instanceof CliError && error.code === "authentication_error")
+            return true;
+        throw new CliError(error instanceof CliError ? error.code : "provider_error", `MAX did not log the session out (${error instanceof Error ? error.message : String(error)}); nothing was forgotten — try again`);
+    }
+    finally {
+        await client.close();
+    }
+};
+const METHODS = ["token", "qr", "qr-chrome", "sms"];
+export const startSession = async (context, method, events) => {
+    const { renderer, store, createClient, interactive } = context;
+    if (store.hasLoggedIn())
+        refuseWhilePaused(store.readState());
+    if (method !== "token" && !interactive)
+        throw new CliError("validation_error", `\`session start ${method}\` needs a person at a terminal — use \`session start token\``);
+    if (method !== "token" && process.env.MAX_TOKEN)
+        throw new CliError("validation_error", "MAX_TOKEN is set, and it would outrank the new session — unset it first");
+    const pasted = method === "token"
+        ? process.env.MAX_TOKEN?.trim() || (await context.ask("MAX token: ", { secret: true }))
+        : undefined;
+    if (method === "token" && !pasted)
+        throw new CliError("validation_error", "no token given");
+    context.signal.throwIfAborted();
+    if ((await context.stopServer()) === "stopped")
+        renderer.note("stopped `max serve`; it starts again on the new session");
+    const token = method === "token" ? String(pasted) : await obtain(method, context, events);
+    context.signal.throwIfAborted();
+    const client = createClient({ events }, { own: true });
+    const firstLogin = store.readState().viewerId === undefined;
+    try {
+        await adoptToken(client, store, token);
+        const profile = await client.account.me();
+        return { profile: maskedProfile(profile), stored: true, method, firstLogin };
+    }
+    finally {
+        await client.close();
+    }
+};
+/** Long enough to find the phone and type a number and a code; the profile dies with the wait. */
+const BROWSER_WAIT_MS = 5 * 60_000;
+const QR_INDENT = 2;
+const obtain = async (method, { createClient, renderer, browser, track, ask, streams, columns }, events) => {
+    if (method !== "qr") {
+        renderer.note(method === "qr-chrome"
+            ? "web.max.ru is opening in a separate browser window — scan its QR code with the MAX app on your phone"
+            : "web.max.ru is opening in a separate browser window — choose to log in by phone number there");
+        return await browser.chromiumToken({ track, waitMs: BROWSER_WAIT_MS });
+    }
+    const client = createClient({ events }, { own: true });
+    let page;
+    try {
+        return await client.login.byQr({
+            show: async (link) => {
+                const drawn = terminalQr(link);
+                // Straight to the diagnostic stream, not through the renderer: --quiet must not hide the code.
+                if (columns !== undefined && drawn.width + QR_INDENT <= columns) {
+                    streams.diagnostic(`\n${indent(drawn.text, QR_INDENT)}`);
+                    renderer.note("scan this code with the MAX app on your phone");
+                    return;
+                }
+                page = await serveQrPage(link);
+                track(page);
+                await browser.open(page.url);
+                renderer.note("the terminal is too narrow for the QR code, so it is open in your browser — scan it there");
+            },
+            askPassword: (hint, again) => ask(`${again ? "wrong password, try again" : "MAX password"}${hint ? ` (hint: ${hint})` : ""}: `, {
+                secret: true,
+            }),
+        });
+    }
+    finally {
+        await page?.close();
+        await client.close();
+    }
+};
+//# sourceMappingURL=session.js.map

package/dist/commands/session.js.map

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

package/dist/commands/setup.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const setupCommand: () => Command;
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAA;AA0D3C,eAAO,MAAM,YAAY,QAAO,OAoI1B,CAAA"}

package/dist/commands/setup.js

@@ -0,0 +1,168 @@
+import { accessSync, constants, mkdirSync } from "node:fs";
+import { CliError, indent, renderPretty, resolvePaths } from "@wirecat/cli-core";
+import { annotate } from "@wirecat/cli-core/commands";
+import { installSkill } from "@wirecat/cli-core/skill";
+import { runtime } from "@wirecat/cli-messaging/cli";
+import { Command, Option } from "commander";
+import { maskedProfile } from "../domain/map.js";
+import { asFirstWord, commandWords, refuseCommandName, rootOf } from "../profile.js";
+import { SKILL, SKILL_APP } from "../skill.js";
+import { installer } from "../update.js";
+import { environmentOf, forCommand } from "./context.js";
+import { startSession, TERMS_NOTICE } from "./session.js";
+const AGENTS = ["none", "codex", "cursor", "claude", "gemini", "all"];
+const STEPS = 4;
+const DETAIL = 6;
+const chatCount = (count) => `${count} ${count === 1 ? "chat" : "chats"}`;
+/**
+ * A person sees each step as a heading with its details indented under it. `--quiet` hides both, as it
+ * hides notes; a machine mode keeps the plain notes it always had, since stderr there is a log.
+ */
+const screenFor = (context, quiet) => {
+    const person = context.format === "pretty";
+    const say = (text) => {
+        if (!quiet)
+            context.streams.diagnostic(text);
+    };
+    return {
+        title: (text) => (person ? say(text) : context.renderer.note(text)),
+        step: (index, title) => person ? say(`\n[${index}/${STEPS}] ${title}`) : context.renderer.note(`${index}/${STEPS} — ${title}`),
+        detail: (text) => (person ? say(indent(text, DETAIL)) : context.renderer.note(text)),
+        indent: person ? DETAIL : 0,
+    };
+};
+/** The login's messages, questions and QR code, shifted to sit under their step. */
+const underStep = (context, screen) => ({
+    ...context,
+    renderer: { ...context.renderer, note: screen.detail },
+    ask: (prompt, options) => context.ask(`${" ".repeat(screen.indent)}${prompt}`, options),
+    streams: { ...context.streams, diagnostic: (text) => context.streams.diagnostic(indent(text, screen.indent)) },
+    ...(context.columns === undefined ? {} : { columns: context.columns - screen.indent }),
+});
+const agentFor = async (context, given, pad) => {
+    if (given)
+        return given;
+    if (context.format !== "pretty" || !context.interactive)
+        return "none";
+    const answer = (await context.ask(`${" ".repeat(pad)}Agent [codex/cursor/claude/gemini/all/none] (none): `, {
+        signal: context.signal,
+    }))
+        .trim()
+        .toLowerCase() || "none";
+    if (!AGENTS.includes(answer))
+        throw new CliError("validation_error", `unknown agent — choose ${AGENTS.join(", ")} with --agent`);
+    return answer;
+};
+export const setupCommand = () => annotate(new Command("setup"), { mutates: true })
+    .description("set up your personal MAX account and connect your agent")
+    .configureHelp({ showGlobalOptions: true })
+    .addHelpText("after", "\nExamples:\n" +
+    "  max setup                         Guided QR login in your local terminal\n" +
+    "  max setup --agent codex           Install the skill for Codex\n" +
+    "  max work setup --agent claude     Set up a separate work profile\n" +
+    "  max setup --method qr-chrome      Log in through web.max.ru in Chromium\n" +
+    "  max setup --method sms            Enter your phone number in that browser\n" +
+    "  max setup --method token          Import a token at a hidden prompt or from stdin\n" +
+    "\nAllow about 5 minutes. Scan the QR with MAX on your phone.\n" +
+    "Keep tokens and passwords in the local terminal, never in command arguments.\n" +
+    "Agents: read `max skill show` before login. QR/browser login needs a local terminal.\n" +
+    "Existing sessions are checked without another login. Machine mode skips agent installation\n" +
+    "unless --agent is given. Bot accounts use `max <profile> bot auth set` separately.\n" +
+    "\nSetup checks five chats. Choose a chat and how much history to fetch before:\n" +
+    "  max store fetch <chat> --last 100\n" +
+    "Setup starts no background service and downloads no message history.\n" +
+    "\nWindows: use max.cmd or npm.cmd if PowerShell blocks scripts. Without PATH:\n" +
+    "  npm.cmd exec --yes --package=@wirecat/max-cli -- max setup\n")
+    .addOption(new Option("--agent <agent>", "install the skill for this agent; asks at a terminal, otherwise none").choices(AGENTS))
+    .addOption(new Option("--method <method>", "how to log in when there is no session")
+    .choices(["token", "qr", "qr-chrome", "sms"])
+    .default("qr"))
+    .action(async function () {
+    const context = forCommand(this);
+    const { settings, renderer, store } = context;
+    const options = this.opts();
+    refuseCommandName(settings.profile, commandWords(rootOf(this)));
+    if (this.optsWithGlobals().offline)
+        throw new CliError("validation_error", "max setup verifies MAX — remove --offline");
+    if (store.isBot())
+        throw new CliError("validation_error", `this is a bot profile — use max ${asFirstWord(settings.profile)}bot auth set; setup is for your personal account`);
+    const reused = store.readToken() !== undefined;
+    if (!reused && !store.hasLoggedIn() && options.method !== "token" && !context.interactive)
+        throw new CliError("validation_error", "max setup needs a local terminal for QR/browser login — run it locally; token import uses --method token");
+    const prefix = `max ${asFirstWord(settings.profile)}`;
+    const runner = installer(environmentOf(this).update) === "npx"
+        ? `npm${process.platform === "win32" ? ".cmd" : ""} exec --yes --package=@wirecat/max-cli -- ${prefix}`
+        : prefix;
+    const paths = resolvePaths({ appName: "max-cli", prefix: "MAX" });
+    const screen = screenFor(context, this.optsWithGlobals().quiet === true);
+    const answer = await context.run("setup", async (events) => {
+        screen.title(`MAX setup — profile ${settings.profile}. Allow about 5 minutes; downloading chat history is a separate step.`);
+        screen.step(1, "This computer");
+        for (const path of [paths.config, paths.state, paths.cache]) {
+            mkdirSync(path, { recursive: true });
+            accessSync(path, constants.W_OK);
+        }
+        screen.detail("✓ local directories ready");
+        if (process.platform === "win32")
+            screen.detail("Windows: use max.cmd or npm.cmd if PowerShell blocks scripts. Open a new terminal after installing Node.js.");
+        if (reused || store.hasLoggedIn()) {
+            screen.step(2, "Log in");
+            screen.detail("✓ existing session, no new login");
+        }
+        else {
+            screen.step(2, "Log in: scan the QR code with MAX on your phone");
+            const login = await startSession(underStep(context, screen), options.method, events);
+            if (login.firstLogin)
+                screen.detail(TERMS_NOTICE);
+        }
+        screen.step(3, "Account");
+        const client = context.createClient({ events }, { own: true });
+        let account;
+        let chats;
+        try {
+            account = await client.account.me();
+            chats = await client.chats.list({ limit: 5 });
+        }
+        finally {
+            await client.close();
+        }
+        screen.detail(`✓ verified, ${chatCount(chats.items.length)} read`);
+        screen.step(4, "Agent");
+        const agent = await agentFor(context, options.agent, screen.indent);
+        screen.detail(agent === "none" ? "✓ no agent skill installed" : `✓ ${agent}`);
+        const targets = agent === "all" ? ["claude", "agents"] : [agent === "claude" ? "claude" : "agents"];
+        context.signal.throwIfAborted();
+        const written = agent === "none" ? [] : installSkill(SKILL_APP, SKILL, { targets, env: process.env });
+        const next = {
+            instructions: `${runner}skill show`,
+            chats: `${runner}chats list --limit 5`,
+            history: `${runner}store fetch <chat> --last 100`,
+            ...(agent === "none" ? { skill: `${runner}skill install` } : {}),
+        };
+        return {
+            profile: settings.profile,
+            runtime: runtime(),
+            paths,
+            session: { reused },
+            account: maskedProfile(account),
+            chats: { checked: chats.items.length, hasMore: chats.hasMore },
+            agent: { name: agent, written },
+            next,
+        };
+    });
+    if (context.format !== "pretty")
+        renderer.result(answer);
+    else {
+        const rows = {
+            "Try now": answer.next.chats,
+            History: `${answer.next.history}  (choose the chat and the amount first)`,
+            "Agent skill": answer.agent.name === "none"
+                ? `skipped — install later: ${answer.next.skill}`
+                : `installed for ${answer.agent.name}; start a new agent session if it is not found`,
+            "For an agent": answer.next.instructions,
+        };
+        context.streams.data(`\n✓ MAX is ready — profile ${settings.profile}, ${chatCount(answer.chats.checked)} checked\n\n` +
+            indent(renderPretty(rows, { color: context.color }), 2));
+    }
+});
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AACrD,OAAO,EAAE,YAAY,EAAoB,MAAM,yBAAyB,CAAA;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACpF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAuB,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC7E,OAAO,EAAe,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEtE,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAU,CAAA;AAG9E,MAAM,KAAK,GAAG,CAAC,CAAA;AACf,MAAM,MAAM,GAAG,CAAC,CAAA;AAChB,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAA;AAEjF;;;GAGG;AACH,MAAM,SAAS,GAAG,CAAC,OAAuB,EAAE,KAAc,EAAE,EAAE;IAC5D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAA;IAC1C,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,EAAE;QAC3B,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IAC9C,CAAC,CAAA;IACD,OAAO;QACL,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3E,IAAI,EAAE,CAAC,KAAa,EAAE,KAAa,EAAE,EAAE,CACrC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,KAAK,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,KAAK,MAAM,KAAK,EAAE,CAAC;QACxG,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5F,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;KAC5B,CAAA;AACH,CAAC,CAAA;AAED,oFAAoF;AACpF,MAAM,SAAS,GAAG,CAAC,OAAuB,EAAE,MAAoC,EAAkB,EAAE,CAAC,CAAC;IACpG,GAAG,OAAO;IACV,QAAQ,EAAE,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE;IACtD,GAAG,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC;IACvF,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE;IAC9G,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;CACvF,CAAC,CAAA;AAEF,MAAM,QAAQ,GAAG,KAAK,EAAE,OAAuB,EAAE,KAAwB,EAAE,GAAW,EAAkB,EAAE;IACxG,IAAI,KAAK;QAAE,OAAO,KAAK,CAAA;IACvB,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,WAAW;QAAE,OAAO,MAAM,CAAA;IACtE,MAAM,MAAM,GACV,CACE,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,sDAAsD,EAAE;QAC1F,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CACH;SACE,IAAI,EAAE;SACN,WAAW,EAAE,IAAI,MAAM,CAAA;IAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAe,CAAC;QACnC,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,0BAA0B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;IACpG,OAAO,MAAe,CAAA;AACxB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,GAAY,EAAE,CACxC,QAAQ,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;KAC9C,WAAW,CAAC,yDAAyD,CAAC;KACtE,aAAa,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;KAC1C,WAAW,CACV,OAAO,EACP,eAAe;IACb,8EAA8E;IAC9E,mEAAmE;IACnE,sEAAsE;IACtE,6EAA6E;IAC7E,+EAA+E;IAC/E,uFAAuF;IACvF,gEAAgE;IAChE,gFAAgF;IAChF,wFAAwF;IACxF,8FAA8F;IAC9F,sFAAsF;IACtF,kFAAkF;IAClF,uCAAuC;IACvC,wEAAwE;IACxE,iFAAiF;IACjF,gEAAgE,CACnE;KACA,SAAS,CACR,IAAI,MAAM,CAAC,iBAAiB,EAAE,sEAAsE,CAAC,CAAC,OAAO,CAC3G,MAAM,CACP,CACF;KACA,SAAS,CACR,IAAI,MAAM,CAAC,mBAAmB,EAAE,wCAAwC,CAAC;KACtE,OAAO,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;KAC5C,OAAO,CAAC,IAAI,CAAC,CACjB;KACA,MAAM,CAAC,KAAK;IACX,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;IAChC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,OAAO,CAAA;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAqC,CAAA;IAC9D,iBAAiB,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC/D,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC,OAAO;QAChC,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,2CAA2C,CAAC,CAAA;IACrF,IAAI,KAAK,CAAC,KAAK,EAAE;QACf,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,mCAAmC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,kDAAkD,CACnH,CAAA;IACH,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,EAAE,KAAK,SAAS,CAAA;IAC9C,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW;QACvF,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,0GAA0G,CAC3G,CAAA;IACH,MAAM,MAAM,GAAG,OAAO,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAA;IACrD,MAAM,MAAM,GACV,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK;QAC7C,CAAC,CAAC,MAAM,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,6CAA6C,MAAM,EAAE;QACvG,CAAC,CAAC,MAAM,CAAA;IACZ,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;IACjE,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAA;IACxE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACzD,MAAM,CAAC,KAAK,CACV,uBAAuB,QAAQ,CAAC,OAAO,uEAAuE,CAC/G,CAAA;QACD,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,eAAe,CAAC,CAAA;QAC/B,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5D,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YACpC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAA;QAClC,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAA;QAC1C,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;YAC9B,MAAM,CAAC,MAAM,CACX,6GAA6G,CAC9G,CAAA;QACH,IAAI,MAAM,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;YACxB,MAAM,CAAC,MAAM,CAAC,kCAAkC,CAAC,CAAA;QACnD,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,iDAAiD,CAAC,CAAA;YACjE,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;YACpF,IAAI,KAAK,CAAC,UAAU;gBAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;QACnD,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;QACzB,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAA;QAC9D,IAAI,OAAsD,CAAA;QAC1D,IAAI,KAAoD,CAAA;QACxD,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,CAAA;YACnC,KAAK,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;QAC/C,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;QACtB,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,eAAe,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAClE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;QACvB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QACnE,MAAM,CAAC,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAA;QAC7E,MAAM,OAAO,GACX,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;QACrF,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAA;QAC/B,MAAM,OAAO,GAAG,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QACrG,MAAM,IAAI,GAAG;YACX,YAAY,EAAE,GAAG,MAAM,YAAY;YACnC,KAAK,EAAE,GAAG,MAAM,sBAAsB;YACtC,OAAO,EAAE,GAAG,MAAM,+BAA+B;YACjD,GAAG,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,MAAM,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjE,CAAA;QACD,OAAO;YACL,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,OAAO,EAAE,OAAO,EAAE;YAClB,KAAK;YACL,OAAO,EAAE,EAAE,MAAM,EAAE;YACnB,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC;YAC/B,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE;YAC9D,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE;YAC/B,IAAI;SACL,CAAA;IACH,CAAC,CAAC,CAAA;IACF,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ;QAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;SACnD,CAAC;QACJ,MAAM,IAAI,GAAG;YACX,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK;YAC5B,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,0CAA0C;YACzE,aAAa,EACX,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM;gBAC1B,CAAC,CAAC,4BAA4B,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE;gBACjD,CAAC,CAAC,iBAAiB,MAAM,CAAC,KAAK,CAAC,IAAI,gDAAgD;YACxF,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY;SACzC,CAAA;QACD,OAAO,CAAC,OAAO,CAAC,IAAI,CAClB,8BAA8B,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc;YAC9F,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAC1D,CAAA;IACH,CAAC;AACH,CAAC,CAAC,CAAA"}

package/dist/commands/skill.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare const skillCommand: () => Command;
+//# sourceMappingURL=skill.d.ts.map

package/dist/commands/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/commands/skill.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAIxC,eAAO,MAAM,YAAY,QAAO,OAM7B,CAAA"}

package/dist/commands/skill.js

@@ -0,0 +1,7 @@
+import { skillCommand as sharedSkillCommand } from "@wirecat/cli-messaging/cli";
+import { MAX_APP } from "../app.js";
+import { SKILL } from "../skill.js";
+export const skillCommand = () => sharedSkillCommand(MAX_APP, SKILL).addHelpText("after", "\nAgents: run `max skill show` before login; it needs no MAX session.\n" +
+    "Guided first run: `max setup --agent codex`.\n" +
+    "Install instructions separately: `max skill install --for all`.\n");
+//# sourceMappingURL=skill.js.map

package/dist/commands/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/commands/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAE/E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAEnC,MAAM,CAAC,MAAM,YAAY,GAAG,GAAY,EAAE,CACxC,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,WAAW,CAC5C,OAAO,EACP,yEAAyE;IACvE,gDAAgD;IAChD,mEAAmE,CACtE,CAAA"}

package/dist/commands/stickers.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare const stickersCommand: () => Command;
+//# sourceMappingURL=stickers.d.ts.map

package/dist/commands/stickers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stickers.d.ts","sourceRoot":"","sources":["../../src/commands/stickers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,eAAO,MAAM,eAAe,QAAO,OAA8C,CAAA"}

package/dist/commands/stickers.js

@@ -0,0 +1,4 @@
+import { stickersCommand as sharedStickersCommand } from "@wirecat/cli-messaging/cli";
+import { maxMessenger } from "../messenger.js";
+export const stickersCommand = () => sharedStickersCommand(maxMessenger);
+//# sourceMappingURL=stickers.js.map

package/dist/commands/stickers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stickers.js","sourceRoot":"","sources":["../../src/commands/stickers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,IAAI,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAErF,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,MAAM,CAAC,MAAM,eAAe,GAAG,GAAY,EAAE,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAA"}

package/dist/commands/upgrade.d.ts

@@ -0,0 +1,2 @@
+export declare const upgradeCommand: () => import("commander").Command;
+//# sourceMappingURL=upgrade.d.ts.map

package/dist/commands/upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,cAAc,mCASvB,CAAA"}