@clickonsearch/whatsapp-agent 0.1.0

package/README.md

@@ -0,0 +1,121 @@
+# whatsapp-agent
+
+A personal WhatsApp assistant, usable two ways:
+
+- **Over WhatsApp itself** — message **yourself** ("Message yourself" —
+  Settings → your own contact) to give it an instruction, and it replies in
+  that same chat.
+- **From a browser chat UI** — an AG-UI protocol server (same pattern as
+  [`github-agent`](../github-agent)) with a bundled chat page, for when
+  typing in a web page is easier than typing on your phone, or you want to
+  embed it in your own tooling.
+
+Both modes share the same underlying agent loop and the same WhatsApp MCP
+tools, so "send Alex a message asking if she's free tomorrow" works
+identically either way — it really sends it, through your linked account.
+
+Requires [`@clickonsearch/whatsapp-mcp-server`](../../mcp-servers/whatsapp-mcp-server)
+running first — that's the piece that actually holds your WhatsApp session.
+This package is just the agent loop(s) on top of it.
+
+## How it works: WhatsApp mode
+
+Unlike `github-agent` (which only waits for an HTTP request), this mode is
+push-driven:
+
+1. Connects to `whatsapp-mcp-server`'s `/events` SSE stream and watches for
+   messages where `fromMe` is true and the chat is your own JID — i.e.
+   messages you sent to yourself.
+2. Each one becomes the prompt for the normal provider tool-calling loop
+   (same `openai/claude/deepseek-remote-mcp-bridge` packages `github-agent`
+   uses), with the WhatsApp MCP tools (`send_message`, `list_chats`,
+   `get_recent_messages`, `search_contacts`) available — so "send Alex a
+   message asking if she's free tomorrow" or "summarize my last 20 messages
+   with Sam" both work as tool calls, not just chat.
+3. The agent's final answer is sent back to you in the same self-chat via
+   `send_message`.
+
+```
+you: message yourself on WhatsApp
+        │
+        ▼
+whatsapp-mcp-server (Baileys) ──/events──▶ whatsapp-agent
+        ▲                                        │
+        │                                        ▼
+        └──────── send_message ─────── model + WhatsApp tools
+```
+
+## Setup
+
+```bash
+# 1. start the MCP server first (separate terminal, separate package)
+cd mcp-servers/whatsapp-mcp-server
+npm install && cp .env.example .env
+npm run dev   # scan the QR code it prints
+
+# 2. then this agent
+cd agents/whatsapp-agent
+npm install
+cp .env.example .env
+# fill in WHATSAPP_MCP_URL (if not localhost:4100) and your provider's API key
+```
+
+## Run: WhatsApp mode
+
+```bash
+npm run dev
+```
+
+Then open WhatsApp on your phone, message yourself something like "list my
+most recent chats" or "send a message to +1555... saying I'm running 10
+minutes late", and watch the reply come back in the same chat.
+
+## Run: browser chat UI (AG-UI server)
+
+```bash
+npm run build
+npm run serve          # or `npm run dev:serve` for tsx, no build step
+```
+
+This starts an HTTP server (default `http://localhost:3100`) with:
+
+- `GET /` — a self-contained chat page (`public/index.html`) with a
+  provider dropdown. Open it in a browser and talk to the assistant.
+- `POST /agent` — the AG-UI protocol endpoint (`RunAgentInput` in, AG-UI
+  SSE events out) — the exact same shape as `github-agent`'s, so any
+  AG-UI client can drive this one too, not just the bundled page.
+- `GET /health` — liveness check.
+
+You can run this alongside WhatsApp mode (`npm run dev` in one terminal,
+`npm run serve` in another) — they're independent processes hitting the
+same `whatsapp-mcp-server`, so either one can send/read messages at any
+time.
+
+## Config
+
+| Env var             | Required               | Notes                                              |
+| -------------------- | ----------------------- | --------------------------------------------------- |
+| `WHATSAPP_MCP_URL`   | no (default `http://localhost:4100`) | where whatsapp-mcp-server is running   |
+| `PORT`               | no (default `3100`)     | browser chat UI / AG-UI server only                  |
+| `PROVIDER`           | no (default `openai`)   | `openai`, `claude`, or `deepseek`                    |
+| `OPENAI_API_KEY`     | when provider=openai    |                                                       |
+| `OPENAI_MODEL`       | no (default `gpt-4.1`)  |                                                       |
+| `ANTHROPIC_API_KEY`  | when provider=claude    |                                                       |
+| `ANTHROPIC_MODEL`    | no (default `claude-sonnet-5`) |                                                |
+| `DEEPSEEK_API_KEY`   | when provider=deepseek  |                                                       |
+| `DEEPSEEK_MODEL`     | no (default `deepseek-chat`) |                                                  |
+
+## Known limitations (v1)
+
+- WhatsApp mode is single-turn per instruction: each self-message is its
+  own fresh prompt, with no memory across separate instructions. The
+  browser chat UI (AG-UI mode) doesn't have this limitation — like
+  `github-agent`, it flattens prior turns in the conversation into a system
+  preamble, so follow-up questions in the same chat session work.
+- Only your own "Message yourself" chat triggers the WhatsApp-mode
+  assistant. Any other incoming message is ignored by design, so it can't
+  be triggered by someone messaging you.
+- `whatsapp-mcp-server`'s chat/message recall is in-memory only (not
+  persisted across restarts) and capped at the last 200 messages per chat —
+  it does get real history via WhatsApp's own backfill-on-connect, just not
+  unbounded history.

