@wirecat/max-cli 0.0.0 → 0.42.0

package/dist/diagnose.js

@@ -0,0 +1,183 @@
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { createRequire } from "node:module";
+import { join } from "node:path";
+import { pathsAreOverridden, resolvePaths } from "@wirecat/cli-core";
+import { runtime, storeSummary } from "@wirecat/cli-messaging/cli";
+import { openCache, storePath } from "@wirecat/cli-messaging/store";
+import { checkInstall, ownScript } from "./install.js";
+import { CLIENT } from "./spec/identity.js";
+import { isInstalled, modelsDirectory } from "./transcribe/install.js";
+import { DEFAULT_MODEL, findModel } from "./transcribe/models.js";
+/** Owner's ruling, NEED-264: the web client releases more often than that, and breaks later. */
+export const STALE_AFTER_DAYS = 60;
+/**
+ * Everything a command depends on, read from disk and **never from MAX**.
+ *
+ * It is a separate function rather than the body of the command because `forCommand` builds its
+ * own renderer over the real streams, so anything left inside a command action cannot be asserted
+ * on (`CLI-15`, and `src/session/adopt.ts` moved for the same reason).
+ *
+ * ⚠ **It must work when everything is broken**, which is the only time anybody runs it: no
+ * session, no configuration file, an unreadable store, a keyring that will not open. Each
+ * of those is a field in the answer, never an exception.
+ *
+ * ⚠ **It reads the state file directly instead of calling `readState`**, which invents a device
+ * identity and writes it out on first read. A diagnosis that creates the thing it is reporting on
+ * is not a diagnosis.
+ */
+export const diagnose = async ({ profile, env = process.env, stateDir, cacheDir, readStore = storeSummary, storedToken = () => undefined, storedBotToken = () => undefined, configured = [], now = () => new Date(), install = () => thisInstall(env), native = loadNative, speechModel = DEFAULT_MODEL, modelsDir, }) => {
+    const paths = resolvePaths({ appName: "max-cli", prefix: "MAX", env });
+    const state = stateDir ?? paths.state;
+    const cacheHome = cacheDir ?? paths.cache;
+    const moved = pathsAreOverridden({ appName: "max-cli", prefix: "MAX", env });
+    const fromEnvironment = (env.MAX_TOKEN ?? "").trim() !== "";
+    const tokenAt = fromEnvironment ? undefined : storedToken(profile);
+    const stateFile = join(state, "profiles", `${profile}.json`);
+    const stored = readState(stateFile);
+    const cacheFile = join(cacheHome, `${profile}.db`);
+    const cacheExists = existsSync(cacheFile);
+    const runsDirectory = join(state, "runs");
+    const bots = join(state, "bots");
+    const registryFile = join(bots, `${profile}.json`);
+    const registry = readState(registryFile);
+    const botFromEnvironment = (env.MAX_BOT_TOKEN ?? "").trim() !== "";
+    const botTokenAt = botFromEnvironment ? undefined : storedBotToken(profile);
+    const profiles = knownProfiles({ stateDir: state, configured }).map((row) => ({
+        ...row,
+        personal: row.personal || storedToken(row.name) !== undefined,
+        bot: row.bot || storedBotToken(row.name) !== undefined,
+    }));
+    return {
+        token: {
+            present: fromEnvironment || tokenAt !== undefined,
+            from: fromEnvironment ? "environment" : (tokenAt ?? "none"),
+        },
+        keyring: { service: moved ? `max-cli:${paths.config}` : "max-cli", movedByEnvironment: moved },
+        session: {
+            stateFile,
+            exists: stored !== undefined,
+            deviceId: typeof stored?.deviceId === "string" && stored.deviceId !== "",
+            viewerId: typeof stored?.viewerId === "string" && stored.viewerId !== "",
+            logins: typeof stored?.logins === "number" ? stored.logins : null,
+            lastLoginAt: typeof stored?.lastLoginAt === "string" ? stored.lastLoginAt : null,
+            loginPausedUntil: typeof stored?.loginPausedUntil === "string" && Date.parse(stored.loginPausedUntil) > Date.now()
+                ? stored.loginPausedUntil
+                : null,
+        },
+        loggedInProfiles: profilesWithState(join(state, "profiles")),
+        profiles,
+        bot: {
+            token: {
+                present: botFromEnvironment || botTokenAt !== undefined,
+                from: botFromEnvironment ? "environment" : (botTokenAt ?? "none"),
+            },
+            registry: {
+                file: registryFile,
+                exists: registry !== undefined,
+                botKnown: typeof registry?.botId === "string",
+                chats: Array.isArray(registry?.chats) ? registry.chats.length : 0,
+            },
+            sends: join(bots, "sends", `${profile}.jsonl`),
+        },
+        paths: {
+            state,
+            cache: cacheHome,
+            runs: runsDirectory,
+            bots,
+            sends: join(state, "sends", `${profile}.jsonl`),
+            messages: storePath(env),
+        },
+        store: await readStore(env),
+        legacyCache: { file: cacheFile, exists: cacheExists },
+        runs: { directory: runsDirectory, kept: countEntries(runsDirectory) },
+        client: clientAge(now()),
+        install: install(),
+        native: await native(),
+        speech: speechOf(speechModel, modelsDir ?? modelsDirectory(env)),
+    };
+};
+const speechOf = (id, directory) => {
+    const model = findModel(id);
+    return { model: id, languages: model?.languages ?? null, downloaded: model ? isInstalled(model, directory) : false };
+};
+const thisInstall = (env) => checkInstall({
+    scriptPath: ownScript(),
+    execPath: process.execPath,
+    runtime: runtime(),
+    env,
+    platform: process.platform,
+});
+/** The two parts that are not JavaScript. Loaded here, never used: a load that fails is the answer. */
+const loadNative = async () => {
+    const attempt = async (load) => {
+        try {
+            await load();
+            return "ok";
+        }
+        catch (error) {
+            return error instanceof Error ? (error.message.split("\n")[0] ?? "failed") : String(error);
+        }
+    };
+    return {
+        // The keyring module belongs to cli-core, so it is resolved from there, as cli-core does.
+        keyring: await attempt(() => createRequire(import.meta.resolve("@wirecat/cli-core"))("@napi-rs/keyring")),
+        sqlite: await attempt(async () => (await openCache(":memory:")).close()),
+    };
+};
+/** A file that is missing, unreadable or not JSON is "no session", never a thrown error. */
+const readState = (file) => {
+    try {
+        const parsed = JSON.parse(readFileSync(file, "utf8"));
+        return typeof parsed === "object" && parsed !== null ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+/** `<profile>.moderation.json` shares the directory (`moderation/rules.ts`). */
+const MODERATION_SUFFIX = ".moderation.json";
+/**
+ * **Which profiles have been logged in**, which is not the same list as the configured ones —
+ * `config show` says so and cannot answer it, because a profile needs no configuration entry.
+ */
+const profilesWithState = (directory) => jsonNames(directory, MODERATION_SUFFIX);
+/** File names only: `bots/joins/` and `bots/sends/` are folders, not profiles. */
+const jsonNames = (directory, except) => {
+    try {
+        return readdirSync(directory, { withFileTypes: true })
+            .filter((entry) => entry.isFile() && entry.name.endsWith(".json") && !(except && entry.name.endsWith(except)))
+            .map((entry) => entry.name.slice(0, -".json".length))
+            .sort();
+    }
+    catch {
+        return [];
+    }
+};
+/**
+ * **Every profile, from files only**: a personal state file, a bot registry file, or a name in the
+ * configuration. It never reads the keyring — `config show` uses it as is, and that is `doctor`'s
+ * job (`CLI-12`); `diagnose` adds the keyring on top.
+ */
+export const knownProfiles = ({ stateDir, configured = [], env = process.env, }) => {
+    const state = stateDir ?? resolvePaths({ appName: "max-cli", prefix: "MAX", env }).state;
+    const personal = new Set(profilesWithState(join(state, "profiles")));
+    const bot = new Set(jsonNames(join(state, "bots")));
+    const named = new Set(configured);
+    return [...new Set([...personal, ...bot, ...named])]
+        .sort()
+        .map((name) => ({ name, personal: personal.has(name), bot: bot.has(name), configured: named.has(name) }));
+};
+const countEntries = (directory) => {
+    try {
+        return readdirSync(directory).filter((name) => statSync(join(directory, name)).isDirectory()).length;
+    }
+    catch {
+        return 0;
+    }
+};
+const DAY_MS = 86_400_000;
+const clientAge = (today) => {
+    const ageDays = Math.floor((today.getTime() - Date.parse(CLIENT.readOn)) / DAY_MS);
+    return { ...CLIENT, ageDays, stale: ageDays > STALE_AFTER_DAYS };
+};
+//# sourceMappingURL=diagnose.js.map

package/dist/diagnose.js.map

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

package/dist/domain/map.d.ts

@@ -0,0 +1,65 @@
+import { type Payload } from "../protocol/frame.js";
+import type { AccountSession, Button, CallRecord, Chat, Contact, Folder, GroupCard, GroupMember, GroupSettings, Id, Message, Poll, PrivacySettings, Profile, ProfileFacts, Reactions, Sticker, StickerSet } 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;
+/** Our name for each flag MAX lets an owner write (PyMax `ChatOption`); the rest are read-only. */
+export declare const SETTING_FLAGS: Record<keyof GroupSettings, string>;
+export declare const toGroupCard: (raw: Payload) => GroupCard;
+export declare const toMessage: (raw: Payload, chatId: Id, lookup?: NameLookup) => Message;
+/** `lastMessagedAt` is always `null` here: MAX puts it on the chat, and only the store has both. */
+export declare const toContact: (raw: Payload) => Contact;
+/**
+ * One entry of opcode 59 `MEMBER`: `{contact, presence: {seen, status?}, readMark}` (measured
+ * 2026-09-27). The unit of `seen` and `registrationTime` was not seen, so both are read either way.
+ */
+export declare const toGroupMember: (raw: Payload) => GroupMember;
+/**
+ * One `CONTACT_INFO` contact as `contacts profile` shows it. MAX tells when the account was made and
+ * whether it has a photo; `options` naming `BOT` marks a bot (measured 2026-10-08, `pnpm probe:bot-link info`).
+ */
+export declare const toProfileFacts: (raw: Payload, chats: ProfileFacts["chats"]) => ProfileFacts;
+/** One person's entry of opcode 35 `{seen, status?}`; `status` 1 is online in the tab's code, never measured. */
+export declare const toSeen: (raw: Payload | undefined) => ProfileFacts["seen"];
+export declare const toProfile: (raw: Payload) => Profile;
+export declare const toFolder: (raw: Payload) => Folder;
+export declare const toSession: (raw: Payload) => AccountSession;
+/** A call in the history 163 answers (measured 2026-10-08); `HUNGUP` is one that was picked up, as the web client reads it. */
+export declare const toCallRecord: (raw: Payload, self: Id | undefined) => CallRecord;
+/**
+ * The privacy part of the settings LOGIN carries. A key left out means MAX's default, as the web client
+ * reads it (chunk `Cdo8IOYe`, 2026-10-08): everyone may find, call and invite; contacts see the number.
+ */
+export declare const toPrivacy: (user: Payload) => PrivacySettings;
+/** The other way: only the settings named, as MAX names them. MAX finds an account by number for everyone or contacts only. */
+export declare const fromPrivacy: (change: PrivacySettings) => Record<string, string | boolean>;
+export declare const toStickerSet: (raw: Payload) => StickerSet;
+export declare const toSticker: (raw: Payload) => Sticker;
+/** 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>;
+/** The last four digits only, unless the owner asks for the whole number (`NEED-209`). */
+export declare const maskedProfile: (profile: Profile) => Profile;
+/** `reactionInfo` as the reaction request answers it (measured 2026-09-23). */
+export declare const toReactions: (raw: Payload) => Reactions;
+/** A bot's keyboard: `{callbackId, keyboard: {buttons: [[{type, text, payload, url, intent}]]}}` (measured 2026-10-08). */
+export declare const toButtons: (entry: Payload) => Button[][];
+export declare const POLL_CLOSED = 8;
+export declare const toPoll: (entry: Payload) => Poll | undefined;
+/** The settings bits a new poll is created with. */
+export declare const pollSettings: ({ multiple, anonymous, revote, }: {
+    multiple?: boolean;
+    anonymous?: boolean;
+    revote?: boolean;
+}) => number;
+//# 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":"AACA,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EACV,cAAc,EAGd,MAAM,EAEN,UAAU,EACV,IAAI,EAEJ,OAAO,EACP,MAAM,EACN,SAAS,EACT,WAAW,EACX,aAAa,EACb,EAAE,EACF,OAAO,EACP,IAAI,EACJ,eAAe,EACf,OAAO,EACP,YAAY,EAEZ,SAAS,EACT,OAAO,EACP,UAAU,EACX,MAAM,aAAa,CAAA;AAEpB;;;;;;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,QAAS,OAAO,KAAG,IAOpC,CAAA;AAEF,mGAAmG;AACnG,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,aAAa,EAAE,MAAM,CAM7D,CAAA;AAED,eAAO,MAAM,WAAW,QAAS,OAAO,KAAG,SAe1C,CAAA;AAED,eAAO,MAAM,SAAS,QAAS,OAAO,UAAU,EAAE,WAAU,UAAU,KAAQ,OAkB7E,CAAA;AAuDD,oGAAoG;AACpG,eAAO,MAAM,SAAS,QAAS,OAAO,KAAG,OAMvC,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAS,OAAO,KAAG,WAU5C,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAS,OAAO,SAAS,YAAY,CAAC,OAAO,CAAC,KAAG,YAc3E,CAAA;AAED,iHAAiH;AACjH,eAAO,MAAM,MAAM,QAAS,OAAO,GAAG,SAAS,KAAG,YAAY,CAAC,MAAM,CAGpE,CAAA;AASD,eAAO,MAAM,SAAS,QAAS,OAAO,KAAG,OAUxC,CAAA;AAED,eAAO,MAAM,QAAQ,QAAS,OAAO,KAAG,MAItC,CAAA;AAEF,eAAO,MAAM,SAAS,QAAS,OAAO,KAAG,cAMvC,CAAA;AAEF,+HAA+H;AAC/H,eAAO,MAAM,YAAY,QAAS,OAAO,QAAQ,EAAE,GAAG,SAAS,KAAG,UAejE,CAAA;AAWD;;;GAGG;AACH,eAAO,MAAM,SAAS,SAAU,OAAO,KAAG,eAMxC,CAAA;AAIF,+HAA+H;AAC/H,eAAO,MAAM,WAAW,WAAY,eAAe,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAepF,CAAA;AAED,eAAO,MAAM,YAAY,QAAS,OAAO,KAAG,UAK1C,CAAA;AAEF,eAAO,MAAM,SAAS,QAAS,OAAO,KAAG,OAKvC,CAAA;AAEF,oGAAoG;AACpG,eAAO,MAAM,SAAS,aAAc,OAAO,KAAG,GAAG,CAAC,EAAE,EAAE,MAAM,CAY3D,CAAA;AA+CD,0FAA0F;AAC1F,eAAO,MAAM,aAAa,YAAa,OAAO,KAAG,OAG/C,CAAA;AASF,+EAA+E;AAC/E,eAAO,MAAM,WAAW,QAAS,OAAO,KAAG,SAM1C,CAAA;AA6DD,2HAA2H;AAC3H,eAAO,MAAM,SAAS,UAAW,OAAO,KAAG,MAAM,EAAE,EAUlD,CAAA;AAMD,eAAO,MAAM,WAAW,IAAI,CAAA;AAW5B,eAAO,MAAM,MAAM,UAAW,OAAO,KAAG,IAAI,GAAG,SAwC9C,CAAA;AAED,oDAAoD;AACpD,eAAO,MAAM,YAAY,qCAItB;IACD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,KAAG,MAAwG,CAAA"}