whatsapp-pi 1.0.51 → 1.0.53

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
@@ -27,7 +28,7 @@ Pi is a powerful agentic AI coding assistant that operates in your terminal. Thi
 - **Media Support**: 
   - **Vision Analysis**: Automatically forwards WhatsApp images to Pi for analysis.
   - **Audio Transcription**: Transcribes voice notes when Whisper is installed.
-  - **Document Handling**: Downloads and stores documents (PDF, text) for agent access.
+  - **Document Handling**: Downloads and stores documents (PDF, text) for agent access; PDFs include a bounded text preview when readable.
 
 ## Prerequisites
 
@@ -36,10 +37,8 @@ To enable audio transcription features:
 python -m pip install -U openai-whisper
 ```
 
-To enable PDF reading capabilities (required for the agent to process documents):
-- **Linux**: `sudo apt-get install poppler-utils`
-- **macOS**: `brew install poppler`
-- **Windows**: Install `poppler` (e.g., via Scoop) and add to PATH.
+PDF documents are parsed locally and do not require extra system utilities.
+If a PDF cannot be parsed automatically, it is still saved and forwarded with a clear fallback notice.
 
 ## Quick Start
 
@@ -126,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
@@ -162,9 +162,10 @@ 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 documents are saved under `./.pi-data/whatsapp/documents/`.
+- **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.
 - **Session Handling**: Saved state, allow list, and startup reconnects are restored automatically when available.
 - **Intelligent Message Filtering**: Messages ending with `π` are ignored to prevent bot loops.
 - **Storage Management**: Persistent data lives under `.pi-data/` plus the recents store in the user home directory.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "whatsapp-pi",
-  "version": "1.0.51",
+  "version": "1.0.53",
   "type": "module",
   "description": "WhatsApp integration extension for Pi",
   "main": "whatsapp-pi.ts",
@@ -32,6 +32,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
+    "@llamaindex/liteparse": "^1.5.3",
     "baileys": "^6.7.21",
     "pino": "^10.3.1",
     "qrcode-terminal": "^0.12.0"

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",
@@ -197,6 +202,8 @@ const fallback = {
     "incoming.media.documentSize": "Size: {size}",
     "incoming.media.documentLocation": "Location: {relativePath}",
     "incoming.media.documentDescription": "Description: {caption}",
+    "incoming.media.documentPdfPreviewHeading": "PDF text preview:",
+    "incoming.media.documentPdfFallbackNotice": "PDF text was not extracted automatically. The file is saved at the path above.",
     "incoming.media.documentDownloadFailed": "[WhatsApp-Pi] Failed to download document:",
     "incoming.media.documentDownloadFailedText": "[Document: {fileName} (download failed)]",
     "audio.emptyTranscription": "[Empty transcription]",
@@ -304,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",
@@ -375,6 +387,8 @@ const translations: Record<Locale, Partial<Record<Key, string>>> = {
         "incoming.media.documentSize": "Tamanho: {size}",
         "incoming.media.documentLocation": "Local: {relativePath}",
         "incoming.media.documentDescription": "Descrição: {caption}",
+        "incoming.media.documentPdfPreviewHeading": "Prévia do texto do PDF:",
+        "incoming.media.documentPdfFallbackNotice": "O texto do PDF não pôde ser extraído automaticamente. O arquivo foi salvo no caminho acima.",
         "incoming.media.documentDownloadFailed": "[WhatsApp-Pi] Falha ao baixar documento:",
         "incoming.media.documentDownloadFailedText": "[Documento: {fileName} (download falhou)]",
     },

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/incoming-media.service.ts

@@ -1,6 +1,7 @@
 import { downloadContentFromMessage } from 'baileys';
 import { mkdir, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
+import { LiteParse } from '@llamaindex/liteparse';
 import { AudioService } from './audio.service.js';
 import type { IncomingResolution } from './incoming-message.resolver.js';
 import { WhatsAppPiLogger } from './whatsapp-pi.logger.js';
@@ -12,7 +13,11 @@ export interface ProcessedIncomingContent {
     imageMimeType?: string;
 }
 
+const PDF_PREVIEW_LIMIT = 1200;
+
 export class IncomingMediaService {
+    private readonly pdfParser = new LiteParse({ ocrEnabled: true });
+
     constructor(
         private readonly audioService: AudioService,
         private readonly logger = new WhatsAppPiLogger(false)
@@ -80,6 +85,15 @@ export class IncomingMediaService {
                 + t('incoming.media.documentSize', { size: this.formatFileSize(fileSize) }) + '\n'
                 + t('incoming.media.documentLocation', { relativePath });
 
+            if (this.isPdfDocument(fileName, mimeType)) {
+                const preview = await this.extractPdfPreview(buffer);
+                if (preview) {
+                    text += `\n\n${t('incoming.media.documentPdfPreviewHeading')}\n${preview}`;
+                } else {
+                    text += `\n\n${t('incoming.media.documentPdfFallbackNotice')}`;
+                }
+            }
+
             if (documentMessage.caption) {
                 text += `\n\n${t('incoming.media.documentDescription', { caption: documentMessage.caption })}`;
             }
@@ -91,6 +105,34 @@ export class IncomingMediaService {
         }
     }
 
+    private async extractPdfPreview(buffer: Buffer): Promise<string | null> {
+        try {
+            const result = await this.pdfParser.parse(buffer);
+            return this.formatPdfPreview(result.text);
+        } catch (error) {
+            this.logger.warn('[WhatsApp-Pi] PDF parsing failed, falling back to storage-only behavior.', error);
+            return null;
+        }
+    }
+
+    private formatPdfPreview(text: string | undefined | null): string | null {
+        const normalized = (text || '').replace(/\r\n/g, '\n').trim();
+        if (!normalized) {
+            return null;
+        }
+
+        if (normalized.length <= PDF_PREVIEW_LIMIT) {
+            return normalized;
+        }
+
+        return `${normalized.slice(0, PDF_PREVIEW_LIMIT)}…`;
+    }
+
+    private isPdfDocument(fileName: string, mimeType: string): boolean {
+        const normalizedMimeType = mimeType.toLowerCase().split(';')[0].trim();
+        return normalizedMimeType === 'application/pdf' || fileName.toLowerCase().endsWith('.pdf');
+    }
+
     private async downloadMessage(message: any, type: 'image' | 'document'): Promise<Buffer> {
         const stream = await downloadContentFromMessage(message, type);
         let buffer = Buffer.from([]);

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: {

package/whatsapp-pi.ts

@@ -183,17 +183,6 @@ export default function (pi: ExtensionAPI) {
         }
 
         ctx.ui.notify('WhatsApp: Session reset via /new is now fully supported.', 'info');
-
-        // Verify pdftotext availability for document support
-        try {
-            const { code } = await pi.exec('pdftotext', ['-v']);
-            if (code !== 0 && code !== 99) { // 99 is a common exit code for -v in some versions
-                throw new Error(`pdftotext returned code ${code}`);
-            }
-        } catch {
-            ctx.ui.notify('WhatsApp: pdftotext not found. PDF document support will be limited to storage only.', 'warning');
-            logger.warn('[WhatsApp-Pi] Warning: pdftotext not found in system PATH.');
-        }
     });
 
     // Track whether send_wa_message tool already sent a reply this turn