@leemour/max-cli 0.1.0

package/dist/commands/context.js

@@ -0,0 +1,40 @@
+import { MaxClient } from "../client.js";
+import { resolveSettings } from "../config.js";
+import { resolveOutput } from "../output.js";
+import { recorded } from "../runs/recording.js";
+import { SessionStore } from "../session/store.js";
+/**
+ * Everything a command needs, resolved once — and **the only place a `MaxClient` is built.**
+ *
+ * One construction site is what keeps the protocol note quiet under `--quiet`: a command building
+ * its own client gets the default `warn`, which writes straight to stderr past the renderer
+ * (`BUG-7`). With eight commands, "remember to pass `warn`" is a rule that gets broken once and
+ * then nobody can see it.
+ *
+ * It is also where `--record` stops being a flag and becomes a setting: `recorded` takes what
+ * `resolveSettings` decided — flag, then environment, then the configuration file — rather than
+ * what `commander` happened to parse.
+ *
+ * The cache is not opened here on purpose — only the reading commands want one, and opening it
+ * would create a database file for `session end`, which will never read it.
+ */
+export const forCommand = (flags) => {
+    const settings = resolveSettings(flags);
+    const { renderer, format } = resolveOutput(settings);
+    const store = new SessionStore({ profile: settings.profile });
+    return {
+        settings,
+        renderer,
+        format,
+        store,
+        createClient: (extra = {}) => new MaxClient({ store, timeoutMs: settings.timeoutMs, warn: renderer.note, ...extra }),
+        run: (command, body) => recorded({
+            command,
+            profile: settings.profile,
+            options: { record: settings.record, verbose: settings.verbose },
+            format,
+            keepDays: settings.keepRunsForDays,
+        }, body),
+    };
+};
+//# sourceMappingURL=context.js.map

package/dist/commands/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAyB,MAAM,cAAc,CAAA;AAC/D,OAAO,EAAoB,eAAe,EAAiB,MAAM,cAAc,CAAA;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAgBlD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAkB,EAAkB,EAAE;IAC/D,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA;IACvC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAA;IACpD,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;IAE7D,OAAO;QACL,QAAQ;QACR,QAAQ;QACR,MAAM;QACN,KAAK;QACL,YAAY,EAAE,CAAC,KAAK,GAAG,EAAE,EAAE,EAAE,CAC3B,IAAI,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC;QACxF,GAAG,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CACrB,QAAQ,CACN;YACE,OAAO;YACP,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE;YAC/D,MAAM;YACN,QAAQ,EAAE,QAAQ,CAAC,eAAe;SACnC,EACD,IAAI,CACL;KACJ,CAAA;AACH,CAAC,CAAA"}

package/dist/commands/messages.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/commands/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAInC,eAAO,MAAM,eAAe,QAAO,OAgElC,CAAA"}

package/dist/commands/messages.js

@@ -0,0 +1,62 @@
+import { Command } from "commander";
+import { openProfileCache } from "../cache/index.js";
+import { forCommand } from "./context.js";
+export const messagesCommand = () => {
+    const command = new Command("messages").description("read and send messages in a chat");
+    /**
+     * Observational, and deliberately so: this reads `CHAT_HISTORY` and never sends `CHAT_MARK`, so
+     * looking at a conversation does not tell anyone you read it (REQUIREMENTS §19).
+     */
+    command
+        .command("list")
+        .argument("<chat>", "chat id, or part of a chat name")
+        .description("recent messages in a chat, oldest first")
+        .option("--limit <n>", "how many to read", (value) => Number.parseInt(value, 10))
+        .action(async function (chat) {
+        const { renderer, settings, createClient, run } = forCommand(this.optsWithGlobals());
+        const cache = await openProfileCache(settings.profile, { onProblem: (message) => renderer.note(message) });
+        await run("messages list", async (events) => {
+            const client = createClient({ events, ...(cache ? { cache } : {}) });
+            try {
+                const chatId = await client.chats.resolve(chat);
+                renderer.result(await client.messages.list(chatId, settings.limit));
+            }
+            finally {
+                await client.close();
+                cache?.close();
+            }
+        });
+    });
+    /**
+     * One message, one command, no retry.
+     *
+     * There is no `--dry-run` here: the target and the text are both in the line the person typed, so
+     * a preview would restate the command back at them (REQUIREMENTS §21). What this command does owe
+     * the caller is honesty about an outcome it does not know — see `MaxClient.messages.send`.
+     */
+    command
+        .command("send")
+        .argument("<chat>", "chat id, or part of a chat name")
+        .argument("<text>", "what to say")
+        .description("send one text message")
+        .option("--cid <n>", "reuse a client id from an earlier ambiguous send; MAX collapses the duplicate", (value) => Number.parseInt(value, 10))
+        .action(async function (chat, text) {
+        const options = this.optsWithGlobals();
+        const { renderer, settings, createClient, run } = forCommand(options);
+        const cache = await openProfileCache(settings.profile, { onProblem: (message) => renderer.note(message) });
+        await run("messages send", async (events) => {
+            const client = createClient({ events, ...(cache ? { cache } : {}) });
+            try {
+                const chatId = await client.chats.resolve(chat);
+                const sent = await client.messages.send(chatId, text, options.cid === undefined ? {} : { cid: options.cid });
+                renderer.result(sent);
+            }
+            finally {
+                await client.close();
+                cache?.close();
+            }
+        });
+    });
+    return command;
+};
+//# sourceMappingURL=messages.js.map

