@wirecat/max-cli 0.0.0-stage → 0.42.0

package/dist/bot/permissions.js

@@ -0,0 +1,88 @@
+/**
+ * Which of the personal account's permission names (`CLI-37`) a bot write falls under, so one
+ * `allow` list covers both. An operation missing here is refused whenever `allow` is set — a
+ * write added by a future schema sync starts out forbidden, not allowed.
+ */
+export const BOT_PERMISSIONS = {
+    sendMessage: "send",
+    sendComment: "send",
+    sendAction: "send",
+    answerOnCallback: "send",
+    getUploadUrl: "send",
+    editMessage: "edit",
+    editComment: "edit",
+    deleteMessage: "delete",
+    deleteComment: "delete",
+    pinMessage: "pin",
+    unpinMessage: "pin",
+    editChat: "groups",
+    leaveChat: "groups",
+    postAdmins: "groups",
+    deleteAdmins: "groups",
+    addMembers: "groups",
+    removeMember: "groups",
+    editMyCommands: "profile",
+    getUpdates: "read",
+};
+/**
+ * How a bot write is journaled. `getUpdates` is absent on purpose: it is a write only because it
+ * commits the marker, it reaches nobody, and a recipient list has nothing to say about it.
+ */
+export const BOT_JOURNAL_KINDS = {
+    sendMessage: "message",
+    sendComment: "message",
+    answerOnCallback: "message",
+    sendAction: "chat",
+    editMessage: "edit",
+    editComment: "edit",
+    deleteMessage: "delete",
+    deleteComment: "delete",
+    pinMessage: "pin",
+    unpinMessage: "pin",
+    editChat: "chat",
+    leaveChat: "chat",
+    postAdmins: "chat",
+    deleteAdmins: "chat",
+    addMembers: "chat",
+    removeMember: "chat",
+    editMyCommands: "account",
+    subscribe: "account",
+    unsubscribe: "account",
+    getUploadUrl: "account",
+};
+export const BOT_KEYS = {
+    getMyInfo: "bot.me",
+    editMyCommands: "bot.commands.set",
+    getChat: "bot.chats.show",
+    editChat: "bot.chats.update",
+    sendAction: "bot.chats.action",
+    getPinnedMessage: "bot.messages.pinned",
+    pinMessage: "bot.messages.pin",
+    unpinMessage: "bot.messages.unpin",
+    getMembership: "bot.chats.members.me",
+    leaveChat: "bot.chats.leave",
+    getAdmins: "bot.chats.admins.list",
+    postAdmins: "bot.chats.admins.add",
+    deleteAdmins: "bot.chats.admins.remove",
+    getMembers: "bot.chats.members.list",
+    addMembers: "bot.chats.members.add",
+    removeMember: "bot.chats.members.remove",
+    getSubscriptions: "bot.webhooks.list",
+    subscribe: "bot.webhooks.set",
+    unsubscribe: "bot.webhooks.delete",
+    getUploadUrl: "bot.uploads",
+    getMessages: "bot.messages.list",
+    sendMessage: "bot.messages.send",
+    editMessage: "bot.messages.edit",
+    deleteMessage: "bot.messages.delete",
+    getMessageById: "bot.messages.show",
+    getComments: "bot.messages.list",
+    sendComment: "bot.messages.send",
+    editComment: "bot.messages.edit",
+    deleteComment: "bot.messages.delete",
+    getCommentById: "bot.messages.show",
+    getVideoAttachmentDetails: "bot.messages.download",
+    answerOnCallback: "bot.buttons.press",
+    getUpdates: "bot.updates.poll",
+};
+//# sourceMappingURL=permissions.js.map

