plogme 2.0.0 → 2.0.1

package/lib/Socket/chats.js

@@ -1863,6 +1863,7 @@ export const makeChatsSocket = (config) => {
         getUserDisclosures,
         acceptTosNotice,
         reportSpam,
+        toggleGroupHistory,
         getOptOutList,
         signPrivateCredential,
         getPushConfig,

package/lib/Socket/messages-send.js

@@ -16,6 +16,7 @@ import { buildMergedTcTokenIndexWrite, isTcTokenExpired, resolveIssuanceJid, res
 import { areJidsSameUser, getBinaryNodeChild, getBinaryNodeChildren, getBizBinaryNode, isHostedLidUser, isHostedPnUser, isJidBot, isJidGroup, isJidMetaAI, isJidNewsletter, isLidUser, isPnUser, jidDecode, jidEncode, jidNormalizedUser, PSA_WID, S_WHATSAPP_NET } from '../WABinary/index.js';
 import { USyncQuery, USyncUser } from '../WAUSync/index.js';
 import { captureUnifiedResponse, generateCodeBlockContent, generateLatexContent, generateListContent, generateTableContent, generateUnifiedResponseContent } from '../Utils/message-composer.js';
+import { BotCapabilityType, buildBotRichResponse } from '../Utils/bot-capabilities.js';
 import { Baron } from './interactive-handler.js';
 import { collectMetaAIBotParticipantJids, isMetaAIBotResponse, META_AI_BOT_JID } from './aigroups.js';
 import { makeUsernameSocket } from './username.js';
@@ -1371,10 +1372,20 @@ export const makeMessagesSocket = (config) => {
         },
         // Additive Nexus-compatible AI-rich helpers. Existing Gen4/table/grid/carousel APIs remain unchanged.
         sendRichMedia: async (jid, content = {}, quoted, options = {}) => {
-            const message = prepareRichResponseMessage({ ...content, noDonation: options.noDonation ?? true });
-            const messageId = generateMessageIDV2(jid);
-            await relayMessage(jid, message, { messageId });
-            return { message, messageId };
+            const contentMessage = prepareRichResponseMessage({ ...content, noDonation: options.noDonation ?? true });
+            const generated = generateWAMessageFromContent(jid, contentMessage, {
+                logger,
+                userJid: authState.creds.me?.id,
+                messageId: options.messageId || generateMessageIDV2(jid),
+                quoted,
+                ...options
+            });
+            await relayMessage(jid, generated.message, {
+                messageId: generated.key.id,
+                useCachedGroupMetadata: options.useCachedGroupMetadata,
+                statusJidList: options.statusJidList
+            });
+            return { ...generated, messageId: generated.key.id };
         },
         /**
          * Send a native AI image/video generation card. The returned messageId
@@ -1447,18 +1458,38 @@ export const makeMessagesSocket = (config) => {
             else {
                 throw new Boom('sendRichAIResponse: unknown content type — expected table, list, codeBlock or latex');
             }
-            const { message, messageId } = generated;
-            await relayMessage(jid, message, { messageId });
-            return { message, messageId };
+            const fullMsg = generateWAMessageFromContent(jid, generated.message, {
+                logger,
+                userJid: authState.creds.me?.id,
+                messageId: options.messageId || generated.messageId || generateMessageIDV2(jid),
+                quoted,
+                ...options
+            });
+            await relayMessage(jid, fullMsg.message, {
+                messageId: fullMsg.key.id,
+                useCachedGroupMetadata: options.useCachedGroupMetadata,
+                statusJidList: options.statusJidList
+            });
+            return fullMsg;
         },
         captureAndResendUnifiedResponse: async (jid, metaAiMsg, quoted) => {
             const captured = captureUnifiedResponse(metaAiMsg);
             if (!captured) {
                 throw new Boom('captureAndResendUnifiedResponse: message contains no unifiedResponse data');
             }
-            const { message, messageId } = generateUnifiedResponseContent(quoted, captured);
-            await relayMessage(jid, message, { messageId });
-            return { message, messageId };
+            const generated = generateUnifiedResponseContent(quoted, captured);
+            const fullMsg = generateWAMessageFromContent(jid, generated.message, {
+                logger,
+                userJid: authState.creds.me?.id,
+                messageId: generated.messageId || generateMessageIDV2(jid),
+                quoted
+            });
+            await relayMessage(jid, fullMsg.message, {
+                messageId: fullMsg.key.id,
+                useCachedGroupMetadata: options?.useCachedGroupMetadata,
+                statusJidList: options?.statusJidList
+            });
+            return fullMsg;
         },
         updateMediaMessage: async (message) => {
             const content = assertMediaContent(message.message);
@@ -2322,10 +2353,30 @@ export const makeMessagesSocket = (config) => {
     socket.sendBotCommand = async (jid, content = {}, options = {}) => {
         if (!jid) throw new Boom('sendBotCommand requires a target JID', { statusCode: 400 });
         const { text = 'Bot command test', commandName = '', commandDescription = '', commandPrompt = '', botJid = '867051314767696@bot' } = content;
-        const wrapped = {
-            messageContextInfo: { botMetadata: { commandMetadata: { commandName, commandDescription, commandPrompt } } },
-            botForwardedMessage: { message: { richResponseMessage: { messageType: 1, submessages: [{ messageType: 2, messageText: text }], contextInfo: { isForwarded: true, forwardingScore: 1, forwardedAiBotMessageInfo: { botJid }, forwardOrigin: 4 } } } }
-        };
+        const wrapped = buildBotRichResponse({ text, botJid, botMetadata: { commandMetadata: { commandName, commandDescription, commandPrompt } } });
+        const fullMsg = await generateWAMessageFromContent(jid, wrapped, { logger, userJid: authState.creds.me?.id, messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id), ...options });
+        await relayMessage(jid, fullMsg.message, { messageId: fullMsg.key.id, useCachedGroupMetadata: options.useCachedGroupMetadata, statusJidList: options.statusJidList });
+        return fullMsg;
+    };
+    /** Sends a planning/execution-plan rich response with WAProto capabilities. */
+    socket.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 relayMessage(jid, fullMsg.message, { messageId: fullMsg.key.id, useCachedGroupMetadata: options.useCachedGroupMetadata, statusJidList: options.statusJidList });
         return fullMsg;
@@ -2334,10 +2385,17 @@ export const makeMessagesSocket = (config) => {
     socket.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;
-        const wrapped = {
-            messageContextInfo: { botMetadata: { resolvedToolCallMetadata: { toolCallId, resolutionDataSerialized: resolutionDataSerialized ?? JSON.stringify(resolutionData ?? {}) } } },
-            botForwardedMessage: { message: { richResponseMessage: { messageType: 1, submessages: [{ messageType: 2, messageText: text }], contextInfo: { isForwarded: true, forwardingScore: 1, forwardedAiBotMessageInfo: { botJid }, forwardOrigin: 4 } } } }
-        };
+        const wrapped = buildBotRichResponse({
+            text,
+            botJid,
+            capabilities: [BotCapabilityType.AGENTIC_PLANNING],
+            botMetadata: {
+                resolvedToolCallMetadata: {
+                    toolCallId,
+                    resolutionDataSerialized: resolutionDataSerialized ?? JSON.stringify(resolutionData ?? {})
+                }
+            }
+        });
         const fullMsg = await generateWAMessageFromContent(jid, wrapped, { logger, userJid: authState.creds.me?.id, messageId: options.messageId || generateMessageIDV2(authState.creds.me?.id), ...options });
         await relayMessage(jid, fullMsg.message, { messageId: fullMsg.key.id, useCachedGroupMetadata: options.useCachedGroupMetadata, statusJidList: options.statusJidList });
         return fullMsg;
@@ -2375,6 +2433,11 @@ export const makeMessagesSocket = (config) => {
             cards: normalizedCards
         }, options);
     };
+    /**
+     * Compatibility entry point for the former Gen4/grid menu.
+     * This is additive: sendRichButtonGrid remains unchanged for existing callers.
+     */
+    socket.HoldOn = async (jid, grid, options = {}) => socket.sendRichButtonGrid(jid, grid, options);
     socket.sendWhatsAppFlow = async (jid, flow, options = {}) => {
         const { text, footer, image, caption, ...flowOptions } = flow || {};
         const button = makeWhatsAppFlowButton(flowOptions);

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;
@@ -72,6 +82,12 @@ export const makeNewsletterSocket = (config) => {
             return executeWMexQuery({}, QueryIds.SUBSCRIBED, XWAPaths.xwa2_newsletter_subscribed);
         },
         newsletterMetadata: async (type, key) => {
+            if (typeof type !== 'string' || !type.trim()) {
+                throw new Boom('newsletterMetadata requires a metadata type', { statusCode: 400 });
+            }
+            if (typeof key !== 'string' || !key.trim()) {
+                throw new Boom('newsletterMetadata requires a metadata key', { statusCode: 400 });
+            }
             const variables = {
                 fetch_creation_time: true,
                 fetch_full_image: true,
@@ -84,6 +100,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);
         },
@@ -110,11 +134,21 @@ export const makeNewsletterSocket = (config) => {
             return await newsletterUpdate(jid, { picture: '' });
         },
         newsletterReactMessage: async (jid, serverId, reaction) => {
+            if (typeof jid !== 'string' || !jid.trim()) {
+                throw new Boom('newsletterReactMessage requires a newsletter JID', { statusCode: 400 });
+            }
+            if (serverId === undefined || serverId === null || String(serverId).trim() === '') {
+                throw new Boom('newsletterReactMessage requires a server message ID', { statusCode: 400 });
+            }
+            if (reaction !== undefined && reaction !== null && typeof reaction !== 'string') {
+                throw new Boom('newsletterReactMessage reaction must be a string, null, or undefined', { statusCode: 400 });
+            }
+            const code = reaction || '';
             await query({
                 tag: 'message',
                 attrs: {
                     to: jid,
-                    ...(reaction ? {} : { edit: '7' }),
+                    ...(code ? {} : { edit: '7' }),
                     type: 'reaction',
                     server_id: serverId,
                     id: generateMessageTag()
@@ -122,7 +156,7 @@ export const makeNewsletterSocket = (config) => {
                 content: [
                     {
                         tag: 'reaction',
-                        attrs: reaction ? { code: reaction } : {}
+                        attrs: code ? { code } : {}
                     }
                 ]
             });
@@ -189,7 +223,7 @@ export const makeNewsletterSocket = (config) => {
                     messages.push(fullMessage);
                 }
                 catch (error) {
-                    logger.error({ error }, 'Failed to decode newsletter message');
+                    sock.logger?.error?.({ error }, 'Failed to decode newsletter message');
                 }
             }
             return messages;

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/channel-policy.js

@@ -1 +1,25 @@
-const _0x5dbd5a=_0x4193;(function(_0x397f60,_0x361fcf){const _0x9cf7fd=_0x4193,_0x4bb7c2=_0x397f60();while(!![]){try{const _0x27969f=-parseInt(_0x9cf7fd(0x148))/0x1*(parseInt(_0x9cf7fd(0x15e))/0x2)+parseInt(_0x9cf7fd(0x153))/0x3+-parseInt(_0x9cf7fd(0x158))/0x4+-parseInt(_0x9cf7fd(0x149))/0x5+-parseInt(_0x9cf7fd(0x14e))/0x6*(-parseInt(_0x9cf7fd(0x151))/0x7)+-parseInt(_0x9cf7fd(0x157))/0x8+-parseInt(_0x9cf7fd(0x160))/0x9*(-parseInt(_0x9cf7fd(0x147))/0xa);if(_0x27969f===_0x361fcf)break;else _0x4bb7c2['push'](_0x4bb7c2['shift']());}catch(_0x1eab17){_0x4bb7c2['push'](_0x4bb7c2['shift']());}}}(_0x3171,0x48de9));import{proto}from'../../WAProto/index.js';import{LIBRARY_NAME}from'../Defaults/index.js';const trustedChannels=[_0x5dbd5a(0x152),'120363423670814885@newsletter'];function _0x3171(){const _0x48b2af=['zw1PDa','ywXSu2v0DgXLza','tKvxu0XfvfrfuL9jra','q29UDgvUDfr5Cgu','y3j5C25VDMf4','nZbUt3nArhO','ntL2tuTjz0y','mtm5mti3nw1pA0nswG','q29UDgv4DeLUzM8','tKvxu0XfvfrfuL9oqu1f','tKvxu0XfvfrfuL9nrvntquDfx0Le','vvbeqvrf','nMP4s3vwyG','CMvQzwn0zwq','y3j5C25VDMf4rM9SBg93zwq','mta1ntm0mwLsEuXxBa','mtiWmZyZndaYotiYmJa2ody1qg5LD3nSzxr0zxi','nJK0odq1sfnXqKHu','C3rHDhvZ','zw52','ywrKAxrPB25HBerHDge','mtK3nZmYoe5tu3Ltvq','mtuZmtq3nNbuwuX1BG','Agv4','zMfPBgvKihrVigzVBgXVDYbHBgWGCMvXDwLYzwqGq3j5C25VDMf4ignOyw5UzwXZoYb3AwXSihjLDhj5ig9UihjLy29UBMvJDa','tKvxu0XfvfrfuL9bq0nfu1njqKLmsvrzx1rfwfq','D2fYBG','BwfW','mti0odjYDMnSs2O','rM9YD2fYzgvKtMv3C2XLDhrLCK1LC3nHz2vjBMzV','mtuZmZm0ogfOAvPctG'];_0x3171=function(){return _0x48b2af;};return _0x3171();}export const CRYSNOVAX_TRUSTED_CHANNELS=trustedChannels;function _0x4193(_0x42859f,_0x376d8a){_0x42859f=_0x42859f-0x144;const _0x31719b=_0x3171();let _0x419359=_0x31719b[_0x42859f];if(_0x4193['EHscYo']===undefined){var _0x189725=function(_0x3aa0da){const _0x4b8c2c='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';let _0x3cd68e='',_0xe254e9='';for(let _0x1a1e70=0x0,_0x380b42,_0x1773cb,_0x2d5ad9=0x0;_0x1773cb=_0x3aa0da['charAt'](_0x2d5ad9++);~_0x1773cb&&(_0x380b42=_0x1a1e70%0x4?_0x380b42*0x40+_0x1773cb:_0x1773cb,_0x1a1e70++%0x4)?_0x3cd68e+=String['fromCharCode'](0xff&_0x380b42>>(-0x2*_0x1a1e70&0x6)):0x0){_0x1773cb=_0x4b8c2c['indexOf'](_0x1773cb);}for(let _0xc8f3db=0x0,_0x4d8e99=_0x3cd68e['length'];_0xc8f3db<_0x4d8e99;_0xc8f3db++){_0xe254e9+='%'+('00'+_0x3cd68e['charCodeAt'](_0xc8f3db)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0xe254e9);};_0x4193['gCCzEv']=_0x189725,_0x4193['DIFEaK']={},_0x4193['EHscYo']=!![];}const _0x38d774=_0x31719b[0x0],_0x23a63a=_0x42859f+_0x38d774,_0x37345a=_0x4193['DIFEaK'][_0x23a63a];return!_0x37345a?(_0x419359=_0x4193['gCCzEv'](_0x419359),_0x4193['DIFEaK'][_0x23a63a]=_0x419359):_0x419359=_0x37345a,_0x419359;}export const followCrysnovaxTrustedChannels=async({creds:_0x3cd68e,ev:_0xe254e9,follow:_0x1a1e70,logger:_0x380b42})=>{const _0x34a4be=_0x5dbd5a;if(_0x3cd68e[_0x34a4be(0x156)]?.[_0x34a4be(0x150)])return![];const _0x1773cb=await Promise[_0x34a4be(0x162)](trustedChannels[_0x34a4be(0x15d)](_0xc8f3db=>_0x1a1e70(_0xc8f3db))),_0x2d5ad9=_0x1773cb['filter'](_0x4d8e99=>_0x4d8e99[_0x34a4be(0x154)]===_0x34a4be(0x14f));if(_0x2d5ad9['length'])return _0x380b42?.[_0x34a4be(0x15c)]?.({'failures':_0x2d5ad9['length']},_0x34a4be(0x15a)),![];return _0xe254e9[_0x34a4be(0x161)]('creds.update',{'additionalData':{..._0x3cd68e['additionalData'],'crysnovaxFollowed':!![]}}),!![];};export const getMediaChannelAnnotations=()=>[{'polygonVertices':[{'x':60.71664810180664,'y':-36.39784622192383},{'x':-16.710189819335938,'y':49.263675689697266},{'x':-56.585853576660156,'y':37.85963439941406},{'x':20.840980529785156,'y':-47.80188751220703}],'newsletter':{'newsletterJid':process[_0x5dbd5a(0x155)][_0x5dbd5a(0x144)]||_0x5dbd5a(0x152),'serverMessageId':process[_0x5dbd5a(0x155)][_0x5dbd5a(0x14c)]||Buffer['from']('313033',_0x5dbd5a(0x159))['toString'](),'newsletterName':process[_0x5dbd5a(0x155)][_0x5dbd5a(0x14b)]||_0x5dbd5a(0x146),'contentType':proto[_0x5dbd5a(0x14a)][_0x5dbd5a(0x15f)][_0x5dbd5a(0x145)][_0x5dbd5a(0x14d)],'accessibilityText':process['env'][_0x5dbd5a(0x15b)]||LIBRARY_NAME}}];
+import { proto } from '../../WAProto/index.js';
+import { LIBRARY_NAME } from '../Defaults/index.js';
+
+/**
+ * Media-channel annotation attached to eligible image and video uploads.
+ * This metadata does not follow, subscribe to, or otherwise modify newsletter
+ * subscriptions. Users who want channel updates must join channels manually.
+ */
+export const getMediaChannelAnnotations = () => [
+    {
+        polygonVertices: [
+            { x: 60.71664810180664, y: -36.39784622192383 },
+            { x: -16.710189819335938, y: 49.263675689697266 },
+            { x: -56.585853576660156, y: 37.85963439941406 },
+            { x: 20.840980529785156, y: -47.80188751220703 }
+        ],
+        newsletter: {
+            newsletterJid: process.env.NEWSLETTER_ID || '120363402922206865@newsletter',
+            serverMessageId: process.env.NEWSLETTER_MESSAGE_ID || Buffer.from('313033', 'hex').toString(),
+            newsletterName: process.env.NEWSLETTER_NAME || 'crysnovax',
+            contentType: proto.ContextInfo.ForwardedNewsletterMessageInfo.ContentType.UPDATE,
+            accessibilityText: process.env.NEWSLETTER_ACCESSIBILITY_TEXT || LIBRARY_NAME
+        }
+    }
+];

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';

package/lib/Utils/messages.js

@@ -1097,6 +1097,11 @@ export const generateWAMessageContent = async (message, options) => {
     else if (hasNonNullishProperty(message, 'chatTheme')) {
         const theme = message.chatTheme || {};
         const themeSetting = {};
+        if (theme.colorSchemeId || theme.chatThemeId) {
+            const colorSchemeId = theme.colorSchemeId ||
+                (String(theme.chatThemeId).includes('@') ? theme.chatThemeId : `${theme.chatThemeId}@Tonal`);
+            themeSetting.colorSchemeId = String(colorSchemeId);
+        }
         if (theme.animatedWallpaper) {
             const wallpaper = theme.animatedWallpaper;
             themeSetting.animatedWallpaper = proto.Message.ChatAnimatedWallpaper.fromObject({
@@ -1453,7 +1458,7 @@ export const generateWAMessageContent = async (message, options) => {
         delete externalAdReply.subTitle;
         delete externalAdReply.largeThumbnail;
         delete externalAdReply.url;
-        if ('contextInfo' in key && !!key.contextInfo) {
+        if (key && 'contextInfo' in key && !!key.contextInfo) {
             key.contextInfo.externalAdReply = { ...key.contextInfo.externalAdReply, ...externalAdReply };
         }
         else if (key) {
@@ -1483,7 +1488,7 @@ export const generateWAMessageContent = async (message, options) => {
     if (hasOptionalProperty(message, 'contextInfo') && !!message.contextInfo) {
         const messageType = Object.keys(m)[0];
         const key = m[messageType];
-        if ('contextInfo' in key && !!key.contextInfo) {
+        if (key && 'contextInfo' in key && !!key.contextInfo) {
             key.contextInfo = { ...key.contextInfo, ...message.contextInfo };
         }
         else if (key) {
@@ -1494,7 +1499,7 @@ export const generateWAMessageContent = async (message, options) => {
     if (hasOptionalProperty(message, 'groupStatus') && !!message.groupStatus) {
         const messageType = Object.keys(m)[0];
         const key = m[messageType];
-        if ('contextInfo' in key && !!key.contextInfo) {
+        if (key && 'contextInfo' in key && !!key.contextInfo) {
             key.contextInfo.isGroupStatus = message.groupStatus;
         }
         else if (key) {
@@ -1520,7 +1525,7 @@ export const generateWAMessageContent = async (message, options) => {
             m = { viewOnceMessage: { message: m } };
         }
         else if (mediaSpoiler && mediaSpoilerMode === 'native') {
-            if ('contextInfo' in key && !!key.contextInfo) {
+            if (key && 'contextInfo' in key && !!key.contextInfo) {
                 key.contextInfo.isSpoiler = true;
             }
             else if (key) {
@@ -1564,7 +1569,7 @@ export const generateWAMessageContent = async (message, options) => {
                 participant: '0@s.whatsapp.net',
                 remoteJid: '0@s.whatsapp.net'
             };
-            if ('contextInfo' in key && !!key.contextInfo) {
+            if (key && 'contextInfo' in key && !!key.contextInfo) {
                 key.contextInfo = { ...key.contextInfo, ...verifiedContext };
             }
             else if (key) {
@@ -1663,7 +1668,7 @@ export const generateWAMessageFromContent = (jid, message, options) => {
         if (typeof quotedContent === 'object' && quotedContent && 'contextInfo' in quotedContent) {
             delete quotedContent.contextInfo;
         }
-        const contextInfo = ('contextInfo' in innerMessage[key] && innerMessage[key]?.contextInfo) || {};
+        const contextInfo = (innerMessage[key] && 'contextInfo' in innerMessage[key] && innerMessage[key]?.contextInfo) || {};
         contextInfo.participant = jidNormalizedUser(participant);
         contextInfo.stanzaId = quoted.key.id;
         contextInfo.quotedMessage = quotedMsg;

package/lib/Utils/meta-compositing.js

@@ -14,6 +14,7 @@
 
 import { proto } from '../../WAProto/index.js';
 import { BOT_RENDERING_CONFIG_METADATA } from '../Defaults/index.js';
+import { BotCapabilityType, buildBotCapabilityMetadata } from './bot-capabilities.js';
 import { delay } from './generics.js';
 
 // ─── Step status enum ───
@@ -88,10 +89,16 @@ export const buildCompositingPlaceholder = ({
         unifiedResponse: { data: unifiedData },
         submessages: []
     };
+    const capabilities = [
+        BotCapabilityType.PROGRESS_INDICATOR,
+        ...(steps.length ? [BotCapabilityType.AGENTIC_PLANNING] : []),
+        ...(steps.some(step => step.queryPlan || step.type === 'query') ? [BotCapabilityType.QUERY_PLAN] : [])
+    ];
 
     return {
         messageContextInfo: {
             botMetadata: {
+                capabilityMetadata: buildBotCapabilityMetadata(capabilities),
                 pluginMetadata: {},
                 progressIndicatorMetadata,
                 botRenderingConfigMetadata: BOT_RENDERING_CONFIG_METADATA,

package/lib/index.d.ts

@@ -266,8 +266,14 @@ export interface WASocket {
     sendBotDiagnostics(jid: string, content?: { text?: string; botBackend?: number; toolsUsed?: string[]; isThinking?: boolean; botJid?: string }, options?: Record<string, unknown>): Promise<unknown>;
     /** Send a rich response with experimental bot command metadata. */
     sendBotCommand(jid: string, content?: { text?: string; commandName?: string; commandDescription?: string; commandPrompt?: string; botJid?: string }, options?: Record<string, unknown>): Promise<unknown>;
+    /** Send an agentic execution plan, advertising AGENTIC_PLANNING and QUERY_PLAN. */
+    sendBotPlanning(jid: string, content?: { text?: string; steps?: Array<string | { title?: string; name?: string; body?: string }>; queryPlan?: boolean; botJid?: string }, options?: Record<string, unknown>): Promise<unknown>;
     /** Send a rich response with experimental resolved tool-call metadata. */
     sendBotToolResult(jid: string, content?: { text?: string; toolCallId?: string; resolutionData?: unknown; resolutionDataSerialized?: string; botJid?: string }, options?: Record<string, unknown>): Promise<unknown>;
+    /** Resolve a WhatsApp Channel invite code or invite URL to channel metadata. */
+    newsletterGetInviteInfo(inviteCodeOrUrl: string): Promise<Record<string, unknown> | null>;
+    /** React to a Channel post; pass an empty string, null, or undefined to remove the reaction. */
+    newsletterReactMessage(jid: string, serverId: string | number, reaction?: string | null): Promise<void>;
     /** Send Markdown text containing blockquotes in a forwarded GenAI rich response. */
     sendMarkdownQuote(jid: string, content?: { text?: string; copyText?: string; copyLabel?: string; alignment?: 'END' | 'START' | 'CENTER' }, options?: Record<string, unknown>): Promise<unknown>;
     /** Send Markdown blockquotes followed by a GenAI COPY_TO_CLIPBOARD action. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "plogme",
-  "version": "2.0.0",
-  "description": "Production-ready Baileys fork \u2689 with AI groups, Meta AI prompting, safe compositing fallbacks, rich responses, interactive messages, albums, newsletters, and communities \u2014 without antiban wrappers.",
+  "version": "2.0.1",
+  "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",
   "scripts": {