package/dist/commands/messages.js.map

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

package/dist/commands/runs.d.ts

@@ -0,0 +1,9 @@
+import { Command } from "commander";
+/**
+ * What this tool did, when it was asked to keep the record.
+ *
+ * Reading the log is not itself an action worth recording, so **nothing here starts a run** — a
+ * `max runs list` that created a run directory while listing them would be its own joke.
+ */
+export declare const runsCommand: () => Command;
+//# sourceMappingURL=runs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/commands/runs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAInC;;;;;GAKG;AACH,eAAO,MAAM,WAAW,QAAO,OAgD9B,CAAA"}

package/dist/commands/runs.js

@@ -0,0 +1,68 @@
+import { CliError } from "@leemour/cli-core";
+import { Command } from "commander";
+import { resolveOutput } from "../output.js";
+import { findRun, listRuns, readEvents, runsDirFor } from "../runs/run.js";
+/**
+ * What this tool did, when it was asked to keep the record.
+ *
+ * Reading the log is not itself an action worth recording, so **nothing here starts a run** — a
+ * `max runs list` that created a run directory while listing them would be its own joke.
+ */
+export const runsCommand = () => {
+    const command = new Command("runs").description("recorded runs — what this tool did, and when");
+    command
+        .command("list")
+        .description("recorded runs, newest first")
+        .option("--limit <n>", "how many to show", (value) => Number.parseInt(value, 10), 20)
+        .action(function () {
+        const options = this.optsWithGlobals();
+        const { renderer } = resolveOutput(options);
+        const runs = listRuns(runsDirFor());
+        renderer.result(runs.slice(0, options.limit));
+        // An empty list reads as broken otherwise, and the reason is that nothing asked for a
+        // record — recording is off unless it is asked for (`NEED-52`). The explanation is a
+        // diagnostic, so stdout still carries one JSON value and nothing else.
+        if (runs.length === 0)
+            renderer.note("nothing recorded — a run is kept only with `--record`");
+    });
+    command
+        .command("show")
+        .argument("<run-id>", "an id from `max runs list`")
+        .description("one run: what it was, and one line per request")
+        .action(function (id) {
+        const options = this.optsWithGlobals();
+        const { renderer } = resolveOutput(options);
+        const found = runOrRefuse(id);
+        // Both, because neither answers the question on its own: the metadata says how it ended and
+        // the events say where it went.
+        renderer.result({ ...found.metadata, directory: found.dir, events: readEvents(found.dir).map(readable) });
+    });
+    command
+        .command("path")
+        .argument("<run-id>", "an id from `max runs list`")
+        .description("the directory holding one run")
+        .action(function (id) {
+        const options = this.optsWithGlobals();
+        const { renderer } = resolveOutput(options);
+        // One JSON value on stdout here too, with no exception for convenience (`NEED-88`): a script
+        // reads `--json | jq -r .path`, and a terminal prints the bare path as a labelled line.
+        renderer.result({ path: runOrRefuse(id).dir });
+    });
+    return command;
+};
+/**
+ * Drops what Pino puts on every line: the level, and the run id, command and profile that are the
+ * same for the whole run and are printed above it anyway.
+ *
+ * Without this the table is five constant columns wide before it reaches the opcode, and the
+ * durations and sizes — the reason anyone opened it — fall off the right of an 80-column terminal.
+ * `max runs path <id>` still gives the file, envelope and all.
+ */
+const readable = ({ level, runId, command, profile, ...event }) => event;
+const runOrRefuse = (id) => {
+    const found = findRun(runsDirFor(), id);
+    if (!found)
+        throw new CliError("not_found", `no recorded run "${id}" — \`max runs list\` shows what there is`);
+    return found;
+};
+//# sourceMappingURL=runs.js.map