package/dist/bot/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../src/bot/permissions.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAyC;IACnE,WAAW,EAAE,MAAM;IACnB,WAAW,EAAE,MAAM;IACnB,UAAU,EAAE,MAAM;IAClB,gBAAgB,EAAE,MAAM;IACxB,YAAY,EAAE,MAAM;IACpB,WAAW,EAAE,MAAM;IACnB,WAAW,EAAE,MAAM;IACnB,aAAa,EAAE,QAAQ;IACvB,aAAa,EAAE,QAAQ;IACvB,UAAU,EAAE,KAAK;IACjB,YAAY,EAAE,KAAK;IACnB,QAAQ,EAAE,QAAQ;IAClB,SAAS,EAAE,QAAQ;IACnB,UAAU,EAAE,QAAQ;IACpB,YAAY,EAAE,QAAQ;IACtB,UAAU,EAAE,QAAQ;IACpB,YAAY,EAAE,QAAQ;IACtB,cAAc,EAAE,SAAS;IACzB,UAAU,EAAE,MAAM;CACnB,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAuC;IACnE,WAAW,EAAE,SAAS;IACtB,WAAW,EAAE,SAAS;IACtB,gBAAgB,EAAE,SAAS;IAC3B,UAAU,EAAE,MAAM;IAClB,WAAW,EAAE,MAAM;IACnB,WAAW,EAAE,MAAM;IACnB,aAAa,EAAE,QAAQ;IACvB,aAAa,EAAE,QAAQ;IACvB,UAAU,EAAE,KAAK;IACjB,YAAY,EAAE,KAAK;IACnB,QAAQ,EAAE,MAAM;IAChB,SAAS,EAAE,MAAM;IACjB,UAAU,EAAE,MAAM;IAClB,YAAY,EAAE,MAAM;IACpB,UAAU,EAAE,MAAM;IAClB,YAAY,EAAE,MAAM;IACpB,cAAc,EAAE,SAAS;IACzB,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,SAAS;IACtB,YAAY,EAAE,SAAS;CACxB,CAAA;AAED,MAAM,CAAC,MAAM,QAAQ,GAAqC;IACxD,SAAS,EAAE,QAAQ;IACnB,cAAc,EAAE,kBAAkB;IAClC,OAAO,EAAE,gBAAgB;IACzB,QAAQ,EAAE,kBAAkB;IAC5B,UAAU,EAAE,kBAAkB;IAC9B,gBAAgB,EAAE,qBAAqB;IACvC,UAAU,EAAE,kBAAkB;IAC9B,YAAY,EAAE,oBAAoB;IAClC,aAAa,EAAE,sBAAsB;IACrC,SAAS,EAAE,iBAAiB;IAC5B,SAAS,EAAE,uBAAuB;IAClC,UAAU,EAAE,sBAAsB;IAClC,YAAY,EAAE,yBAAyB;IACvC,UAAU,EAAE,wBAAwB;IACpC,UAAU,EAAE,uBAAuB;IACnC,YAAY,EAAE,0BAA0B;IACxC,gBAAgB,EAAE,mBAAmB;IACrC,SAAS,EAAE,kBAAkB;IAC7B,WAAW,EAAE,qBAAqB;IAClC,YAAY,EAAE,aAAa;IAC3B,WAAW,EAAE,mBAAmB;IAChC,WAAW,EAAE,mBAAmB;IAChC,WAAW,EAAE,mBAAmB;IAChC,aAAa,EAAE,qBAAqB;IACpC,cAAc,EAAE,mBAAmB;IACnC,WAAW,EAAE,mBAAmB;IAChC,WAAW,EAAE,mBAAmB;IAChC,WAAW,EAAE,mBAAmB;IAChC,aAAa,EAAE,qBAAqB;IACpC,cAAc,EAAE,mBAAmB;IACnC,yBAAyB,EAAE,uBAAuB;IAClD,gBAAgB,EAAE,mBAAmB;IACrC,UAAU,EAAE,kBAAkB;CAC/B,CAAA"}

package/dist/bot/registry.d.ts

