@codexverified/baileys 2.14.14 → 2.17.18

package/lib/Socket/messages-send.js

@@ -12,12 +12,14 @@ import { areJidsSameUser, getBinaryNodeChild, getBinaryNodeChildren, getBizBinar
 import { USyncQuery, USyncUser } from '../WAUSync/index.js';
 import { captureUnifiedResponse, generateButtonGridContent, generateCodeBlockContent, generateLatexContent, generateListContent, generateRichMenuContent, generateTableContent, generateUnifiedResponseContent } from '../Utils/message-composer.js';
 import { Baron } from './interactive-handler.js';
-import { prepareRichResponseMessage, prepareRichGenerationMessage, prepareRichTextMessage, prepareRichImageMessage, prepareRichLinkMessage, prepareHtmlMessage, prepareRichHtmlMessage } from '../Utils/rich-message-utils.js';
+import { prepareRichResponseMessage, prepareRichGenerationMessage, prepareRichTextMessage, prepareRichImageMessage, prepareRichLinkMessage, prepareA2UICommandMenu, prepareAIRichCommandMenu, prepareVideoGridMessage, prepareVerticalAlbumMessage, prepareHtmlMessage, prepareRichHtmlMessage, prepareA2UIMessage, prepareBotPromptSuggestionsMessage, prepareBotPttTranscriptMessage, prepareBotSourcesMessage, prepareInstagramProfileMessage, prepareRichDynamicMediaMessage, prepareRichMapMessage, prepareSocialEntityMessage } from '../Utils/rich-message-utils.js';
 import { generateSlotMachineHtml } from '../Utils/games/slot-machine.js';
+import { generateMiniAppHtml } from '../Utils/games/miniapp.js';
 import { generateWebsitePreviewHtml, generateLinkPreviewHtml } from '../Utils/website-preview.js';
 import { isViewOnceMessage, downloadViewOnceMedia, createRegularMessageFromViewOnce, parseViewOnceInfo } from '../Utils/view-once-utils.js';
 import { collectMetaAIBotParticipantJids, isMetaAIBotResponse, META_AI_BOT_JID } from './aigroups.js';
 import { makeUsernameSocket } from './username.js';
+import { grepSource } from '../Utils/source-grep.js';
 
 const STATUS_JID = 'status@broadcast';
 export const normalizeStatusJidList = (value) => {
@@ -1242,11 +1244,38 @@ export const makeMessagesSocket = (config) => {
         if (!content.copyText) throw new Boom('sendQuoteCopy requires copyText content', { statusCode: 400 });
         return socket.sendRichTextCopy(jid, content, options);
         },
+        /** Send a full-width stacked AIRich album with one large image/video per row. */
         sendAlbumMessage: async (jid, medias = [], options = {}) => {
         if (!jid) throw new Boom('sendAlbumMessage requires a target JID', { statusCode: 400 });
         if (!Array.isArray(medias) || medias.length < 2) throw new Boom('sendAlbumMessage requires at least two media items', { statusCode: 400 });
-        const album = medias.map((media, index) => { const normalized = media?.type && media?.data ? { [media.type]: media.data } : { ...media }; if (index === 0 && options.caption && !normalized.caption) normalized.caption = options.caption; return normalized; });
-        return socket.sendMessage(jid, { album }, options);
+        const albumItems = medias.map((media) => {
+            const raw = media?.type && media?.data ? media.data : (media?.image ?? media);
+            if (media?.video || media?.type === 'video') {
+                const video = media?.video || raw;
+                const sourceUrl = typeof video === 'string' ? video.trim() : String(video?.url || video?.videoUrl || '').trim();
+                if (!sourceUrl) throw new Boom('Each video album item requires a video URL', { statusCode: 400 });
+                return { type: 'video', video: { ...video, url: sourceUrl } };
+            }
+            const image = typeof raw === 'string' ? raw.trim() : { ...raw, url: String(raw?.url || '').trim() };
+            if (!image || (typeof image === 'object' && !image.url && !image.sourceUrl)) {
+                throw new Boom('Each image album item requires an image URL', { statusCode: 400 });
+            }
+            return { type: 'image', image };
+        });
+        const wrapped = prepareVerticalAlbumMessage({ items: albumItems, verificationMetadata: options.verificationMetadata });
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
+            logger,
+            userJid: authState.creds.me?.id,
+            messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id || jid),
+            ...options
+        });
+        await relayMessage(jid, fullMsg.message, { messageId: fullMsg.key.id, ...options });
+        if (config.emitOwnEvents) {
+            process.nextTick(async () => {
+                await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
+            });
+        }
+        return fullMsg;
         },
         sendBotDiagnostics: async (jid, content = {}, options = {}) => {
         if (!jid) throw new Boom('sendBotDiagnostics requires a target JID', { statusCode: 400 });
@@ -1258,6 +1287,29 @@ export const makeMessagesSocket = (config) => {
         const { text = 'Bot command test', commandName = '', commandDescription = '', commandPrompt = '', botJid = '867051314767696@bot' } = content;
         return socket.sendRichGeneration(jid, { text, botMetadata: { commandMetadata: { commandName, commandDescription, commandPrompt } }, botJid }, undefined, options);
         },
+        /** Sends a planning/execution-plan rich response with WAProto capabilities. */
+        sendBotPlanning: async (jid, content = {}, options = {}) => {
+        if (!jid) throw new Boom('sendBotPlanning requires a target JID', { statusCode: 400 });
+        const { text = 'Execution plan', steps = [], queryPlan = true, botJid = '867051314767696@bot' } = content;
+        const submessages = [
+            { messageType: proto.AIRichResponseSubMessageType.AI_RICH_RESPONSE_TEXT, messageText: text },
+            ...steps.map(step => ({
+                messageType: proto.AIRichResponseSubMessageType.AI_RICH_RESPONSE_TEXT,
+                messageText: typeof step === 'string' ? step : `${step.title || step.name || 'Step'}${step.body ? `: ${step.body}` : ''}`
+            }))
+        ];
+        const wrapped = buildBotRichResponse({
+            botJid,
+            submessages,
+            capabilities: [
+                BotCapabilityType.AGENTIC_PLANNING,
+                ...(queryPlan ? [BotCapabilityType.QUERY_PLAN] : [])
+            ]
+        });
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, { logger, userJid: authState.creds.me?.id, messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id), ...options });
+        await relayRichMessage(jid, fullMsg, options);
+        return fullMsg;
+        },
         sendBotToolResult: async (jid, content = {}, options = {}) => {
         if (!jid) throw new Boom('sendBotToolResult requires a target JID', { statusCode: 400 });
         const { text = 'Bot tool result test', toolCallId = 'tool-' + Date.now(), resolutionData, resolutionDataSerialized, botJid = '867051314767696@bot' } = content;
@@ -1270,6 +1322,153 @@ export const makeMessagesSocket = (config) => {
             await relayMessage(jid, fullMsg.message, { messageId: fullMsg.key.id, useCachedGroupMetadata: options.useCachedGroupMetadata, statusJidList: options.statusJidList });
             return fullMsg;
         },
+        sendA2UIMessage: async (jid, content = {}, options = {}) => {
+        if (!jid) throw new Boom('sendA2UIMessage requires a target JID', { statusCode: 400 });
+        const { image, ...payload } = content || {};
+        let imageMessage;
+        if (image) {
+            const prepared = await prepareWAMessageMedia({ image }, { upload: waUploadToServer });
+            imageMessage = prepared.imageMessage;
+        }
+        const wrapped = prepareA2UIMessage({ ...payload, imageMessage });
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
+            logger,
+            userJid: authState.creds.me?.id,
+            messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id || jid),
+            ...options,
+        });
+        await relayRichMessage(jid, fullMsg, { ...options, forceRichEdit: true });
+        if (config.emitOwnEvents) process.nextTick(async () => { await messageMutex.mutex(() => upsertMessage(fullMsg, 'append')); });
+        return fullMsg;
+    },
+        sendBotPromptSuggestions: async (jid, content = {}, options = {}) => {
+        if (!jid) throw new Boom('sendBotPromptSuggestions requires a target JID', { statusCode: 400 });
+        const wrapped = prepareBotPromptSuggestionsMessage(content);
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
+            logger,
+            userJid: authState.creds.me?.id,
+            messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
+            ...options
+        });
+        await relayRichMessage(jid, fullMsg, options);
+        return fullMsg;
+    },
+        sendBotPttTranscript: async (jid, content = {}, options = {}) => {
+        if (!jid) throw new Boom('sendBotPttTranscript requires a target JID', { statusCode: 400 });
+        const wrapped = prepareBotPttTranscriptMessage(content);
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
+            logger,
+            userJid: authState.creds.me?.id,
+            messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
+            ...options
+        });
+        await relayRichMessage(jid, fullMsg, options);
+        return fullMsg;
+    },
+        sendBotSources: async (jid, content = {}, options = {}) => {
+        if (!jid) throw new Boom('sendBotSources requires a target JID', { statusCode: 400 });
+        const wrapped = prepareBotSourcesMessage(content);
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
+            logger,
+            userJid: authState.creds.me?.id,
+            messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
+            ...options
+        });
+        await relayRichMessage(jid, fullMsg, options);
+        return fullMsg;
+    },
+        sendInstagramProfile: async (jid, content = {}, options = {}) => {
+        if (!jid) throw new Boom('sendInstagramProfile requires a target JID', { statusCode: 400 });
+        const wrapped = prepareInstagramProfileMessage(content);
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
+            logger,
+            userJid: authState.creds.me?.id,
+            messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id || jid),
+            ...options
+        });
+        await relayRichMessage(jid, fullMsg, options);
+        if (config.emitOwnEvents) process.nextTick(async () => { await messageMutex.mutex(() => upsertMessage(fullMsg, 'append')); });
+        return fullMsg;
+        },
+        sendRichDynamicMedia: async (jid, content = {}, options = {}) => {
+        if (!jid) throw new Boom('sendRichDynamicMedia requires a target JID', { statusCode: 400 });
+        const wrapped = prepareRichDynamicMediaMessage(content);
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
+            logger,
+            userJid: authState.creds.me?.id,
+            messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
+            ...options
+        });
+        await relayRichMessage(jid, fullMsg, options);
+        return fullMsg;
+    },
+        sendRichMap: async (jid, content = {}, options = {}) => {
+        if (!jid) throw new Boom('sendRichMap requires a target JID', { statusCode: 400 });
+        const wrapped = prepareRichMapMessage(content);
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
+            logger,
+            userJid: authState.creds.me?.id,
+            messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id),
+            ...options
+        });
+        await relayRichMessage(jid, fullMsg, options);
+        return fullMsg;
+    },
+        sendSocialEntity: async (jid, content = {}, options = {}) => {
+        if (!jid) throw new Boom('sendSocialEntity requires a target JID', { statusCode: 400 });
+        const wrapped = prepareSocialEntityMessage(content);
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
+            logger,
+            userJid: authState.creds.me?.id,
+            messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id || jid),
+            ...options,
+        });
+        await relayRichMessage(jid, fullMsg, options);
+        if (config.emitOwnEvents) process.nextTick(async () => { await messageMutex.mutex(() => upsertMessage(fullMsg, 'append')); });
+        return fullMsg;
+    },
+        /** Send the large A2UI command menu with an uploaded image header, rows, and URL buttons. */
+        /** Sends the manually serialized AIRich command card shown in the screenshot. */
+        sendAIRichCommandMenu: async (jid, content = {}, options = {}) => {
+        if (!jid) throw new Boom('sendAIRichCommandMenu requires a target JID', { statusCode: 400 });
+        const wrapped = prepareAIRichCommandMenu(content);
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
+            logger,
+            userJid: authState.creds.me?.id,
+            messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id || jid),
+            ...options,
+        });
+        await relayRichMessage(jid, fullMsg, options);
+        if (config.emitOwnEvents) {
+            process.nextTick(async () => {
+                await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
+            });
+        }
+        return fullMsg;
+        },
+        sendA2UICommandMenu: async (jid, content = {}, options = {}) => {
+        if (!jid) throw new Boom('sendA2UICommandMenu requires a target JID', { statusCode: 400 });
+        const { image, ...menuContent } = content || {};
+        let imageMessage;
+        if (image) {
+            const prepared = await prepareWAMessageMedia({ image }, { upload: waUploadToServer });
+            imageMessage = prepared.imageMessage;
+        }
+        const wrapped = prepareA2UICommandMenu({ ...menuContent, imageMessage });
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, {
+            logger,
+            userJid: authState.creds.me?.id,
+            messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id || jid),
+            ...options
+        });
+        await relayMessage(jid, fullMsg.message, { messageId: fullMsg.key.id, ...options.relayOptions });
+        if (config.emitOwnEvents) {
+            process.nextTick(async () => {
+                await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
+            });
+        }
+        return fullMsg;
+        },
         sendRichButtonGrid: async (jid, grid, options = {}) => {
             const message = generateButtonGridContent(grid, options.quoted, options);
             const fullMsg = await generateWAMessageFromContent(jid, message, { logger, userJid: authState.creds.me?.id, messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id), ...options });