package/dist/commands/runs.js.map

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

package/dist/commands/session.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const sessionCommand: () => Command;
+//# 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":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAKnC,eAAO,MAAM,cAAc,QAAO,OA4EjC,CAAA"}

package/dist/commands/session.js

@@ -0,0 +1,74 @@
+import { Command } from "commander";
+import { commandWords, refuseCommandName, rootOf } from "../profile.js";
+import { readSecret } from "../session/prompt.js";
+import { forCommand } from "./context.js";
+export const sessionCommand = () => {
+    const command = new Command("session").description("the stored MAX session for this profile");
+    /**
+     * For now, importing a token obtained elsewhere — from `web.max.ru`, or from another client.
+     *
+     * This is not a stopgap: it is the escape hatch that keeps every other command usable when our
+     * own login flow meets a captcha or an unusual second factor, and it is how the slice is tested
+     * without an SMS per run. The interactive phone-and-code flow lands beside it, not instead of it.
+     *
+     * **The token is asked for, not passed.** A token in argv is read by `ps` and kept by shell
+     * history, and a file leaves a copy nobody deletes, so with `MAX_TOKEN` unset it is read from the
+     * terminal without being echoed — or from a pipe, for `pass show max | max session start`. From
+     * there it goes to the OS keyring.
+     */
+    command
+        .command("start")
+        .description("store a MAX session for this profile")
+        .action(async function () {
+        const { renderer, settings, store, createClient, run } = forCommand(this.optsWithGlobals());
+        // Creation is the only moment the collision can still be explained; after this the name is
+        // written down and `max <name>` would silently be a command instead.
+        refuseCommandName(settings.profile, commandWords(rootOf(this)));
+        const token = process.env.MAX_TOKEN?.trim() || (await readSecret("MAX token: "));
+        // Before the run directory: nothing was attempted, so there is nothing to record.
+        if (!token) {
+            renderer.failure("no token given");
+            process.exitCode = 2;
+            return;
+        }
+        store.writeToken(token);
+        await run("session start", async (events) => {
+            const client = createClient({ events });
+            try {
+                await client.connect();
+                const profile = client.account.me();
+                renderer.result({ profile, stored: true });
+                renderer.success(`logged in as ${profile.name ?? profile.id}`);
+            }
+            finally {
+                await client.close();
+            }
+        });
+    });
+    /**
+     * Local only, for now: it forgets the token and the device identity on this machine.
+     *
+     * It does **not** send LOGOUT (opcode 20), which would end the session on MAX's side too — and
+     * with it the browser tab the token came from. That distinction is in the output rather than
+     * glossed over: a forgotten token that is still live elsewhere is a different thing from a
+     * revoked one.
+     */
+    command
+        .command("end")
+        .description("forget the stored session for this profile")
+        .action(async function () {
+        const { renderer, store, run } = forCommand(this.optsWithGlobals());
+        // It contacts nobody, so the run holds no events — but forgetting a session is an action, and
+        // "when did this profile stop working" is a question the record is kept to answer.
+        await run("session end", async () => {
+            const had = store.forget();
+            renderer.result({ profile: store.profile, forgotten: had, revokedOnServer: false });
+            if (had)
+                renderer.success(`forgot the session for "${store.profile}" on this machine`);
+            else
+                renderer.note(`there was no session for "${store.profile}"`);
+        });
+    });
+    return command;
+};
+//# 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/config.d.ts

