@wirecat/max-cli 0.0.0 → 0.42.0

package/dist/transcribe/speech.d.ts

@@ -0,0 +1,25 @@
+import type { SpeechModel } from "./models.js";
+/** What transcription needs from a speech engine — small enough for a test to stand in for it. */
+export interface Recognizer {
+    recognize(pcm: Float32Array): string;
+    free(): void;
+}
+export declare const SAMPLE_RATE = 16000;
+/**
+ * MAX voice messages are Ogg Opus at 48 kHz (measured on a received one), and the models want
+ * 16 kHz. Averaging each three samples is ours rather than the engine's resampler, which announces
+ * itself on stderr on every call.
+ */
+export declare const toModelRate: (samples: Float32Array, rate: number) => Float32Array;
+export declare const decodeOgg: (bytes: Uint8Array) => Promise<{
+    samples: Float32Array;
+    rate: number;
+}>;
+/**
+ * The model, and a voice detector that cuts the audio at pauses into pieces of at most 20 seconds.
+ * The cutting is not optional: five minutes in one piece crash the WebAssembly build (measured).
+ *
+ * `sherpa-onnx` is loaded here, on first use, so no other command pays for its 15 MB of WebAssembly.
+ */
+export declare const openRecognizer: (model: SpeechModel, path: (name: string) => string, vadModel: string) => Recognizer;
+//# sourceMappingURL=speech.d.ts.map

package/dist/transcribe/speech.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speech.d.ts","sourceRoot":"","sources":["../../src/transcribe/speech.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,kGAAkG;AAClG,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAAA;IACpC,IAAI,IAAI,IAAI,CAAA;CACb;AAED,eAAO,MAAM,WAAW,QAAS,CAAA;AAQjC;;;;GAIG;AACH,eAAO,MAAM,WAAW,YAAa,YAAY,QAAQ,MAAM,KAAG,YAYjE,CAAA;AAED,eAAO,MAAM,SAAS,UAAiB,UAAU,KAAG,OAAO,CAAC;IAAE,OAAO,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAYlG,CAAA;AA0BD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,UAAW,WAAW,QAAQ,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,YAAY,MAAM,KAAG,UA0DrG,CAAA"}

package/dist/transcribe/speech.js

