@wirecat/max-cli 0.0.0 → 0.43.0

package/dist/spec/operations/messages.js

@@ -0,0 +1,347 @@
+import * as v from "valibot";
+import { defineOperation } from "../define.js";
+import { ambiguous, chatOf, countOf, messageOf, objectOf, peopleOf } from "../guards.js";
+import { id } from "../scalars.js";
+export const messagesSend = defineOperation({
+    name: "messages.send",
+    constant: "MSG_SEND",
+    opcode: 64,
+    auth: true,
+    request: v.union([
+        v.strictObject({
+            chatId: id(),
+            message: v.strictObject({
+                /** Left out on a forward, as the web client does: the forwarded message is the content. */
+                text: v.optional(v.string()),
+                /**
+                 * The client id MAX deduplicates by — measured, and it is what makes one retry safe. It must
+                 * never be regenerated on a retry: a fresh one means a second message in somebody's chat.
+                 */
+                cid: v.pipe(v.number(), v.integer()),
+                /** Markup in UTF-16 positions. STRONG, EMPHASIZED, STRIKETHROUGH, MONOSPACED measured locally 2026-09-24; LINK attributes.url and UNDERLINE preserved in raw CHAT_HISTORY readback locally 2026-10-03 (release Saved messages check). */
+                elements: v.optional(v.array(v.strictObject({
+                    type: v.string(),
+                    from: v.number(),
+                    length: v.number(),
+                    attributes: v.optional(v.strictObject({ url: v.string() })),
+                }))),
+                attaches: v.array(v.unknown()),
+                /** Read back as `{type, chatId, message}` — the quoted message whole (measured 2026-09-23). */
+                link: v.optional(v.variant("type", [
+                    v.strictObject({ type: v.literal("REPLY"), messageId: id() }),
+                    /** `chatId` is the chat the message is forwarded **from** (web.max.ru, PyMax). */
+                    v.strictObject({ type: v.literal("FORWARD"), messageId: id(), chatId: id() }),
+                ])),
+                /**
+                 * When MAX itself sends it, in epoch milliseconds — the message waits in the chat's DELAYED
+                 * history until then. The answer adds `notifySender` and `notifyOpponents`, which we leave
+                 * to MAX as the web client does (measured 2026-09-24, `FIND-139`).
+                 */
+                delayedAttributes: v.optional(v.strictObject({ timeToFire: v.pipe(v.number(), v.integer()) })),
+            }),
+            /** Left out when starting a bot, as the web client does. */
+            notify: v.optional(v.boolean()),
+        }),
+        /**
+         * Creating a group is a message too: a CONTROL attachment with no chat to send it to. Measured
+         * 2026-09-24 with nobody invited (`pnpm probe:groups`); the answer adds `chat` and `chatId`.
+         * `CHANNEL` measured 2026-09-28 (`scripts/probe-channel.ts`): the answer is a private channel.
+         */
+        v.strictObject({
+            message: v.strictObject({
+                cid: v.pipe(v.number(), v.integer()),
+                attaches: v.tuple([
+                    v.strictObject({
+                        _type: v.literal("CONTROL"),
+                        event: v.literal("new"),
+                        chatType: v.picklist(["CHAT", "CHANNEL"]),
+                        title: v.pipe(v.string(), v.minLength(1)),
+                        userIds: v.array(id()),
+                    }),
+                ]),
+            }),
+            notify: v.boolean(),
+        }),
+    ]),
+    response: v.looseObject({ message: v.optional(v.looseObject({})), chat: v.optional(v.looseObject({})) }),
+    guard: (request) => {
+        const message = objectOf(request.message);
+        const cid = typeof message.cid === "number" ? { sendId: String(message.cid) } : {};
+        const [control] = Array.isArray(message.attaches) ? message.attaches.map(objectOf) : [];
+        if (request.chatId === undefined && control?._type === "CONTROL" && control.event === "new") {
+            return {
+                chatId: null,
+                kind: "chat",
+                action: "create",
+                people: countOf(control.userIds),
+                personIds: peopleOf(control.userIds),
+                ...cid,
+            };
+        }
+        const chatId = chatOf(request);
+        // Starting a bot is a message to it, as the web client's Start button sends it (chunk `Cdo8IOYe`, 2026-10-08).
+        const only = Array.isArray(message.attaches) && message.attaches.length === 1;
+        if (only && control?._type === "CONTROL" && control.event === "botStarted")
+            return { chatId, kind: "message", key: "chats.start", ...cid };
+        // A control attachment changes a chat; in a message it would pass as a plain send.
+        if (Array.isArray(message.attaches) && message.attaches.some((attach) => objectOf(attach)._type === "CONTROL")) {
+            return ambiguous("messages.send");
+        }
+        const attaches = Array.isArray(message.attaches) ? message.attaches.map(objectOf) : [];
+        if (attaches.some((attach) => attach._type === "POLL") &&
+            (attaches.length !== 1 ||
+                (typeof message.text === "string" && message.text !== "") ||
+                objectOf(message.link).type !== undefined))
+            return ambiguous("polls.create");
+        const link = objectOf(message.link);
+        const at = objectOf(message.delayedAttributes).timeToFire;
+        if (link.type === "FORWARD") {
+            if (typeof message.text === "string" && message.text !== "")
+                return ambiguous("messages.send");
+            return { chatId, kind: "forward", ...cid };
+        }
+        return {
+            chatId,
+            kind: "message",
+            ...(control?._type === "POLL" ? { key: "polls.create" } : {}),
+            ...cid,
+            length: typeof message.text === "string" ? message.text.length : 0,
+            ...(typeof at === "number" ? { scheduledFor: new Date(at).toISOString() } : {}),
+        };
+    },
+    provenance: {
+        confidence: "measured",
+        sources: [
+            "measured against MAX 2026-09-19, including deduplication by `cid` across two connections",
+            "`link` and `elements` measured 2026-09-23 in Saved messages (`pnpm probe:reply`); shapes from tsmax and PyMax",
+            "the FORWARD link: web.max.ru `_app/immutable/chunks/5oCuRT0F.js` (2026-09-24), PyMax `api/messages/payloads.py:56-73`",
+            "a forward with no `text` and no `elements` measured 2026-09-24 in Saved messages (`pnpm probe:edit-pin-forward`)",
+            "LINK attributes.url and UNDERLINE sent and preserved in raw CHAT_HISTORY readback 2026-10-03 in Saved messages (release check)",
+            "group creation measured 2026-09-24 (`pnpm probe:groups`); shape from PyMax create_group",
+            "`delayedAttributes` from web.max.ru (2026-09-24, `FIND-78`), measured 2026-09-24 in Saved messages (`pnpm probe:scheduled`)",
+        ],
+        notes: "How long MAX remembers a `cid` is still unmeasured (`PROTO-2`); the two probes were seconds apart. " +
+            "The forward was measured from chat 0 to chat 0, so that `link.chatId` is the source rests on the two clients.",
+    },
+});
+export const messagesEdit = defineOperation({
+    name: "messages.edit",
+    constant: "MSG_EDIT",
+    opcode: 67,
+    auth: true,
+    request: v.strictObject({
+        chatId: id(),
+        messageId: id(),
+        /** Left out when closing a poll, as the web client does: only the attachment changes. */
+        text: v.optional(v.string()),
+        elements: v.optional(v.array(v.strictObject({
+            type: v.string(),
+            from: v.number(),
+            length: v.number(),
+            attributes: v.optional(v.strictObject({ url: v.string() })),
+        }))),
+        /** `attachments`, not `attaches` as in MSG_SEND — every source spells them differently. */
+        attachments: v.array(v.unknown()),
+    }),
+    response: v.looseObject({ message: v.optional(v.looseObject({})) }),
+    guard: (request) => ({
+        chatId: chatOf(request),
+        kind: "edit",
+        ...(request.text === undefined &&
+            Array.isArray(request.attachments) &&
+            request.attachments.length === 1 &&
+            objectOf(request.attachments[0])._type === "POLL"
+            ? { key: "polls.close" }
+            : {}),
+        ...messageOf(request),
+        length: typeof request.text === "string" ? request.text.length : 0,
+    }),
+    provenance: {
+        confidence: "measured",
+        sources: [
+            "measured against MAX 2026-09-24 in Saved messages (`pnpm probe:edit-pin-forward`)",
+            "web.max.ru `_app/immutable/chunks/5oCuRT0F.js` (2026-09-24)",
+            "PyMax `api/messages/payloads.py:21-28` (53103f0)",
+        ],
+        notes: 'Answers `{message}` with `status: "EDITED"`. `attachments: []` removes a photo; the ones history gives, sent back ' +
+            "as they are, keep it. LOGIN's `config.server.edit-timeout` was 604800 s. The web client edits only your own " +
+            "messages, and never a forward.",
+    },
+});
+export const messagesReactions = defineOperation({
+    name: "messages.reactions",
+    constant: "MSG_GET_REACTIONS",
+    opcode: 180,
+    auth: true,
+    request: v.strictObject({ chatId: id(), messageIds: v.array(id()) }),
+    response: v.looseObject({ messagesReactions: v.optional(v.looseObject({})) }),
+    guard: null,
+    provenance: {
+        confidence: "measured",
+        sources: [
+            "measured against MAX 2026-09-24 in Saved messages (`pnpm probe:message-shapes`)",
+            "tsmax getReactions",
+            "PyMax get_reactions",
+        ],
+        notes: "Answers `{messagesReactions: {<message id>: {counters: [{count, reaction}], yourReaction, totalCount}}}`. History carries no reactions (measured 2026-09-23), so this is the only way to read them.",
+    },
+});
+export const messagesMedia = defineOperation({
+    name: "messages.media",
+    constant: "CHAT_MEDIA",
+    opcode: 51,
+    auth: true,
+    /** Paged from a message, as history is; `attachTypes` as MAX names them: `PHOTO`, `VIDEO`, `FILE`, `AUDIO`, `SHARE`. */
+    request: v.strictObject({
+        chatId: id(),
+        messageId: id(),
+        attachTypes: v.array(v.picklist(["PHOTO", "VIDEO", "FILE", "AUDIO", "SHARE"])),
+        forward: v.number(),
+        backward: v.number(),
+    }),
+    response: v.looseObject({ messages: v.optional(v.array(v.looseObject({}))), total: v.optional(v.number()) }),
+    guard: null,
+    provenance: {
+        confidence: "measured",
+        sources: [
+            "web.max.ru chunk `_app/immutable/chunks/Cdo8IOYe.js`, read 2026-10-08: `send(51, {chatId, messageId, attachTypes, forward, backward})`",
+            "measured 2026-10-08 on test account B, in the A↔B dialog: `SHARE` answered all 6 link messages history holds, `total: 6`; the other kinds answered `total: 0`",
+            "rumax a9ecaf3 `get_chat_media`",
+        ],
+        notes: "Reading marks nothing: no `CHAT_MARK`, and history's own read never moved a read mark (`RES-11`).",
+    },
+});
+export const messagesSearch = defineOperation({
+    name: "messages.search",
+    constant: "MSG_SEARCH",
+    opcode: 73,
+    auth: true,
+    request: v.strictObject({ chatId: id(), query: v.pipe(v.string(), v.minLength(1)), count: v.number() }),
+    response: v.looseObject({ result: v.optional(v.array(v.looseObject({}))), total: v.optional(v.number()) }),
+    guard: null,
+    provenance: {
+        confidence: "measured",
+        sources: [
+            "measured against MAX 2026-10-07 on a second account, in Saved messages (`pnpm probe:search`)",
+            "PyMax 53103f0 `MSG_SEARCH` (`src/pymax/protocol/enums.py:72`), named only",
+            "pr0bel1230/max-api-docs 82ff271 `protocol/messaging.md:946-989`",
+        ],
+        notes: "Answers `{result: [{message, highlights}], total}`, or `{result: [], ucpQId}` when nothing matched. One chat only: without `chatId` it is refused (`proto.payload`). Matches a word's beginning, not other forms of a Russian word.",
+    },
+});
+export const messagesReact = defineOperation({
+    name: "messages.react",
+    constant: "MSG_REACTION",
+    opcode: 178,
+    auth: true,
+    request: v.strictObject({
+        chatId: id(),
+        messageId: id(),
+        reaction: v.strictObject({ reactionType: v.literal("EMOJI"), id: v.string() }),
+    }),
+    response: v.looseObject({ reactionInfo: v.optional(v.looseObject({})) }),
+    guard: (request) => ({ chatId: chatOf(request), kind: "reaction", key: "reactions.add", ...messageOf(request) }),
+    provenance: {
+        confidence: "measured",
+        sources: [
+            "measured against MAX 2026-09-23 in Saved messages (`pnpm probe:reply`)",
+            "tsmax addReaction",
+            "PyMax add_reaction",
+        ],
+        notes: "Answers `{reactionInfo: {counters: [{count, reaction}], yourReaction, totalCount}}`. Allowed by the owner (`NEED-141`).",
+    },
+});
+export const messagesPress = defineOperation({
+    name: "messages.press",
+    constant: "MSG_CALLBACK",
+    opcode: 118,
+    auth: true,
+    request: v.strictObject({
+        /** The keyboard attach's own `callbackId`, not the button's. */
+        callbackId: v.string(),
+        type: v.literal("CALLBACK"),
+        payload: v.optional(v.string()),
+        timestamp: v.number(),
+    }),
+    response: v.looseObject({
+        chat: v.optional(v.looseObject({})),
+        message: v.optional(v.looseObject({})),
+        unread: v.optional(v.number()),
+        mark: v.optional(v.number()),
+    }),
+    // The request names no chat: the web client sends only what is above.
+    guard: () => ({ chatId: null, kind: "reaction", key: "messages.press" }),
+    provenance: {
+        confidence: "observed",
+        sources: [
+            "web.max.ru code, chunk `Cdo8IOYe` (2026-10-08): `send(118, {callbackId, type, payload, timestamp: Date.now()})`, the answer read for `chat`, `message`, `unread`, `mark`",
+            "the keyboard attach measured 2026-10-08 (`pnpm probe:keyboard`): `{_type: INLINE_KEYBOARD, callbackId, keyboard: {buttons: [[{type, text, payload, url, intent}]]}}`",
+        ],
+        notes: "Only CALLBACK buttons are sent; the web client opens the other kinds itself.",
+    },
+});
+export const messagesUnreact = defineOperation({
+    name: "messages.unreact",
+    constant: "MSG_CANCEL_REACTION",
+    opcode: 179,
+    auth: true,
+    request: v.strictObject({ chatId: id(), messageId: id() }),
+    response: v.looseObject({ reactionInfo: v.optional(v.looseObject({})) }),
+    guard: (request) => ({ chatId: chatOf(request), kind: "reaction", key: "reactions.remove", ...messageOf(request) }),
+    provenance: {
+        confidence: "measured",
+        sources: ["measured against MAX 2026-09-24 in Saved messages", "tsmax removeReaction", "PyMax remove_reaction"],
+        notes: "Answers the reactions left, `{reactionInfo: {}}` when none. A second call is answered the same.",
+    },
+});
+export const messagesPollVote = defineOperation({
+    name: "messages.pollVote",
+    constant: "SEND_VOTE",
+    opcode: 304,
+    auth: true,
+    request: v.strictObject({
+        chatId: id(),
+        messageId: id(),
+        pollId: id(),
+        /** Plain integers, not ids: wrapped as 64-bit, MAX answered `proto.payload` and closed the connection. Empty takes the vote back. */
+        answersIds: v.array(v.pipe(v.number(), v.integer(), v.minValue(0))),
+    }),
+    response: v.looseObject({ state: v.optional(v.looseObject({})) }),
+    guard: (request) => ({ chatId: chatOf(request), kind: "reaction", key: "polls.vote", ...messageOf(request) }),
+    provenance: {
+        confidence: "measured",
+        sources: [
+            "measured 2026-09-27 in Saved messages (`pnpm probe:polls`, `FIND-247`): a vote, two answers, an empty list, a vote on a closed poll",
+            "web.max.ru `_app/immutable/chunks/5oCuRT0F.js` (2026-09-24, `FIND-140`)",
+            "PyMax 2.4.1 `vote_poll`",
+        ],
+        notes: "Answers the poll's new `state`: `{total, result: [{answerId, voteCount, options, rate, votes}], voterPreviewIds}`, " +
+            "bit 1 of `options` marking the owner's own vote. A closed poll is refused with `poll.denied`.",
+    },
+});
+export const messagesDelete = defineOperation({
+    name: "messages.delete",
+    constant: "MSG_DELETE",
+    opcode: 66,
+    auth: true,
+    request: v.strictObject({ chatId: id(), messageIds: v.array(id()), forMe: v.boolean() }),
+    response: v.looseObject({}),
+    guard: (request) => ({
+        chatId: chatOf(request),
+        kind: "delete",
+        count: Math.max(1, countOf(request.messageIds)),
+        forEveryone: request.forMe === false,
+    }),
+    provenance: {
+        confidence: "measured",
+        sources: [
+            "PyMax 2.4.1 `delete_message`",
+            "tsmax",
+            "`forMe: false` measured 2026-09-27: the owner, as the group's admin, deleted another member's message in a test group by `max chats check` (`NEED-318`); it was gone from the history MAX returned",
+        ],
+        notes: "`forMe: true` removes the messages for this account only, `false` for everyone in the chat. An admin may " +
+            "delete another member's message for everyone. Sent by `max messages delete` and `max chats check`, on the " +
+            "owner's word each time (`NEED-32` corrected, `MAX-47`, `NEED-308`).",
+    },
+});
+//# sourceMappingURL=messages.js.map