@@ -0,0 +1,53 @@
+import * as v from "valibot";
+export declare const configSchema: v.StrictObjectSchema<{
+    readonly defaultProfile: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly profiles: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.StrictObjectSchema<{
+        readonly limit: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
+        readonly timeoutMs: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
+        readonly color: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        /** The run log reads these two; nothing records anything until it exists. */
+        readonly record: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly keepRunsForDays: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
+    }, undefined>, undefined>, {}>;
+}, undefined>;
+export type Config = v.InferOutput<typeof configSchema>;
+/** Whatever the command line carried. Everything is optional: absent means "not given here". */
+export interface GlobalFlags {
+    profile?: string;
+    json?: boolean;
+    quiet?: boolean;
+    verbose?: boolean;
+    limit?: number;
+    record?: boolean;
+}
+export interface Settings {
+    profile: string;
+    json: boolean;
+    quiet: boolean;
+    verbose: boolean;
+    /** Unset means "decide from the terminal", which is `resolveOutput`'s job, not this one's. */
+    color: boolean | undefined;
+    limit: number;
+    /** Unset means the transport's own default; the number lives in `protocol/connection.ts`. */
+    timeoutMs: number | undefined;
+    record: boolean;
+    keepRunsForDays: number;
+    /** Named in errors and in `max --help`, so a person can find the file that decided this. */
+    configPath: string;
+}
+export interface ResolveOptions {
+    env?: NodeJS.ProcessEnv;
+    /** Tests pass a temporary directory; nothing else should need this. */
+    configDir?: string;
+}
+/**
+ * **Flag, then environment, then the configuration file, then the built-in default.** One place,
+ * so no command can decide the order differently from another.
+ *
+ * Two things already jump this queue and are documented rather than re-litigated here:
+ * `MAX_TOKEN` outranks the keyring (`cli-core`'s `Credentials.read`), and `MAX_CONFIG_DIR`,
+ * `MAX_STATE_DIR` or `MAX_CACHE_DIR` move the whole installation — including which keyring entry
+ * a profile means (`ARCHITECTURE.md` §13).
+ */
+export declare const resolveSettings: (flags?: GlobalFlags, { env, configDir }?: ResolveOptions) => Settings;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AA6B5B,eAAO,MAAM,YAAY;;;;;;QALvB,6EAA6E;;;;aAQ7E,CAAA;AAEF,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,YAAY,CAAC,CAAA;AAEvD,gGAAgG;AAChG,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,8FAA8F;IAC9F,KAAK,EAAE,OAAO,GAAG,SAAS,CAAA;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,6FAA6F;IAC7F,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,MAAM,EAAE,OAAO,CAAA;IACf,eAAe,EAAE,MAAM,CAAA;IACvB,4FAA4F;IAC5F,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAAI,QAAO,WAAgB,EAAE,qBAAkC,cAAmB,aA4B7G,CAAA"}

package/dist/config.js