@@ -0,0 +1,11 @@
+import { ChatRegistry as SharedChatRegistry } from "@wirecat/cli-messaging/cli";
+export type { SeenChat } from "@wirecat/cli-messaging/cli";
+/** Everything this machine keeps about its bots: seen chats, recipients, the send journal. */
+export declare const botsDirectory: (env?: NodeJS.ProcessEnv) => string;
+/** cli-messaging's, under max-cli's state directory. */
+export declare class ChatRegistry extends SharedChatRegistry {
+    constructor(profile: string, env?: NodeJS.ProcessEnv);
+}
+/** Every profile that has ever kept a registry — the bots this machine has used. */
+export declare const registryProfiles: (env?: NodeJS.ProcessEnv) => string[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/bot/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/bot/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,IAAI,kBAAkB,EAGnC,MAAM,4BAA4B,CAAA;AAGnC,YAAY,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAE1D,8FAA8F;AAC9F,eAAO,MAAM,aAAa,SAAS,MAAM,CAAC,UAAU,KAAiB,MAA2C,CAAA;AAEhH,wDAAwD;AACxD,qBAAa,YAAa,SAAQ,kBAAkB;IAClD,YAAY,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,EAEhE;CACF;AAED,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,SAAS,MAAM,CAAC,UAAU,KAAiB,MAAM,EAA0C,CAAA"}

package/dist/bot/registry.js

@@ -0,0 +1,13 @@
+import { ChatRegistry as SharedChatRegistry, botsDirectory as sharedBotsDirectory, registryProfiles as sharedRegistryProfiles, } from "@wirecat/cli-messaging/cli";
+import { MAX_APP } from "../app.js";
+/** Everything this machine keeps about its bots: seen chats, recipients, the send journal. */
+export const botsDirectory = (env = process.env) => sharedBotsDirectory(MAX_APP, env);
+/** cli-messaging's, under max-cli's state directory. */
+export class ChatRegistry extends SharedChatRegistry {
+    constructor(profile, env = process.env) {
+        super(MAX_APP, profile, env);
+    }
+}
+/** Every profile that has ever kept a registry — the bots this machine has used. */
+export const registryProfiles = (env = process.env) => sharedRegistryProfiles(MAX_APP, env);
+//# sourceMappingURL=registry.js.map

package/dist/bot/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/bot/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,IAAI,kBAAkB,EAClC,aAAa,IAAI,mBAAmB,EACpC,gBAAgB,IAAI,sBAAsB,GAC3C,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAInC,8FAA8F;AAC9F,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG,EAAU,EAAE,CAAC,mBAAmB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;AAEhH,wDAAwD;AACxD,MAAM,OAAO,YAAa,SAAQ,kBAAkB;IAClD,YAAY,OAAe,EAAE,GAAG,GAAsB,OAAO,CAAC,GAAG;QAC/D,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAA;IAC9B,CAAC;CACF;AAED,oFAAoF;AACpF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG,EAAY,EAAE,CAAC,sBAAsB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA"}

package/dist/bot/russian-trusted-root.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Russian Trusted Root CA, issued by the Ministry of Digital Development. It signs
+ * platform-api2.max.ru, and Node's bundled roots do not include it (measured 2026-09-26, FIND-219).
+ * SHA-256 D2:6D:2D:02:31:B7:C3:9F:92:CC:73:85:12:BA:54:10:35:19:E4:40:5D:68:B5:BD:70:3E:97:88:CA:8E:CF:31,
+ * valid until 2032-02-27. Used for our own bot requests only (owner, NEED-293).
+ */
+export declare const RUSSIAN_TRUSTED_ROOT_CA = "-----BEGIN CERTIFICATE-----\nMIIFwjCCA6qgAwIBAgICEAAwDQYJKoZIhvcNAQELBQAwcDELMAkGA1UEBhMCUlUx\nPzA9BgNVBAoMNlRoZSBNaW5pc3RyeSBvZiBEaWdpdGFsIERldmVsb3BtZW50IGFu\nZCBDb21tdW5pY2F0aW9uczEgMB4GA1UEAwwXUnVzc2lhbiBUcnVzdGVkIFJvb3Qg\nQ0EwHhcNMjIwMzAxMjEwNDE1WhcNMzIwMjI3MjEwNDE1WjBwMQswCQYDVQQGEwJS\nVTE/MD0GA1UECgw2VGhlIE1pbmlzdHJ5IG9mIERpZ2l0YWwgRGV2ZWxvcG1lbnQg\nYW5kIENvbW11bmljYXRpb25zMSAwHgYDVQQDDBdSdXNzaWFuIFRydXN0ZWQgUm9v\ndCBDQTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMfFOZ8pUAL3+r2n\nqqE0Zp52selXsKGFYoG0GM5bwz1bSFtCt+AZQMhkWQheI3poZAToYJu69pHLKS6Q\nXBiwBC1cvzYmUYKMYZC7jE5YhEU2bSL0mX7NaMxMDmH2/NwuOVRj8OImVa5s1F4U\nzn4Kv3PFlDBjjSjXKVY9kmjUBsXQrIHeaqmUIsPIlNWUnimXS0I0abExqkbdrXbX\nYwCOXhOO2pDUx3ckmJlCMUGacUTnylyQW2VsJIyIGA8V0xzdaeUXg0VZ6ZmNUr5Y\nBer/EAOLPb8NYpsAhJe2mXjMB/J9HNsoFMBFJ0lLOT/+dQvjbdRZoOT8eqJpWnVD\nU+QL/qEZnz57N88OWM3rabJkRNdU/Z7x5SFIM9FrqtN8xewsiBWBI0K6XFuOBOTD\n4V08o4TzJ8+Ccq5XlCUW2L48pZNCYuBDfBh7FxkB7qDgGDiaftEkZZfApRg2E+M9\nG8wkNKTPLDc4wH0FDTijhgxR3Y4PiS1HL2Zhw7bD3CbslmEGgfnnZojNkJtcLeBH\nBLa52/dSwNU4WWLubaYSiAmA9IUMX1/RpfpxOxd4Ykmhz97oFbUaDJFipIggx5sX\nePAlkTdWnv+RWBxlJwMQ25oEHmRguNYf4Zr/Rxr9cS93Y+mdXIZaBEE0KS2iLRqa\nOiWBki9IMQU4phqPOBAaG7A+eP8PAgMBAAGjZjBkMB0GA1UdDgQWBBTh0YHlzlpf\nBKrS6badZrHF+qwshzAfBgNVHSMEGDAWgBTh0YHlzlpfBKrS6badZrHF+qwshzAS\nBgNVHRMBAf8ECDAGAQH/AgEEMA4GA1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsF\nAAOCAgEAALIY1wkilt/urfEVM5vKzr6utOeDWCUczmWX/RX4ljpRdgF+5fAIS4vH\ntmXkqpSCOVeWUrJV9QvZn6L227ZwuE15cWi8DCDal3Ue90WgAJJZMfTshN4OI8cq\nW9E4EG9wglbEtMnObHlms8F3CHmrw3k6KmUkWGoa+/ENmcVl68u/cMRl1JbW2bM+\n/3A+SAg2c6iPDlehczKx2oa95QW0SkPPWGuNA/CE8CpyANIhu9XFrj3RQ3EqeRcS\nAQQod1RNuHpfETLU/A2gMmvn/w/sx7TB3W5BPs6rprOA37tutPq9u6FTZOcG1Oqj\nC/B7yTqgI7rbyvox7DEXoX7rIiEqyNNUguTk/u3SZ4VXE2kmxdmSh3TQvybfbnXV\n4JbCZVaqiZraqc7oZMnRoWrXRG3ztbnbes/9qhRGI7PqXqeKJBztxRTEVj8ONs1d\nWN5szTwaPIvhkhO3CO5ErU2rVdUr89wKpNXbBODFKRtgxUT70YpmJ46VVaqdAhOZ\nD9EUUn4YaeLaS8AjSF/h7UkjOibNc4qVDiPP+rkehFWM66PVnP1Msh93tc+taIfC\nEYVMxjh8zNbFuoc7fzvvrFILLe7ifvEIUqSVIC/AzplM/Jxw7buXFeGP1qVCBEHq\n391d/9RAfaZ12zkwFsl+IKwE/OZxW8AHa9i1p4GO0YSNuczzEm4=\n-----END CERTIFICATE-----\n";
+//# sourceMappingURL=russian-trusted-root.d.ts.map

package/dist/bot/russian-trusted-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"russian-trusted-root.d.ts","sourceRoot":"","sources":["../../src/bot/russian-trusted-root.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,+iEAiCnC,CAAA"}

package/dist/bot/russian-trusted-root.js

@@ -0,0 +1,41 @@
+/**
+ * Russian Trusted Root CA, issued by the Ministry of Digital Development. It signs
+ * platform-api2.max.ru, and Node's bundled roots do not include it (measured 2026-09-26, FIND-219).
+ * SHA-256 D2:6D:2D:02:31:B7:C3:9F:92:CC:73:85:12:BA:54:10:35:19:E4:40:5D:68:B5:BD:70:3E:97:88:CA:8E:CF:31,
+ * valid until 2032-02-27. Used for our own bot requests only (owner, NEED-293).
+ */
+export const RUSSIAN_TRUSTED_ROOT_CA = `-----BEGIN CERTIFICATE-----
+MIIFwjCCA6qgAwIBAgICEAAwDQYJKoZIhvcNAQELBQAwcDELMAkGA1UEBhMCUlUx
+PzA9BgNVBAoMNlRoZSBNaW5pc3RyeSBvZiBEaWdpdGFsIERldmVsb3BtZW50IGFu
+ZCBDb21tdW5pY2F0aW9uczEgMB4GA1UEAwwXUnVzc2lhbiBUcnVzdGVkIFJvb3Qg
+Q0EwHhcNMjIwMzAxMjEwNDE1WhcNMzIwMjI3MjEwNDE1WjBwMQswCQYDVQQGEwJS
+VTE/MD0GA1UECgw2VGhlIE1pbmlzdHJ5IG9mIERpZ2l0YWwgRGV2ZWxvcG1lbnQg
+YW5kIENvbW11bmljYXRpb25zMSAwHgYDVQQDDBdSdXNzaWFuIFRydXN0ZWQgUm9v
+dCBDQTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMfFOZ8pUAL3+r2n
+qqE0Zp52selXsKGFYoG0GM5bwz1bSFtCt+AZQMhkWQheI3poZAToYJu69pHLKS6Q
+XBiwBC1cvzYmUYKMYZC7jE5YhEU2bSL0mX7NaMxMDmH2/NwuOVRj8OImVa5s1F4U
+zn4Kv3PFlDBjjSjXKVY9kmjUBsXQrIHeaqmUIsPIlNWUnimXS0I0abExqkbdrXbX
+YwCOXhOO2pDUx3ckmJlCMUGacUTnylyQW2VsJIyIGA8V0xzdaeUXg0VZ6ZmNUr5Y
+Ber/EAOLPb8NYpsAhJe2mXjMB/J9HNsoFMBFJ0lLOT/+dQvjbdRZoOT8eqJpWnVD
+U+QL/qEZnz57N88OWM3rabJkRNdU/Z7x5SFIM9FrqtN8xewsiBWBI0K6XFuOBOTD
+4V08o4TzJ8+Ccq5XlCUW2L48pZNCYuBDfBh7FxkB7qDgGDiaftEkZZfApRg2E+M9
+G8wkNKTPLDc4wH0FDTijhgxR3Y4PiS1HL2Zhw7bD3CbslmEGgfnnZojNkJtcLeBH
+BLa52/dSwNU4WWLubaYSiAmA9IUMX1/RpfpxOxd4Ykmhz97oFbUaDJFipIggx5sX
+ePAlkTdWnv+RWBxlJwMQ25oEHmRguNYf4Zr/Rxr9cS93Y+mdXIZaBEE0KS2iLRqa
+OiWBki9IMQU4phqPOBAaG7A+eP8PAgMBAAGjZjBkMB0GA1UdDgQWBBTh0YHlzlpf
+BKrS6badZrHF+qwshzAfBgNVHSMEGDAWgBTh0YHlzlpfBKrS6badZrHF+qwshzAS
+BgNVHRMBAf8ECDAGAQH/AgEEMA4GA1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsF
+AAOCAgEAALIY1wkilt/urfEVM5vKzr6utOeDWCUczmWX/RX4ljpRdgF+5fAIS4vH
+tmXkqpSCOVeWUrJV9QvZn6L227ZwuE15cWi8DCDal3Ue90WgAJJZMfTshN4OI8cq
+W9E4EG9wglbEtMnObHlms8F3CHmrw3k6KmUkWGoa+/ENmcVl68u/cMRl1JbW2bM+
+/3A+SAg2c6iPDlehczKx2oa95QW0SkPPWGuNA/CE8CpyANIhu9XFrj3RQ3EqeRcS
+AQQod1RNuHpfETLU/A2gMmvn/w/sx7TB3W5BPs6rprOA37tutPq9u6FTZOcG1Oqj
+C/B7yTqgI7rbyvox7DEXoX7rIiEqyNNUguTk/u3SZ4VXE2kmxdmSh3TQvybfbnXV
+4JbCZVaqiZraqc7oZMnRoWrXRG3ztbnbes/9qhRGI7PqXqeKJBztxRTEVj8ONs1d
+WN5szTwaPIvhkhO3CO5ErU2rVdUr89wKpNXbBODFKRtgxUT70YpmJ46VVaqdAhOZ
+D9EUUn4YaeLaS8AjSF/h7UkjOibNc4qVDiPP+rkehFWM66PVnP1Msh93tc+taIfC
+EYVMxjh8zNbFuoc7fzvvrFILLe7ifvEIUqSVIC/AzplM/Jxw7buXFeGP1qVCBEHq
+391d/9RAfaZ12zkwFsl+IKwE/OZxW8AHa9i1p4GO0YSNuczzEm4=
+-----END CERTIFICATE-----
+`;
+//# sourceMappingURL=russian-trusted-root.js.map

package/dist/bot/russian-trusted-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"russian-trusted-root.js","sourceRoot":"","sources":["../../src/bot/russian-trusted-root.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCtC,CAAA"}

package/dist/bot/transport.d.ts

@@ -0,0 +1,46 @@
+import { type RetryConfig, type SleepLike } from "@wirecat/cli-core";
+import type { ManifestOperation } from "@wirecat/cli-core/codegen";
+import { type FetchLike } from "@wirecat/cli-core/http";
+import { type DiagnosticEvent } from "@wirecat/cli-messaging/cli";
+export declare const BOT_API_URL = "https://platform-api2.max.ru";
+/**
+ * Adds the Минцифры root to the trusted roots (`NEED-293`). On Node (22.19+) that changes the
+ * process-wide default, so every TLS connection this process makes from then on trusts it, not only
+ * the Bot API's: Node's `fetch` takes no per-request list. Bun does, so there only these calls do.
+ */
+export declare const botFetch: () => FetchLike;
+export interface CallInput {
+    path?: Readonly<Record<string, string>>;
+    query?: Readonly<Record<string, string | readonly string[]>>;
+    /** JSON text, sent as it is — ids in it must reach MAX as the digits the caller wrote. */
+    body?: string;
+}
+export interface TransportOptions {
+    token: string;
+    baseUrl?: string;
+    fetch?: FetchLike;
+    timeoutMs?: number;
+    retry?: RetryConfig;
+    sleep?: SleepLike;
+    random?: () => number;
+    signal?: AbortSignal;
+    /** `--trace` and the run log; one request and one response per HTTP attempt. */
+    events?: (event: DiagnosticEvent) => void;
+    now?: () => number;
+}
+/**
+ * The official Bot API over HTTP. Speaks for one token, writes nothing to stdout or stderr, and
+ * turns every failure into a `CliError` that never contains the token.
+ */
+export declare class BotTransport {
+    #private;
+    constructor(options: TransportOptions);
+    /** The parsed answer, numbers still lossless; `null` when MAX answered with no body. */
+    call(operation: ManifestOperation, input?: CallInput): Promise<unknown>;
+}
+/**
+ * What `max bot api` prints: a number that fits a JS number stays one, and a bigger one becomes
+ * its exact digits as a string rather than a rounded different number.
+ */
+export declare const plainJson: (value: unknown) => unknown;
+//# sourceMappingURL=transport.d.ts.map

package/dist/bot/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/bot/transport.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,WAAW,EAEhB,KAAK,SAAS,EAEf,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAClE,OAAO,EAAE,KAAK,SAAS,EAAgC,MAAM,wBAAwB,CAAA;AACrF,OAAO,EAAE,KAAK,eAAe,EAAuC,MAAM,4BAA4B,CAAA;AAMtG,eAAO,MAAM,WAAW,iCAAiC,CAAA;AAQzD;;;;GAIG;AACH,eAAO,MAAM,QAAQ,QAAO,SAU3B,CAAA;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACvC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC,CAAA;IAC5D,0FAA0F;IAC1F,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,gFAAgF;IAChF,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAA;IACzC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB;AAyBD;;;GAGG;AACH,qBAAa,YAAY;;IAYvB,YAAY,OAAO,EAAE,gBAAgB,EAWpC;IAED,wFAAwF;IAClF,IAAI,CAAC,SAAS,EAAE,iBAAiB,EAAE,KAAK,GAAE,SAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAoChF;CAuIF;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,UAAW,OAAO,KAAG,OAKxC,CAAA"}

package/dist/bot/transport.js

@@ -0,0 +1,252 @@
+import tls from "node:tls";
+import { backoffMs, CliError, DEFAULT_RETRY, realSleep, singleLine, } from "@wirecat/cli-core";
+import { providerWaitMs, statusToCode } from "@wirecat/cli-core/http";
+import { providerErrorKey } from "@wirecat/cli-messaging/cli";
+import { guardedWrite, newOperationId } from "@wirecat/cli-messaging/sends";
+import { isLosslessNumber, isSafeNumber, parse, stringify } from "lossless-json";
+import { VERSION } from "../version.js";
+import { RUSSIAN_TRUSTED_ROOT_CA } from "./russian-trusted-root.js";
+export const BOT_API_URL = "https://platform-api2.max.ru";
+const DEFAULT_TIMEOUT_MS = 60_000;
+/** `GET /updates` holds the request open for up to its own `timeout`; ours has to outlast it. */
+const LONG_POLL_MARGIN_MS = 15_000;
+let trusted = false;
+/**
+ * Adds the Минцифры root to the trusted roots (`NEED-293`). On Node (22.19+) that changes the
+ * process-wide default, so every TLS connection this process makes from then on trusts it, not only
+ * the Bot API's: Node's `fetch` takes no per-request list. Bun does, so there only these calls do.
+ */
+export const botFetch = () => {
+    if ("Bun" in globalThis) {
+        const ca = [...tls.rootCertificates, RUSSIAN_TRUSTED_ROOT_CA];
+        return (input, init) => fetch(input, { ...init, tls: { ca } });
+    }
+    if (!trusted && typeof tls.setDefaultCACertificates === "function") {
+        tls.setDefaultCACertificates([...tls.getCACertificates("default"), RUSSIAN_TRUSTED_ROOT_CA]);
+        trusted = true;
+    }
+    return fetch;
+};
+/** Path parameters that are ids, by the name the run log uses. `videoToken` is not one of them. */
+const LOGGED_IDS = {
+    chatId: "chat",
+    messageId: "message",
+    userId: "user",
+    commentId: "comment",
+};
+const TLS_FAILURES = new Set([
+    "UNABLE_TO_GET_ISSUER_CERT_LOCALLY",
+    "UNABLE_TO_VERIFY_LEAF_SIGNATURE",
+    "SELF_SIGNED_CERT_IN_CHAIN",
+    "CERT_HAS_EXPIRED",
+]);
+const GATEWAY_FAILURES = new Set([502, 503, 504]);
+const causeCode = (error) => {
+    const cause = error?.cause;
+    const code = typeof cause?.code === "string" ? cause.code : error?.code;
+    return typeof code === "string" ? code : undefined;
+};
+/**
+ * The official Bot API over HTTP. Speaks for one token, writes nothing to stdout or stderr, and
+ * turns every failure into a `CliError` that never contains the token.
+ */
+export class BotTransport {
+    #token;
+    #baseUrl;
+    #fetch;
+    #timeoutMs;
+    #retry;
+    #sleep;
+    #random;
+    #signal;
+    #events;
+    #now;
+    constructor(options) {
+        this.#token = options.token;
+        this.#baseUrl = (options.baseUrl ?? BOT_API_URL).replace(/\/$/, "");
+        this.#fetch = options.fetch ?? botFetch();
+        this.#timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.#retry = options.retry ?? DEFAULT_RETRY;
+        this.#sleep = options.sleep ?? realSleep;
+        this.#random = options.random ?? Math.random;
+        this.#signal = options.signal;
+        this.#events = options.events ?? (() => { });
+        this.#now = options.now ?? Date.now;
+    }
+    /** The parsed answer, numbers still lossless; `null` when MAX answered with no body. */
+    async call(operation, input = {}) {
+        if (operation.binding.kind !== "http") {
+            throw new CliError("configuration_error", `${operation.id} is not an HTTP operation`);
+        }
+        const url = this.#url(operation.binding.path, input);
+        const reads = operation.effect === "read";
+        const timeoutMs = this.#timeoutFor(operation, input);
+        const ids = idsIn(input);
+        for (let attempt = 1;; attempt++) {
+            const said = { operation: operation.id, ...(ids ? { ids } : {}) };
+            const started = this.#now();
+            this.#events({ event: "request", ...said });
+            try {
+                const send = () => this.#once(operation, url, input.body, timeoutMs);
+                // Permissions are checked by the caller; this also lets the command deadline see a write in flight.
+                const { answer, status, bytes } = await (reads
+                    ? send()
+                    : guardedWrite({ check: () => { }, record: () => { } }, { operationId: newOperationId(), chatId: null }, send));
+                this.#events({ event: "response", ...said, status, bytes, durationMs: this.#now() - started, outcome: "ok" });
+                return answer;
+            }
+            catch (error) {
+                this.#events({ event: "response", ...said, durationMs: this.#now() - started, ...failureOf(error) });
+                if (!(error instanceof CliError))
+                    throw error;
+                if (this.#signal?.aborted)
+                    throw error;
+                const retryable = reads && error.details.retryable === true && attempt <= this.#retry.retries;
+                if (!retryable)
+                    throw error;
+                const wait = error.details.retryAfterMs ?? backoffMs(attempt, this.#retry, this.#random);
+                if (wait > this.#retry.maxRetryAfterMs)
+                    throw error;
+                try {
+                    await this.#sleep(wait, this.#signal, "retry");
+                }
+                catch {
+                    throw error;
+                }
+            }
+        }
+    }
+    #url(template, input) {
+        const path = template.replace(/\{([^}]+)\}/g, (_, name) => {
+            const value = input.path?.[name];
+            if (value === undefined)
+                throw new CliError("validation_error", `missing path parameter ${name}`);
+            return encodeURIComponent(value);
+        });
+        const url = new URL(`${this.#baseUrl}${path}`);
+        for (const [name, value] of Object.entries(input.query ?? {})) {
+            url.searchParams.set(name, typeof value === "string" ? value : value.join(","));
+        }
+        return url;
+    }
+    #timeoutFor(operation, input) {
+        const poll = Number(input.query?.timeout);
+        return operation.id === "getUpdates" && Number.isFinite(poll)
+            ? Math.max(this.#timeoutMs, poll * 1000 + LONG_POLL_MARGIN_MS)
+            : this.#timeoutMs;
+    }
+    async #once(operation, url, body, timeoutMs) {
+        const signals = [AbortSignal.timeout(timeoutMs), ...(this.#signal ? [this.#signal] : [])];
+        const reads = operation.effect === "read";
+        let response;
+        try {
+            response = await this.#fetch(url, {
+                method: operation.binding.kind === "http" ? operation.binding.method : "POST",
+                headers: {
+                    Authorization: this.#token,
+                    "User-Agent": `max-cli/${VERSION}`,
+                    Accept: "application/json",
+                    ...(body === undefined ? {} : { "Content-Type": "application/json" }),
+                },
+                ...(body === undefined ? {} : { body }),
+                signal: AbortSignal.any(signals),
+            });
+        }
+        catch (error) {
+            throw this.#transportFailure(operation, error, reads, timeoutMs);
+        }
+        const text = await response.text();
+        if (!response.ok)
+            throw this.#refusal(operation, response, text, reads);
+        const answered = { status: response.status, bytes: Buffer.byteLength(text) };
+        if (text.trim() === "")
+            return { answer: null, ...answered };
+        try {
+            return { answer: parse(text), ...answered };
+        }
+        catch {
+            throw new CliError("invalid_response", `MAX answered ${operation.id} with something that is not JSON`, {
+                operation: operation.id,
+                status: response.status,
+            });
+        }
+    }
+    #transportFailure(operation, error, reads, timeoutMs) {
+        const code = causeCode(error);
+        if (code && TLS_FAILURES.has(code)) {
+            return new CliError("network_error", `this machine does not trust ${new URL(this.#baseUrl).host}'s certificate (${code}). ` +
+                "max-cli adds the Russian Trusted Root CA itself on Node 22.19+ and Bun — update Node, " +
+                "or set NODE_EXTRA_CA_CERTS to that certificate", { operation: operation.id, retryable: false });
+        }
+        if (this.#signal?.aborted) {
+            const deadline = this.#signal.reason?.name === "TimeoutError";
+            if (!deadline)
+                return new CliError("cancelled", `${operation.id} was cancelled`, { operation: operation.id });
+            if (!reads) {
+                return new CliError("outcome_unknown", `the command's time ran out while ${operation.id} was in flight; MAX may or may not have carried it out`, { operation: operation.id, retryable: false });
+            }
+            return new CliError("timeout", `the command's time ran out during ${operation.id}`, {
+                operation: operation.id,
+                retryable: false,
+            });
+        }
+        const timedOut = error?.name === "TimeoutError";
+        if (!reads) {
+            return new CliError("outcome_unknown", `${operation.id} got no answer${timedOut ? ` within ${timeoutMs} ms` : ""}; MAX may or may not have ` +
+                "carried it out — check before repeating it", { operation: operation.id, retryable: false });
+        }
+        return new CliError(timedOut ? "timeout" : "network_error", timedOut ? `${operation.id} got no answer within ${timeoutMs} ms` : `${operation.id} could not reach MAX`, { operation: operation.id, retryable: true });
+    }
+    #refusal(operation, response, text, reads) {
+        let maxCode;
+        let said;
+        try {
+            const body = parse(text);
+            if (typeof body?.code === "string")
+                maxCode = body.code;
+            said = typeof body?.message === "string" ? body.message : typeof body?.error === "string" ? body.error : undefined;
+        }
+        catch { }
+        const reason = said ? `: ${singleLine(said).replaceAll(this.#token, "<token>").slice(0, 300)}` : "";
+        // A gateway answers for MAX without saying whether MAX got the write, so it is no refusal.
+        if (!reads && GATEWAY_FAILURES.has(response.status)) {
+            return new CliError("outcome_unknown", `${operation.id} got ${response.status} from a gateway in front of MAX${reason}; MAX may or may not have ` +
+                "carried it out — check before repeating it", { operation: operation.id, status: response.status, retryable: false, ...(maxCode ? { maxCode } : {}) });
+        }
+        const retryable = response.status === 429 || response.status === 502 || response.status === 503;
+        const retryAfterMs = providerWaitMs(response.headers, () => new Date());
+        return new CliError(statusToCode(response.status), `MAX refused ${operation.id} (${response.status}${maxCode ? ` ${maxCode}` : ""})${reason}`, {
+            operation: operation.id,
+            status: response.status,
+            retryable,
+            ...(maxCode ? { maxCode } : {}),
+            ...(retryAfterMs === undefined ? {} : { retryAfterMs }),
+        });
+    }
+}
+/**
+ * What `max bot api` prints: a number that fits a JS number stays one, and a bigger one becomes
+ * its exact digits as a string rather than a rounded different number.
+ */
+export const plainJson = (value) => JSON.parse(stringify(value, (_, inner) => isLosslessNumber(inner) && !isSafeNumber(inner.value) ? inner.toString() : inner) ?? "null");
+const idsIn = (input) => {
+    const ids = Object.entries(input.path ?? {}).flatMap(([name, value]) => {
+        const logged = LOGGED_IDS[name];
+        return logged ? [[logged, value]] : [];
+    });
+    return ids.length ? Object.fromEntries(ids) : undefined;
+};
+/** The code and MAX's own key, never the message: MAX's refusal can quote what we sent. */
+const failureOf = (error) => {
+    if (!(error instanceof CliError))
+        return { outcome: "error", errorCode: "generic_failure" };
+    const status = typeof error.details.status === "number" ? error.details.status : undefined;
+    const providerError = providerErrorKey(error.details.maxCode);
+    return {
+        outcome: "error",
+        errorCode: error.code,
+        ...(status === undefined ? {} : { status }),
+        ...(providerError ? { providerError } : {}),
+    };
+};
+//# sourceMappingURL=transport.js.map