@@ -0,0 +1,107 @@
+import { createRequire } from "node:module";
+export const SAMPLE_RATE = 16_000;
+/**
+ * Half a second of silence ahead of the speech. Without it the voice detector clipped a recording
+ * that starts talking at once: "Ничьих" came back as "чьих" (measured 2026-09-24).
+ */
+const LEAD = SAMPLE_RATE / 2;
+/**
+ * MAX voice messages are Ogg Opus at 48 kHz (measured on a received one), and the models want
+ * 16 kHz. Averaging each three samples is ours rather than the engine's resampler, which announces
+ * itself on stderr on every call.
+ */
+export const toModelRate = (samples, rate) => {
+    const step = rate / SAMPLE_RATE;
+    const length = Math.floor(samples.length / step);
+    const pcm = new Float32Array(LEAD + length);
+    for (let i = 0; i < length; i++) {
+        const from = Math.floor(i * step);
+        const to = Math.max(from + 1, Math.floor((i + 1) * step));
+        let sum = 0;
+        for (let j = from; j < to; j++)
+            sum += samples[j] ?? 0;
+        pcm[LEAD + i] = sum / (to - from);
+    }
+    return pcm;
+};
+export const decodeOgg = async (bytes) => {
+    const { OggOpusDecoder } = await import("ogg-opus-decoder");
+    const decoder = new OggOpusDecoder();
+    await decoder.ready;
+    try {
+        const { channelData, sampleRate, samplesDecoded } = await decoder.decodeFile(bytes);
+        const samples = channelData[0];
+        if (!samples || samplesDecoded === 0)
+            throw new Error("no Ogg Opus audio in it");
+        return { samples, rate: sampleRate };
+    }
+    finally {
+        decoder.free();
+    }
+};
+const WINDOW = 512;
+/**
+ * The model, and a voice detector that cuts the audio at pauses into pieces of at most 20 seconds.
+ * The cutting is not optional: five minutes in one piece crash the WebAssembly build (measured).
+ *
+ * `sherpa-onnx` is loaded here, on first use, so no other command pays for its 15 MB of WebAssembly.
+ */
+export const openRecognizer = (model, path, vadModel) => {
+    const sherpa = createRequire(import.meta.url)("sherpa-onnx");
+    const engine = sherpa.createOfflineRecognizer({
+        featConfig: { sampleRate: SAMPLE_RATE, featureDim: model.featureDim },
+        modelConfig: { ...model.config(path), numThreads: 1, provider: "cpu", debug: 0 },
+        decodingMethod: "greedy_search",
+    });
+    const vad = sherpa.createVad({
+        sileroVad: {
+            model: vadModel,
+            threshold: 0.5,
+            minSilenceDuration: 0.5,
+            minSpeechDuration: 0.25,
+            maxSpeechDuration: 20,
+            windowSize: WINDOW,
+        },
+        sampleRate: SAMPLE_RATE,
+        numThreads: 1,
+        provider: "cpu",
+        debug: 0,
+        bufferSizeInSeconds: 30,
+    });
+    const piece = (samples) => {
+        const stream = engine.createStream();
+        try {
+            stream.acceptWaveform(SAMPLE_RATE, samples);
+            engine.decode(stream);
+            return engine.getResult(stream).text.trim();
+        }
+        finally {
+            stream.free();
+        }
+    };
+    return {
+        recognize: (pcm) => {
+            // One recognizer can hear several recordings in a row; nothing of the last may leak into this one.
+            vad.reset();
+            const parts = [];
+            const drain = () => {
+                while (!vad.isEmpty()) {
+                    parts.push(piece(vad.front().samples));
+                    vad.pop();
+                }
+            };
+            for (let i = 0; i + WINDOW <= pcm.length; i += WINDOW) {
+                vad.acceptWaveform(pcm.subarray(i, i + WINDOW));
+                drain();
+            }
+            vad.flush();
+            drain();
+            return parts.filter(Boolean).join(" ");
+        },
+        free: () => {
+            vad.free();
+            engine.free();
+        },
+    };
+};
+//# sourceMappingURL=speech.js.map

package/dist/transcribe/speech.js.map

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

package/dist/update.d.ts

@@ -0,0 +1,31 @@
+import type { FetchLike } from "@wirecat/cli-core/http";
+import { type Installer } from "@wirecat/cli-core/update";
+export declare const PACKAGE = "@wirecat/max-cli";
+/** npm, the clock, the terminal and the package manager as `max upgrade` sees them — faked in a test. */
+export interface UpdateEnvironment {
+    fetch?: FetchLike;
+    now?: () => number;
+    stderrIsTTY?: boolean;
+    scriptPath?: string;
+    /** Runs the update and answers its exit code; its output goes to stderr. */
+    spawn?: (argv: string[]) => number;
+}
+export declare const installer: ({ scriptPath }?: UpdateEnvironment) => Installer;
+export declare const latest: (environment?: UpdateEnvironment) => Promise<string | undefined>;
+/** The package manager's output goes to stderr, so stdout stays one result. */
+export declare const runUpdate: (argv: string[], environment?: UpdateEnvironment) => number;
+/**
+ * The daily "a newer version exists" line, or `undefined`. Started beside the command and awaited
+ * after it, so asking npm costs the command nothing; any failure is silence, never an error.
+ */
+export declare const updateNotice: (argv: readonly string[], { tty, environment, env, }: {
+    tty?: boolean;
+    environment?: UpdateEnvironment;
+    env?: NodeJS.ProcessEnv;
+}) => Promise<string | undefined>;
+/** The daily line telling an agent that `max skill install` gives it this tool's guide, or `undefined`. */
+export declare const skillHint: (argv: readonly string[], { env, now }?: {
+    env?: NodeJS.ProcessEnv;
+    now?: () => number;
+}) => string | undefined;
+//# sourceMappingURL=update.d.ts.map