@@ -0,0 +1,83 @@
+import { CliError, configFilePath, loadConfigFile, resolvePaths } from "@leemour/cli-core";
+import * as v from "valibot";
+import { DEFAULT_PROFILE, usableProfileName } from "./profile.js";
+const APP = "max-cli";
+const DEFAULT_LIMIT = 20;
+const DEFAULT_KEEP_RUNS_FOR_DAYS = 30;
+const count = v.pipe(v.number(), v.integer(), v.minValue(1));
+/**
+ * ⚠ `strictObject`, not `object`: an unknown key is an error here.
+ *
+ * `object()` drops what it does not recognise — measured with valibot 1.5, `{ limitt: 5 }` parses
+ * to `{}` and reports nothing — so a misspelled setting would run with the default and never say
+ * why. That is the failure this schema exists to prevent, and it is the **opposite** of the rule
+ * for MAX's own answers, which keep unknown fields on purpose (`NEED-35`).
+ *
+ * **No field here can hold a secret.** No token, no phone number, no chat id: a schema with
+ * nowhere to put one is stronger than a rule saying do not put one there.
+ */
+const profileSettings = v.strictObject({
+    limit: v.optional(count),
+    timeoutMs: v.optional(count),
+    color: v.optional(v.boolean()),
+    /** The run log reads these two; nothing records anything until it exists. */
+    record: v.optional(v.boolean()),
+    keepRunsForDays: v.optional(count),
+});
+export const configSchema = v.strictObject({
+    defaultProfile: v.optional(v.string()),
+    profiles: v.optional(v.record(v.string(), profileSettings), {}),
+});
+/**
+ * **Flag, then environment, then the configuration file, then the built-in default.** One place,
+ * so no command can decide the order differently from another.
+ *
+ * Two things already jump this queue and are documented rather than re-litigated here:
+ * `MAX_TOKEN` outranks the keyring (`cli-core`'s `Credentials.read`), and `MAX_CONFIG_DIR`,
+ * `MAX_STATE_DIR` or `MAX_CACHE_DIR` move the whole installation — including which keyring entry
+ * a profile means (`ARCHITECTURE.md` §13).
+ */
+export const resolveSettings = (flags = {}, { env = process.env, configDir } = {}) => {
+    const paths = resolvePaths({ appName: APP, prefix: "MAX", env });
+    const configPath = configFilePath(configDir ?? paths.config);
+    const config = readConfig(configPath);
+    const profile = usableProfileName(flags.profile ?? given(env.MAX_PROFILE) ?? config.defaultProfile ?? DEFAULT_PROFILE);
+    const configured = config.profiles[profile] ?? {};
+    const settings = {
+        profile,
+        json: flags.json === true,
+        quiet: flags.quiet === true,
+        verbose: flags.verbose === true,
+        color: configured.color,
+        limit: flags.limit ?? configured.limit ?? DEFAULT_LIMIT,
+        timeoutMs: configured.timeoutMs,
+        record: flags.record ?? configured.record ?? false,
+        keepRunsForDays: configured.keepRunsForDays ?? DEFAULT_KEEP_RUNS_FOR_DAYS,
+        configPath,
+    };
+    // The file was checked by the schema; a flag was not, and `--limit abc` is `NaN` by the time it
+    // gets here, which slices an array to nothing without complaining.
+    if (!Number.isInteger(settings.limit) || settings.limit < 1) {
+        throw new CliError("validation_error", `--limit takes a whole number from 1 upwards, not ${flags.limit}`);
+    }
+    return settings;
+};
+/**
+ * A missing file is not an error — it is a program nobody has configured. A malformed one is, in
+ * every output mode: an agent reading JSON deserves the same refusal a person gets, and silently
+ * falling back to the defaults is what makes a typo cost an afternoon.
+ */
+const readConfig = (path) => {
+    try {
+        return loadConfigFile(path, configSchema, () => ({ profiles: {} }));
+    }
+    catch (error) {
+        throw new CliError("configuration_error", error instanceof Error ? error.message : String(error));
+    }
+};
+/** An environment variable set to the empty string is not a value; it is the shell being unset. */
+const given = (value) => {
+    const trimmed = value?.trim();
+    return trimmed === undefined || trimmed === "" ? undefined : trimmed;
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/domain/map.d.ts

@@ -0,0 +1,22 @@
+import { type Payload } from "../protocol/frame.js";
+import type { Chat, Contact, Id, Message, Profile } from "./models.js";
+/**
+ * Wire shapes into our own types.
+ *
+ * **Tolerant when reading** (REQUIREMENTS §29): an unknown field is ignored, a missing one becomes
+ * `null`, and nothing here throws. This is an unofficial protocol — a response that gained a field
+ * must not break a command, and a response that lost one must say so rather than invent a value.
+ */
+export interface NameLookup {
+    /** Display names by user id, built from the `contacts` the login response carries. */
+    names?: Map<Id, string>;
+    /** Whose account this is, so a message can say whether it is ours. */
+    viewerId?: Id;
+}
+export declare const toChat: (raw: Payload) => Chat;
+export declare const toMessage: (raw: Payload, chatId: Id, lookup?: NameLookup) => Message;
+export declare const toContact: (raw: Payload) => Contact;
+export declare const toProfile: (raw: Payload) => Profile;
+/** The names a login response carries, so a message can name its sender without another request. */
+export declare const namesFrom: (contacts: unknown) => Map<Id, string>;
+//# sourceMappingURL=map.d.ts.map

package/dist/domain/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/domain/map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAc,IAAI,EAAY,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE5F;;;;;;GAMG;AAEH,MAAM,WAAW,UAAU;IACzB,sFAAsF;IACtF,KAAK,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;IACvB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,EAAE,CAAA;CACd;AAED,eAAO,MAAM,MAAM,GAAI,KAAK,OAAO,KAAG,IAOpC,CAAA;AAEF,eAAO,MAAM,SAAS,GAAI,KAAK,OAAO,EAAE,QAAQ,EAAE,EAAE,SAAQ,UAAe,KAAG,OAc7E,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,KAAK,OAAO,KAAG,OAKvC,CAAA;AAEF,eAAO,MAAM,SAAS,GAAI,KAAK,OAAO,KAAG,OAQxC,CAAA;AAED,oGAAoG;AACpG,eAAO,MAAM,SAAS,GAAI,UAAU,OAAO,KAAG,GAAG,CAAC,EAAE,EAAE,MAAM,CAY3D,CAAA"}

package/dist/domain/map.js

@@ -0,0 +1,107 @@
+import { asId } from "../protocol/frame.js";
+export const toChat = (raw) => ({
+    id: asId(raw.id) ?? "",
+    title: text(raw.title),
+    kind: chatKind(raw.type),
+    unreadCount: count(raw.newMessages),
+    lastMessageAt: timestamp(raw.lastEventTime ?? asRecord(raw.lastMessage)?.time),
+    participantsCount: count(raw.participantsCount),
+});
+export const toMessage = (raw, chatId, lookup = {}) => {
+    const senderId = asId(raw.sender);
+    return {
+        id: asId(raw.id) ?? "",
+        chatId,
+        senderId: senderId ?? null,
+        senderName: senderId ? (lookup.names?.get(senderId) ?? null) : null,
+        timestamp: timestamp(raw.time) ?? new Date(0).toISOString(),
+        editedAt: timestamp(raw.updateTime),
+        text: text(raw.text) ?? "",
+        outgoing: lookup.viewerId === undefined || senderId === undefined ? null : senderId === lookup.viewerId,
+        attachments: attachments(raw.attaches),
+    };
+};
+export const toContact = (raw) => ({
+    id: asId(raw.id) ?? "",
+    name: displayName(raw.names) ?? text(raw.name),
+    username: text(raw.link),
+    description: text(raw.description),
+});
+export const toProfile = (raw) => {
+    const contact = asRecord(raw.contact) ?? raw;
+    return {
+        id: asId(contact.id) ?? "",
+        name: displayName(contact.names) ?? text(contact.name),
+        phone: phone(contact.phones) ?? text(contact.phone),
+    };
+};
+/** The names a login response carries, so a message can name its sender without another request. */
+export const namesFrom = (contacts) => {
+    const names = new Map();
+    if (!Array.isArray(contacts))
+        return names;
+    for (const entry of contacts) {
+        const contact = asRecord(entry);
+        if (!contact)
+            continue;
+        const id = asId(contact.id);
+        const name = displayName(contact.names) ?? text(contact.name);
+        if (id && name)
+            names.set(id, name);
+    }
+    return names;
+};
+const asRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value) ? value : undefined;
+const text = (value) => (typeof value === "string" && value !== "" ? value : null);
+const count = (value) => {
+    const asNumber = typeof value === "bigint" ? Number(value) : value;
+    return typeof asNumber === "number" && Number.isFinite(asNumber) ? asNumber : null;
+};
+/** MAX sends Unix milliseconds; output is ISO 8601, which sorts, parses and needs no timezone guess. */
+const timestamp = (value) => {
+    const ms = count(value);
+    if (ms === null || ms <= 0)
+        return null;
+    const date = new Date(ms);
+    return Number.isNaN(date.getTime()) ? null : date.toISOString();
+};
+const chatKind = (value) => {
+    switch (typeof value === "string" ? value.toUpperCase() : "") {
+        case "DIALOG":
+            return "dialog";
+        case "CHAT":
+            return "group";
+        case "CHANNEL":
+            return "channel";
+        default:
+            return "unknown";
+    }
+};
+/** `names` is a list of `{name, type}`; the full name wins, and any name beats none. */
+const displayName = (value) => {
+    if (!Array.isArray(value))
+        return null;
+    const entries = value.map(asRecord).filter((entry) => entry !== undefined);
+    const full = entries.find((entry) => entry.type === "FULL_NAME");
+    return text(full?.name) ?? text(entries[0]?.name);
+};
+const phone = (value) => {
+    if (!Array.isArray(value))
+        return null;
+    const first = asRecord(value[0]);
+    const number = first?.number;
+    return text(number) ?? (typeof number === "number" || typeof number === "bigint" ? `+${number}` : null);
+};
+/**
+ * Attachment **metadata**, never its content. A message that carries a photo says so; downloading
+ * it is a different command that does not exist yet (§11 of the brief).
+ */
+const attachments = (value) => {
+    if (!Array.isArray(value))
+        return [];
+    return value
+        .map(asRecord)
+        .filter((entry) => entry !== undefined)
+        .map((entry) => ({ kind: typeof entry._type === "string" ? entry._type.toLowerCase() : "unknown" }));
+};
+//# sourceMappingURL=map.js.map