package/dist/agui.js

@@ -0,0 +1,88 @@
+import { randomUUID } from "node:crypto";
+import { EventType, contentToText } from "@ag-ui/core";
+import { EventEncoder } from "@ag-ui/encoder";
+import { runAssistantAgent, isProvider } from "./providers.js";
+/**
+ * Mirrors agents/github-agent/src/agui.ts. The agent loop only takes a
+ * single prompt string, not a structured history, so every prior
+ * user/assistant message is flattened into a text transcript passed as a
+ * system preamble, and the most recent user message becomes the prompt.
+ */
+function extractPrompt(messages) {
+    const lastUserIndex = messages.map((m) => m.role).lastIndexOf("user");
+    if (lastUserIndex === -1) {
+        throw new Error("RunAgentInput.messages must include at least one user message");
+    }
+    const lastUser = messages[lastUserIndex];
+    const userPrompt = contentToText(lastUser.content);
+    const transcript = messages
+        .slice(0, lastUserIndex)
+        .filter((m) => m.role === "user" || m.role === "assistant")
+        .map((m) => `${m.role}: ${m.role === "assistant" ? (m.content ?? "") : contentToText(m.content)}`)
+        .filter((line) => line.length > "user: ".length || line.length > "assistant: ".length)
+        .join("\n");
+    return {
+        systemPrompt: transcript ? `Prior conversation for context:\n${transcript}` : undefined,
+        userPrompt,
+    };
+}
+/**
+ * Runs the personal assistant for one AG-UI `RunAgentInput`, streaming the
+ * result to `res` as AG-UI protocol events (SSE by default).
+ */
+export async function runAgUiRequest(params) {
+    const { input, mcpServerUrl, defaultProvider, res, acceptHeader } = params;
+    const encoder = new EventEncoder({ accept: acceptHeader });
+    res.writeHead(200, {
+        "Content-Type": encoder.getContentType(),
+        "Cache-Control": "no-cache, no-transform",
+        Connection: "keep-alive",
+        "X-Accel-Buffering": "no",
+    });
+    const emit = (event) => {
+        res.write(encoder.encode(event));
+    };
+    const threadId = input.threadId ?? randomUUID();
+    const runId = input.runId ?? randomUUID();
+    emit({ type: EventType.RUN_STARTED, threadId, runId });
+    try {
+        const provider = isProvider(input.forwardedProps?.provider) ? input.forwardedProps.provider : defaultProvider;
+        const { systemPrompt, userPrompt } = extractPrompt(input.messages);
+        await runAssistantAgent(provider, {
+            prompt: userPrompt,
+            systemPrompt,
+            mcpServerUrl,
+            onAssistantText: (text) => {
+                const messageId = randomUUID();
+                emit({ type: EventType.TEXT_MESSAGE_START, messageId, role: "assistant" });
+                emit({ type: EventType.TEXT_MESSAGE_CONTENT, messageId, delta: text });
+                emit({ type: EventType.TEXT_MESSAGE_END, messageId });
+            },
+            onToolCall: (name, args, toolCallId) => {
+                emit({ type: EventType.TOOL_CALL_START, toolCallId, toolCallName: name });
+                emit({ type: EventType.TOOL_CALL_ARGS, toolCallId, delta: JSON.stringify(args ?? {}) });
+                emit({ type: EventType.TOOL_CALL_END, toolCallId });
+            },
+            onToolResult: (toolCallId, _name, result) => {
+                emit({
+                    type: EventType.TOOL_CALL_RESULT,
+                    messageId: randomUUID(),
+                    toolCallId,
+                    content: result,
+                    role: "tool",
+                });
+            },
+        });
+        emit({ type: EventType.RUN_FINISHED, threadId, runId });
+    }
+    catch (error) {
+        emit({
+            type: EventType.RUN_ERROR,
+            message: error instanceof Error ? error.message : String(error),
+        });
+    }
+    finally {
+        res.end();
+    }
+}
+//# sourceMappingURL=agui.js.map

