whatsapp-pi 1.0.46 → 1.0.48

package/README.md

@@ -8,7 +8,7 @@ A WhatsApp integration extension for the **[Pi Coding Agent](https://github.com/
 
 [![GitHub](https://img.shields.io/badge/github-repo-black.svg?style=flat-square&logo=github)](https://github.com/RaphaCastelloes/whatsapp-pi)
 
-Pi is a powerful agentic AI coding assistant that operates in your terminal. This extension allows you to chat and pair-program with your Pi agent directly through WhatsApp, featuring message filtering, allow-listing, and reliable message delivery.
+Pi is a powerful agentic AI coding assistant that operates in your terminal. This extension allows you to chat and pair-program with your Pi agent directly through WhatsApp, featuring message filtering, allow-listing, recents/history browsing, message detail/reply, group-only binding, and reliable message delivery.
 
 ## Features
 
@@ -16,10 +16,17 @@ Pi is a powerful agentic AI coding assistant that operates in your terminal. Thi
 - **Allow List**: Control which numbers can interact with Pi
   - Add contacts with optional names for easy identification
   - View ignored numbers (not in allow list) and add them when needed
+  - Manage aliases and print allowed numbers from the menu
+- **Allowed Groups**: Control which WhatsApp groups can interact with Pi
+  - Add group JIDs with optional aliases
+  - 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
-- **TUI Integration**: Menu-driven interface for managing connections and contacts
+- **TUI Integration**: Menu-driven interface for managing connections, contacts, and recent chats
+- **Group-Only Mode**: Bind the agent to a single WhatsApp group with `--whatsapp-group`
 - **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.
 
 ## Prerequisites
@@ -46,12 +53,12 @@ pi install npm:whatsapp-pi
 pi
 ```
 
-After connecting WhatsApp once from the menu and scanning the QR code, you can start Pi with auto-connect enabled:
-```bash
-pi --whatsapp-pi-online
-```
+After connecting WhatsApp once from the menu and scanning the QR code, you can start Pi with auto-connect enabled:
+```bash
+pi --whatsapp-pi-online
+```
 
-3. Use the menu to connect WhatsApp and manage allowed/blocked numbers
+3. Use the menu to connect WhatsApp and manage allowed numbers and groups
 
 ## Development / Testing
 
@@ -69,15 +76,15 @@ npm install
 pi -e whatsapp-pi.ts
 ```
 
-For verbose mode (shows Baileys trace logs for debugging):
-```bash
-pi -e whatsapp-pi.ts --verbose
-```
-
-To test startup auto-connect locally after you have already paired WhatsApp:
-```bash
-pi -e whatsapp-pi.ts --whatsapp-pi-online
-```
+For verbose mode (shows Baileys trace logs for debugging):
+```bash
+pi -e whatsapp-pi.ts --verbose
+```
+
+To test startup auto-connect locally after you have already paired WhatsApp:
+```bash
+pi -e whatsapp-pi.ts --whatsapp-pi-online
+```
 
 ## Commands
 
@@ -87,18 +94,26 @@ pi -e whatsapp-pi.ts --whatsapp-pi-online
 - **Connect / Reconnect WhatsApp** - Start WhatsApp connection using saved credentials when available; QR code appears only if pairing is required
 - **Disconnect WhatsApp** - Stop WhatsApp connection
 - **Logoff (Delete Session)** - Remove all credentials and session data
+- **Recents** - Open recent conversations, view history, and reply
 - **Allowed Numbers** - Manage contacts that can interact with Pi
-- **Blocked Numbers** - View ignored numbers and manage them
+- **Allowed Groups** - Manage WhatsApp groups that can interact with Pi
 
 ### Allowed Numbers Management
 - **Add Number** - Add a new contact to the allow list (format: +5511999999999)
-- **Select a contact** - Open a submenu with **Send Message**, **Remove Number**, and **Back**
+- **Select a contact** - Open a submenu with **History**, **Send Message**, **Print Number**, alias actions, **Remove Number**, and **Back**
 - **Back** - Return to main menu
 
-### Blocked Numbers Management
-- **View List** - See all numbers that have been ignored (not in allow list)
-- **Allow** - Move a blocked number to the allowed list
-- **Delete** - Remove a number from the blocked list
+### 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**
+- **Back** - Return to main menu
+
+### Recents Management
+- **History** - Open full message history for that conversation
+- **Send Message** - Send a new message without Pi suffix
+- **Reply** - Open message detail, then press `R` to reply
+- **Allow Number / Allow Group** - Move a recent sender into the appropriate allow list
+- **Remove Alias** - Clear saved alias for that sender
 - **Back** - Return to main menu
 
 ## Project Structure
@@ -106,11 +121,11 @@ pi -e whatsapp-pi.ts --whatsapp-pi-online
 ```
 src/
 ├── models/          # Type definitions
-├── services/        # Core services (WhatsApp, Session, MessageSender)
-└── ui/              # Menu handlers
+├── services/        # Core services (WhatsApp, Session, Recents, Media)
+└── ui/              # Menu handlers and TUI views
 
-specs/               # Feature specifications
-tests/               # Unit and integration tests
+tests/
+└── unit/            # Unit tests
 ```
 
 ## Development
@@ -122,15 +137,13 @@ npm test
 
 ## Implementation Notes
 
-### Recent Feature Updates (2026-04)
-
-- **Auto-Connect Support**: Use the `--whatsapp-pi-online` flag to automatically connect to WhatsApp on startup if you have a valid active session.
-- **Vision Analysis**: Images sent via WhatsApp are automatically downloaded and forwarded to the Pi agent as base64, enabling vision-based interactions.
-- **Document Message Support**: 
-  - WhatsApp documents (PDFs, text files, etc.) are downloaded and saved to `./.pi-data/whatsapp/documents/`.
-  - The Pi agent receives a notification with the file path and metadata.
-- **Full US-English Localization**: All user-facing menus, TUI notifications, console logs, and agent communication headers have been localized to `en-US` for a consistent experience.
-- **Intelligent Message Filtering**: 
-  - **Loop Prevention**: The bot automatically ignores any message ending with the `π` symbol, preventing infinite loops between instances.
-  - **Manual Interaction**: Users can now interact with the bot from their own WhatsApp account; the bot will process `fromMe` messages as long as they don't contain the bot's signature.
-- **Storage Management**: All persistent data (auth state, documents, config) is centralized in the `.pi-data/` directory.
+### Recent Feature Updates (2026-05)
+
+- **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.
+- **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/`.
+- **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.46",
+  "version": "1.0.48",
   "type": "module",
   "description": "WhatsApp integration extension for Pi",
   "main": "whatsapp-pi.ts",
@@ -32,7 +32,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@whiskeysockets/baileys": "^6.11.0",
+    "baileys": "^6.7.21",
     "pino": "^10.3.1",
     "qrcode-terminal": "^0.12.0"
   },