@@ -1289,6 +1488,8 @@ export const makeMessagesSocket = (config) => {
             const lines = [title, headers.length ? `| ${headers.map(String).join(' | ')} |` : '', headers.length ? `| ${headers.map(() => '---').join(' | ')} |` : '', ...rows.map(row => `| ${(Array.isArray(row) ? row : [row]).map(value => String(value ?? '')).join(' | ')} |`)].filter(Boolean);
             return sock.sendMessage(jid, { ...(image ? { image, caption: lines.join('\\n') } : { text: lines.join('\\n') }), buttons, ...(footer ? { footer } : {}) }, options);
         },
+        /** Compatibility alias for the former Gen4/grid menu entry point. */
+        HoldOn: async (jid, grid, options = {}) => socket.sendRichButtonGrid(jid, grid, options),
         sendWhatsAppFlow: async (jid, flow = {}, options = {}) => {
             const { text, footer, image, caption, flowId, flowToken, flowName = 'flow', flowAction = 'navigate', flowActionPayload = {} } = flow;
             if (!flowId || !flowToken) throw new Boom('sendWhatsAppFlow requires flowId and flowToken', { statusCode: 400 });
@@ -1313,6 +1514,38 @@ export const makeMessagesSocket = (config) => {
             await relayMessage(jid, message, { messageId });
             return { message, messageId };
         },
+        sendCarousel: async (jid, cards, options = {}) => {
+            if (!Array.isArray(cards) || cards.length === 0) {
+                throw new Boom('sendCarousel requires a non-empty cards array', { statusCode: 400 });
+            }
+            const normalizedCards = cards.map(card => ({
+                ...card,
+                text: card.text ?? card.body?.text,
+                caption: card.caption ?? card.body?.text,
+                footer: card.footer?.text ?? card.footer,
+                buttons: card.buttons ?? card.nativeFlowMessage?.buttons,
+                ...(card.media?.image ? { image: card.media.image } : {}),
+                ...(card.media?.video ? { video: card.media.video } : {}),
+                ...(card.media?.document ? { document: card.media.document } : {})
+            }));
+            const { text, footer, ...messageOptions } = options;
+            const fullMsg = await generateWAMessage(jid, {
+                ...messageOptions,
+                cards: normalizedCards,
+                ...(text !== undefined ? { text } : {}),
+                ...(footer !== undefined ? { footer } : {})
+            }, {
+                logger,
+                userJid: authState.creds.me?.id,
+                upload: waUploadToServer,
+                mediaCache: config.mediaCache,
+                options: config.options,
+                ...options,
+                messageId: options.messageId || generateMessageIDV2(jid)
+            });
+            await relayMessage(jid, fullMsg.message, { messageId: fullMsg.key.id, ...options });
+            return fullMsg;
+        },
         sendLatex: async (jid, quoted, options) => {
             const { message, messageId } = generateLatexContent(quoted, options);
             await relayMessage(jid, message, { messageId });
@@ -1519,6 +1752,31 @@ export const makeMessagesSocket = (config) => {
             await relayMessage(jid, message, { messageId });
             return { message, messageId };
         },
+        /** Send one tolerant AIRich response containing every supported section supplied in content. */
+        sendCodexMessage: async (jid, content = {}, quoted, options = {}) => {
+            if (!jid) throw new Boom('sendCodexMessage requires a target JID', { statusCode: 400 });
+            if (!content || typeof content !== 'object' || Array.isArray(content)) {
+                throw new Boom('sendCodexMessage content must be an object', { statusCode: 400 });
+            }
+            const message = prepareRichResponseMessage({
+                ...content,
+                noDonation: options.noDonation ?? true,
+            });
+            const fullMsg = generateWAMessageFromContent(jid, message, {
+                logger,
+                userJid: authState.creds.me?.id,
+                messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id || jid),
+                quoted,
+                ...options,
+            });
+            await relayMessage(jid, fullMsg, options);
+            if (config.emitOwnEvents) {
+                process.nextTick(async () => {
+                    await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
+                });
+            }
+            return fullMsg;
+        },
         captureAndResendUnifiedResponse: async (jid, metaAiMsg, quoted) => {
             const captured = captureUnifiedResponse(metaAiMsg);
             if (!captured) {
@@ -2259,6 +2517,35 @@ export const makeMessagesSocket = (config) => {
         return { message, messageId };
     };
 
+    /**
+     * Sends a unified-response video grid. This uses GenAIVideoPrimitive items
+     * inside GenAIGridLayoutViewModel; it is not the image-only GRID_IMAGE type.
+     */
+    socket.sendVideoGridMessage = async (jid, videos = [], options = {}) => {
+        if (!jid) throw new Boom('sendVideoGridMessage requires a target JID', { statusCode: 400 });
+        if (!Array.isArray(videos) || videos.length < 2) {
+            throw new Boom('sendVideoGridMessage requires at least two videos', { statusCode: 400 });
+        }
+        const wrapped = prepareVideoGridMessage({
+            videos,
+            verificationMetadata: options.verificationMetadata
+        });
+        const fullMsg = generateWAMessageFromContent(jid, wrapped, {
+            logger,
+            userJid: authState.creds.me?.id,
+            messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id || jid),
+            ...options
+        });
+        await relayRichMessage(jid, fullMsg, options);
+        if (config.emitOwnEvents) {
+            process.nextTick(async () => {
+                await messageMutex.mutex(() => upsertMessage(fullMsg, 'append'));
+            });
+        }
+        return fullMsg;
+    };
+
+
     socket.sendHtmlMessage = async (jid, content = {}, options = {}) => {
         if (!jid) throw new Boom('sendHtmlMessage requires a target JID', { statusCode: 400 });
         if (!content.html) throw new Boom('sendHtmlMessage requires html content', { statusCode: 400 });
@@ -2276,10 +2563,23 @@ export const makeMessagesSocket = (config) => {
         await relayMessage(jid, fullMsg.message, { messageId: fullMsg.key.id, useCachedGroupMetadata: options.useCachedGroupMetadata, statusJidList: options.statusJidList });
         return fullMsg;
     };
+    /** Find a word or expression in the installed package source. */
+    socket.grepCode = (pattern, options = {}) => grepSource(pattern, options);
+
     socket.sendSlotMachine = async (jid, options = {}, sendOptions = {}) => {
         return socket.sendHtmlMessage(jid, { html: generateSlotMachineHtml(options) }, sendOptions);
     };
 
+    /** Send the built-in interactive Codex mini-app through the rich HTML envelope. */
+    socket.sendMiniApp = async (jid, options = {}, sendOptions = {}) => {
+        if (!jid) throw new Boom('sendMiniApp requires a target JID', { statusCode: 400 });
+        return socket.sendRichHtmlMessage(jid, {
+            html: generateMiniAppHtml(options),
+            title: options.title || 'mini-app',
+            url: 'https://codex-ai.site',
+            trustedSources: ['codex-ai.site']
+        }, sendOptions);
+    };
     socket.sendWebsitePreview = async (jid, url, options = {}, sendOptions = {}) => {
         if (!url) throw new Boom('sendWebsitePreview requires a URL', { statusCode: 400 });
         return socket.sendHtmlMessage(jid, { html: await generateWebsitePreviewHtml(url, options) }, sendOptions);

package/lib/Socket/newsletter.js

@@ -1,3 +1,4 @@
+import { Boom } from '@hapi/boom';
 import { proto } from '../../WAProto/index.js';
 import { QueryIds, XWAPaths } from '../Types/index.js';
 import { generateProfilePicture } from '../Utils/messages-media.js';
@@ -34,6 +35,15 @@ const parseNewsletterMetadata = (result) => {
     }
     return null;
 };
+const normalizeNewsletterInviteCode = (value) => {
+    if (typeof value !== 'string' || !value.trim()) {
+        throw new Boom('newsletterGetInviteInfo requires a non-empty invite code or URL', { statusCode: 400 });
+    }
+    return value.trim()
+        .replace(/^https?:\/\/(?:www\.)?whatsapp\.com\/channel\//i, '')
+        .replace(/^https?:\/\/wa\.me\/channel\//i, '')
+        .split(/[/?#]/, 1)[0];
+};
 export const makeNewsletterSocket = (config) => {
     const sock = makeAIGroupsSocket(config);
     const { query, generateMessageTag } = sock;
@@ -84,6 +94,14 @@ export const makeNewsletterSocket = (config) => {
             const result = await executeWMexQuery(variables, QueryIds.METADATA, XWAPaths.xwa2_newsletter_metadata);
             return parseNewsletterMetadata(result);
         },
+        newsletterGetInviteInfo: async (inviteCodeOrUrl) => {
+            const inviteCode = normalizeNewsletterInviteCode(inviteCodeOrUrl);
+            return executeWMexQuery(
+                { input: { key: inviteCode, type: 'INVITE' }, fetch_creation_time: true, fetch_full_image: true, fetch_viewer_metadata: true },
+                QueryIds.METADATA,
+                XWAPaths.xwa2_newsletter_metadata
+            ).then(parseNewsletterMetadata);
+        },
         newsletterFollow: (jid) => {
             return executeWMexQuery({ newsletter_id: jid }, QueryIds.FOLLOW, XWAPaths.xwa2_newsletter_join_v2);
         },
@@ -224,3 +242,4 @@ export const makeNewsletterSocket = (config) => {
         }
     };
 };
+    

package/lib/Utils/bot-capabilities.js

@@ -0,0 +1,84 @@
+import { proto } from '../../WAProto/index.js';
+
+/**
+ * Numeric capability values exposed by WAProto.BotCapabilityMetadata.
+ * Keep this derived from the generated protobuf so callers cannot drift from
+ * the checked-in schema.
+ */
+export const BotCapabilityType = proto.BotCapabilityMetadata.BotCapabilityType;
+
+const capabilityNames = new Set(
+    Object.keys(BotCapabilityType).filter(name => Number.isNaN(Number(name)))
+);
+
+/** Normalize enum names/numbers and reject unknown capability values. */
+export const normalizeBotCapabilities = (capabilities = []) => {
+    if (!Array.isArray(capabilities)) {
+        throw new TypeError('capabilities must be an array');
+    }
+    const values = capabilities.map(capability => {
+        if (typeof capability === 'string') {
+            if (!capabilityNames.has(capability)) {
+                throw new TypeError(`Unknown bot capability: ${capability}`);
+            }
+            return BotCapabilityType[capability];
+        }
+        if (Number.isInteger(capability) && BotCapabilityType[capability] !== undefined) {
+            return capability;
+        }
+        throw new TypeError(`Invalid bot capability: ${String(capability)}`);
+    });
+    return [...new Set(values)];
+};
+
+export const buildBotCapabilityMetadata = (capabilities = []) => ({
+    capabilities: normalizeBotCapabilities(capabilities)
+});
+
+/**
+ * Build the canonical wrapper used by WhatsApp's bot rich-response messages.
+ * The capability list is deliberately explicit; unknown or duplicate values
+ * are never put on the wire.
+ */
+export const buildBotRichResponse = ({
+    text,
+    submessages,
+    capabilities = [],
+    botMetadata = {},
+    botJid = '867051314767696@bot',
+    richResponse = {}
+} = {}) => {
+    const resolvedSubmessages = submessages || (text == null ? [] : [{
+        messageType: proto.AIRichResponseSubMessageType.AI_RICH_RESPONSE_TEXT,
+        messageText: String(text)
+    }]);
+    return {
+        messageContextInfo: {
+            botMetadata: {
+                ...botMetadata,
+                capabilityMetadata: buildBotCapabilityMetadata(capabilities)
+            }
+        },
+        botForwardedMessage: {
+            message: {
+                richResponseMessage: {
+                    messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD,
+                    submessages: resolvedSubmessages,
+                    ...richResponse,
+                    contextInfo: {
+                        isForwarded: true,
+                        forwardingScore: 1,
+                        forwardedAiBotMessageInfo: { botJid },
+                        forwardOrigin: 4,
+                        ...(richResponse.contextInfo || {})
+                    }
+                }
+            }
+        }
+    };
+};
+
+export const capability = (name) => {
+    if (!capabilityNames.has(name)) throw new TypeError(`Unknown bot capability: ${name}`);
+    return BotCapabilityType[name];
+};

package/lib/Utils/games/miniapp.js

@@ -0,0 +1,5 @@
+/** Generate the attached interactive mini-app HTML game. */
+export const generateMiniAppHtml = (options = {}) => {
+    const html = "<style>*{-webkit-tap-highlight-color:transparent;-webkit-user-select:none;user-select:none;-webkit-touch-callout:none}</style>\n<body style=\"margin:0;background:transparent;font-family:Arial,sans-serif;color:#eee;touch-action:manipulation;cursor:pointer\">\n<div style=\"width:100%;max-width:620px;margin:auto;padding:16px;box-sizing:border-box\">\n<div style=\"background:rgba(255,255,255,.06);backdrop-filter:blur(14px);-webkit-backdrop-filter:blur(14px);border:1px solid rgba(255,255,255,.15);border-radius:16px;overflow:hidden;box-shadow:0 8px 32px rgba(0,0,0,.35)\">\n<div style=\"padding:18px 20px;border-bottom:1px solid rgba(255,255,255,.12);display:flex;justify-content:space-between;align-items:center\">\n<div><div style=\"font-size:11px;letter-spacing:1.5px;color:rgba(255,255,255,.45)\">𝑶𝒓𝒊𝒈𝒊𝒏✦</div><div style=\"font-size:21px;font-weight:bold;color:#fff\">mini-app</div></div>\n<div style=\"text-align:right\"><div id=\"score\" style=\"font-size:18px;font-weight:bold;color:#fff;text-shadow:0 0 10px rgba(108,92,231,.85);transition:transform .15s\">00000</div><div id=\"best\" style=\"font-size:10px;color:rgba(255,255,255,.4);margin-top:2px\">BEST 00000</div></div>\n</div>\n<div style=\"padding:18px\">\n<canvas id=\"game\" width=\"560\" height=\"190\" style=\"width:100%;height:auto;background:rgba(255,255,255,.03);border:1px solid rgba(255,255,255,.12);border-radius:12px;display:block\"></canvas>\n<div id=\"status\" style=\"text-align:center;margin-top:10px;font-size:12px;color:rgba(255,255,255,.55)\">Velocità 5.0x</div>\n</div></div></div>\n<script>\nconst c=document.getElementById('game'),x=c.getContext('2d'),scoreEl=document.getElementById('score'),bestEl=document.getElementById('best'),statusEl=document.getElementById('status');\nconst GY=170;\nlet d,o,clouds,particles,ambient,trail,score,best=0,speed,gameOver,last,shake,flash,runT,spawnTimer,milestone,squash;\nfunction loadBest(){\nlet vals=[];\ntry{let v=localStorage.getItem('dino_best');if(v)vals.push(parseInt(v,10))}catch(e){}\ntry{let v=sessionStorage.getItem('dino_best');if(v)vals.push(parseInt(v,10))}catch(e){}\ntry{let m=document.cookie.match(/(?:^|;\\s*)dino_best=(\\d+)/);if(m)vals.push(parseInt(m[1],10))}catch(e){}\nreturn vals.length?Math.max(...vals.filter(v=>!isNaN(v))):0\n}\nfunction saveBest(v){\nlet val=String(Math.floor(v));\ntry{localStorage.setItem('dino_best',val)}catch(e){}\ntry{sessionStorage.setItem('dino_best',val)}catch(e){}\ntry{document.cookie='dino_best='+val+';max-age=31536000;path=/'}catch(e){}\ntry{\nlet rq=indexedDB.open('dino_db',1);\nrq.onupgradeneeded=()=>{rq.result.createObjectStore('kv')};\nrq.onsuccess=()=>{try{rq.result.transaction('kv','readwrite').objectStore('kv').put(val,'dino_best')}catch(e){}}\n}catch(e){}\n}\nfunction loadBestAsync(cb){\ntry{\nlet rq=indexedDB.open('dino_db',1);\nrq.onupgradeneeded=()=>{rq.result.createObjectStore('kv')};\nrq.onsuccess=()=>{\ntry{\nlet gr=rq.result.transaction('kv','readonly').objectStore('kv').get('dino_best');\ngr.onsuccess=()=>{if(gr.result)cb(parseInt(gr.result,10))}\n}catch(e){}\n}\n}catch(e){}\n}\nbest=loadBest();\nloadBestAsync(v=>{if(!isNaN(v)&&v>best){best=v;bestEl.textContent='BEST '+String(Math.floor(best)).padStart(5,'0')}});\nfunction reset(){\nd={x:55,y:132,w:27,h:30,vy:0,jumping:false};\no=[];\nclouds=[{x:120,y:32,w:44,s:.35},{x:300,y:52,w:60,s:.22},{x:460,y:26,w:36,s:.4},{x:560,y:70,w:50,s:.18}];\nparticles=[];\ntrail=[];\nif(!ambient){ambient=[];for(let i=0;i<18;i++)ambient.push({x:Math.random()*c.width,y:Math.random()*c.height,r:.5+Math.random()*1.5,vx:.1+Math.random()*.3,ph:Math.random()*10})}\nscore=0;speed=5;gameOver=false;last=0;shake=0;flash=0;runT=0;milestone=0;squash=1;\nspawnTimer=70+Math.random()*30;\nbestEl.textContent='BEST '+String(Math.floor(best)).padStart(5,'0');\nstatusEl.textContent='Speed 5.0x'\n}\nfunction burst(px,py,n,col,spd){for(let i=0;i<n;i++)particles.push({x:px,y:py,vx:(Math.random()-.5)*spd,vy:-Math.random()*spd,life:1,col,size:2+Math.random()*2})}\nfunction jumpDino(){\nif(gameOver){reset();return}\nif(!d.jumping){d.jumping=true;d.vy=-13;squash=.7;burst(d.x+13,d.y+30,10,'255,255,255',4)}\n}\nfunction cactus(){\nlet h=24+Math.random()*24;\no.push({x:c.width+20,y:GY-h,w:16+Math.random()*6,h});\nif(Math.random()<.22){o.push({x:c.width+20+34+Math.random()*10,y:GY-(20+Math.random()*18),w:16,h:20+Math.random()*18})}\n}\nfunction hit(a,b){return a.x+4<b.x+b.w&&a.x+a.w-4>b.x&&a.y+4<b.y+b.h&&a.y+a.h>b.y}\nfunction drawTrail(){\ntrail.forEach((p,i)=>{x.fillStyle='rgba(108,92,231,'+(.25*(i/trail.length))+')';x.fillRect(p.x,p.y,27,30)})\n}\nfunction drawDino(){\nx.save();\nlet cx=d.x+13,cy=d.y+30;\nx.translate(cx,cy);\nx.scale(1/squash,squash);\nx.translate(-cx,-cy);\nlet legOff=d.jumping?0:Math.sin(runT*.5)*5;\nx.fillStyle='#eaeaea';\nx.fillRect(d.x,d.y,27,30);\nx.fillRect(d.x+22,d.y+5,13,18);\nx.fillStyle='#6c5ce7';\nx.fillRect(d.x+29,d.y+8,4,4);\nx.fillStyle='#eaeaea';\nx.fillRect(d.x+5,d.y+30,6,8+legOff);\nx.fillRect(d.x+20,d.y+30,6,8-legOff);\nx.restore()\n}\nfunction drawCactus(q){\nx.save();\nx.shadowColor='rgba(255,90,90,.35)';x.shadowBlur=10;\nx.fillStyle='#e17a7a';\nx.fillRect(q.x,q.y,q.w,q.h);\nx.fillRect(q.x-7,q.y+10,7,6);\nx.fillRect(q.x-7,q.y+4,6,12);\nx.fillRect(q.x+q.w,q.y+18,7,6);\nx.fillRect(q.x+q.w+1,q.y+12,6,12);\nx.restore()\n}\nfunction drawParticles(){\nparticles.forEach(p=>{x.fillStyle='rgba('+p.col+','+Math.max(p.life,0)+')';x.fillRect(p.x,p.y,p.size,p.size)})\n}\nfunction drawAmbient(){\nambient.forEach(p=>{let a=.15+Math.sin(runT*.05+p.ph)*.1;x.fillStyle='rgba(180,160,255,'+a+')';x.beginPath();x.arc(p.x,p.y,p.r,0,7);x.fill()})\n}\nfunction draw(){\nx.clearRect(0,0,c.width,c.height);\nx.save();\nif(shake>0)x.translate((Math.random()-.5)*shake,(Math.random()-.5)*shake);\ndrawAmbient();\nx.fillStyle='rgba(255,255,255,.35)';\nclouds.forEach(q=>{let b=Math.sin(runT*.03+q.x)*2;x.fillRect(q.x,q.y+b,q.w,5);x.fillRect(q.x+10,q.y+b-5,q.w*.45,10)});\nx.strokeStyle='rgba(255,255,255,.25)';\nx.lineWidth=2;\nx.setLineDash([10,8]);\nx.lineDashOffset=-runT*speed*.6;\nx.beginPath();x.moveTo(0,GY);x.lineTo(c.width,GY);x.stroke();\nx.setLineDash([]);\ndrawTrail();\ndrawDino();\no.forEach(drawCactus);\ndrawParticles();\nif(flash>0){x.fillStyle='rgba(255,60,60,'+(flash*.35)+')';x.fillRect(0,0,c.width,c.height)}\nx.restore();\nif(gameOver){\nx.fillStyle='rgba(15,15,25,.55)';x.fillRect(0,0,c.width,c.height);\nx.fillStyle='#fff';x.textAlign='center';\nx.font='bold 24px Arial';x.fillText('GAME OVER',c.width/2,85);\nx.font='14px Arial';x.fillText('Tocca per giocare di nuovo',c.width/2,112);\nx.textAlign='left'\n}\n}\nfunction loop(t){\nif(!last)last=t;\nlet dt=Math.min((t-last)/16.67,2);\nlast=t;\nrunT+=dt;\nif(!gameOver){\nd.y+=d.vy*dt;d.vy+=.75*dt;\nif(d.y>=132){\nif(d.jumping){burst(d.x+13,GY,10,'255,255,255',3.5);squash=1.35}\nd.y=132;d.vy=0;d.jumping=false\n}\nif(d.jumping)trail.push({x:d.x,y:d.y});\nif(trail.length>6)trail.shift();\nif(!d.jumping)trail.length=0;\nsquash+=(1-squash)*.18*dt;\nif(!d.jumping&&Math.floor(runT)%8===0&&Math.random()<.4)burst(d.x+6,GY-2,1,'255,255,255',1.5);\nambient.forEach(p=>{p.x-=p.vx*dt;if(p.x<-4)p.x=c.width+4});\nspawnTimer-=dt;\nif(spawnTimer<=0){cactus();spawnTimer=Math.max(38,62-speed*1.4)+Math.random()*30}\no.forEach(q=>q.x-=speed*dt);\no=o.filter(q=>q.x>-40);\nclouds.forEach(q=>{q.x-=q.s*dt;if(q.x<-80)q.x=c.width+Math.random()*100});\nparticles.forEach(p=>{p.x+=p.vx*dt;p.y+=p.vy*dt;p.vy+=.3*dt;p.life-=.03*dt});\nparticles=particles.filter(p=>p.life>0);\nspeed=Math.min(11,speed+.0018*dt);\nscore+=dt*.6;\nif(score>best)best=score;\nif(Math.floor(score/500)>milestone){\nmilestone=Math.floor(score/500);\nscoreEl.style.transform='scale(1.35)';\nsetTimeout(()=>scoreEl.style.transform='scale(1)',150)\n}\nscoreEl.textContent=String(Math.floor(score)).padStart(5,'0');\nbestEl.textContent='BEST '+String(Math.floor(best)).padStart(5,'0');\nstatusEl.textContent='Speed '+speed.toFixed(1)+'x';\nfor(const q of o)if(hit(d,q)){\ngameOver=true;shake=14;flash=1;\nsaveBest(best);\nburst(d.x+13,d.y+15,18,'255,90,90',5)\n}\n}\nif(shake>0)shake=Math.max(0,shake-.6*dt);\nif(flash>0)flash=Math.max(0,flash-.05*dt);\ndraw();\nrequestAnimationFrame(loop)\n}\ndocument.addEventListener('pointerdown',e=>{e.preventDefault();jumpDino()});\ndocument.addEventListener('keydown',e=>{if(e.code==='Space'){e.preventDefault();jumpDino()}});\nreset();\nrequestAnimationFrame(loop);\n</script></body>";
+    return options.title ? html.replace('mini-app', String(options.title)) : html;
+};

package/lib/Utils/index.js

@@ -6,6 +6,7 @@ export * from './messages-media.js';
 export * from './rich-message-utils.js';
 export * from './meta-compositing.js';
 export * from './bot-planning-replay.js';
+export * from './bot-capabilities.js';
 export * from './welcome-flow.js';
 export * from './message-composer.js';
 export * from './consumer-application.js';
@@ -38,3 +39,6 @@ export * from './native-flow.js';
 export * from './view-once-utils.js';
 export * from './website-preview.js';
 export * from './portable-compat.js';
+export * from './games/miniapp.js';
+export { prepareVerticalAlbumMessage } from './rich-message-utils.js';
+export { prepareAIRichCommandMenu, prepareVideoGridMessage } from './rich-message-utils.js';