package/dist/domain/map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../src/domain/map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAgB,MAAM,sBAAsB,CAAA;AAkBzD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,GAAY,EAAQ,EAAE,CAAC,CAAC;IAC7C,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE;IACtB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;IACtB,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;IACxB,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC;IACnC,aAAa,EAAE,SAAS,CAAC,GAAG,CAAC,aAAa,IAAI,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;IAC9E,iBAAiB,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC;CAChD,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAY,EAAE,MAAU,EAAE,SAAqB,EAAE,EAAW,EAAE;IACtF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAEjC,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE;QACtB,MAAM;QACN,QAAQ,EAAE,QAAQ,IAAI,IAAI;QAC1B,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;QACnE,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;QAC3D,QAAQ,EAAE,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC;QACnC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE;QAC1B,QAAQ,EAAE,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ;QACvG,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC;KACvC,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAY,EAAW,EAAE,CAAC,CAAC;IACnD,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE;IACtB,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IAC9C,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IACxB,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC;CACnC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAY,EAAW,EAAE;IACjD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,CAAA;IAE5C,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAC1B,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QACtD,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;KACpD,CAAA;AACH,CAAC,CAAA;AAED,oGAAoG;AACpG,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,QAAiB,EAAmB,EAAE;IAC9D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAc,CAAA;IACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAA;IAE1C,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;QAC/B,IAAI,CAAC,OAAO;YAAE,SAAQ;QACtB,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAC3B,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAC7D,IAAI,EAAE,IAAI,IAAI;YAAE,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;IACrC,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAuB,EAAE,CACvD,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAiB,CAAC,CAAC,CAAC,SAAS,CAAA;AAEvG,MAAM,IAAI,GAAG,CAAC,KAAc,EAAiB,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;AAE1G,MAAM,KAAK,GAAG,CAAC,KAAc,EAAiB,EAAE;IAC9C,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IAClE,OAAO,OAAO,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAA;AACpF,CAAC,CAAA;AAED,wGAAwG;AACxG,MAAM,SAAS,GAAG,CAAC,KAAc,EAAiB,EAAE;IAClD,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;IACvB,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IACvC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,CAAA;IACzB,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAA;AACjE,CAAC,CAAA;AAED,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAY,EAAE;IAC5C,QAAQ,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC7D,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAA;QACjB,KAAK,MAAM;YACT,OAAO,OAAO,CAAA;QAChB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAA;QAClB;YACE,OAAO,SAAS,CAAA;IACpB,CAAC;AACH,CAAC,CAAA;AAED,wFAAwF;AACxF,MAAM,WAAW,GAAG,CAAC,KAAc,EAAiB,EAAE;IACpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACtC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAoB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAA;IAC5F,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAA;IAChE,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;AACnD,CAAC,CAAA;AAED,MAAM,KAAK,GAAG,CAAC,KAAc,EAAiB,EAAE;IAC9C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAChC,MAAM,MAAM,GAAG,KAAK,EAAE,MAAM,CAAA;IAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;AACzG,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,WAAW,GAAG,CAAC,KAAc,EAAgB,EAAE;IACnD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACpC,OAAO,KAAK;SACT,GAAG,CAAC,QAAQ,CAAC;SACb,MAAM,CAAC,CAAC,KAAK,EAAoB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;SACxD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;AACxG,CAAC,CAAA"}