package/dist/agui.js.map

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

package/dist/cli.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import "dotenv/config";
+import { startListener } from "./listener.js";
+import { isProvider, PROVIDERS } from "./providers.js";
+function resolveProvider() {
+    const fromEnv = process.env.PROVIDER;
+    if (isProvider(fromEnv))
+        return fromEnv;
+    if (fromEnv) {
+        throw new Error(`PROVIDER must be one of ${PROVIDERS.join(", ")}, got "${fromEnv}"`);
+    }
+    return "openai";
+}
+async function main() {
+    let provider;
+    try {
+        provider = resolveProvider();
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+        return;
+    }
+    const mcpServerUrl = process.env.WHATSAPP_MCP_URL ?? "http://localhost:4100";
+    console.error(`whatsapp-agent starting (initial provider: ${provider}, whatsapp-mcp-server: ${mcpServerUrl})`);
+    await startListener({
+        mcpServerUrl,
+        provider,
+        onLog: (line) => console.error(line),
+    });
+}
+main().catch((error) => {
+    console.error(error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAiB,MAAM,gBAAgB,CAAC;AAEtE,SAAS,eAAe;IACtB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;IACrC,IAAI,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACxC,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,2BAA2B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,OAAO,GAAG,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,eAAe,EAAE,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,uBAAuB,CAAC;IAE7E,OAAO,CAAC,KAAK,CAAC,8CAA8C,QAAQ,0BAA0B,YAAY,GAAG,CAAC,CAAC;IAE/G,MAAM,aAAa,CAAC;QAClB,YAAY;QACZ,QAAQ;QACR,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;KACrC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { runAssistantAgent, whatsappServerConfig, WHATSAPP_SERVER_NAME, isProvider, PROVIDERS } from "./providers.js";
+export { startListener } from "./listener.js";
+export { createServer } from "./server.js";
+export { runAgUiRequest } from "./agui.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEtH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/listener.js

@@ -0,0 +1,93 @@
+import { setTimeout as sleep } from "node:timers/promises";
+import { McpManager } from "@clickonsearch/openai-remote-mcp-bridge";
+import { runAssistantAgent, whatsappServerConfig } from "./providers.js";
+/** Polls the whatsapp-mcp-server's /health until it reports a connected session, returning the self JID. */
+async function waitForSelfId(mcpServerUrl, onLog) {
+    const healthUrl = new URL("/health", mcpServerUrl).toString();
+    for (;;) {
+        try {
+            const res = await fetch(healthUrl);
+            const body = (await res.json());
+            if (body.connected && body.self)
+                return body.self;
+        }
+        catch {
+            // whatsapp-mcp-server isn't up yet
+        }
+        onLog?.("Waiting for whatsapp-mcp-server to report a connected WhatsApp session...");
+        await sleep(2000);
+    }
+}
+/** Delivers the assistant's reply back to the user's own "Message yourself" chat. */
+async function replyToSelf(mcpServerUrl, selfId, text) {
+    const mcp = new McpManager();
+    await mcp.connectAll([whatsappServerConfig(mcpServerUrl)]);
+    try {
+        await mcp.callTool("whatsapp__send_message", { to: selfId, text });
+    }
+    finally {
+        await mcp.closeAll();
+    }
+}
+/**
+ * Connects to the whatsapp-mcp-server's SSE /events stream and watches for
+ * messages the user sent to themselves — that's the "instruction inbox".
+ * Each one runs through the agent loop (with the WhatsApp MCP tools
+ * available) and the final answer is sent back to the same self-chat.
+ *
+ * The provider is fixed for the life of this process (from the PROVIDER
+ * env var) — see agents/whatsapp-agent's AG-UI server if you want to pick
+ * a provider per-request instead.
+ */
+export async function startListener(options) {
+    const { mcpServerUrl, provider, onLog } = options;
+    const selfId = await waitForSelfId(mcpServerUrl, onLog);
+    onLog?.(`Connected. Listening for instructions in your "Message yourself" chat (${selfId}). Provider: ${provider}.`);
+    await replyToSelf(mcpServerUrl, selfId, `Assistant is online (provider: ${provider}).`);
+    const eventsUrl = new URL("/events", mcpServerUrl).toString();
+    const res = await fetch(eventsUrl);
+    if (!res.ok || !res.body) {
+        throw new Error(`Failed to connect to whatsapp-mcp-server's events stream: HTTP ${res.status}`);
+    }
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        buffer += decoder.decode(value, { stream: true });
+        let sep;
+        while ((sep = buffer.indexOf("\n\n")) !== -1) {
+            const frame = buffer.slice(0, sep);
+            buffer = buffer.slice(sep + 2);
+            const line = frame.split("\n").find((l) => l.startsWith("data:"));
+            if (!line)
+                continue;
+            let event;
+            try {
+                event = JSON.parse(line.slice(5).trim());
+            }
+            catch {
+                continue;
+            }
+            if (!event.isSelfChat)
+                continue;
+            onLog?.(`Instruction (${provider}): ${event.text}`);
+            try {
+                const answer = await runAssistantAgent(provider, {
+                    prompt: event.text,
+                    mcpServerUrl,
+                    onToolCall: (name, args) => onLog?.(`  tool call: ${name}(${JSON.stringify(args)})`),
+                });
+                await replyToSelf(mcpServerUrl, selfId, answer.trim() || "Done.");
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                onLog?.(`  error: ${message}`);
+                await replyToSelf(mcpServerUrl, selfId, `Sorry, something went wrong: ${message}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=listener.js.map

package/dist/listener.js.map

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

package/dist/providers.js

@@ -0,0 +1,117 @@
+/**
+ * Mirrors agents/github-agent/src/providers.ts. Adding a new remote MCP
+ * bridge means: add its `runWith*` function below, add it here, and add
+ * its API key/model env vars to the README/.env.example.
+ */
+export const PROVIDERS = ["openai", "claude", "deepseek"];
+export function isProvider(value) {
+    return typeof value === "string" && PROVIDERS.includes(value);
+}
+export const WHATSAPP_SERVER_NAME = "whatsapp";
+/**
+ * `baseUrl` is whatsapp-mcp-server's origin (e.g. "http://localhost:4100"),
+ * the same value used for its /health and /events endpoints elsewhere in
+ * this package — its actual MCP endpoint is at /mcp.
+ */
+export function whatsappServerConfig(baseUrl) {
+    return { name: WHATSAPP_SERVER_NAME, url: new URL("/mcp", baseUrl).toString(), transport: "http" };
+}
+export const DEFAULT_SYSTEM_PROMPT = [
+    "You are a personal WhatsApp assistant. The user just messaged themselves",
+    "on WhatsApp to give you an instruction. You have tools to send WhatsApp",
+    "messages, list chats, read recent messages, and search contacts.",
+    "Complete the requested task using those tools, then reply with a short,",
+    "plain-text summary of what you did (or the answer, if it was a question).",
+    "This summary is sent back to the user as a WhatsApp message, so keep it",
+    "conversational and brief.",
+].join(" ");
+async function runWithOpenAi(options) {
+    const { McpManager, runAgent } = await import("@clickonsearch/openai-remote-mcp-bridge");
+    const { default: OpenAI } = await import("openai");
+    const apiKey = process.env.OPENAI_API_KEY;
+    if (!apiKey) {
+        throw new Error("Missing OPENAI_API_KEY environment variable");
+    }
+    const mcp = new McpManager();
+    await mcp.connectAll([whatsappServerConfig(options.mcpServerUrl)]);
+    try {
+        const openai = new OpenAI({ apiKey });
+        return await runAgent({
+            openai,
+            model: process.env.OPENAI_MODEL ?? "gpt-4.1",
+            systemPrompt: options.systemPrompt ?? DEFAULT_SYSTEM_PROMPT,
+            userPrompt: options.prompt,
+            mcp,
+            onToolCall: options.onToolCall,
+            onToolResult: options.onToolResult,
+            onAssistantText: options.onAssistantText,
+        });
+    }
+    finally {
+        await mcp.closeAll();
+    }
+}
+async function runWithClaude(options) {
+    const { McpManager, runAgent } = await import("@clickonsearch/claude-remote-mcp-bridge");
+    const { default: Anthropic } = await import("@anthropic-ai/sdk");
+    const apiKey = process.env.ANTHROPIC_API_KEY;
+    if (!apiKey) {
+        throw new Error("Missing ANTHROPIC_API_KEY environment variable");
+    }
+    const mcp = new McpManager();
+    await mcp.connectAll([whatsappServerConfig(options.mcpServerUrl)]);
+    try {
+        const anthropic = new Anthropic({ apiKey });
+        return await runAgent({
+            anthropic,
+            model: process.env.ANTHROPIC_MODEL ?? "claude-sonnet-5",
+            systemPrompt: options.systemPrompt ?? DEFAULT_SYSTEM_PROMPT,
+            userPrompt: options.prompt,
+            mcp,
+            onToolCall: options.onToolCall,
+            onToolResult: options.onToolResult,
+            onAssistantText: options.onAssistantText,
+        });
+    }
+    finally {
+        await mcp.closeAll();
+    }
+}
+async function runWithDeepSeek(options) {
+    const { McpManager, runAgent } = await import("@clickonsearch/deepseek-remote-mcp-bridge");
+    const { default: OpenAI } = await import("openai");
+    const apiKey = process.env.DEEPSEEK_API_KEY;
+    if (!apiKey) {
+        throw new Error("Missing DEEPSEEK_API_KEY environment variable");
+    }
+    const mcp = new McpManager();
+    await mcp.connectAll([whatsappServerConfig(options.mcpServerUrl)]);
+    try {
+        const deepseek = new OpenAI({
+            apiKey,
+            baseURL: process.env.DEEPSEEK_BASE_URL ?? "https://api.deepseek.com",
+        });
+        return await runAgent({
+            deepseek,
+            model: process.env.DEEPSEEK_MODEL ?? "deepseek-chat",
+            systemPrompt: options.systemPrompt ?? DEFAULT_SYSTEM_PROMPT,
+            userPrompt: options.prompt,
+            mcp,
+            onToolCall: options.onToolCall,
+            onToolResult: options.onToolResult,
+            onAssistantText: options.onAssistantText,
+        });
+    }
+    finally {
+        await mcp.closeAll();
+    }
+}
+/** Runs the personal assistant through the requested provider's remote MCP bridge. */
+export async function runAssistantAgent(provider, options) {
+    if (provider === "claude")
+        return runWithClaude(options);
+    if (provider === "deepseek")
+        return runWithDeepSeek(options);
+    return runWithOpenAi(options);
+}
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

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

package/dist/server-cli.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import "dotenv/config";
+import { createServer } from "./server.js";
+import { isProvider, PROVIDERS } from "./providers.js";
+function resolveDefaultProvider() {
+    const fromEnv = process.env.PROVIDER;
+    if (isProvider(fromEnv))
+        return fromEnv;
+    if (fromEnv) {
+        throw new Error(`PROVIDER must be one of ${PROVIDERS.join(", ")}, got "${fromEnv}"`);
+    }
+    return "openai";
+}
+function main() {
+    let defaultProvider;
+    try {
+        defaultProvider = resolveDefaultProvider();
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+        return;
+    }
+    const mcpServerUrl = process.env.WHATSAPP_MCP_URL ?? "http://localhost:4100";
+    const port = Number(process.env.PORT ?? 3100);
+    const app = createServer({ mcpServerUrl, defaultProvider });
+    app.listen(port, () => {
+        console.error(`whatsapp-agent AG-UI server listening on http://localhost:${port}`);
+        console.error(`  AG-UI endpoint: POST http://localhost:${port}/agent`);
+        console.error(`  Chat UI:        http://localhost:${port}/`);
+        console.error(`  WhatsApp MCP server: ${mcpServerUrl}`);
+        console.error(`  Default provider: ${defaultProvider} (override per-request via forwardedProps.provider)`);
+    });
+}
+main();
+//# sourceMappingURL=server-cli.js.map

package/dist/server-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-cli.js","sourceRoot":"","sources":["../src/server-cli.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAiB,MAAM,gBAAgB,CAAC;AAEtE,SAAS,sBAAsB;IAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;IACrC,IAAI,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACxC,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,2BAA2B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,OAAO,GAAG,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,IAAI;IACX,IAAI,eAAyB,CAAC;IAC9B,IAAI,CAAC;QACH,eAAe,GAAG,sBAAsB,EAAE,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,uBAAuB,CAAC;IAC7E,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;IAE9C,MAAM,GAAG,GAAG,YAAY,CAAC,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC,CAAC;IAE5D,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QACpB,OAAO,CAAC,KAAK,CAAC,6DAA6D,IAAI,EAAE,CAAC,CAAC;QACnF,OAAO,CAAC,KAAK,CAAC,2CAA2C,IAAI,QAAQ,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,sCAAsC,IAAI,GAAG,CAAC,CAAC;QAC7D,OAAO,CAAC,KAAK,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAC;QACxD,OAAO,CAAC,KAAK,CAAC,uBAAuB,eAAe,qDAAqD,CAAC,CAAC;IAC7G,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/server.js

@@ -0,0 +1,49 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import express from "express";
+import cors from "cors";
+import { runAgUiRequest } from "./agui.js";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export function createServer(options) {
+    const app = express();
+    app.use(cors());
+    app.use(express.json({ limit: "2mb" }));
+    app.use(express.static(path.join(__dirname, "..", "public")));
+    app.get("/health", (_req, res) => {
+        res.json({ ok: true, defaultProvider: options.defaultProvider });
+    });
+    app.post("/agent", async (req, res) => {
+        const body = req.body;
+        if (!body || !Array.isArray(body.messages)) {
+            res.status(400).json({ error: 'Request body must be a RunAgentInput with a "messages" array' });
+            return;
+        }
+        const input = {
+            threadId: body.threadId ?? "",
+            runId: body.runId ?? "",
+            messages: body.messages,
+            tools: body.tools ?? [],
+            context: body.context ?? [],
+            forwardedProps: body.forwardedProps,
+        };
+        try {
+            await runAgUiRequest({
+                input,
+                mcpServerUrl: options.mcpServerUrl,
+                defaultProvider: options.defaultProvider,
+                res,
+                acceptHeader: req.headers.accept,
+            });
+        }
+        catch (error) {
+            if (!res.headersSent) {
+                res.status(500).json({ error: error instanceof Error ? error.message : String(error) });
+            }
+            else {
+                res.end();
+            }
+        }
+    });
+    return app;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAO/D,MAAM,UAAU,YAAY,CAAC,OAA4B;IACvD,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAChB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACxC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE9D,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAC/B,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACpC,MAAM,IAAI,GAAG,GAAG,CAAC,IAA0C,CAAC;QAE5D,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3C,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,8DAA8D,EAAE,CAAC,CAAC;YAChG,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAkB;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;YAC3B,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,cAAc,CAAC;gBACnB,KAAK;gBACL,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,eAAe,EAAE,OAAO,CAAC,eAAe;gBACxC,GAAG;gBACH,YAAY,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM;aACjC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACrB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC1F,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,GAAG,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@clickonsearch/whatsapp-agent",
+  "version": "0.1.0",
+  "description": "Personal WhatsApp assistant, usable two ways: message yourself on WhatsApp to give it instructions, or drive it from a browser chat UI over the AG-UI protocol. Routed through OpenAI, Claude, or DeepSeek depending on preference.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ClickOnSearch/ai-apps.git",
+    "directory": "agents/whatsapp-agent"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "public"
+  ],
+  "main": "dist/index.js",
+  "bin": {
+    "whatsapp-agent": "dist/cli.js",
+    "whatsapp-agent-serve": "dist/server-cli.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/cli.js",
+    "dev": "tsx src/cli.ts",
+    "serve": "node dist/server-cli.js",
+    "dev:serve": "tsx src/server-cli.ts"
+  },
+  "dependencies": {
+    "@clickonsearch/openai-remote-mcp-bridge": "^0.1.0",
+    "@clickonsearch/claude-remote-mcp-bridge": "^0.1.0",
+    "@clickonsearch/deepseek-remote-mcp-bridge": "^0.1.0",
+    "openai": "^4.68.0",
+    "@anthropic-ai/sdk": "^0.32.1",
+    "@ag-ui/core": "^1.0.0",
+    "@ag-ui/encoder": "^1.0.0",
+    "express": "^4.21.1",
+    "cors": "^2.8.5",
+    "dotenv": "^16.4.5"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3",
+    "tsx": "^4.19.1",
+    "@types/node": "^22.7.5",
+    "@types/express": "^4.17.21",
+    "@types/cors": "^2.8.17"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/public/index.html

@@ -0,0 +1,314 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>WhatsApp Assistant</title>
+<style>
+  :root {
+    color-scheme: light dark;
+    --bg: #0b0d12;
+    --panel: #12151c;
+    --border: #232833;
+    --text: #e6e9ef;
+    --muted: #8b93a3;
+    --accent: #25d366;
+    --user-bubble: #1f6feb22;
+    --assistant-bubble: #171b24;
+    --tool-bubble: #1a2a1f;
+    --error-bubble: #3a1414;
+  }
+  * { box-sizing: border-box; }
+  body {
+    margin: 0;
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+    background: var(--bg);
+    color: var(--text);
+    height: 100vh;
+    display: flex;
+    flex-direction: column;
+  }
+  header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 12px 20px;
+    border-bottom: 1px solid var(--border);
+    background: var(--panel);
+  }
+  header h1 {
+    font-size: 15px;
+    font-weight: 600;
+    margin: 0;
+  }
+  header .sub {
+    color: var(--muted);
+    font-size: 12px;
+    margin-top: 2px;
+  }
+  select {
+    background: var(--panel);
+    color: var(--text);
+    border: 1px solid var(--border);
+    border-radius: 6px;
+    padding: 6px 10px;
+    font-size: 13px;
+  }
+  #log {
+    flex: 1;
+    overflow-y: auto;
+    padding: 20px;
+    display: flex;
+    flex-direction: column;
+    gap: 12px;
+    max-width: 820px;
+    width: 100%;
+    margin: 0 auto;
+  }
+  .bubble {
+    padding: 10px 14px;
+    border-radius: 10px;
+    max-width: 100%;
+    white-space: pre-wrap;
+    word-break: break-word;
+    line-height: 1.45;
+    font-size: 14px;
+  }
+  .user { align-self: flex-end; background: var(--user-bubble); border: 1px solid #1f6feb55; }
+  .assistant { align-self: flex-start; background: var(--assistant-bubble); border: 1px solid var(--border); }
+  .tool { align-self: flex-start; background: var(--tool-bubble); border: 1px solid #2f6b3f55; font-size: 12.5px; color: var(--muted); font-family: ui-monospace, monospace; }
+  .tool .name { color: #8fd19e; }
+  .tool .result { display: block; margin-top: 6px; color: var(--text); white-space: pre-wrap; max-height: 220px; overflow-y: auto; }
+  .error { align-self: center; background: var(--error-bubble); border: 1px solid #7a2424; color: #ffb4b4; font-size: 13px; }
+  .status { align-self: flex-start; color: var(--muted); font-size: 12.5px; font-style: italic; }
+  footer {
+    border-top: 1px solid var(--border);
+    background: var(--panel);
+    padding: 14px 20px;
+  }
+  form {
+    max-width: 820px;
+    margin: 0 auto;
+    display: flex;
+    gap: 10px;
+  }
+  textarea {
+    flex: 1;
+    resize: none;
+    background: #0e1117;
+    color: var(--text);
+    border: 1px solid var(--border);
+    border-radius: 8px;
+    padding: 10px 12px;
+    font-size: 14px;
+    font-family: inherit;
+    min-height: 42px;
+    max-height: 160px;
+  }
+  button {
+    background: var(--accent);
+    color: #06210f;
+    border: none;
+    border-radius: 8px;
+    padding: 0 18px;
+    font-size: 14px;
+    font-weight: 600;
+    cursor: pointer;
+  }
+  button:disabled { opacity: 0.5; cursor: default; }
+</style>
+</head>
+<body>
+  <header>
+    <div>
+      <h1>WhatsApp assistant</h1>
+      <div class="sub">talks to your linked WhatsApp account over its MCP server, via an AG-UI protocol stream</div>
+    </div>
+    <select id="provider">
+      <option value="openai">OpenAI</option>
+      <option value="claude">Claude</option>
+      <option value="deepseek">DeepSeek</option>
+    </select>
+  </header>
+
+  <div id="log"></div>
+
+  <footer>
+    <form id="form">
+      <textarea id="input" placeholder="Ask it to check messages, send one, or look someone up..." rows="1"></textarea>
+      <button id="send" type="submit">Send</button>
+    </form>
+  </footer>
+
+<script>
+(() => {
+  const log = document.getElementById("log");
+  const form = document.getElementById("form");
+  const input = document.getElementById("input");
+  const sendButton = document.getElementById("send");
+  const providerSelect = document.getElementById("provider");
+
+  const threadId = crypto.randomUUID();
+  /** @type {{id: string, role: string, content: string}[]} */
+  const messages = [];
+
+  // Reflect the server's actual configured default (PROVIDER env var)
+  // instead of always showing the dropdown's first option.
+  fetch("/health")
+    .then((res) => res.json())
+    .then((data) => {
+      if (data.defaultProvider && providerSelect.querySelector(`option[value="${data.defaultProvider}"]`)) {
+        providerSelect.value = data.defaultProvider;
+      }
+    })
+    .catch(() => {});
+
+  function bubble(className, text) {
+    const el = document.createElement("div");
+    el.className = "bubble " + className;
+    el.textContent = text;
+    log.appendChild(el);
+    log.scrollTop = log.scrollHeight;
+    return el;
+  }
+
+  function setBusy(busy) {
+    sendButton.disabled = busy;
+    input.disabled = busy;
+  }
+
+  async function send(text) {
+    messages.push({ id: crypto.randomUUID(), role: "user", content: text });
+    bubble("user", text);
+
+    setBusy(true);
+    const statusEl = bubble("status", "thinking…");
+
+    const textBubbles = new Map(); // messageId -> { el, buffer }
+    const toolBubbles = new Map(); // toolCallId -> { el, nameEl, resultEl }
+
+    try {
+      const res = await fetch("/agent", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          threadId,
+          runId: crypto.randomUUID(),
+          messages,
+          forwardedProps: { provider: providerSelect.value },
+        }),
+      });
+
+      if (!res.ok || !res.body) {
+        throw new Error(`Request failed: ${res.status} ${res.statusText}`);
+      }
+
+      const reader = res.body.getReader();
+      const decoder = new TextDecoder();
+      let buffer = "";
+
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+
+        let sep;
+        while ((sep = buffer.indexOf("\n\n")) !== -1) {
+          const frame = buffer.slice(0, sep);
+          buffer = buffer.slice(sep + 2);
+          const line = frame.split("\n").find((l) => l.startsWith("data:"));
+          if (!line) continue;
+
+          const event = JSON.parse(line.slice(5).trim());
+          handleEvent(event);
+        }
+      }
+    } catch (err) {
+      bubble("error", String(err));
+    } finally {
+      statusEl.remove();
+      setBusy(false);
+    }
+
+    function handleEvent(event) {
+      switch (event.type) {
+        case "TEXT_MESSAGE_START": {
+          const el = bubble("assistant", "");
+          textBubbles.set(event.messageId, { el, buffer: "" });
+          break;
+        }
+        case "TEXT_MESSAGE_CONTENT": {
+          const entry = textBubbles.get(event.messageId);
+          if (entry) {
+            entry.buffer += event.delta;
+            entry.el.textContent = entry.buffer;
+            log.scrollTop = log.scrollHeight;
+          }
+          break;
+        }
+        case "TEXT_MESSAGE_END": {
+          const entry = textBubbles.get(event.messageId);
+          if (entry) {
+            messages.push({ id: event.messageId, role: "assistant", content: entry.buffer });
+          }
+          break;
+        }
+        case "TOOL_CALL_START": {
+          const el = document.createElement("div");
+          el.className = "bubble tool";
+          const nameEl = document.createElement("span");
+          nameEl.className = "name";
+          nameEl.textContent = "🔧 " + event.toolCallName;
+          el.appendChild(nameEl);
+          const resultEl = document.createElement("span");
+          resultEl.className = "result";
+          resultEl.textContent = "running…";
+          el.appendChild(resultEl);
+          log.appendChild(el);
+          log.scrollTop = log.scrollHeight;
+          toolBubbles.set(event.toolCallId, { el, nameEl, resultEl });
+          break;
+        }
+        case "TOOL_CALL_RESULT": {
+          const entry = toolBubbles.get(event.toolCallId);
+          if (entry) {
+            const text = typeof event.content === "string" ? event.content : JSON.stringify(event.content);
+            entry.resultEl.textContent = text.length > 2000 ? text.slice(0, 2000) + "…" : text;
+            log.scrollTop = log.scrollHeight;
+          }
+          break;
+        }
+        case "RUN_ERROR": {
+          bubble("error", event.message);
+          break;
+        }
+        default:
+          break;
+      }
+    }
+  }
+
+  form.addEventListener("submit", (e) => {
+    e.preventDefault();
+    const text = input.value.trim();
+    if (!text) return;
+    input.value = "";
+    input.style.height = "auto";
+    send(text);
+  });
+
+  input.addEventListener("keydown", (e) => {
+    if (e.key === "Enter" && !e.shiftKey) {
+      e.preventDefault();
+      form.requestSubmit();
+    }
+  });
+
+  input.addEventListener("input", () => {
+    input.style.height = "auto";
+    input.style.height = Math.min(input.scrollHeight, 160) + "px";
+  });
+})();
+</script>
+</body>
+</html>