package/dist/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAEvD,OAAO,EACL,KAAK,SAAS,EAKf,MAAM,0BAA0B,CAAA;AAKjC,eAAO,MAAM,OAAO,qBAAqB,CAAA;AAEzC,yGAAyG;AACzG,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM,CAAA;CACnC;AAED,eAAO,MAAM,SAAS,oBAAoB,iBAAiB,KAAQ,SACM,CAAA;AAEzE,eAAO,MAAM,MAAM,iBAAiB,iBAAiB,gCACoB,CAAA;AAEzE,+EAA+E;AAC/E,eAAO,MAAM,SAAS,SAAU,MAAM,EAAE,gBAAe,iBAAiB,KAAQ,MACT,CAAA;AAKvE;;;GAGG;AACH,eAAO,MAAM,YAAY,SACjB,SAAS,MAAM,EAAE,8BAKpB;IAAE,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KAC7E,OAAO,CAAC,MAAM,GAAG,SAAS,CAiC5B,CAAA;AAED,2GAA2G;AAC3G,eAAO,MAAM,SAAS,SACd,SAAS,MAAM,EAAE,iBACK;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAAE,KAC1E,MAAM,GAAG,SAcX,CAAA"}

package/dist/update.js

@@ -0,0 +1,69 @@
+import { realpathSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { resolvePaths } from "@wirecat/cli-core";
+import { skillHint as sharedSkillHint } from "@wirecat/cli-core/skill";
+import { installerOf, latestVersion, runUpdate as runPackageManager, updateNotice as sharedNotice, } from "@wirecat/cli-core/update";
+import { resolveSettings } from "./config.js";
+import { SKILL_APP } from "./skill.js";
+import { VERSION } from "./version.js";
+export const PACKAGE = "@wirecat/max-cli";
+export const installer = ({ scriptPath } = {}) => installerOf(scriptPath ?? realpathSync(fileURLToPath(import.meta.url)));
+export const latest = (environment = {}) => latestVersion(PACKAGE, environment.fetch ?? fetch, { timeoutMs: 3000 });
+/** The package manager's output goes to stderr, so stdout stays one result. */
+export const runUpdate = (argv, environment = {}) => environment.spawn ? environment.spawn(argv) : runPackageManager(argv);
+const statePath = (env) => join(resolvePaths({ appName: "max-cli", prefix: "MAX", env }).state, "update-check.json");
+/**
+ * The daily "a newer version exists" line, or `undefined`. Started beside the command and awaited
+ * after it, so asking npm costs the command nothing; any failure is silence, never an error.
+ */
+export const updateNotice = (argv, { tty, environment = {}, env = process.env, }) => {
+    try {
+        const delimiter = argv.indexOf("--");
+        const options = argv.slice(0, delimiter < 0 ? undefined : delimiter);
+        if (["--help", "-h", "--version", "-V", "--json", "--jsonl", "--dry-run", "--timeout", "commands"].some((word) => options.includes(word)))
+            return Promise.resolve(undefined);
+        if (argv.includes("upgrade"))
+            return Promise.resolve(undefined);
+        const pretty = !argv.includes("--json") && !argv.includes("--jsonl") && (tty ?? process.stdout.isTTY === true);
+        // cli-core names the command `update`; it is `upgrade` here (CONVENTIONS, "Command names").
+        return sharedNotice({
+            argv,
+            packageName: PACKAGE,
+            command: "max",
+            version: VERSION,
+            statePath: statePath(env),
+            fetch: environment.fetch ?? fetch,
+            ...(environment.now ? { now: environment.now } : {}),
+            format: pretty ? "pretty" : "json",
+            stderrIsTTY: environment.stderrIsTTY ?? process.stderr.isTTY === true,
+            quiet: argv.includes("--quiet"),
+            enabled: resolveSettings({}, { env }).updateCheck,
+            installer: installer(environment),
+            env,
+            offVariables: ["MAX_NO_UPDATE_CHECK"],
+        }).then((line) => line?.replace("`max update`", "`max upgrade`"));
+    }
+    catch {
+        return Promise.resolve(undefined);
+    }
+};
+/** The daily line telling an agent that `max skill install` gives it this tool's guide, or `undefined`. */
+export const skillHint = (argv, { env = process.env, now } = {}) => {
+    try {
+        if (argv.includes("--quiet"))
+            return undefined;
+        return sharedSkillHint({
+            app: SKILL_APP,
+            argv,
+            env,
+            statePath: statePath(env),
+            enabled: resolveSettings({}, { env }).skillHint,
+            ...(now ? { now } : {}),
+        });
+    }
+    catch {
+        return undefined;
+    }
+};
+//# sourceMappingURL=update.js.map

package/dist/update.js.map

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

package/dist/upload.d.ts

@@ -0,0 +1,15 @@
+export declare const isImage: (path: string) => boolean;
+export declare const isVideo: (path: string) => boolean;
+export declare const readUpload: (path: string, { anyFile }?: {
+    anyFile?: boolean;
+}) => Promise<Buffer>;
+/** Measured 2026-09-24: a multipart POST, field `file`, answers `{photos: {<key>: {token}}}`. */
+export declare const uploadPhoto: (url: string, path: string, bytes: Buffer) => Promise<string>;
+/**
+ * Measured 2026-09-24: the bytes raw, with `Content-Range: 0-<end>/<size>` — no `bytes ` unit, as
+ * PyMax sends it and MAX accepted.
+ */
+export declare const uploadFile: (url: string, path: string, bytes: Buffer) => Promise<void>;
+/** Measured 2026-09-27 with the `bytes ` unit, which PyMax and the web client send for these. */
+export declare const uploadMedia: (kind: "video" | "voice message", url: string, path: string, bytes: Buffer) => Promise<void>;
+//# sourceMappingURL=upload.d.ts.map

package/dist/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,OAAO,SAAU,MAAM,KAAG,OAAqD,CAAA;AAK5F,eAAO,MAAM,OAAO,SAAU,MAAM,KAAG,OAA4D,CAAA;AA2BnG,eAAO,MAAM,UAAU,SAAgB,MAAM,gBAAuB;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,KAAQ,OAAO,CAAC,MAAM,CAc9G,CAAA;AAUD,iGAAiG;AACjG,eAAO,MAAM,WAAW,QAAe,MAAM,QAAQ,MAAM,SAAS,MAAM,KAAG,OAAO,CAAC,MAAM,CAY1F,CAAA;AAkBD;;;GAGG;AACH,eAAO,MAAM,UAAU,QAAS,MAAM,QAAQ,MAAM,SAAS,MAAM,KAAG,OAAO,CAAC,IAAI,CACN,CAAA;AAE5E,iGAAiG;AACjG,eAAO,MAAM,WAAW,SAAU,OAAO,GAAG,eAAe,OAAO,MAAM,QAAQ,MAAM,SAAS,MAAM,kBACrB,CAAA"}

package/dist/upload.js

@@ -0,0 +1,97 @@
+import { realpathSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { basename, extname, isAbsolute, relative, resolve, sep } from "node:path";
+import { CliError, resolvePaths } from "@wirecat/cli-core";
+import { WEB_USER_AGENT } from "./spec/identity.js";
+const HEADERS = {
+    "User-Agent": WEB_USER_AGENT.headerUserAgent,
+    Referer: "https://web.max.ru/",
+    Origin: "https://web.max.ru",
+};
+const IMAGE_TYPES = {
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".png": "image/png",
+    ".webp": "image/webp",
+    ".gif": "image/gif",
+};
+export const isImage = (path) => extname(path).toLowerCase() in IMAGE_TYPES;
+/** The Bot API's list of video formats; MAX transcodes what it takes. */
+const VIDEO_EXTENSIONS = new Set([".mp4", ".mov", ".webm", ".mkv"]);
+export const isVideo = (path) => VIDEO_EXTENSIONS.has(extname(path).toLowerCase());
+/**
+ * A file somebody talked an agent into sending would be a key or a token: those live in hidden
+ * files and folders, `~/.ssh` among them, and in max's own folders, which `MAX_*_DIR` can move out
+ * of sight (`NEED-274`). The real path is checked as well as the typed one, so a link does not hide
+ * where it points.
+ */
+const refusedPlace = (path) => {
+    const own = Object.values(resolvePaths({ appName: "max-cli", prefix: "MAX" }));
+    let real = resolve(path);
+    try {
+        real = realpathSync(path);
+    }
+    catch { }
+    return [resolve(path), real].some((candidate) => candidate.split(sep).some((part) => part.startsWith(".") && part !== "." && part !== "..") ||
+        own.some((dir) => inside(candidate, dir)));
+};
+const inside = (path, dir) => {
+    const fold = (value) => (process.platform === "win32" ? value.toLowerCase() : value);
+    const way = relative(fold(resolve(dir)), fold(path));
+    return way === "" || (!way.startsWith("..") && !isAbsolute(way));
+};
+export const readUpload = async (path, { anyFile = false } = {}) => {
+    if (!anyFile && refusedPlace(path)) {
+        throw new CliError("validation_error", `cannot send ${path}: hidden files and folders, ~/.ssh and max's own folders are not sent — ` +
+            "add --allow-any-file if this file is meant to go");
+    }
+    try {
+        return await readFile(path);
+    }
+    catch (error) {
+        const reason = error.code === "ENOENT" ? "no such file" : "it cannot be read";
+        throw new CliError("validation_error", `cannot send ${path}: ${reason}`);
+    }
+};
+/** The whole upload, not a stall: `fetch` reports no progress on a body it sends. */
+const UPLOAD_MS = 15 * 60_000;
+const uploadDeadline = () => AbortSignal.timeout(UPLOAD_MS);
+const refused = (kind, status) => new CliError("network_error", `the ${kind} could not be uploaded: HTTP ${status} — nothing was sent`);
+/** Measured 2026-09-24: a multipart POST, field `file`, answers `{photos: {<key>: {token}}}`. */
+export const uploadPhoto = async (url, path, bytes) => {
+    const form = new FormData();
+    const type = IMAGE_TYPES[extname(path).toLowerCase()] ?? "application/octet-stream";
+    form.append("file", new Blob([bytes], { type }), `image${extname(path).toLowerCase()}`);
+    const response = await fetch(url, { method: "POST", headers: HEADERS, body: form, signal: uploadDeadline() });
+    if (!response.ok)
+        throw refused("photo", response.status);
+    const answer = (await response.json().catch(() => ({})));
+    const token = Object.values(answer.photos ?? {})[0]?.token;
+    if (typeof token !== "string")
+        throw new CliError("provider_error", "the photo upload answered no token — nothing was sent");
+    return token;
+};
+const postRaw = async (kind, url, path, bytes, range) => {
+    const response = await fetch(url, {
+        method: "POST",
+        headers: {
+            ...HEADERS,
+            "Content-Disposition": `attachment; filename=${encodeURIComponent(basename(path))}`,
+            "Content-Range": range,
+            "Content-Type": "application/octet-stream",
+        },
+        body: bytes,
+        signal: uploadDeadline(),
+    });
+    await response.body?.cancel();
+    if (!response.ok)
+        throw refused(kind, response.status);
+};
+/**
+ * Measured 2026-09-24: the bytes raw, with `Content-Range: 0-<end>/<size>` — no `bytes ` unit, as
+ * PyMax sends it and MAX accepted.
+ */
+export const uploadFile = (url, path, bytes) => postRaw("file", url, path, bytes, `0-${bytes.length - 1}/${bytes.length}`);
+/** Measured 2026-09-27 with the `bytes ` unit, which PyMax and the web client send for these. */
+export const uploadMedia = (kind, url, path, bytes) => postRaw(kind, url, path, bytes, `bytes 0-${bytes.length - 1}/${bytes.length}`);
+//# sourceMappingURL=upload.js.map

package/dist/upload.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.42.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAA"}

package/dist/version.js

@@ -0,0 +1,2 @@
+export const VERSION = "0.42.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAA"}

package/dist/voice.d.ts

@@ -0,0 +1,9 @@
+/**
+ * What a voice message carries besides the file, as web.max.ru builds it (`FIND-104`): its length
+ * in milliseconds and 80 bars of loudness, 0–127. Computed here, so only the file leaves the machine.
+ */
+export declare const voiceOf: (path: string, bytes: Uint8Array) => Promise<{
+    durationMs: number;
+    wave: Uint8Array;
+}>;
+//# sourceMappingURL=voice.d.ts.map

package/dist/voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../src/voice.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,eAAO,MAAM,OAAO,SAAgB,MAAM,SAAS,UAAU,KAAG,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAyB/G,CAAA"}

package/dist/voice.js

@@ -0,0 +1,36 @@
+import { CliError } from "@wirecat/cli-core";
+import { decodeOgg } from "./transcribe/speech.js";
+const BARS = 80;
+const isOggOpus = (bytes) => {
+    const head = Buffer.from(bytes.subarray(0, 64)).toString("latin1");
+    return head.startsWith("OggS") && head.includes("OpusHead");
+};
+/**
+ * What a voice message carries besides the file, as web.max.ru builds it (`FIND-104`): its length
+ * in milliseconds and 80 bars of loudness, 0–127. Computed here, so only the file leaves the machine.
+ */
+export const voiceOf = async (path, bytes) => {
+    if (!isOggOpus(bytes)) {
+        throw new CliError("validation_error", `${path} is not Ogg Opus, the format of a voice message — convert it first: ` +
+            "ffmpeg -i <file> -ac 1 -ar 48000 -c:a libopus -b:a 32k voice.ogg");
+    }
+    let decoded;
+    try {
+        decoded = await decodeOgg(bytes);
+    }
+    catch {
+        throw new CliError("validation_error", `${path} could not be decoded as Ogg Opus`);
+    }
+    const { samples, rate } = decoded;
+    const wave = new Uint8Array(BARS);
+    const size = Math.max(1, Math.floor(samples.length / BARS));
+    for (let bar = 0; bar < BARS; bar++) {
+        let peak = 0;
+        for (let index = bar * size; index < Math.min(samples.length, (bar + 1) * size); index++) {
+            peak = Math.max(peak, Math.abs(samples[index] ?? 0));
+        }
+        wave[bar] = Math.min(127, Math.round(peak * 127));
+    }
+    return { durationMs: Math.round((samples.length / rate) * 1000), wave };
+};
+//# sourceMappingURL=voice.js.map

package/dist/voice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.js","sourceRoot":"","sources":["../src/voice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAElD,MAAM,IAAI,GAAG,EAAE,CAAA;AAEf,MAAM,SAAS,GAAG,CAAC,KAAiB,EAAW,EAAE;IAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAClE,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;AAC7D,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,IAAY,EAAE,KAAiB,EAAqD,EAAE;IAClH,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,GAAG,IAAI,sEAAsE;YAC3E,kEAAkE,CACrE,CAAA;IACH,CAAC;IACD,IAAI,OAAgD,CAAA;IACpD,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,CAAA;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,GAAG,IAAI,mCAAmC,CAAC,CAAA;IACpF,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,OAAO,CAAA;IACjC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAA;IAC3D,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;QACpC,IAAI,IAAI,GAAG,CAAC,CAAA;QACZ,KAAK,IAAI,KAAK,GAAG,GAAG,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;YACzF,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACtD,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAA;IACnD,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,IAAI,EAAE,CAAA;AACzE,CAAC,CAAA"}

package/dist/wire-events.d.ts

@@ -0,0 +1,23 @@
+import type { Payload } from "./protocol/frame.js";
+/** The warnings the client raises: a code, never the sentence — the sentence quotes MAX, and MAX quotes us. */
+export type WarningCode = "chats_partial" | "token_not_saved" | "cache_not_written" | "reactions_unread" | "names_unread" | "response_shape";
+/**
+ * The ids a request named, by name, from a list of fields that is written out here.
+ *
+ * **An allowlist, never a filter.** Copying the request and removing what looks dangerous means a
+ * field nobody has seen yet arrives in the log by default; this way it cannot. `token` is the case
+ * that matters: it is a field of `session.login` and there is no branch here that could reach it.
+ */
+export declare const idsOf: (request: unknown) => {
+    ids?: Record<string, string>;
+    counts?: Record<string, number>;
+};
+/**
+ * How many of each list MAX sent back — `{ chats: 25, contacts: 6 }`.
+ *
+ * Every array at the top of the answer, counted. Generic on purpose: a per-operation table of
+ * "which field is the interesting one" is a second registry to keep in step with `src/spec/`, and
+ * a field name with a length beside it is content-free whatever MAX adds next.
+ */
+export declare const countsIn: (payload: Payload) => Record<string, number> | undefined;
+//# sourceMappingURL=wire-events.d.ts.map

package/dist/wire-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-events.d.ts","sourceRoot":"","sources":["../src/wire-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,+GAA+G;AAC/G,MAAM,MAAM,WAAW,GACnB,eAAe,GACf,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,cAAc,GACd,gBAAgB,CAAA;AAEpB;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,YAAa,OAAO,KAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAqBvG,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,YAAa,OAAO,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAIpE,CAAA"}

package/dist/wire-events.js

@@ -0,0 +1,47 @@
+/**
+ * The ids a request named, by name, from a list of fields that is written out here.
+ *
+ * **An allowlist, never a filter.** Copying the request and removing what looks dangerous means a
+ * field nobody has seen yet arrives in the log by default; this way it cannot. `token` is the case
+ * that matters: it is a field of `session.login` and there is no branch here that could reach it.
+ */
+export const idsOf = (request) => {
+    if (!isRecord(request))
+        return {};
+    const ids = {};
+    const counts = {};
+    if (isId(request.chatId))
+        ids.chat = String(request.chatId);
+    if (isId(request.messageId))
+        ids.message = String(request.messageId);
+    if (typeof request.cid === "number")
+        ids.send = String(request.cid);
+    // `messages.send` carries its client id one level down, and the `cid` is the one thing that makes
+    // an ambiguous send repeatable — see `MaxClient.messages.send`.
+    const message = isRecord(request.message) ? request.message : undefined;
+    if (message && typeof message.cid === "number")
+        ids.send = String(message.cid);
+    if (Array.isArray(request.contactIds))
+        counts.contacts = request.contactIds.length;
+    return {
+        ...(Object.keys(ids).length > 0 ? { ids } : {}),
+        ...(Object.keys(counts).length > 0 ? { counts } : {}),
+    };
+};
+/**
+ * How many of each list MAX sent back — `{ chats: 25, contacts: 6 }`.
+ *
+ * Every array at the top of the answer, counted. Generic on purpose: a per-operation table of
+ * "which field is the interesting one" is a second registry to keep in step with `src/spec/`, and
+ * a field name with a length beside it is content-free whatever MAX adds next.
+ */
+export const countsIn = (payload) => {
+    const counts = {};
+    for (const [field, value] of Object.entries(payload))
+        if (Array.isArray(value))
+            counts[field] = value.length;
+    return Object.keys(counts).length > 0 ? counts : undefined;
+};
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isId = (value) => typeof value === "string" || typeof value === "number" || typeof value === "bigint";
+//# sourceMappingURL=wire-events.js.map

package/dist/wire-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-events.js","sourceRoot":"","sources":["../src/wire-events.ts"],"names":[],"mappings":"AAWA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,OAAgB,EAAqE,EAAE;IAC3G,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAA;IAEjC,MAAM,GAAG,GAA2B,EAAE,CAAA;IACtC,MAAM,MAAM,GAA2B,EAAE,CAAA;IAEzC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3D,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;QAAE,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACpE,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ;QAAE,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAEnE,kGAAkG;IAClG,gEAAgE;IAChE,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;IACvE,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ;QAAE,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAE9E,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;QAAE,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAA;IAElF,OAAO;QACL,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAA;AACH,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,OAAgB,EAAsC,EAAE;IAC/E,MAAM,MAAM,GAA2B,EAAE,CAAA;IACzC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,CAAA;IAC5G,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;AAC5D,CAAC,CAAA;AAED,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CACpE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAEtE,MAAM,IAAI,GAAG,CAAC,KAAc,EAAqC,EAAE,CACjE,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAA"}

package/install/postinstall.mjs

@@ -0,0 +1,3 @@
+if (process.env.npm_config_global === "true") {
+  await import("../dist/install/postinstall.js").then(({ completeGlobalInstall }) => completeGlobalInstall())
+}