plogme 2.0.3 → 2.0.4

package/README.md

@@ -291,7 +291,7 @@ await sock.sendMessage(jid, {
 
 ### Albums
 
-Albums now use the AIRich `GRID_IMAGE` unified-response layout. Provide at least two image URLs; the client receives one forwarded rich message containing preview, full-resolution, and dark-mode image primitives. The old `albumMessage` parent/child collection is no longer generated.
+Albums now use an AIRich vertical unified-response layout. Provide at least two image or video items; the client receives one forwarded rich message with one large media item per row, matching WhatsApp's full-width stacked album presentation. The old `albumMessage` parent/child collection and compact thumbnail grid are no longer generated by `sendAlbumMessage()`.
 
 ```js
 await sock.sendAlbumMessage(jid, [
@@ -305,11 +305,20 @@ await sock.sendAlbumMessage(jid, [
       width: 1200,
       height: 800
     }
+  },
+  {
+    type: 'video',
+    data: {
+      url: 'https://example.com/three.mp4',
+      mimeType: 'video/mp4',
+      duration: 12,
+      thumbnailUrl: 'https://example.com/three.jpg'
+    }
   }
 ])
 ```
 
-The general `sendMessage` album form delegates to the same GRID_IMAGE implementation:
+The general `sendMessage` album form delegates to the same full-width vertical album implementation:
 
 ```js
 await sock.sendMessage(jid, {
@@ -320,7 +329,30 @@ await sock.sendMessage(jid, {
 })
 ```
 
-GRID_IMAGE albums support images only. Video items and local `Buffer`/file inputs are rejected because this layout carries fetchable image URLs rather than uploaded album children.
+`sendAlbumMessage()` accepts fetchable image and video URLs. Local `Buffer`/file inputs are not uploaded by this rich album API. The lower-level `prepareGridImageMessage()` helper remains available when a compact `GRID_IMAGE` layout is specifically required; `sendAlbumMessage()` itself uses the larger `GenAIVStackLayoutViewModel` presentation.
+
+### Video grids
+
+Video grids use the supported `GenAIVideoPrimitive` inside a unified-response `GenAIGridLayoutViewModel`. They are exposed separately from `sendAlbumMessage()` because WhatsApp's protobuf does not define a `GRID_VIDEO` submessage type. Provide at least two publicly fetchable video URLs:
+
+```js
+await sock.sendVideoGridMessage(jid, [
+  {
+    url: 'https://example.com/first.mp4',
+    title: 'First clip',
+    thumbnailUrl: 'https://example.com/first.jpg',
+    progressiveUrls: ['https://cdn.example.com/first-720p.mp4']
+  },
+  {
+    url: 'https://example.com/second.mp4',
+    title: 'Second clip',
+    thumbnailUrl: 'https://example.com/second.jpg',
+    progressiveUrls: ['https://cdn.example.com/second-720p.mp4']
+  }
+])
+```
+
+The video-grid API is intentionally URL-based; it does not upload local buffers or files. `sendVideoGridMessage()` also uses the rich-message edit relay, so supported clients receive the unified response without an initial Download-only placeholder.
 
 ## Interactive messages
 
@@ -524,7 +556,7 @@ const result = await sock.sendPlogmeMessage(jid, {
     { latexExpression: 'E = mc^2', url: 'https://example.com/equation.png' }
   ],
 
-  // Optional sources/links, posts, products, or suggested prompts.
+  // Optional citation links.
   links: [
     {
       text: 'Open the deployment logs',
@@ -533,6 +565,43 @@ const result = await sock.sendPlogmeMessage(jid, {
       displayName: 'Logs'
     }
   ],
+
+  // Optional AIRich product card (object = Single layout; array = HScroll).
+  products: {
+    title: 'CODY AI hosting',
+    brand: 'Plogme',
+    price: '$10',
+    sale_price: '$7',
+    url: 'https://example.com/product',
+    image: 'https://example.com/product.jpg'
+  },
+
+  // Optional social-post cards (always HScroll).
+  posts: [{
+    title: 'Release announcement',
+    username: 'codyai',
+    profile: 'https://example.com/profile.jpg',
+    thumbnail: 'https://example.com/post.jpg',
+    caption: 'Deployment completed.',
+    url: 'https://example.com/post',
+    source: 'INSTAGRAM',
+    verified: true
+  }],
+
+  // Optional source cards: [favicon URL, source URL, display text].
+  sources: [[
+    'https://example.com/favicon.jpg',
+    'https://example.com/docs',
+    'Documentation'
+  ]],
+
+  // Optional playable video card. Metadata may be supplied manually.
+  inlineVideo: {
+    url: 'https://example.com/clip.mp4',
+    mimeType: 'video/mp4',
+    duration: 12,
+    fileLength: 123456
+  },
   suggested: true,
   footerText: 'Generated by CODY AI'
 }, undefined, {
@@ -580,6 +649,53 @@ await sock.richMenu(jid, {
 })
 ```
 
+### Large A2UI command card
+
+Use `sendA2UICommandMenu` for the full-size card layout with an uploaded image header, a command/function table, URL buttons, and a native-flow command selector. This is an `interactiveMessage`/A2UI payload, not an AIRich `unifiedResponse`, so it is intentionally separate from `sendPlogmeMessage` and `richMenu`.
+
+```js
+await sock.sendA2UICommandMenu(jid, {
+  image: 'https://example.com/cover.jpg',
+  title: 'CODY AI',
+  rows: [
+    ['.meid', 'Check ID'],
+    ['.fromid', 'Check Source'],
+    ['.ping', 'Check Speed']
+  ],
+  buttons: [
+    { text: '1st-Channel', url: 'https://example.com/first' },
+    { text: '2nd-Channel', url: 'https://example.com/second' }
+  ]
+})
+```
+
+The image URL is uploaded as the interactive header media. Rows are also available through the native-flow `single_select` menu, and button URLs are represented as A2UI `openUrl` actions.
+
+### Screenshot-style raw AIRich command card
+
+Use `sendAIRichCommandMenu` when you want the manually serialized AIRich variant: an image primitive, widget CTAs, Markdown text with optional LaTeX inline metadata, a command table, and footer URL actions. Unlike A2UI, this path is an AIRich unified response and therefore uses the normal relay plus type-14 immediate-render edit.
+
+```js
+await sock.sendAIRichCommandMenu(jid, {
+  image: 'https://example.com/cover.jpg',
+  title: 'CODY AI',
+  subtitle: 'Command List',
+  code: 'CODY AI',
+  rows: [
+    ['.meid', 'Check ID'],
+    ['.fromid', 'Check Source'],
+    ['.ping', 'Check Speed']
+  ],
+  latexImage: 'https://example.com/logo.png',
+  latexExpression: 'CODY',
+  buttons: [
+    { text: '1st-Channel', url: 'https://example.com/first' },
+    { text: '2nd-Channel', url: 'https://example.com/second' }
+  ],
+  footer: 'Developed by - CODY AI'
+})
+```
+
 Cards and carousel layout are supported:
 
 ```js

package/lib/Socket/messages-send.js

@@ -5,7 +5,7 @@ import { proto } from '../../WAProto/index.js';
 import { BIZ_BOT_SUPPORT_PAYLOAD, DEFAULT_CACHE_TTLS, WA_DEFAULT_EPHEMERAL } from '../Defaults/index.js';
 import { aggregateMessageKeysNotFromMe, assertMediaContent, assertMeId, bindWaitForEvent, buildLinkPreview, decryptMediaRetryData, DEF_MEDIA_HOST, delay, encodeNewsletterMessage, encodeSignedDeviceIdentity, encodeWAMessage, encryptMediaRetryRequest, extractDeviceJids, extractImageThumb, generateMessageIDV2, generateParticipantHashV2, generateWAMessage, generateWAMessageFromContent, getStatusCodeForMediaRetry, makeWhatsAppFlowButton, getUrlFromDirectPath, getWAUploadToServer, MessageRetryManager, normalizeMessageContent, parseAndInjectE2ESessions, prepareWAMessageMedia, shouldIncludeBizBinaryNode, unixTimestampSeconds } from '../Utils/index.js';
 import { getUrlInfo } from '../Utils/link-preview.js';
-import { prepareRichMenuMessage, prepareRichResponseMessage, prepareRichGenerationMessage, prepareCopyToClipboardMessage, prepareRichTextMessage, prepareRichQuoteMessage, prepareRichImageMessage, prepareRichLinkMessage, prepareGridImageMessage, prepareHtmlMessage, prepareRichHtmlMessage, attachBotVerificationProofs, hasVerifiableProofs } from '../Utils/rich-message-utils.js';
+import { prepareRichMenuMessage, prepareA2UICommandMenu, prepareAIRichCommandMenu, prepareRichResponseMessage, prepareRichGenerationMessage, prepareCopyToClipboardMessage, prepareRichTextMessage, prepareRichQuoteMessage, prepareRichImageMessage, prepareRichLinkMessage, prepareGridImageMessage, prepareVerticalAlbumMessage, prepareVideoGridMessage, prepareHtmlMessage, prepareRichHtmlMessage, attachBotVerificationProofs, hasVerifiableProofs } 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/games/website-preview.js';
@@ -1276,18 +1276,39 @@ export const makeMessagesSocket = (config) => {
         },
         sendTable: async (jid, title, headers, rows, quoted, options = {}) => {
             const { message, messageId } = generateTableContent(title, headers, rows, quoted, options);
-            await relayMessage(jid, message, { messageId });
-            return { message, messageId };
+            const fullMsg = generateWAMessageFromContent(jid, message, {
+                logger,
+                userJid: authState.creds.me?.id,
+                messageId: options.messageId || messageId || generateMessageIDV2(jid),
+                quoted,
+                ...options
+            });
+            await relayRichMessage(jid, fullMsg, options);
+            return fullMsg;
         },
         sendList: async (jid, title, items, quoted, options = {}) => {
             const { message, messageId } = generateListContent(title, items, quoted, options);
-            await relayMessage(jid, message, { messageId });
-            return { message, messageId };
+            const fullMsg = generateWAMessageFromContent(jid, message, {
+                logger,
+                userJid: authState.creds.me?.id,
+                messageId: options.messageId || messageId || generateMessageIDV2(jid),
+                quoted,
+                ...options
+            });
+            await relayRichMessage(jid, fullMsg, options);
+            return fullMsg;
         },
         sendCodeBlock: async (jid, code, quoted, options = {}) => {
             const { message, messageId } = generateCodeBlockContent(code, quoted, options);
-            await relayMessage(jid, message, { messageId });
-            return { message, messageId };
+            const fullMsg = generateWAMessageFromContent(jid, message, {
+                logger,
+                userJid: authState.creds.me?.id,
+                messageId: options.messageId || messageId || generateMessageIDV2(jid),
+                quoted,
+                ...options
+            });
+            await relayRichMessage(jid, fullMsg, options);
+            return fullMsg;
         },
         sendCarousel: async (jid, cards, options = {}) => {
             if (!Array.isArray(cards) || cards.length === 0) {
@@ -1323,8 +1344,15 @@ export const makeMessagesSocket = (config) => {
         },
         sendLatex: async (jid, quoted, options = {}) => {
             const { message, messageId } = generateLatexContent(quoted, { expressions: [], ...options });
-            await relayMessage(jid, message, { messageId });
-            return { message, messageId };
+            const fullMsg = generateWAMessageFromContent(jid, message, {
+                logger,
+                userJid: authState.creds.me?.id,
+                messageId: options.messageId || messageId || generateMessageIDV2(jid),
+                quoted,
+                ...options
+            });
+            await relayRichMessage(jid, fullMsg, options);
+            return fullMsg;
         },
         /**
          * Send LaTeX as rendered PNG image (like Meta AI does).
@@ -1352,8 +1380,14 @@ export const makeMessagesSocket = (config) => {
                 headerText,
                 footer
             });
-            await relayMessage(jid, message, { messageId });
-            return { message, messageId };
+            const fullMsg = generateWAMessageFromContent(jid, message, {
+                logger,
+                userJid: authState.creds.me?.id,
+                messageId: options.messageId || messageId || generateMessageIDV2(jid),
+                ...options
+            });
+            await relayRichMessage(jid, fullMsg, options);
+            return fullMsg;
         },
         sendMetaAI: async (a, b, c = {}) => {
             // baron signature: (jid, text, opts) — README signature: (text, opts)
@@ -2353,6 +2387,52 @@ export const makeMessagesSocket = (config) => {
         }
         return fullMsg;
     };
+    /**
+     * Sends the A2UI interactive card/menu format used by WhatsApp's large
+     * command-card presentation. This is intentionally separate from richMenu
+     * because it is an interactiveMessage, not an AIRich unifiedResponse.
+     */
+    socket.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;
+    };
+    /** Sends the manually serialized AIRich command card shown in the screenshot. */
+    socket.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;
+    };
     /** Sends a rich response with experimental BotInfrastructureDiagnostics metadata. */
     socket.sendBotDiagnostics = async (jid, content = {}, options = {}) => {
         if (!jid) throw new Boom('sendBotDiagnostics requires a target JID', { statusCode: 400 });
@@ -2616,38 +2696,58 @@ export const makeMessagesSocket = (config) => {
 
 
     /**
-     * Sends an AIRich GRID_IMAGE album. Unlike the legacy albumMessage
-     * collection, this is one forwarded unified-response message containing
-     * the requested image primitives.
+     * Sends a full-width vertical AIRich album. Unlike the legacy
+     * albumMessage collection or compact GRID_IMAGE layout, this is one
+     * forwarded unified-response message with one large media item per row.
      */
     socket.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 imageUrls = medias.map((media) => {
+        const albumItems = medias.map((media) => {
             const raw = media?.type && media?.data ? media.data : (media?.image ?? media);
             if (media?.video || media?.type === 'video') {
-                throw new Boom('GRID_IMAGE albums support images only', { statusCode: 400 });
-            }
-            const sourceUrl = typeof raw === 'string' ? raw : (raw?.sourceUrl || raw?.url || '');
-            if (!sourceUrl) {
-                throw new Boom('Each GRID_IMAGE album item requires an image URL', { statusCode: 400 });
+                const video = media?.video || raw;
+                const sourceUrl = typeof video === 'string' ? video : (video?.url || video?.videoUrl || '');
+                if (!sourceUrl) throw new Boom('Each video album item requires a video URL', { statusCode: 400 });
+                return { type: 'video', video: { ...video, url: sourceUrl } };
             }
             return {
-                sourceUrl,
-                imagePreviewUrl: raw?.imagePreviewUrl || raw?.previewUrl || sourceUrl,
-                imageHighResUrl: raw?.imageHighResUrl || raw?.highResUrl || raw?.url || sourceUrl,
-                darkModePreviewUrl: raw?.darkModePreviewUrl,
-                darkModeHighResUrl: raw?.darkModeHighResUrl,
-                width: raw?.width || media?.width || 600,
-                height: raw?.height || media?.height || 400,
-                darkWidth: raw?.darkWidth || media?.darkWidth,
-                darkHeight: raw?.darkHeight || media?.darkHeight
+                type: 'image',
+                image: raw
             };
         });
-        const wrapped = prepareGridImageMessage({
-            imageUrls,
+        const wrapped = prepareVerticalAlbumMessage({
+            items: albumItems,
+            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;
+    };
+
+    /**
+     * 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, {

package/lib/Utils/rich-message-utils.js

@@ -472,6 +472,78 @@ export const prepareRichMenuMessage = (content = {}) => {
  * @param {'END'|'START'|'CENTER'} [options.alignment='END'] - Button alignment
  * @returns {Object} Wrapped botForwardedMessage ready for relayMessage
  */
+/** Build the manually serialized AIRich command menu shown in the screenshot. */
+export const prepareAIRichCommandMenu = ({ image, title = 'CODY AI', subtitle = '', code = '', rows = [], buttons = [], footer = 'Developed by - CODY AI', latexImage, latexExpression = '' } = {}) => {
+    if (!image) throw new Error('AIRich command menu requires an image URL');
+    if (!Array.isArray(rows)) throw new Error('AIRich command-menu rows must be an array');
+    if (!Array.isArray(buttons)) throw new Error('AIRich command-menu buttons must be an array');
+    const safeRows = rows.map((row, index) => ({ command: String(row?.[0] ?? row?.command ?? `command_${index + 1}`), description: String(row?.[1] ?? row?.description ?? '') }));
+    const table = ['Command | Function', '--- | ---', ...safeRows.map((row) => `${row.command} | ${row.description}`)].join('\n');
+    const inlineEntities = latexImage ? [{ key: 'NGA', metadata: { latex_expression: String(latexExpression), latex_image: { url: String(latexImage), width: 400, height: 400 }, font_height: 83.333, padding: 15, __typename: 'GenAILatexItem' } }] : [];
+    const text = [String(title), subtitle && String(subtitle), code && `Code: ${String(code)}`, '## Command List', table, footer && String(footer)].filter(Boolean).join('\n');
+    const imagePrimitive = { __typename: 'GenAIImagePrimitive', preview_image: { __typename: 'GenAIMediaItem', mime_type: 'image/png', url: String(image) }, full_image: { __typename: 'GenAIMediaItem', mime_type: 'image/png', url: String(image) } };
+    const ctas = buttons.map((button, index) => ({ label: String(button?.text || button?.label || `Button ${index + 1}`), state: 'PENDING', kind: 'OTHER', tool_call_id: String(button?.id || `airich_menu_${index + 1}`), toast: { label: String(button?.toast || ''), __typename: 'GenAIExtWidgetToast' }, __typename: 'GenAI3PExtWidgetCTA' }));
+    const footerPrimitives = buttons.map((button, index) => ({ cta_text: String(button?.text || button?.label || `Button ${index + 1}`), cta_type: 'OPEN_URL', cta_url: String(button?.url || ''), __typename: 'GenAIFooterActionPrimitive' }));
+    footerPrimitives.push({ cta_text: '☷ OPEN MENU', cta_type: 'OPEN_URL', cta_url: String(buttons[0]?.url || ''), __typename: 'GenAIFooterActionPrimitive' });
+    const sections = [
+        { __typename: 'GenAIUnifiedResponseSection', view_model: { __typename: 'GenAISingleLayoutViewModel', primitive: imagePrimitive } },
+        ...(ctas.length ? [{ __typename: 'GenAIUnifiedResponseSection', view_model: { primitives: [{ __typename: 'GenAI3PExtWidgetPrimitive', header: { __typename: 'GenAI3PExtWidgetStandardHeader', title: 'Command List' }, body: { __typename: 'GenAIExtCalendarEventList', ctas, sections: [] } }], __typename: 'GenAIActionRowLayoutViewModel' } }] : []),
+        { __typename: 'GenAIUnifiedResponseSection', view_model: { primitive: { text: `{{NGA}}${text}{{/NGA}}`, inline_entities: inlineEntities, __typename: 'GenAIMarkdownTextUXPrimitive' }, __typename: 'GenAISingleLayoutViewModel' } },
+        { __typename: 'GenAIUnifiedResponseSection', view_model: { primitives: footerPrimitives, __typename: 'GenAIActionRowLayoutViewModel' } }
+    ];
+    const richResponseMessage = proto.AIRichResponseMessage.create({
+        submessages: [{ messageType: RichSubMessageType.TEXT, messageText: text }],
+        messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD,
+        unifiedResponse: { data: Buffer.from(JSON.stringify({ response_id: randomUUID(), sections })) },
+        contextInfo: { isForwarded: true, forwardingScore: 1, forwardedAiBotMessageInfo: { botJid: '867051314767696@bot' }, forwardOrigin: 4 }
+    });
+    return wrapToBotForwardedMessage(richResponseMessage);
+};
+
+/** Build the A2UI interactive command menu used by the full-size card layout. */
+export const prepareA2UICommandMenu = ({ imageMessage, title = 'CODY AI', rows = [], buttons = [], fallback = '' } = {}) => {
+    if (!Array.isArray(rows)) throw new Error('A2UI command-menu rows must be an array');
+    if (!Array.isArray(buttons)) throw new Error('A2UI command-menu buttons must be an array');
+    const safeRows = rows.map((row, index) => ({
+        title: String(row?.[0] ?? row?.title ?? `Command ${index + 1}`),
+        description: String(row?.[1] ?? row?.description ?? ''),
+        id: String(row?.[2] ?? row?.id ?? row?.[0] ?? `command_${index + 1}`)
+    }));
+    const safeButtons = buttons.map((button, index) => ({ id: `a2ui_button_${index + 1}`, label: String(button?.text || button?.label || `Button ${index + 1}`), url: String(button?.url || '') }));
+    const componentIds = ['title', 'divider', 'tableCard', 'footer', ...(safeButtons.length ? ['buttonRow'] : [])];
+    const components = [
+        { id: 'root', component: 'Column', align: 'center', children: componentIds },
+        { id: 'title', component: 'Text', text: String(title), variant: 'h2' },
+        { id: 'divider', component: 'Divider' },
+        { id: 'tableCard', component: 'Card', child: 'tableColumn' },
+        { id: 'tableColumn', component: 'Column', children: ['headerRow', ...safeRows.flatMap((_, index) => [`divider_${index}`, `row_${index}`])] },
+        { id: 'headerRow', component: 'Row', children: ['headerCommand', 'headerFunction'] },
+        { id: 'headerCommand', component: 'Text', text: 'Command', variant: 'h5' },
+        { id: 'headerFunction', component: 'Text', text: 'Function', variant: 'h5' },
+        ...safeRows.flatMap((row, index) => [
+            { id: `divider_${index}`, component: 'Divider' },
+            { id: `row_${index}`, component: 'Row', children: [`command_${index}`, `description_${index}`] },
+            { id: `command_${index}`, component: 'Text', text: row.title },
+            { id: `description_${index}`, component: 'Text', text: row.description }
+        ]),
+        { id: 'footer', component: 'Text', text: 'Developed by - CODY AI', variant: 'caption' }
+    ];
+    if (safeButtons.length) {
+        components.push({ id: 'buttonRow', component: 'Row', justify: 'spaceEvenly', children: safeButtons.flatMap((button, index) => [`buttonLabel_${index}`, `button_${index}`]) });
+        safeButtons.forEach((button, index) => {
+            components.push({ id: `buttonLabel_${index}`, component: 'Text', text: button.label });
+            components.push({ id: `button_${index}`, component: 'Button', child: `buttonLabel_${index}`, variant: 'primary', action: { call: 'openUrl', args: { url: button.url } } });
+        });
+    }
+    return {
+        interactiveMessage: {
+            ...(imageMessage ? { header: { imageMessage, hasMediaAttachment: true } } : {}),
+            bloksWidget: { type: 'im_a2ui', data: JSON.stringify({ version: 'v0.9', createSurface: { surfaceId: 'plogme-a2ui-command-menu', catalogId: 'https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json', components } }), fallback: String(fallback || title) },
+            nativeFlowMessage: { messageParamsJson: JSON.stringify({ limited_time_offer: { text: String(title), url: safeButtons[0]?.url || '', copy_code: String(title), expiration_time: Date.now() * 1000 } }), buttons: [{ name: 'single_select', buttonParamsJson: JSON.stringify({ title: String(title), sections: [{ title: 'Available Commands', rows: safeRows }] }) }] }
+        }
+    };
+};
+
 export const prepareCopyToClipboardMessage = (options = {}) => {
     const { text = '', label, alignment = 'END', verificationMetadata } = options;
     const displayText = label || text;
@@ -697,9 +769,114 @@ export const prepareGridImageMessage = ({ imageUrls = [], verificationMetadata }
     return wrapToBotForwardedMessage(richResponseMessage, verificationMetadata);
 };
 
+/**
+ * Build a video grid using the client-supported GenAIVideoPrimitive.
+ *
+ * WhatsApp exposes no AIRich GRID_VIDEO submessage type. Video grids therefore
+ * use the generic unified-response Grid layout with one GenAIVideoPrimitive per
+ * item. This is deliberately separate from prepareGridImageMessage so callers
+ * do not accidentally label video media as GenAIImagePrimitive.
+ */
+/** Build a full-width vertical album with one large media item per row. */
+export const prepareVerticalAlbumMessage = ({ items = [], verificationMetadata } = {}) => {
+    if (!Array.isArray(items) || items.length < 2) throw new Error('Vertical album requires at least two media items');
+    const expiration = String(Date.now() + 30 * 24 * 60 * 60 * 1000);
+    const primitives = items.map((item) => {
+        const kind = item?.type || (item?.video ? 'video' : 'image');
+        if (kind === 'video') {
+            const video = item.video || item.data || item;
+            const url = typeof video === 'string' ? video : (video?.url || video?.videoUrl || '');
+            if (!url) throw new Error('Each video album item requires a video URL');
+            return buildImaginePrimitive({ mediaType: 'video', url, thumbnail: video?.thumbnail || video?.thumbnailUrl, mimeType: video?.mimeType || video?.mime_type || 'video/mp4', fileLength: video?.fileLength || video?.file_length || 0, duration: video?.duration || 0, status: 'READY' });
+        }
+        const image = item?.image || item?.data || item;
+        const sourceUrl = typeof image === 'string' ? image : (image?.sourceUrl || image?.url || '');
+        if (!sourceUrl) throw new Error('Each image album item requires an image URL');
+        const previewUrl = image?.imagePreviewUrl || image?.previewUrl || sourceUrl;
+        const fullUrl = image?.imageHighResUrl || image?.highResUrl || image?.url || sourceUrl;
+        const width = image?.width || item?.width || 600;
+        const height = image?.height || item?.height || 400;
+        const mimeType = image?.mimeType || image?.mime_type || 'image/png';
+        return {
+            preview_image: { url: previewUrl, mime_type: mimeType, expiration_timestamp_ms: expiration, width, height },
+            full_image: { url: fullUrl, mime_type: mimeType, expiration_timestamp_ms: expiration, width, height },
+            dark_mode_preview_image: { url: image?.darkModePreviewUrl || previewUrl, mime_type: mimeType, expiration_timestamp_ms: expiration, width, height },
+            dark_mode_full_image: { url: image?.darkModeHighResUrl || image?.darkModePreviewUrl || fullUrl, mime_type: mimeType, expiration_timestamp_ms: expiration, width, height },
+            asset_query_status: 'FETCHED',
+            __typename: 'GenAIImagePrimitive'
+        };
+    });
+    const richResponseMessage = proto.AIRichResponseMessage.create({
+        submessages: [],
+        messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD,
+        unifiedResponse: { data: Buffer.from(JSON.stringify({ response_id: randomUUID(), sections: [{ view_model: { primitives, __typename: 'GenAIVStackLayoutViewModel' } }] })) },
+        contextInfo: { isForwarded: true, forwardingScore: 1, forwardedAiBotMessageInfo: { botJid: '867051314767696@bot' }, forwardOrigin: 4 }
+    });
+    return wrapToBotForwardedMessage(richResponseMessage, verificationMetadata);
+};
+
+export const prepareVideoGridMessage = ({ videos = [], verificationMetadata } = {}) => {
+    if (!Array.isArray(videos) || videos.length < 2) {
+        throw new Error('Video grid requires at least two videos');
+    }
+    const primitives = videos.map((video) => {
+        const url = typeof video === 'string' ? video : (video?.url || video?.videoUrl || video?.reelsUrl || '');
+        if (!url) throw new Error('Each video-grid item requires a video URL');
+        const item = typeof video === 'string' ? {} : video;
+        return {
+            post_id: item.postId == null ? undefined : String(item.postId),
+            reels_url: url,
+            reels_title: item.title,
+            thumbnail_url: item.thumbnailUrl || item.thumbnail,
+            creator: item.creator,
+            avatar_url: item.avatarUrl,
+            content_hash: item.contentHash,
+            likes_count: item.likes,
+            comments_count: item.comments,
+            shares_count: item.shares,
+            is_verified: item.isVerified,
+            source_app: item.sourceApp,
+            video_delivery_response: {
+                progressive_urls: (item.progressiveUrls || []).map((value) => ({
+                    progressive_url: value,
+                    __typename: 'GenAIProgressiveUrlResponse'
+                })),
+                dash_manifests: (item.dashManifests || []).map((value) => ({
+                    manifest_xml: value,
+                    __typename: 'GenAIDashManifestResponse'
+                })),
+                __typename: 'GenAIVideoDeliveryResponse'
+            },
+            __typename: 'GenAIVideoPrimitive'
+        };
+    });
+    const unified = {
+        response_id: randomUUID(),
+        sections: [{
+            view_model: {
+                primitives,
+                __typename: 'GenAIGridLayoutViewModel'
+            }
+        }]
+    };
+    const richResponseMessage = proto.AIRichResponseMessage.create({
+        submessages: [],
+        messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD,
+        unifiedResponse: { data: Buffer.from(JSON.stringify(unified)) },
+        contextInfo: {
+            isForwarded: true,
+            forwardingScore: 1,
+            forwardedAiBotMessageInfo: { botJid: '867051314767696@bot' },
+            forwardOrigin: 4
+        }
+    });
+    return wrapToBotForwardedMessage(richResponseMessage, verificationMetadata);
+};
+
 export const prepareRichResponseMessage = (content) => {
     const { alignment, code, contentText, disclaimerText, footerText, headerText, imageText, inlineImage, inlineVideo, items, language, latex, links, noDonation, noHeading, posts, products, reels, sources: sourceInputs, suggested, richResponse, table, tapLinkUrl, title, verificationMetadata } = content;
     let submessages = [];
+    const extraSections = [];
     if (Array.isArray(richResponse)) {
         submessages = richResponse.map((submessage) => {
             if (submessage.text) {
@@ -843,9 +1020,21 @@ export const prepareRichResponseMessage = (content) => {
             });
         }
         if (inlineVideo) {
-            submessages.push({
-                messageType: RichSubMessageType.TEXT,
-                messageText: 'INLINE_VIDEO'
+            const video = typeof inlineVideo === 'string' ? { url: inlineVideo } : inlineVideo;
+            submessages.push({ messageType: RichSubMessageType.TEXT, messageText: '[ CANNOT_LOAD_VIDEO - NIXEL ]' });
+            extraSections.push({
+                view_model: {
+                    primitive: buildImaginePrimitive({
+                        mediaType: 'video',
+                        url: video?.url || video?.videoUrl || '',
+                        mimeType: video?.mimeType || video?.mime_type || 'video/mp4',
+                        fileLength: video?.fileLength || video?.file_length || 0,
+                        duration: video?.duration || 0,
+                        thumbnail: video?.thumbnail,
+                        status: video?.status || 'READY'
+                    }),
+                    __typename: 'GenAISingleLayoutViewModel'
+                }
             });
         }
         if (latex) {
@@ -863,7 +1052,40 @@ export const prepareRichResponseMessage = (content) => {
             title: 'PAIR CRYSN⚉VA AI ⩇⩇:⩇⩇',
             displayName: 'pair bot'
         };
-        const sourceLinks = (sourceInputs || links || []).map((linkField) => {
+        const rawSources = Array.isArray(sourceInputs) ? sourceInputs : [];
+        // Existing `sources: [{ url, displayName, subtitle }]` callers use
+        // citation entities. The serialized AIRich addSource format is the
+        // distinct tuple form: `[[faviconUrl, sourceUrl, displayText], ...]`.
+        const sourceTuples = rawSources.length > 0 && rawSources.every((source) => Array.isArray(source));
+        if (sourceTuples) {
+            const sourceCards = rawSources.map((source) => {
+                const item = Array.isArray(source)
+                    ? { icon: source[0], url: source[1], text: source[2] }
+                    : source;
+                const sourceUrl = item.url || item.sourceUrl || item.source_url || '';
+                return {
+                    source_type: 'THIRD_PARTY',
+                    source_display_name: item.text || item.displayName || item.sourceDisplayName || '',
+                    source_subtitle: item.subtitle || 'AI',
+                    source_url: sourceUrl,
+                    favicon: {
+                        url: item.icon || item.iconUrl || item.favicon || '',
+                        mime_type: item.mimeType || 'image/jpeg',
+                        width: item.width || 16,
+                        height: item.height || 16
+                    }
+                };
+            }).filter((source) => source.source_url || source.source_display_name);
+            if (sourceCards.length) {
+                extraSections.push({
+                    view_model: {
+                        primitive: { sources: sourceCards, __typename: 'GenAISearchResultPrimitive' },
+                        __typename: 'GenAISingleLayoutViewModel'
+                    }
+                });
+            }
+        }
+        const sourceLinks = (sourceTuples ? [] : (sourceInputs || links || [])).map((linkField) => {
             if (typeof linkField === 'string') return { text: '', url: linkField, displayName: linkField };
             return { text: linkField?.text || linkField?.displayName || linkField?.title || '', ...linkField };
         });
@@ -898,14 +1120,53 @@ export const prepareRichResponseMessage = (content) => {
         if (posts) {
             submessages.push({
                 messageType: RichSubMessageType.TEXT,
-                messageText: 'POSTS'
+                messageText: '[ CANNOT_LOAD_POST - NIXEL ]'
             });
+            const postItems = (Array.isArray(posts) ? posts : [posts]).map((post) => ({
+                title: post?.title || '',
+                subtitle: post?.subtitle || '',
+                username: post?.username || post?.user || '',
+                profile_picture_url: post?.profile_picture_url || post?.profile || post?.profile_url || '',
+                is_verified: !!(post?.is_verified ?? post?.verified),
+                thumbnail_url: post?.thumbnail_url || post?.thumbnail || '',
+                post_caption: post?.post_caption || post?.caption || '',
+                likes_count: post?.likes_count ?? post?.like ?? 0,
+                comments_count: post?.comments_count ?? post?.comment ?? 0,
+                shares_count: post?.shares_count ?? post?.share ?? 0,
+                post_url: post?.post_url || post?.url || '',
+                post_deeplink: post?.post_deeplink || post?.deeplink || '',
+                source_app: post?.source_app || post?.source || '',
+                footer_label: post?.footer_label || post?.footer || '',
+                footer_icon: post?.footer_icon || post?.icon || '',
+                is_carousel: post?.is_carousel ?? true,
+                orientation: post?.orientation || 'LANDSCAPE',
+                post_type: post?.post_type || 'VIDEO',
+                __typename: 'GenAIPostPrimitive'
+            }));
+            if (postItems.length) extraSections.push({ view_model: { primitives: postItems, __typename: 'GenAIHScrollLayoutViewModel' } });
         }
         if (products) {
             submessages.push({
                 messageType: RichSubMessageType.TEXT,
-                messageText: 'PRODUCTS'
+                messageText: '[ CANNOT_LOAD_PRODUCT - NIXEL ]'
             });
+            const productItems = (Array.isArray(products) ? products : [products]).map((product) => ({
+                title: product?.title || '',
+                brand: product?.brand || '',
+                price: product?.price || '',
+                sale_price: product?.sale_price || product?.salePrice || '',
+                product_url: product?.product_url || product?.url || '',
+                image: { url: product?.image?.url || product?.image || '' },
+                additional_images: [{ url: product?.icon_url || product?.icon || '' }],
+                __typename: 'GenAIProductItemCardPrimitive'
+            }));
+            if (productItems.length) {
+                extraSections.push({
+                    view_model: Array.isArray(products)
+                        ? { primitives: productItems, __typename: 'GenAIHScrollLayoutViewModel' }
+                        : { primitive: productItems[0], __typename: 'GenAISingleLayoutViewModel' }
+                });
+            }
         }
         if (suggested) {
             submessages.push({
@@ -934,6 +1195,7 @@ export const prepareRichResponseMessage = (content) => {
     }
     const uuid = randomUUID();
     const unified = toUnified(submessages, uuid);
+    unified.sections = [...unified.sections.filter(Boolean), ...extraSections];
     const richResponseMessage = proto.AIRichResponseMessage.create({
         submessages,
         messageType: proto.AIRichResponseMessageType.AI_RICH_RESPONSE_TYPE_STANDARD,

package/lib/index.d.ts

@@ -224,7 +224,8 @@ export interface RelayMessageOptions {
 
 export interface AlbumMediaInput {
     image?: unknown;
-    type?: 'image';
+    video?: unknown;
+    type?: 'image' | 'video';
     data?: unknown;
     sourceUrl?: string;
     imagePreviewUrl?: string;
@@ -246,10 +247,50 @@ export interface AnimatedWallpaperInput {
     opacity?: number;
 }
 
+export interface A2UICommandMenuContent {
+    image?: unknown;
+    title?: string;
+    rows?: Array<[string, string, string?] | { title?: string; description?: string; id?: string }>;
+    buttons?: Array<{ text?: string; label?: string; url?: string }>;
+    fallback?: string;
+}
+
+export interface AIRichCommandMenuContent {
+    image: string;
+    title?: string;
+    subtitle?: string;
+    code?: string;
+    rows?: Array<[string, string] | { command?: string; description?: string }>;
+    latexImage?: string;
+    latexExpression?: string;
+    buttons?: Array<{ id?: string; text?: string; label?: string; url?: string; toast?: string }>;
+    footer?: string;
+}
+
 export interface WASocket {
     sendMessage(jid: string | string[], content: StatusContent | GroupStatusContent | Record<string, unknown>, options?: Partial<StatusOptions> & Record<string, unknown>): Promise<unknown>;
-    /** Send at least two image URL items as an AIRich GRID_IMAGE album. */
+    /** Send at least two image/video URL items as a full-width AIRich vertical album. */
     sendAlbumMessage(jid: string, medias: AlbumMediaInput[], options?: Record<string, unknown>): Promise<unknown>;
+    /** Send an AIRich unified-response grid of GenAIVideoPrimitive items. Requires at least two video URLs. */
+    sendVideoGridMessage(jid: string, videos: Array<string | {
+        url?: string;
+        videoUrl?: string;
+        reelsUrl?: string;
+        postId?: string | number;
+        title?: string;
+        thumbnailUrl?: string;
+        thumbnail?: string;
+        creator?: string;
+        avatarUrl?: string;
+        contentHash?: string;
+        likes?: number;
+        comments?: number;
+        shares?: number;
+        isVerified?: boolean;
+        sourceApp?: string;
+        progressiveUrls?: string[];
+        dashManifests?: string[];
+    }>, options?: Record<string, unknown>): Promise<unknown>;
     /** Update the connected account's WhatsApp About/profile status. */
     updateProfileStatus(status: string): Promise<void>;
     /** Update the connected account's profile name. */
@@ -260,6 +301,10 @@ export interface WASocket {
     relayMessage(jid: string, message: Record<string, unknown>, options?: RelayMessageOptions): Promise<unknown>;
     /** Send an experimental Meta AI-style rich menu with image, card buttons, and an optional URL footer. */
     richMenu(jid: string, content?: RichMenuContent, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send the large A2UI card/menu with an image header, command table, URL buttons, and native-flow selector. */
+    sendA2UICommandMenu(jid: string, content?: A2UICommandMenuContent, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send the manually serialized AIRich command card with image, Markdown, widget CTAs, and footer actions. */
+    sendAIRichCommandMenu(jid: string, content: AIRichCommandMenuContent, options?: Record<string, unknown>): Promise<unknown>;
     /** Send raw HTML through the experimental WhatsApp HTML primitive. */
     sendHtmlMessage(jid: string, content: { html: string; trustedSources?: string[] }, options?: Record<string, unknown>): Promise<unknown>;
     /** Post a personal status using explicit viewers or a configured contact source/provider. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plogme",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "Production-ready Baileys fork ⚉ with AI groups, Meta AI prompting, safe compositing fallbacks, rich responses, interactive messages, albums, newsletters, and communities — without antiban wrappers.",
   "main": "lib/index.js",
   "type": "module",