package/dist/bot/transport.js.map

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

package/dist/bot/uploads.d.ts

@@ -0,0 +1,42 @@
+import { type SleepLike } from "@wirecat/cli-core";
+import { type FetchLike } from "@wirecat/cli-core/http";
+import type { DiagnosticEvent } from "@wirecat/cli-messaging/cli";
+export declare const UPLOAD_TYPES: readonly ["image", "video", "audio", "file"];
+export type UploadType = (typeof UPLOAD_TYPES)[number];
+export declare const uploadTypeOf: (path: string) => UploadType;
+/** What goes into a message body's `attachments`. */
+export interface Attachment {
+    type: UploadType;
+    payload: Record<string, unknown>;
+}
+export interface UploadEndpoint {
+    url: string;
+    token?: string | null;
+}
+export declare const endpointOf: (answer: unknown) => UploadEndpoint;
+/**
+ * The second step: the bytes, streamed from disk as multipart field `data`. The upload URL is not
+ * the Bot API host and is itself a credential, so it gets no token and never appears in an error.
+ * Video and audio answer XML and are named by step one's token; image and file by the answer.
+ */
+export declare const uploadFile: (options: {
+    /** A file on disk, or one already read — `content` — as the shared commands hand it over. */
+    path?: string;
+    content?: {
+        name: string;
+        bytes: Uint8Array;
+    };
+    type: UploadType;
+    endpoint: UploadEndpoint;
+    fetch: FetchLike;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    /** One request and one response; never the URL, which is a credential, nor the file's name. */
+    events?: (event: DiagnosticEvent) => void;
+}) => Promise<Attachment>;
+/**
+ * Repeats a send only while MAX refuses it as not ready — a refusal, so nothing was sent. Any
+ * other failure, an unclear outcome above all, goes straight back to the caller.
+ */
+export declare const whenAttachmentReady: <T>(send: () => Promise<T>, signal?: AbortSignal, sleep?: SleepLike) => Promise<T>;
+//# sourceMappingURL=uploads.d.ts.map

package/dist/bot/uploads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["../../src/bot/uploads.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuC,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACvF,OAAO,EAAE,KAAK,SAAS,EAAgB,MAAM,wBAAwB,CAAA;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAIjE,eAAO,MAAM,YAAY,YAAI,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAU,CAAA;AACxE,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAwBtD,eAAO,MAAM,YAAY,SAAU,MAAM,KAAG,UAA0E,CAAA;AAEtH,qDAAqD;AACrD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAA;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,eAAO,MAAM,UAAU,WAAY,OAAO,KAAG,cAQ5C,CAAA;AAID;;;;GAIG;AACH,eAAO,MAAM,UAAU,YAAmB;IACxC,6FAA6F;IAC7F,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,CAAA;IAC7C,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE,cAAc,CAAA;IACxB,KAAK,EAAE,SAAS,CAAA;IAChB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+FAA+F;IAC/F,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAA;CAC1C,KAAG,OAAO,CAAC,UAAU,CAyErB,CAAA;AAWD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAU,CAAC,QACnC,MAAM,OAAO,CAAC,CAAC,CAAC,WACb,WAAW,UACb,SAAS,KACf,OAAO,CAAC,CAAC,CAUX,CAAA"}