package/dist/spec/operations/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../../src/spec/operations/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACxF,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAElC,MAAM,CAAC,MAAM,YAAY,GAAG,eAAe,CAAC;IAC1C,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,EAAE;IACV,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC;QACf,CAAC,CAAC,YAAY,CAAC;YACb,MAAM,EAAE,EAAE,EAAE;YACZ,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC;gBACtB,2FAA2F;gBAC3F,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;gBAC5B;;;mBAGG;gBACH,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;gBACpC,yOAAyO;gBACzO,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAClB,CAAC,CAAC,KAAK,CACL,CAAC,CAAC,YAAY,CAAC;oBACb,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;oBAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;oBAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;oBAClB,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;iBAC5D,CAAC,CACH,CACF;gBACD,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;gBAC9B,+FAA+F;gBAC/F,IAAI,EAAE,CAAC,CAAC,QAAQ,CACd,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE;oBAChB,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,CAAC;oBAC7D,kFAAkF;oBAClF,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;iBAC9E,CAAC,CACH;gBACD;;;;mBAIG;gBACH,iBAAiB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;aAC/F,CAAC;YACF,4DAA4D;YAC5D,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SAChC,CAAC;QACF;;;;WAIG;QACH,CAAC,CAAC,YAAY,CAAC;YACb,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC;gBACtB,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;gBACpC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC;oBAChB,CAAC,CAAC,YAAY,CAAC;wBACb,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;wBAC3B,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;wBACvB,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;wBACzC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;wBACzC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;qBACvB,CAAC;iBACH,CAAC;aACH,CAAC;YACF,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;SACpB,CAAC;KACH,CAAC;IACF,QAAQ,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACxG,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;QACjB,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACzC,MAAM,GAAG,GAAG,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAClF,MAAM,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QACvF,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,EAAE,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YAC5F,OAAO;gBACL,MAAM,EAAE,IAAI;gBACZ,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;gBAChC,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC;gBACpC,GAAG,GAAG;aACP,CAAA;QACH,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;QAC9B,+GAA+G;QAC/G,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAA;QAC7E,IAAI,IAAI,IAAI,OAAO,EAAE,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,YAAY;YACxE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,GAAG,EAAE,CAAA;QAChE,mFAAmF;QACnF,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,EAAE,CAAC;YAC/G,OAAO,SAAS,CAAC,eAAe,CAAC,CAAA;QACnC,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QACtF,IACE,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC;YAClD,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;gBACpB,CAAC,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,KAAK,EAAE,CAAC;gBACzD,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC;YAE5C,OAAO,SAAS,CAAC,cAAc,CAAC,CAAA;QAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACnC,MAAM,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,UAAU,CAAA;QACzD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,KAAK,EAAE;gBAAE,OAAO,SAAS,CAAC,eAAe,CAAC,CAAA;YAC9F,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,GAAG,EAAE,CAAA;QAC5C,CAAC;QACD,OAAO;YACL,MAAM;YACN,IAAI,EAAE,SAAS;YACf,GAAG,CAAC,OAAO,EAAE,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,GAAG,GAAG;YACN,MAAM,EAAE,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAClE,GAAG,CAAC,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChF,CAAA;IACH,CAAC;IACD,UAAU,EAAE;QACV,UAAU,EAAE,UAAU;QACtB,OAAO,EAAE;YACP,0FAA0F;YAC1F,+GAA+G;YAC/G,uHAAuH;YACvH,kHAAkH;YAClH,gIAAgI;YAChI,yFAAyF;YACzF,6HAA6H;SAC9H;QACD,KAAK,EACH,qGAAqG;YACrG,+GAA+G;KAClH;CACF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,eAAe,CAAC;IAC1C,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,EAAE;IACV,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC;QACtB,MAAM,EAAE,EAAE,EAAE;QACZ,SAAS,EAAE,EAAE,EAAE;QACf,yFAAyF;QACzF,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC5B,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAClB,CAAC,CAAC,KAAK,CACL,CAAC,CAAC,YAAY,CAAC;YACb,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;YAClB,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;SAC5D,CAAC,CACH,CACF;QACD,2FAA2F;QAC3F,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;KAClC,CAAC;IACF,QAAQ,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACnE,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC;QACvB,IAAI,EAAE,MAAM;QACZ,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS;YAC9B,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;YAClC,OAAO,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;YAChC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM;YAC/C,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE;YACxB,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,SAAS,CAAC,OAAO,CAAC;QACrB,MAAM,EAAE,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;KACnE,CAAC;IACF,UAAU,EAAE;QACV,UAAU,EAAE,UAAU;QACtB,OAAO,EAAE;YACP,mFAAmF;YACnF,6DAA6D;YAC7D,kDAAkD;SACnD;QACD,KAAK,EACH,oHAAoH;YACpH,8GAA8G;YAC9G,gCAAgC;KACnC;CACF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC;IAC/C,IAAI,EAAE,oBAAoB;IAC1B,QAAQ,EAAE,mBAAmB;IAC7B,MAAM,EAAE,GAAG;IACX,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACpE,QAAQ,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAC7E,KAAK,EAAE,IAAI;IACX,UAAU,EAAE;QACV,UAAU,EAAE,UAAU;QACtB,OAAO,EAAE;YACP,iFAAiF;YACjF,oBAAoB;YACpB,qBAAqB;SACtB;QACD,KAAK,EACH,qMAAqM;KACxM;CACF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;IAC3C,IAAI,EAAE,gBAAgB;IACtB,QAAQ,EAAE,YAAY;IACtB,MAAM,EAAE,EAAE;IACV,IAAI,EAAE,IAAI;IACV,wHAAwH;IACxH,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC;QACtB,MAAM,EAAE,EAAE,EAAE;QACZ,SAAS,EAAE,EAAE,EAAE;QACf,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAC9E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACrB,CAAC;IACF,QAAQ,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;IAC5G,KAAK,EAAE,IAAI;IACX,UAAU,EAAE;QACV,UAAU,EAAE,UAAU;QACtB,OAAO,EAAE;YACP,wIAAwI;YACxI,+JAA+J;YAC/J,gCAAgC;SACjC;QACD,KAAK,EAAE,mGAAmG;KAC3G;CACF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAC;IAC5C,IAAI,EAAE,iBAAiB;IACvB,QAAQ,EAAE,YAAY;IACtB,MAAM,EAAE,EAAE;IACV,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IACvG,QAAQ,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;IAC1G,KAAK,EAAE,IAAI;IACX,UAAU,EAAE;QACV,UAAU,EAAE,UAAU;QACtB,OAAO,EAAE;YACP,8FAA8F;YAC9F,2EAA2E;YAC3E,iEAAiE;SAClE;QACD,KAAK,EACH,qOAAqO;KACxO;CACF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;IAC3C,IAAI,EAAE,gBAAgB;IACtB,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,GAAG;IACX,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC;QACtB,MAAM,EAAE,EAAE,EAAE;QACZ,SAAS,EAAE,EAAE,EAAE;QACf,QAAQ,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;KAC/E,CAAC;IACF,QAAQ,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACxE,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;IAChH,UAAU,EAAE;QACV,UAAU,EAAE,UAAU;QACtB,OAAO,EAAE;YACP,wEAAwE;YACxE,mBAAmB;YACnB,oBAAoB;SACrB;QACD,KAAK,EACH,yHAAyH;KAC5H;CACF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;IAC3C,IAAI,EAAE,gBAAgB;IACtB,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,GAAG;IACX,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC;QACtB,gEAAgE;QAChE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;QAC3B,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;IACF,QAAQ,EAAE,CAAC,CAAC,WAAW,CAAC;QACtB,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACnC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACtC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC9B,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KAC7B,CAAC;IACF,sEAAsE;IACtE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,gBAAgB,EAAE,CAAC;IACxE,UAAU,EAAE;QACV,UAAU,EAAE,UAAU;QACtB,OAAO,EAAE;YACP,0KAA0K;YAC1K,sKAAsK;SACvK;QACD,KAAK,EAAE,8EAA8E;KACtF;CACF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,eAAe,CAAC;IAC7C,IAAI,EAAE,kBAAkB;IACxB,QAAQ,EAAE,qBAAqB;IAC/B,MAAM,EAAE,GAAG;IACX,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,CAAC;IAC1D,QAAQ,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACxE,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;IACnH,UAAU,EAAE;QACV,UAAU,EAAE,UAAU;QACtB,OAAO,EAAE,CAAC,mDAAmD,EAAE,sBAAsB,EAAE,uBAAuB,CAAC;QAC/G,KAAK,EAAE,iGAAiG;KACzG;CACF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAC;IAC9C,IAAI,EAAE,mBAAmB;IACzB,QAAQ,EAAE,WAAW;IACrB,MAAM,EAAE,GAAG;IACX,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC;QACtB,MAAM,EAAE,EAAE,EAAE;QACZ,SAAS,EAAE,EAAE,EAAE;QACf,MAAM,EAAE,EAAE,EAAE;QACZ,qIAAqI;QACrI,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;KACpE,CAAC;IACF,QAAQ,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACjE,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;IAC7G,UAAU,EAAE;QACV,UAAU,EAAE,UAAU;QACtB,OAAO,EAAE;YACP,qIAAqI;YACrI,yEAAyE;YACzE,yBAAyB;SAC1B;QACD,KAAK,EACH,qHAAqH;YACrH,+FAA+F;KAClG;CACF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAC;IAC5C,IAAI,EAAE,iBAAiB;IACvB,QAAQ,EAAE,YAAY;IACtB,MAAM,EAAE,EAAE;IACV,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;IACxF,QAAQ,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC;IAC3B,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC;QACvB,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC/C,WAAW,EAAE,OAAO,CAAC,KAAK,KAAK,KAAK;KACrC,CAAC;IACF,UAAU,EAAE;QACV,UAAU,EAAE,UAAU;QACtB,OAAO,EAAE;YACP,8BAA8B;YAC9B,OAAO;YACP,oMAAoM;SACrM;QACD,KAAK,EACH,2GAA2G;YAC3G,4GAA4G;YAC5G,qEAAqE;KACxE;CACF,CAAC,CAAA"}

