whatsapp-pi 1.0.52 → 1.0.54

package/README.md

@@ -19,6 +19,7 @@ Pi is a powerful agentic AI coding assistant that operates in your terminal. Thi
   - Manage aliases and print allowed contacts from the menu
 - **Allowed Groups**: Control which WhatsApp groups can interact with Pi
   - Add group JIDs with optional aliases
+  - Choose reaction mode per group: **Active** (reply to all allowed group messages) or **Passive** (reply only when mentioned with @)
   - Only groups in Allowed Groups are processed by the agent
 - **Recents & History**: Browse recent conversations, inspect full message history, and reply from message detail view
 - **Reliable Messaging**: Queue-based message sending with retry logic
@@ -124,7 +125,8 @@ pi -e whatsapp-pi.ts --whatsapp-pi-online
 
 ### Allowed Groups Management
 - **Add Group** - Add a WhatsApp group JID to the allowed groups list (format: 120363012345@g.us)
-- **Select a group** - Open a submenu with **History**, **Send Message**, **Print Group JID**, alias actions, **Remove Group**, and **Back**
+- **Select a group** - Open a submenu with **History**, **Send Message**, **Print Group JID**, **Reaction Mode**, alias actions, **Remove Group**, and **Back**
+- **Reaction Mode** - Switch between **Active** and **Passive** behavior for that group
 - **Back** - Return to main menu
 
 ### Recents Management
@@ -160,6 +162,7 @@ npm test
 
 - **Auto-Connect Support**: Use the `--whatsapp-pi-online` flag to connect on startup when credentials already exist.
 - **Group-Only Mode**: Use `--whatsapp-group <jid>` to bind Pi to a single WhatsApp group. The group must also be present in Allowed Groups.
+- **Allowed Group Reaction Mode**: Each allowed group can be set to Active or Passive. Passive mode only replies when the bot is directly mentioned with @.
 - **Recents Store**: Recent conversations and message history are persisted in `~/.pi/whatsapp-pi/recents/recents.json`.
 - **Message Detail / Reply**: Open a message from history to inspect full content and reply with `R`.
 - **Media Support**: Images are forwarded for vision analysis, audio is transcribed with Whisper, and PDFs are saved under `./.pi-data/whatsapp/documents/` with local text preview when available.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "whatsapp-pi",
-  "version": "1.0.52",
+  "version": "1.0.54",
   "type": "module",
   "description": "WhatsApp integration extension for Pi",
   "main": "whatsapp-pi.ts",

package/src/i18n.ts

