whazaa 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Matthias Nott
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,204 @@
+# Whazaa
+
+WhatsApp MCP server for Claude Code — bidirectional self-chat messaging.
+
+You message yourself on WhatsApp, Claude receives it. Claude responds, you see it on WhatsApp. Your phone becomes a parallel terminal.
+
+---
+
+## Features
+
+- **Bidirectional messaging** — send from Claude, receive from your phone
+- **Zero configuration** — auto-detects your phone number after first scan
+- **First-run QR pairing** — scan once, connects automatically thereafter
+- **Markdown support** — `**bold**`, `*italic*`, `` `code` `` converted to WhatsApp format
+- **Deduplication** — outgoing messages never echo back as incoming
+- **Exponential backoff** — reconnects automatically (1s to 60s)
+- **MCP-safe** — all output except JSON-RPC goes to stderr
+
+---
+
+## Quick Start
+
+### Option 1: Run directly with npx / bunx
+
+No installation required:
+
+```bash
+npx whazaa
+```
+
+or with Bun:
+
+```bash
+bunx whazaa
+```
+
+The first run prints a QR code to your terminal. Scan it with WhatsApp (Settings -> Linked Devices -> Link a Device). Credentials are saved to `~/.whazaa/auth/` and all subsequent runs connect automatically.
+
+### Option 2: Install globally
+
+```bash
+npm install -g whazaa
+whazaa
+```
+
+### Option 3: Build from source
+
+```bash
+git clone https://github.com/mnott/Whazaa.git
+cd whazaa
+npm install
+npm run build
+node dist/index.js
+```
+
+---
+
+## Claude Code MCP Configuration
+
+Add Whazaa to `~/.claude/.mcp.json` (or your project's `.mcp.json`):
+
+### Using npx (always latest version)
+
+```json
+{
+  "mcpServers": {
+    "whazaa": {
+      "command": "npx",
+      "args": ["whazaa"],
+      "description": "Whazaa — WhatsApp self-chat MCP server for Claude Code"
+    }
+  }
+}
+```
+
+### Using bunx
+
+```json
+{
+  "mcpServers": {
+    "whazaa": {
+      "command": "bunx",
+      "args": ["whazaa"],
+      "description": "Whazaa — WhatsApp self-chat MCP server for Claude Code"
+    }
+  }
+}
+```
+
+### Using a local build
+
+```json
+{
+  "mcpServers": {
+    "whazaa": {
+      "command": "node",
+      "args": ["/path/to/whazaa/dist/index.js"],
+      "description": "Whazaa — WhatsApp self-chat MCP server for Claude Code"
+    }
+  }
+}
+```
+
+After updating the MCP config, restart Claude Code. On first run, Whazaa prints a QR code to the Claude Code logs (check Settings -> Developer -> MCP Logs or run it manually from a terminal first to complete pairing).
+
+---
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `whatsapp_status` | Report connection state and phone number |
+| `whatsapp_send` | Send a message to your own WhatsApp self-chat |
+| `whatsapp_receive` | Drain queued incoming messages from your phone |
+| `whatsapp_login` | Trigger a new QR pairing flow |
+
+---
+
+## How It Works
+
+Whazaa uses the [Baileys](https://github.com/WhiskeySockets/Baileys) library to maintain a persistent WebSocket connection to WhatsApp's servers using the same multi-device protocol as WhatsApp Web. It exposes four MCP tools over stdin/stdout and routes all Baileys output to stderr to keep the JSON-RPC stream clean. Incoming messages from your phone are queued in memory and returned when `whatsapp_receive` is called.
+
+---
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `WHAZAA_AUTH_DIR` | `~/.whazaa/auth/` | Directory for WhatsApp session credentials |
+
+### Example: custom auth directory
+
+```json
+{
+  "mcpServers": {
+    "whazaa": {
+      "command": "node",
+      "args": ["/path/to/whazaa/dist/index.js"],
+      "env": {
+        "WHAZAA_AUTH_DIR": "/custom/path/whatsapp-creds"
+      }
+    }
+  }
+}
+```
+
+---
+
+## First-Time Pairing
+
+1. Run Whazaa from a terminal so you can see the QR code:
+   ```bash
+   npx whazaa
+   ```
+
+2. A QR code prints on stderr. Open WhatsApp on your phone:
+   - iOS: Settings -> Linked Devices -> Link a Device
+   - Android: Menu (three dots) -> Linked Devices -> Link a Device
+
+3. Scan the QR code. Whazaa logs `Connected. Phone: +XXXXXXXXXXX`.
+
+4. Add the MCP config to Claude Code. Credentials are now saved; subsequent connections are automatic.
+
+---
+
+## Troubleshooting
+
+**QR code not appearing**
+
+Run Whazaa directly from a terminal (`npx whazaa`) rather than from within Claude Code's MCP runner, which may not show stderr. Once paired, restart Claude Code.
+
+**"Logged out (401)" error**
+
+Your session was invalidated (e.g. you unlinked the device in WhatsApp). Use the `whatsapp_login` tool or delete `~/.whazaa/auth/` and restart Whazaa to re-pair.
+
+**Messages not received**
+
+Call `whatsapp_receive` to drain the queue. Only messages sent to your own number (the self-chat / "Saved Messages" chat) are captured.
+
+**Connection keeps dropping**
+
+Whazaa uses exponential backoff to reconnect automatically. Check your network connection. If the problem persists, use `whatsapp_login` to re-establish the session.
+
+**Multiple WhatsApp accounts**
+
+Set `WHAZAA_AUTH_DIR` to a different directory for each account and run separate instances.
+
+---
+
+## Security Notes
+
+- Session credentials are stored locally in `~/.whazaa/auth/`. Treat them like passwords.
+- Whazaa only reads and sends messages in your self-chat. It does not have access to other conversations.
+- No data is sent to any third-party service. The connection is directly to WhatsApp's servers via Baileys.
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE)
+
+## Author
+
+Matthias Nott — [github.com/mnott](https://github.com/mnott)

package/dist/auth.d.ts

@@ -0,0 +1,31 @@
+/**
+ * auth.ts — Auth directory resolution and QR code display helper
+ *
+ * Whazaa stores session credentials in ~/.whazaa/auth/ by default.
+ * Override with WHAZAA_AUTH_DIR environment variable.
+ *
+ * QR codes are printed to stderr so they never pollute MCP's JSON-RPC
+ * stream on stdout.
+ */
+/**
+ * Resolve the auth directory, with the following priority:
+ *   1. WHAZAA_AUTH_DIR environment variable
+ *   2. ~/.whazaa/auth/ (default)
+ *
+ * Creates the directory if it does not exist.
+ */
+export declare function resolveAuthDir(): string;
+/**
+ * Return true if an existing auth session appears to be present.
+ * Baileys writes creds.json when credentials are saved.
+ */
+export declare function hasExistingSession(authDir: string): boolean;
+/**
+ * Print a QR code to stderr.
+ *
+ * Baileys provides the raw QR string in its 'connection.update' event.
+ * We render it here so it appears in the user's terminal without
+ * contaminating the MCP JSON-RPC stream on stdout.
+ */
+export declare function printQR(qrString: string): void;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,MAAM,CASvC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG3D;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAY9C"}

package/dist/auth.js

@@ -0,0 +1,53 @@
+/**
+ * auth.ts — Auth directory resolution and QR code display helper
+ *
+ * Whazaa stores session credentials in ~/.whazaa/auth/ by default.
+ * Override with WHAZAA_AUTH_DIR environment variable.
+ *
+ * QR codes are printed to stderr so they never pollute MCP's JSON-RPC
+ * stream on stdout.
+ */
+import { existsSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import qrcode from "qrcode-terminal";
+/**
+ * Resolve the auth directory, with the following priority:
+ *   1. WHAZAA_AUTH_DIR environment variable
+ *   2. ~/.whazaa/auth/ (default)
+ *
+ * Creates the directory if it does not exist.
+ */
+export function resolveAuthDir() {
+    const dir = process.env.WHAZAA_AUTH_DIR ?? join(homedir(), ".whazaa", "auth");
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+        process.stderr.write(`[whazaa] Created auth directory: ${dir}\n`);
+    }
+    return dir;
+}
+/**
+ * Return true if an existing auth session appears to be present.
+ * Baileys writes creds.json when credentials are saved.
+ */
+export function hasExistingSession(authDir) {
+    const credsPath = join(authDir, "creds.json");
+    return existsSync(credsPath);
+}
+/**
+ * Print a QR code to stderr.
+ *
+ * Baileys provides the raw QR string in its 'connection.update' event.
+ * We render it here so it appears in the user's terminal without
+ * contaminating the MCP JSON-RPC stream on stdout.
+ */
+export function printQR(qrString) {
+    process.stderr.write("\n[whazaa] Scan the QR code below with WhatsApp:\n");
+    process.stderr.write("[whazaa] Open WhatsApp -> Linked Devices -> Link a Device\n\n");
+    // qrcode-terminal writes to stdout by default; we capture and re-emit to stderr
+    qrcode.generate(qrString, { small: true }, (rendered) => {
+        process.stderr.write(rendered + "\n");
+    });
+    process.stderr.write("[whazaa] Waiting for scan...\n\n");
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,iBAAiB,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAE9E,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,GAAG,IAAI,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC9C,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,QAAgB;IACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAC3E,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,+DAA+D,CAChE,CAAC;IAEF,gFAAgF;IAChF,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,QAAgB,EAAE,EAAE;QAC9D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * index.ts — Whazaa MCP server entry point
+ *
+ * Exposes four tools over the Model Context Protocol (stdio transport):
+ *
+ *   whatsapp_status   — Report connection state and phone number
+ *   whatsapp_send     — Send a message to your own WhatsApp number
+ *   whatsapp_receive  — Drain queued incoming messages from your phone
+ *   whatsapp_login    — Trigger a new QR pairing flow
+ *
+ * CRITICAL: stdout is the MCP JSON-RPC transport.
+ *   - NEVER write non-JSON to stdout.
+ *   - All debug output, QR codes, and logs go to stderr.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG"}

package/dist/index.js

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+/**
+ * index.ts — Whazaa MCP server entry point
+ *
+ * Exposes four tools over the Model Context Protocol (stdio transport):
+ *
+ *   whatsapp_status   — Report connection state and phone number
+ *   whatsapp_send     — Send a message to your own WhatsApp number
+ *   whatsapp_receive  — Drain queued incoming messages from your phone
+ *   whatsapp_login    — Trigger a new QR pairing flow
+ *
+ * CRITICAL: stdout is the MCP JSON-RPC transport.
+ *   - NEVER write non-JSON to stdout.
+ *   - All debug output, QR codes, and logs go to stderr.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { initialize, getStatus, sendMessage, drainMessages, triggerLogin, } from "./whatsapp.js";
+// ---------------------------------------------------------------------------
+// MCP server setup
+// ---------------------------------------------------------------------------
+const server = new McpServer({
+    name: "whazaa",
+    version: "0.1.0",
+});
+// ---------------------------------------------------------------------------
+// Tool: whatsapp_status
+// ---------------------------------------------------------------------------
+server.tool("whatsapp_status", "Check the Whazaa connection state and the WhatsApp phone number it is logged in as.", {}, async () => {
+    const s = getStatus();
+    let text;
+    if (s.awaitingQR) {
+        text =
+            "Awaiting QR scan. Check the terminal where Whazaa is running and scan the QR code with WhatsApp.";
+    }
+    else if (s.connected && s.phoneNumber) {
+        text = `Connected. Phone: +${s.phoneNumber}`;
+    }
+    else {
+        text =
+            "Disconnected. Whazaa is attempting to reconnect in the background.";
+    }
+    return { content: [{ type: "text", text }] };
+});
+// ---------------------------------------------------------------------------
+// Tool: whatsapp_send
+// ---------------------------------------------------------------------------
+server.tool("whatsapp_send", [
+    "Send a message to yourself via WhatsApp self-chat.",
+    "Supports basic Markdown: **bold**, *italic*, `code`.",
+    "The message appears in your own WhatsApp chat with yourself.",
+].join(" "), {
+    message: z
+        .string()
+        .min(1)
+        .describe("The message text to send to your WhatsApp self-chat"),
+}, async ({ message }) => {
+    try {
+        await sendMessage(message);
+        const preview = message.length > 80 ? `${message.slice(0, 80)}...` : message;
+        return {
+            content: [{ type: "text", text: `Sent: ${preview}` }],
+        };
+    }
+    catch (err) {
+        const errMsg = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: "text", text: `Error: ${errMsg}` }],
+            isError: true,
+        };
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: whatsapp_receive
+// ---------------------------------------------------------------------------
+server.tool("whatsapp_receive", [
+    "Return all queued incoming WhatsApp messages received since the last call, then clear the queue.",
+    "Messages are from your own WhatsApp number (self-chat) — i.e. messages you type on your phone.",
+    "Returns 'No new messages.' if the queue is empty.",
+].join(" "), {}, async () => {
+    const messages = drainMessages();
+    if (messages.length === 0) {
+        return { content: [{ type: "text", text: "No new messages." }] };
+    }
+    const formatted = messages
+        .map((m) => {
+        const ts = new Date(m.timestamp).toISOString();
+        return `[${ts}] ${m.body}`;
+    })
+        .join("\n");
+    return { content: [{ type: "text", text: formatted }] };
+});
+// ---------------------------------------------------------------------------
+// Tool: whatsapp_login
+// ---------------------------------------------------------------------------
+server.tool("whatsapp_login", [
+    "Trigger a new WhatsApp QR pairing flow.",
+    "Use this when the connection is lost and automatic reconnection fails,",
+    "or when you need to link a different phone number.",
+    "A QR code will be printed to the Whazaa server's stderr — check the terminal where it is running.",
+].join(" "), {}, async () => {
+    try {
+        // Non-blocking: triggerLogin initiates the reconnect but QR display
+        // happens asynchronously via the Baileys event handler.
+        triggerLogin().catch((err) => {
+            process.stderr.write(`[whazaa] Login trigger error: ${err}\n`);
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "QR pairing initiated. Check the terminal where Whazaa is running and scan the QR code with WhatsApp (Linked Devices -> Link a Device).",
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const errMsg = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: "text", text: `Error: ${errMsg}` }],
+            isError: true,
+        };
+    }
+});
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+async function main() {
+    // Start WhatsApp connection in the background.
+    // initialize() resolves once connected OR once a QR code has been emitted,
+    // so the MCP server is immediately available for tool calls in both cases.
+    initialize().catch((err) => {
+        process.stderr.write(`[whazaa] Initialization error: ${err}\n`);
+    });
+    // Start the MCP server over stdio
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    process.stderr.write(`[whazaa] Fatal error: ${err}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/whatsapp.d.ts

@@ -0,0 +1,54 @@
+/**
+ * whatsapp.ts — WhatsApp connection manager
+ *
+ * Manages the Baileys WebSocket connection with:
+ *   - Automatic self-JID detection (no hardcoded phone number)
+ *   - QR pairing flow on first run, silent reconnect thereafter
+ *   - Exponential backoff reconnection (1s -> 60s max)
+ *   - Deduplication of sent messages to prevent self-echo
+ *   - Markdown -> WhatsApp format conversion
+ *   - All Baileys output silenced to avoid MCP stdio pollution
+ */
+export interface QueuedMessage {
+    body: string;
+    timestamp: number;
+}
+export interface WhatsAppStatus {
+    connected: boolean;
+    /** E.164 phone number without leading +, e.g. "1234567890" */
+    phoneNumber: string | null;
+    /** Full WhatsApp JID, e.g. "1234567890@s.whatsapp.net" */
+    selfJid: string | null;
+    /** Linked Identity JID, e.g. "123456789012@lid" — used for self-chat */
+    selfLid: string | null;
+    /** Whether a QR scan is currently required */
+    awaitingQR: boolean;
+}
+/**
+ * Initialize the WhatsApp connection.
+ * Resolves once the connection is open OR a QR code has been emitted
+ * (so the MCP server can start handling tool calls immediately).
+ */
+export declare function initialize(): Promise<void>;
+/**
+ * Trigger a new QR pairing flow.
+ * Closes the current socket (if any) and reconnects with fresh state
+ * so Baileys emits a new QR code.
+ */
+export declare function triggerLogin(): Promise<void>;
+/**
+ * Return the current connection status snapshot.
+ */
+export declare function getStatus(): WhatsAppStatus;
+/**
+ * Send a message to the authenticated user's own WhatsApp number.
+ * Converts Markdown to WhatsApp formatting before sending.
+ *
+ * @throws If not connected or socket is unavailable.
+ */
+export declare function sendMessage(message: string): Promise<void>;
+/**
+ * Drain and return all queued incoming messages, then clear the queue.
+ */
+export declare function drainMessages(): QueuedMessage[];
+//# sourceMappingURL=whatsapp.d.ts.map

package/dist/whatsapp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp.d.ts","sourceRoot":"","sources":["../src/whatsapp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,0DAA0D;IAC1D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,wEAAwE;IACxE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,8CAA8C;IAC9C,UAAU,EAAE,OAAO,CAAC;CACrB;AAmOD;;;;GAIG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAQhD;AAED;;;;GAIG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CA4BlD;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,cAAc,CAE1C;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BhE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,aAAa,EAAE,CAI/C"}

package/dist/whatsapp.js

@@ -0,0 +1,300 @@
+/**
+ * whatsapp.ts — WhatsApp connection manager
+ *
+ * Manages the Baileys WebSocket connection with:
+ *   - Automatic self-JID detection (no hardcoded phone number)
+ *   - QR pairing flow on first run, silent reconnect thereafter
+ *   - Exponential backoff reconnection (1s -> 60s max)
+ *   - Deduplication of sent messages to prevent self-echo
+ *   - Markdown -> WhatsApp format conversion
+ *   - All Baileys output silenced to avoid MCP stdio pollution
+ */
+import makeWASocket, { DisconnectReason, fetchLatestBaileysVersion, makeCacheableSignalKeyStore, useMultiFileAuthState, } from "@whiskeysockets/baileys";
+import pino from "pino";
+import { resolveAuthDir, printQR } from "./auth.js";
+// --- Module state ------------------------------------------------------------
+/** The active Baileys socket (null when disconnected) */
+let sock = null;
+/** Incoming messages from the phone waiting to be drained */
+const messageQueue = [];
+/** IDs of messages sent by this process — used to suppress self-echo */
+const sentMessageIds = new Set();
+/** Current connection state exposed to MCP tools */
+let status = {
+    connected: false,
+    phoneNumber: null,
+    selfJid: null,
+    selfLid: null,
+    awaitingQR: false,
+};
+/** Reconnect scheduling */
+let reconnectTimer = null;
+let reconnectAttempts = 0;
+const MAX_RECONNECT_DELAY_MS = 60_000;
+/** Set to true on loggedOut — stops all reconnect attempts */
+let permanentlyLoggedOut = false;
+/** Resolve when the first connection attempt completes (either open or qr shown) */
+let initResolve = null;
+// --- Internal helpers --------------------------------------------------------
+/**
+ * Silenced Pino logger — CRITICAL: Baileys must not write to stdout.
+ * Stdout is the MCP JSON-RPC transport; any non-JSON output breaks the protocol.
+ */
+const logger = pino({ level: "silent" });
+/**
+ * Convert common Markdown syntax to WhatsApp formatting codes.
+ *
+ *   **bold**   -> *bold*   (WhatsApp bold)
+ *   *italic*   -> _italic_ (WhatsApp italic)
+ *   `code`     -> ```code``` (WhatsApp monospace)
+ */
+function markdownToWhatsApp(text) {
+    return text
+        .replace(/\*\*(.+?)\*\*/gs, "*$1*")
+        .replace(/(?<!\*)\*(?!\*)(.+?)(?<!\*)\*(?!\*)/gs, "_$1_")
+        .replace(/`([^`]+)`/g, "```$1```");
+}
+/**
+ * Schedule a reconnection attempt with exponential backoff.
+ * Does nothing if permanently logged out or a timer is already pending.
+ */
+function scheduleReconnect() {
+    if (permanentlyLoggedOut)
+        return;
+    if (reconnectTimer)
+        return; // already scheduled
+    reconnectAttempts++;
+    const delay = Math.min(1_000 * Math.pow(2, reconnectAttempts - 1), MAX_RECONNECT_DELAY_MS);
+    process.stderr.write(`[whazaa] Reconnecting in ${delay / 1_000}s (attempt ${reconnectAttempts})...\n`);
+    reconnectTimer = setTimeout(() => {
+        reconnectTimer = null;
+        connect().catch((err) => {
+            process.stderr.write(`[whazaa] Reconnect error: ${err}\n`);
+        });
+    }, delay);
+}
+// --- Core connection ---------------------------------------------------------
+/**
+ * Open (or re-open) the Baileys WebSocket connection.
+ * On first run with no saved credentials, Baileys emits a QR code which we
+ * display on stderr. After the user scans it, credentials are saved and all
+ * subsequent runs connect automatically without showing a QR.
+ */
+async function connect() {
+    const authDir = resolveAuthDir();
+    const { state: authState, saveCreds } = await useMultiFileAuthState(authDir);
+    const { version } = await fetchLatestBaileysVersion();
+    sock = makeWASocket({
+        auth: {
+            creds: authState.creds,
+            keys: makeCacheableSignalKeyStore(authState.keys, logger),
+        },
+        version,
+        // Browser string shown in WhatsApp's linked devices list
+        browser: ["Whazaa", "cli", "0.1.0"],
+        printQRInTerminal: false, // We handle QR display ourselves on stderr
+        syncFullHistory: false,
+        markOnlineOnConnect: false,
+        logger,
+    });
+    // Persist credentials whenever they are updated
+    sock.ev.on("creds.update", saveCreds);
+    // Handle connection lifecycle
+    sock.ev.on("connection.update", ({ connection, lastDisconnect, qr }) => {
+        // Display QR code when pairing is needed
+        if (qr) {
+            status.awaitingQR = true;
+            printQR(qr);
+            // Resolve init promise so MCP server starts up even while awaiting scan
+            if (initResolve) {
+                initResolve();
+                initResolve = null;
+            }
+        }
+        if (connection === "open") {
+            status.awaitingQR = false;
+            status.connected = true;
+            reconnectAttempts = 0;
+            // Derive phone number and LID from the authenticated user
+            const jid = sock?.user?.id ?? null;
+            if (jid) {
+                // JID format: "1234567890:12@s.whatsapp.net" or "1234567890@s.whatsapp.net"
+                const number = jid.split(":")[0].split("@")[0];
+                status.phoneNumber = number;
+                status.selfJid = `${number}@s.whatsapp.net`;
+            }
+            // Capture LID (Linked Identity) — self-chat uses this format
+            const lid = sock?.user?.lid;
+            if (lid) {
+                status.selfLid = lid;
+            }
+            process.stderr.write(`[whazaa] Connected. Phone: +${status.phoneNumber ?? "unknown"}\n`);
+            // Resolve init promise on successful connection
+            if (initResolve) {
+                initResolve();
+                initResolve = null;
+            }
+        }
+        if (connection === "close") {
+            status.connected = false;
+            const statusCode = lastDisconnect?.error?.output
+                ?.statusCode;
+            if (statusCode === DisconnectReason.loggedOut) {
+                // Auth is invalid (401). Stop reconnecting — user must re-pair.
+                permanentlyLoggedOut = true;
+                process.stderr.write("[whazaa] Logged out (401). Run whatsapp_login to re-pair.\n");
+                if (initResolve) {
+                    initResolve();
+                    initResolve = null;
+                }
+                return;
+            }
+            process.stderr.write("[whazaa] Connection closed. Will reconnect...\n");
+            scheduleReconnect();
+        }
+    });
+    // Handle incoming messages — only self-chat messages are queued
+    sock.ev.on("messages.upsert", ({ type, messages }) => {
+        // Accept both "notify" (real-time) and "append" (history sync / self-sent)
+        // Only skip "set" which is bulk history sync on first connect
+        for (const msg of messages) {
+            const remoteJid = msg.key?.remoteJid;
+            const body = msg.message?.conversation ??
+                msg.message?.extendedTextMessage?.text ??
+                null;
+            // Filter to self-chat only: match selfJid, selfLid, or phone number prefix
+            // Strip device suffix (e.g. ":6" or ":12") for comparison
+            const stripDevice = (jid) => jid.replace(/:\d+@/, "@");
+            const selfNumber = status.phoneNumber;
+            const selfLid = status.selfLid ? stripDevice(status.selfLid) : null;
+            const remoteJidNorm = remoteJid ? stripDevice(remoteJid) : null;
+            const isSelfChat = (status.selfJid && remoteJidNorm === stripDevice(status.selfJid)) ||
+                (selfLid && remoteJidNorm === selfLid) ||
+                (selfNumber && remoteJid?.startsWith(selfNumber));
+            if (!isSelfChat) {
+                continue;
+            }
+            // Deduplicate: skip messages sent by this process
+            const msgId = msg.key?.id;
+            if (msgId && sentMessageIds.has(msgId)) {
+                sentMessageIds.delete(msgId);
+                continue;
+            }
+            if (body) {
+                messageQueue.push({
+                    body,
+                    timestamp: Number(msg.messageTimestamp) * 1_000,
+                });
+            }
+        }
+    });
+}
+// --- Public API --------------------------------------------------------------
+/**
+ * Initialize the WhatsApp connection.
+ * Resolves once the connection is open OR a QR code has been emitted
+ * (so the MCP server can start handling tool calls immediately).
+ */
+export async function initialize() {
+    await new Promise((resolve) => {
+        initResolve = resolve;
+        connect().catch((err) => {
+            process.stderr.write(`[whazaa] Init error: ${err}\n`);
+            resolve(); // Don't block MCP startup on connection failure
+        });
+    });
+}
+/**
+ * Trigger a new QR pairing flow.
+ * Closes the current socket (if any) and reconnects with fresh state
+ * so Baileys emits a new QR code.
+ */
+export async function triggerLogin() {
+    permanentlyLoggedOut = false;
+    reconnectAttempts = 0;
+    if (reconnectTimer) {
+        clearTimeout(reconnectTimer);
+        reconnectTimer = null;
+    }
+    if (sock) {
+        try {
+            sock.end(undefined);
+        }
+        catch {
+            // Ignore errors on close
+        }
+        sock = null;
+    }
+    status = {
+        connected: false,
+        phoneNumber: null,
+        selfJid: null,
+        selfLid: null,
+        awaitingQR: false,
+    };
+    // Reconnect — Baileys will emit a QR if no creds are present
+    await connect();
+}
+/**
+ * Return the current connection status snapshot.
+ */
+export function getStatus() {
+    return { ...status };
+}
+/**
+ * Send a message to the authenticated user's own WhatsApp number.
+ * Converts Markdown to WhatsApp formatting before sending.
+ *
+ * @throws If not connected or socket is unavailable.
+ */
+export async function sendMessage(message) {
+    if (!sock) {
+        throw new Error("WhatsApp socket not initialized. Is the connection open?");
+    }
+    if (!status.connected) {
+        throw new Error("WhatsApp is not connected. Check status with whatsapp_status.");
+    }
+    if (!status.selfJid) {
+        throw new Error("Self JID not yet known. Wait for connection to fully open.");
+    }
+    const text = markdownToWhatsApp(message);
+    const result = await sock.sendMessage(status.selfJid, { text });
+    // Register the sent message ID for deduplication
+    if (result?.key?.id) {
+        const id = result.key.id;
+        sentMessageIds.add(id);
+        // Auto-expire after 30 seconds to prevent unbounded growth
+        setTimeout(() => {
+            sentMessageIds.delete(id);
+        }, 30_000);
+    }
+}
+/**
+ * Drain and return all queued incoming messages, then clear the queue.
+ */
+export function drainMessages() {
+    const snapshot = [...messageQueue];
+    messageQueue.length = 0;
+    return snapshot;
+}
+// --- Graceful shutdown -------------------------------------------------------
+function shutdown(signal) {
+    process.stderr.write(`[whazaa] Received ${signal}. Shutting down...\n`);
+    if (reconnectTimer) {
+        clearTimeout(reconnectTimer);
+        reconnectTimer = null;
+    }
+    if (sock) {
+        try {
+            sock.end(undefined);
+        }
+        catch {
+            // Ignore
+        }
+        sock = null;
+    }
+    process.exit(0);
+}
+process.on("SIGINT", () => shutdown("SIGINT"));
+process.on("SIGTERM", () => shutdown("SIGTERM"));
+//# sourceMappingURL=whatsapp.js.map

package/dist/whatsapp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp.js","sourceRoot":"","sources":["../src/whatsapp.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "whazaa",
+  "version": "0.1.0",
+  "description": "WhatsApp MCP server for Claude Code — talk to Claude from your phone via WhatsApp self-chat",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "whazaa": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "whatsapp",
+    "claude",
+    "claude-code",
+    "mcp-server",
+    "baileys",
+    "chatbot",
+    "ai"
+  ],
+  "license": "MIT",
+  "author": "Matthias Nott",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mnott/Whazaa"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "@whiskeysockets/baileys": "^7.0.0-rc.9",
+    "pino": "^9.0.0",
+    "qrcode-terminal": "^0.12.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/qrcode-terminal": "^0.12.2",
+    "typescript": "^5.0.0"
+  }
+}