package/dist/spec/operations/session.d.ts

@@ -0,0 +1,120 @@
+import * as v from "valibot";
+/**
+ * **The keep-alive, which only `max serve` sends** — a one-shot command is gone long before it
+ * would matter. `interactive` is whether the tab is visible; ours is never, as LOGIN's is.
+ */
+export declare const sessionPing: import("../define.js").Operation<v.StrictObjectSchema<{
+    readonly interactive: v.BooleanSchema<undefined>;
+}, undefined>, v.LooseObjectSchema<{}, undefined>>;
+/**
+ * **Telemetry, and only the one event a hidden web tab sends** (`MAX-8`): the chat list shown,
+ * 20 s after the tab opened. A one-shot command never sends it — a hidden tab closed that soon
+ * sends nothing either. Why exactly this and nothing more: `docs/dev/capture/requirements.md`.
+ *
+ * The request is strict and literal on purpose: anything beyond this one event claims a person in
+ * front of a visible tab, which is a different decision.
+ */
+export declare const sessionLog: import("../define.js").Operation<v.StrictObjectSchema<{
+    readonly events: v.ArraySchema<v.StrictObjectSchema<{
+        readonly type: v.LiteralSchema<"NAV", undefined>;
+        readonly userId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "an id is a whole number written as a string">, v.TransformAction<string, bigint>]>;
+        readonly time: v.NumberSchema<undefined>;
+        readonly sessionId: v.NumberSchema<undefined>;
+        readonly event: v.LiteralSchema<"GO", undefined>;
+        readonly params: v.StrictObjectSchema<{
+            readonly action_id: v.LiteralSchema<1, undefined>;
+            readonly screen_to: v.LiteralSchema<150, undefined>;
+            readonly prev_time: v.LiteralSchema<0, undefined>;
+            readonly source_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "an id is a whole number written as a string">, v.TransformAction<string, bigint>]>;
+        }, undefined>;
+    }, undefined>, undefined>;
+}, undefined>, v.LooseObjectSchema<{}, undefined>>;
+export declare const sessionInit: import("../define.js").Operation<v.StrictObjectSchema<{
+    readonly userAgent: v.StrictObjectSchema<{
+        readonly deviceType: v.LiteralSchema<"WEB", undefined>;
+        readonly pushDeviceType: v.LiteralSchema<"WEBPUSH", undefined>;
+        readonly locale: v.StringSchema<undefined>;
+        readonly deviceLocale: v.StringSchema<undefined>;
+        readonly osVersion: v.StringSchema<undefined>;
+        readonly deviceName: v.StringSchema<undefined>;
+        readonly headerUserAgent: v.StringSchema<undefined>;
+        readonly isPwa: v.LiteralSchema<false, undefined>;
+        readonly appVersion: v.StringSchema<undefined>;
+        readonly screen: v.StringSchema<undefined>;
+        readonly timezone: v.StringSchema<undefined>;
+    }, undefined>;
+    readonly deviceId: v.StringSchema<undefined>;
+}, undefined>, v.LooseObjectSchema<{}, undefined>>;
+export declare const sessionLogin: import("../define.js").Operation<v.StrictObjectSchema<{
+    readonly token: v.StringSchema<undefined>;
+    readonly chatsCount: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 100, undefined>]>;
+    /**
+     * False, always: we are a script reading, and claiming a human is present is the small lie that
+     * becomes a side effect nobody can trace (`RES-5`). **Correction 2026-09-25:** this said the web
+     * client sends true; its LOGIN on a live socket sent `false` too — `true` goes in its pings.
+     */
+    readonly interactive: v.LiteralSchema<false, undefined>;
+    /**
+     * **Delta markers, not flags** — measured 2026-09-20. Each is a moment in time, and MAX
+     * returns only what changed in that collection since it. `0` means "everything", which is what
+     * `src/session/handshake.ts` sends and is why every command re-fetches the whole list — except
+     * a `max serve` re-login, which sends its newest chat event in `chatsSync` (`MAX-51`).
+     *
+     * The measurement, on a real account: `0` returned 6 contacts and 25 chats; the `time` the
+     * previous login answered with returned 0 and 0; a week earlier returned 1 and 11. The last of
+     * those is the one that matters — without it, "nothing came back" would equally have meant
+     * "any non-zero value suppresses the collection".
+     *
+     * Feeding them back is `MAX-10`, and it needs somewhere to keep the marker per profile.
+     */
+    readonly chatsSync: v.NumberSchema<undefined>;
+    readonly contactsSync: v.NumberSchema<undefined>;
+    readonly presenceSync: v.NumberSchema<undefined>;
+    readonly draftsSync: v.NumberSchema<undefined>;
+    /** Only when the same connection's owner logs in again — `resume` in `src/session/handshake.ts` (`MAX-51`). */
+    readonly lastLogin: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    readonly configHash: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.LooseObjectSchema<{
+    readonly profile: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+    readonly chats: v.OptionalSchema<v.ArraySchema<v.LooseObjectSchema<{}, undefined>, undefined>, undefined>;
+    readonly contacts: v.OptionalSchema<v.ArraySchema<v.LooseObjectSchema<{}, undefined>, undefined>, undefined>;
+    /**
+     * ⚠ **Shape unknown, and this field is why the response check exists.**
+     *
+     * It was declared as an array here and MAX sends an **object** — found 2026-09-20 by routing
+     * the handshake through the checked path. Nothing broke, because the reader is tolerant; what
+     * happened instead is that every message the login carries has been silently discarded since
+     * the specification was written, after we paid a request for them.
+     *
+     * The reference documents no top-level `messages` on this response at all — each chat carries
+     * its own `lastMessage` (`max-api-docs/protocol/chats.md:61`). So the array was **invented**,
+     * not misread, which is the failure `REQUIREMENTS.md` §10 exists to prevent: an unsourced
+     * shape stated with the same confidence as a measured one.
+     *
+     * Left as `unknown` until somebody looks (`PROTO-6`). `pnpm probe:ids` reports its type and key count.
+     */
+    readonly messages: v.OptionalSchema<v.UnknownSchema, undefined>;
+    /**
+     * **A replacement for a credential that has aged** — measured on the real account 2026-09-22
+     * (`pnpm probe:token`). Logging in with a token pasted months earlier answers with a different
+     * one; logging in with *that* one answers with the same one back. So it is an exchange that
+     * happens once, not a rotation on every login.
+     *
+     * It was undeclared until then, so the exchange happened on every login and the client threw
+     * the result away, leaving the profile on whatever was pasted in months ago (`MAX-11`,
+     * `NEED-106`). The old token goes on working, which is why this is hygiene rather than repair.
+     * `NEED-8` had asserted the rotation in 2026-09-18 on the strength of `tsmax/src/app.ts:99` —
+     * somebody else's client — which is a claim; this is the measurement.
+     *
+     * ⚠ **It is a credential.** Nothing may print it, log it or put it in a fixture. `MaxClient`
+     * writes it to the keyring and never returns it.
+     */
+    readonly token: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly presence: v.OptionalSchema<v.UnknownSchema, undefined>;
+    readonly time: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    readonly chatMarker: v.OptionalSchema<v.UnknownSchema, undefined>;
+    readonly config: v.OptionalSchema<v.UnknownSchema, undefined>;
+    readonly videoChatHistory: v.OptionalSchema<v.UnknownSchema, undefined>;
+}, undefined>>;
+export declare const sessionLogout: import("../define.js").Operation<v.StrictObjectSchema<{}, undefined>, v.LooseObjectSchema<{}, undefined>>;
+//# sourceMappingURL=session.d.ts.map

package/dist/spec/operations/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/spec/operations/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAwB5B;;;GAGG;AACH,eAAO,MAAM,WAAW;;kDAatB,CAAA;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;kDA+BrB,CAAA;AAEF,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;kDAatB,CAAA;AAEF,eAAO,MAAM,YAAY;;;IAUrB;;;;OAIG;;IAEH;;;;;;;;;;;;OAYG;;;;;IAKH,+GAA+G;;;;;;;IAQ/G;;;;;;;;;;;;;;OAcG;;IAEH;;;;;;;;;;;;;;OAcG;;;;;;;cAmBL,CAAA;AAEF,eAAO,MAAM,aAAa,2GAkBxB,CAAA"}