@@ -102,6 +102,11 @@ const fallback = {
     "menu.allowedGroups.group.history": "History",
     "menu.allowedGroups.group.sendMessage": "Send Message",
     "menu.allowedGroups.group.printGroup": "Print Group JID",
+    "menu.allowedGroups.group.reactionMode": "Reaction Mode",
+    "menu.allowedGroups.group.reactionMode.title": "Reaction Mode • {displayName}",
+    "menu.allowedGroups.group.reactionMode.active": "Active",
+    "menu.allowedGroups.group.reactionMode.passive": "Passive",
+    "menu.allowedGroups.group.reactionMode.updated": "Reaction mode set to {mode} for {displayName}",
     "menu.allowedGroups.group.removeAlias": "Remove Alias",
     "menu.allowedGroups.group.addAlias": "Add Alias",
     "menu.allowedGroups.group.removeGroup": "Remove Group",
@@ -306,6 +311,11 @@ const translations: Record<Locale, Partial<Record<Key, string>>> = {
         "menu.allowedGroups.group.history": "Histórico",
         "menu.allowedGroups.group.sendMessage": "Enviar mensagem",
         "menu.allowedGroups.group.printGroup": "Mostrar JID do grupo",
+        "menu.allowedGroups.group.reactionMode": "Modo de reação",
+        "menu.allowedGroups.group.reactionMode.title": "Modo de reação • {displayName}",
+        "menu.allowedGroups.group.reactionMode.active": "Ativo",
+        "menu.allowedGroups.group.reactionMode.passive": "Passivo",
+        "menu.allowedGroups.group.reactionMode.updated": "Modo de reação definido como {mode} para {displayName}",
         "menu.allowedGroups.group.removeAlias": "Remover apelido",
         "menu.allowedGroups.group.addAlias": "Adicionar apelido",
         "menu.allowedGroups.group.removeGroup": "Remover grupo",

package/src/models/whatsapp.types.ts

@@ -10,6 +10,8 @@ export interface AllowList {
     numbers: string[];
 }
 
+export type ReactionMode = 'active' | 'passive';
+
 export interface IncomingMessage {
     id: string;
     remoteJid: string;

package/src/services/session.manager.ts

@@ -2,12 +2,13 @@ import { useMultiFileAuthState } from 'baileys';
 import { join } from 'path';
 import { readFile, writeFile, mkdir, rm, rename } from 'fs/promises';
 import { homedir } from 'os';
-import { SessionStatus } from '../models/whatsapp.types.js';
+import { SessionStatus, type ReactionMode } from '../models/whatsapp.types.js';
 import { t } from '../i18n.js';
 
 export interface Contact {
     number: string;
     name?: string;
+    reactionMode?: ReactionMode;
 }
 
 export class SessionManager {
@@ -72,7 +73,10 @@ export class SessionManager {
                         num = num.number;
                     }
                     if (typeof num === 'string') {
-                        return { number: num, name: item.name };
+                        const reactionMode = item.reactionMode === 'active' || item.reactionMode === 'passive'
+                            ? item.reactionMode
+                            : undefined;
+                        return { number: num, name: item.name, reactionMode };
                     }
                 }
                 return null;
@@ -81,6 +85,8 @@ export class SessionManager {
             const loadedAllowList = (config.allowList || []).map(cleanContact).filter(Boolean) as Contact[];
             const loadedAllowedGroups = (config.allowedGroups || []).map(cleanContact).filter(Boolean) as Contact[];
             const migratedGroups = loadedAllowList.filter(c => SessionManager.isGroupJid(c.number));
+            const needsReactionModeBackfill = loadedAllowedGroups.some(group => !group.reactionMode)
+                || migratedGroups.some(group => !group.reactionMode);
             this.allowList = loadedAllowList.filter(c => !SessionManager.isGroupJid(c.number));
             this.allowedGroups = this.mergeContacts(loadedAllowedGroups, migratedGroups);
             this.ignoredNumbers = (config.ignoredNumbers || []).map(cleanContact).filter(Boolean) as Contact[];
@@ -89,7 +95,7 @@ export class SessionManager {
             this.openaiKey = config.openaiKey || '';
             this.visionModel = config.visionModel || 'gpt-4o';
 
-            if (recovered) {
+            if (recovered || needsReactionModeBackfill) {
                 await this.saveConfig();
             }
         } catch {
@@ -240,7 +246,7 @@ export class SessionManager {
 
         const existing = this.allowedGroups.find(c => c.number === groupJid);
         if (!existing) {
-            this.allowedGroups.push({ number: groupJid, name });
+            this.allowedGroups.push({ number: groupJid, name, reactionMode: 'active' });
             this.ignoredNumbers = this.ignoredNumbers.filter(c => c.number !== groupJid);
             await this.saveConfig();
             return;
@@ -250,6 +256,11 @@ export class SessionManager {
             existing.name = name;
             await this.saveConfig();
         }
+
+        if (!existing.reactionMode) {
+            existing.reactionMode = 'active';
+            await this.saveConfig();
+        }
     }
 
     async removeAllowedGroup(groupJid: string) {
@@ -297,6 +308,20 @@ export class SessionManager {
         await this.saveConfig();
     }
 
+    getAllowedGroupReactionMode(groupJid: string): ReactionMode {
+        return this.getAllowedGroup(groupJid)?.reactionMode || 'active';
+    }
+
+    async setAllowedGroupReactionMode(groupJid: string, reactionMode: ReactionMode) {
+        const group = this.getAllowedGroup(groupJid);
+        if (!group) {
+            return;
+        }
+
+        group.reactionMode = reactionMode;
+        await this.saveConfig();
+    }
+
     async removeAllowedGroupAlias(groupJid: string) {
         const group = this.getAllowedGroup(groupJid);
         if (!group || !group.name) {
@@ -336,11 +361,19 @@ export class SessionManager {
             const existing = merged.find(c => c.number === contact.number);
             if (!existing) {
                 merged.push(contact);
-            } else if (!existing.name && contact.name) {
-                existing.name = contact.name;
+            } else {
+                if (!existing.name && contact.name) {
+                    existing.name = contact.name;
+                }
+                if (!existing.reactionMode && contact.reactionMode) {
+                    existing.reactionMode = contact.reactionMode;
+                }
             }
         }
-        return merged;
+        return merged.map(contact => ({
+            ...contact,
+            reactionMode: contact.reactionMode || 'active'
+        }));
     }
 
     public async isRegistered(): Promise<boolean> {

package/src/services/whatsapp.service.ts

@@ -42,9 +42,16 @@ interface IncomingMessageKey {
     participant?: string;
 }
 
+interface IncomingMessageContextInfo {
+    mentionedJid?: string[];
+}
+
 interface IncomingMessageContent {
     conversation?: string;
-    extendedTextMessage?: { text?: string };
+    extendedTextMessage?: {
+        text?: string;
+        contextInfo?: IncomingMessageContextInfo;
+    };
 }
 
 interface IncomingMessageLike {
@@ -59,6 +66,7 @@ interface MessagesUpsertEvent {
 }
 
 interface WhatsAppSocketLike {
+    user?: { id?: string; lid?: string };
     ev: {
         on(event: 'connection.update', handler: (update: ConnectionUpdateEvent) => void | Promise<void>): void;
         on(event: 'creds.update', handler: () => void | Promise<void>): void;
@@ -170,6 +178,48 @@ export class WhatsAppService {
         return `${digits}@s.whatsapp.net`;
     }
 
+    private normalizeJidForComparison(jid: string): string {
+        const [localPart, domain = ''] = jid.split('@');
+        const normalizedLocal = localPart.split(':')[0];
+        return domain ? `${normalizedLocal}@${domain}` : normalizedLocal;
+    }
+
+    private normalizeJidIdentity(jid: string): string {
+        return this.normalizeJidForComparison(jid).split('@')[0];
+    }
+
+    private getAgentJidCandidates(): string[] {
+        const user = this.socket?.user;
+        const rawJids = [user?.id, user?.lid].filter((jid): jid is string => Boolean(jid));
+        const candidates = new Set<string>();
+
+        for (const jid of rawJids) {
+            const normalized = this.normalizeJidForComparison(jid);
+            candidates.add(normalized);
+            candidates.add(this.normalizeJidIdentity(jid));
+        }
+
+        return [...candidates];
+    }
+
+    private messageHasDirectMention(message: IncomingMessageLike): boolean {
+        const mentionedJids = message.message?.extendedTextMessage?.contextInfo?.mentionedJid || [];
+        if (mentionedJids.length === 0) {
+            return false;
+        }
+
+        const agentCandidates = this.getAgentJidCandidates();
+        if (agentCandidates.length === 0) {
+            return false;
+        }
+
+        return mentionedJids.some(jid => {
+            const normalizedMention = this.normalizeJidForComparison(jid);
+            const mentionIdentity = this.normalizeJidIdentity(jid);
+            return agentCandidates.includes(normalizedMention) || agentCandidates.includes(mentionIdentity);
+        });
+    }
+
     private getDisconnectStatusCode(error: unknown): number | undefined {
         if (!error || typeof error !== 'object') {
             return undefined;
@@ -496,6 +546,10 @@ export class WhatsAppService {
         void this.recordIncomingMessage(message, remoteJid, text);
 
         const pushName = message.pushName || undefined;
+        const groupAllowed = isGroup && this.sessionManager.isAllowedGroup(remoteJid);
+        const passiveGroupBlocked = groupAllowed
+            && this.sessionManager.getAllowedGroupReactionMode(remoteJid) === 'passive'
+            && !this.messageHasDirectMention(message);
 
         if (this.boundGroupJid) {
             if (!this.sessionManager.isAllowedGroup(this.boundGroupJid)) {
@@ -503,6 +557,10 @@ export class WhatsAppService {
                 return;
             }
 
+            if (this.sessionManager.getAllowedGroupReactionMode(this.boundGroupJid) === 'passive' && !this.messageHasDirectMention(message)) {
+                return;
+            }
+
             this.lastRemoteJid = remoteJid;
             this.onMessage?.(payload);
             return;
@@ -516,6 +574,10 @@ export class WhatsAppService {
             return;
         }
 
+        if (passiveGroupBlocked) {
+            return;
+        }
+
         this.lastRemoteJid = remoteJid;
         this.onMessage?.(payload);
     }

package/src/ui/menu.handler.ts

@@ -255,11 +255,12 @@ export class MenuHandler {
         const historyLabel = t('menu.allowedGroups.group.history');
         const sendMessageLabel = t('menu.allowedGroups.group.sendMessage');
         const printGroupLabel = t('menu.allowedGroups.group.printGroup');
+        const reactionModeLabel = t('menu.allowedGroups.group.reactionMode');
         const removeAliasLabel = t('menu.allowedGroups.group.removeAlias');
         const addAliasLabel = t('menu.allowedGroups.group.addAlias');
         const removeGroupLabel = t('menu.allowedGroups.group.removeGroup');
         const backLabel = t('menu.allowedGroups.group.back');
-        const options = [historyLabel, sendMessageLabel, printGroupLabel];
+        const options = [historyLabel, sendMessageLabel, printGroupLabel, reactionModeLabel];
         if (group.name) {
             options.push(removeAliasLabel);
         } else {
@@ -287,6 +288,12 @@ export class MenuHandler {
             return;
         }
 
+        if (choice === reactionModeLabel) {
+            await this.manageAllowedGroupReactionMode(ctx, group);
+            await this.manageAllowedGroup(ctx, group);
+            return;
+        }
+
         if (choice === addAliasLabel) {
             const alias = await ctx.ui.input(t('menu.allowedGroups.enterAlias', { groupJid: group.number }));
             const trimmedAlias = alias?.trim() || '';
@@ -469,6 +476,30 @@ export class MenuHandler {
         });
     }
 
+    private async manageAllowedGroupReactionMode(ctx: ExtensionCommandContext, group: Contact) {
+        const displayName = this.formatAllowedGroupOption(group);
+        const title = t('menu.allowedGroups.group.reactionMode.title', { displayName });
+        const activeLabel = t('menu.allowedGroups.group.reactionMode.active');
+        const passiveLabel = t('menu.allowedGroups.group.reactionMode.passive');
+        const backLabel = t('menu.allowedGroups.group.back');
+        const currentMode = this.sessionManager.getAllowedGroupReactionMode(group.number);
+        const options = [activeLabel, passiveLabel, backLabel];
+
+        const choice = await ctx.ui.select(title, options);
+
+        if (choice === backLabel || !choice) {
+            return;
+        }
+
+        if (choice === activeLabel || choice === passiveLabel) {
+            const nextMode = choice === activeLabel ? 'active' : 'passive';
+            if (currentMode !== nextMode) {
+                await this.sessionManager.setAllowedGroupReactionMode(group.number, nextMode);
+            }
+            ctx.ui.notify(t('menu.allowedGroups.group.reactionMode.updated', { displayName, mode: choice }), 'info');
+        }
+    }
+
     private async sendPromptedMenuMessage(
         ctx: ExtensionCommandContext,
         options: {