@wahooks/channel 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -6,13 +6,13 @@
  * Messages from WhatsApp appear as <channel> events; Claude replies
  * via the reply tool and messages are sent back through WhatsApp.
  *
- * Usage:
- *   claude --dangerously-load-development-channels server:wahooks-channel
+ * Setup:
+ *   /wahooks:configure <api-key>
  *
- * Environment:
+ * Or set environment variables:
  *   WAHOOKS_API_KEY     — WAHooks API token (wh_...)
  *   WAHOOKS_API_URL     — API base URL (default: https://api.wahooks.com)
- *   WAHOOKS_CONNECTION  — Connection ID to use (auto-detected if only one)
+ *   WAHOOKS_CONNECTION  — Connection ID (auto-detected if only one)
  *   WAHOOKS_ALLOW       — Comma-separated phone numbers to accept (empty = all)
  */
 export {};

package/dist/index.js

@@ -6,30 +6,88 @@
  * Messages from WhatsApp appear as <channel> events; Claude replies
  * via the reply tool and messages are sent back through WhatsApp.
  *
- * Usage:
- *   claude --dangerously-load-development-channels server:wahooks-channel
+ * Setup:
+ *   /wahooks:configure <api-key>
  *
- * Environment:
+ * Or set environment variables:
  *   WAHOOKS_API_KEY     — WAHooks API token (wh_...)
  *   WAHOOKS_API_URL     — API base URL (default: https://api.wahooks.com)
- *   WAHOOKS_CONNECTION  — Connection ID to use (auto-detected if only one)
+ *   WAHOOKS_CONNECTION  — Connection ID (auto-detected if only one)
  *   WAHOOKS_ALLOW       — Comma-separated phone numbers to accept (empty = all)
  */
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { ListToolsRequestSchema, CallToolRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import http from "node:http";
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
 // ─── Config ─────────────────────────────────────────────────────────────
-const API_KEY = process.env.WAHOOKS_API_KEY ?? "";
-const API_URL = (process.env.WAHOOKS_API_URL ?? "https://api.wahooks.com").replace(/\/$/, "");
-const CONNECTION_ID = process.env.WAHOOKS_CONNECTION ?? "";
-const ALLOW_LIST = new Set((process.env.WAHOOKS_ALLOW ?? "")
+const CONFIG_DIR = path.join(os.homedir(), ".claude", "channels", "wahooks");
+const ENV_FILE = path.join(CONFIG_DIR, ".env");
+/** Load config from ~/.claude/channels/wahooks/.env, then overlay env vars */
+function loadConfig() {
+    const config = {};
+    // Read stored config file
+    if (fs.existsSync(ENV_FILE)) {
+        const lines = fs.readFileSync(ENV_FILE, "utf-8").split("\n");
+        for (const line of lines) {
+            const match = line.match(/^([A-Z_]+)=(.*)$/);
+            if (match)
+                config[match[1]] = match[2];
+        }
+    }
+    // Env vars override file config
+    for (const key of ["WAHOOKS_API_KEY", "WAHOOKS_API_URL", "WAHOOKS_CONNECTION", "WAHOOKS_ALLOW", "WAHOOKS_CHANNEL_PORT"]) {
+        if (process.env[key])
+            config[key] = process.env[key];
+    }
+    return config;
+}
+/** Save config to ~/.claude/channels/wahooks/.env */
+function saveConfig(key, value) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    const config = {};
+    if (fs.existsSync(ENV_FILE)) {
+        const lines = fs.readFileSync(ENV_FILE, "utf-8").split("\n");
+        for (const line of lines) {
+            const match = line.match(/^([A-Z_]+)=(.*)$/);
+            if (match)
+                config[match[1]] = match[2];
+        }
+    }
+    config[key] = value;
+    const content = Object.entries(config)
+        .map(([k, v]) => `${k}=${v}`)
+        .join("\n");
+    fs.writeFileSync(ENV_FILE, content + "\n", { mode: 0o600 });
+}
+// Handle configure command: wahooks-channel --configure <api-key>
+if (process.argv[2] === "--configure") {
+    const apiKey = process.argv[3];
+    if (!apiKey) {
+        console.error("Usage: wahooks-channel --configure <api-key>");
+        process.exit(1);
+    }
+    saveConfig("WAHOOKS_API_KEY", apiKey);
+    if (process.argv[4])
+        saveConfig("WAHOOKS_CONNECTION", process.argv[4]);
+    console.error(`Saved WAHooks API key to ${ENV_FILE}`);
+    process.exit(0);
+}
+const cfg = loadConfig();
+const API_KEY = cfg.WAHOOKS_API_KEY ?? "";
+const API_URL = (cfg.WAHOOKS_API_URL ?? "https://api.wahooks.com").replace(/\/$/, "");
+const CONNECTION_ID = cfg.WAHOOKS_CONNECTION ?? "";
+const ALLOW_LIST = new Set((cfg.WAHOOKS_ALLOW ?? "")
     .split(",")
     .map((s) => s.trim().replace(/\D/g, ""))
     .filter(Boolean));
-const WEBHOOK_PORT = parseInt(process.env.WAHOOKS_CHANNEL_PORT ?? "8790", 10);
+const WEBHOOK_PORT = parseInt(cfg.WAHOOKS_CHANNEL_PORT ?? "8790", 10);
 if (!API_KEY) {
-    console.error("[wahooks-channel] WAHOOKS_API_KEY is required");
+    console.error("[wahooks-channel] No API key found.");
+    console.error("[wahooks-channel] Run: wahooks-channel --configure <your-api-key>");
+    console.error("[wahooks-channel] Or set WAHOOKS_API_KEY environment variable");
     process.exit(1);
 }
 // ─── WAHooks API helpers ────────────────────────────────────────────────
@@ -68,21 +126,52 @@ async function resolveConnection() {
 }
 // ─── State ──────────────────────────────────────────────────────────────
 let connectionId;
-// Track inbound message → sender mapping for replies
-const messageToSender = new Map();
 // ─── MCP Server ─────────────────────────────────────────────────────────
 const mcp = new Server({ name: "wahooks-channel", version: "0.1.0" }, {
     capabilities: {
-        experimental: { "claude/channel": {} },
+        experimental: {
+            "claude/channel": {},
+            "claude/channel/permission": {},
+        },
         tools: {},
     },
     instructions: [
         "WhatsApp messages arrive as <channel source=\"wahooks-channel\" from=\"phone\" message_id=\"id\">.",
-        "Use the wahooks_reply tool to send responses back. Pass the from phone number.",
-        "Use wahooks_send_image / wahooks_send_document to send media.",
-        "You can also proactively message any phone with wahooks_send.",
+        "Use wahooks_reply to respond to the sender. Use wahooks_send to message any phone.",
+        "Media tools: wahooks_send_image, wahooks_send_video, wahooks_send_audio, wahooks_send_document.",
+        "Also available: wahooks_send_location (lat/lng) and wahooks_send_contact (name/phone).",
+        "For permission requests, the user can reply 'yes XXXXX' or 'no XXXXX' where XXXXX is the request ID.",
     ].join(" "),
 });
+// ─── Permission relay ───────────────────────────────────────────────────
+const PERMISSION_RE = /^\s*(y|yes|n|no)\s+([a-km-z]{5})\s*$/i;
+// Track the last sender so we can forward permission requests
+let lastSender = "";
+// Listen for permission requests from Claude Code
+const PermissionRequestSchema = {
+    method: "notifications/claude/channel/permission_request",
+};
+mcp.setNotificationHandler(PermissionRequestSchema, async (notification) => {
+    const params = notification.params;
+    if (!lastSender || !connectionId)
+        return;
+    // Forward the permission request to the WhatsApp user
+    const msg = [
+        `🔐 Claude wants to run: ${params.tool_name}`,
+        `${params.description}`,
+        ``,
+        `Reply "yes ${params.request_id}" to allow or "no ${params.request_id}" to deny`,
+    ].join("\n");
+    try {
+        await api("POST", `/connections/${connectionId}/send`, {
+            chatId: `${lastSender}@s.whatsapp.net`,
+            text: msg,
+        });
+    }
+    catch {
+        console.error("[wahooks-channel] Failed to forward permission request");
+    }
+});
 // ─── Tools ──────────────────────────────────────────────────────────────
 mcp.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
@@ -136,6 +225,59 @@ mcp.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: ["to", "url"],
             },
         },
+        {
+            name: "wahooks_send_video",
+            description: "Send a video via WhatsApp.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    to: { type: "string", description: "Phone number" },
+                    url: { type: "string", description: "Video URL" },
+                    caption: { type: "string", description: "Optional caption" },
+                },
+                required: ["to", "url"],
+            },
+        },
+        {
+            name: "wahooks_send_audio",
+            description: "Send an audio/voice message via WhatsApp.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    to: { type: "string", description: "Phone number" },
+                    url: { type: "string", description: "Audio URL" },
+                },
+                required: ["to", "url"],
+            },
+        },
+        {
+            name: "wahooks_send_location",
+            description: "Send a location pin via WhatsApp.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    to: { type: "string", description: "Phone number" },
+                    latitude: { type: "number", description: "Latitude" },
+                    longitude: { type: "number", description: "Longitude" },
+                    name: { type: "string", description: "Location name" },
+                    address: { type: "string", description: "Address" },
+                },
+                required: ["to", "latitude", "longitude"],
+            },
+        },
+        {
+            name: "wahooks_send_contact",
+            description: "Send a contact card via WhatsApp.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    to: { type: "string", description: "Phone number" },
+                    contact_name: { type: "string", description: "Contact's display name" },
+                    contact_phone: { type: "string", description: "Contact's phone number" },
+                },
+                required: ["to", "contact_name", "contact_phone"],
+            },
+        },
     ],
 }));
 function toChatId(phone) {
@@ -169,6 +311,39 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
             });
             return { content: [{ type: "text", text: `Document sent to ${args.to}` }] };
         }
+        case "wahooks_send_video": {
+            await api("POST", `/connections/${connectionId}/send-video`, {
+                chatId: toChatId(args.to),
+                url: args.url,
+                caption: args.caption,
+            });
+            return { content: [{ type: "text", text: `Video sent to ${args.to}` }] };
+        }
+        case "wahooks_send_audio": {
+            await api("POST", `/connections/${connectionId}/send-audio`, {
+                chatId: toChatId(args.to),
+                url: args.url,
+            });
+            return { content: [{ type: "text", text: `Audio sent to ${args.to}` }] };
+        }
+        case "wahooks_send_location": {
+            await api("POST", `/connections/${connectionId}/send-location`, {
+                chatId: toChatId(args.to),
+                latitude: parseFloat(args.latitude),
+                longitude: parseFloat(args.longitude),
+                name: args.name,
+                address: args.address,
+            });
+            return { content: [{ type: "text", text: `Location sent to ${args.to}` }] };
+        }
+        case "wahooks_send_contact": {
+            await api("POST", `/connections/${connectionId}/send-contact`, {
+                chatId: toChatId(args.to),
+                contactName: args.contact_name,
+                contactPhone: args.contact_phone,
+            });
+            return { content: [{ type: "text", text: `Contact sent to ${args.to}` }] };
+        }
         default:
             throw new Error(`Unknown tool: ${req.params.name}`);
     }
@@ -210,8 +385,23 @@ function startWebhookServer() {
                     res.end("ok");
                     return;
                 }
-                // Track sender for replies
-                messageToSender.set(messageId, from);
+                // Track last sender for permission relay
+                lastSender = from;
+                // Check if this is a permission verdict
+                const permMatch = PERMISSION_RE.exec(text);
+                if (permMatch) {
+                    await mcp.notification({
+                        method: "notifications/claude/channel/permission",
+                        params: {
+                            request_id: permMatch[2].toLowerCase(),
+                            behavior: permMatch[1].toLowerCase().startsWith("y") ? "allow" : "deny",
+                        },
+                    });
+                    console.error(`[wahooks-channel] Permission verdict: ${permMatch[1]} ${permMatch[2]}`);
+                    res.writeHead(200);
+                    res.end("ok");
+                    return;
+                }
                 // Forward to Claude Code
                 await mcp.notification({
                     method: "notifications/claude/channel",
@@ -236,25 +426,8 @@ function startWebhookServer() {
     });
     server.listen(WEBHOOK_PORT, "127.0.0.1", () => {
         console.error(`[wahooks-channel] Webhook server listening on http://127.0.0.1:${WEBHOOK_PORT}`);
-        console.error(`[wahooks-channel] Configure WAHooks webhook URL: http://localhost:${WEBHOOK_PORT}/webhook`);
     });
 }
-// ─── Setup webhook on WAHooks ───────────────────────────────────────────
-async function ensureWebhook() {
-    try {
-        const webhooks = await api("GET", `/connections/${connectionId}/webhooks`);
-        const localUrl = `http://localhost:${WEBHOOK_PORT}/webhook`;
-        const existing = webhooks.find((w) => w.url === localUrl);
-        if (!existing) {
-            console.error("[wahooks-channel] Note: set up a webhook pointing to this server.");
-            console.error(`[wahooks-channel] URL: ${localUrl}`);
-            console.error("[wahooks-channel] Events: message, message.any");
-        }
-    }
-    catch {
-        // Non-critical
-    }
-}
 // ─── Main ───────────────────────────────────────────────────────────────
 async function main() {
     connectionId = await resolveConnection();
@@ -264,7 +437,6 @@ async function main() {
     await mcp.connect(transport);
     // Start webhook receiver
     startWebhookServer();
-    await ensureWebhook();
     console.error("[wahooks-channel] Ready — WhatsApp messages will appear in Claude Code");
 }
 main().catch((err) => {

package/manifest.json

@@ -0,0 +1,20 @@
+{
+  "name": "wahooks",
+  "version": "0.1.0",
+  "description": "WhatsApp channel for Claude Code — chat with Claude via WhatsApp using WAHooks",
+  "channels": [
+    {
+      "name": "wahooks-channel",
+      "command": "node",
+      "args": ["./dist/index.js"]
+    }
+  ],
+  "skills": [
+    {
+      "name": "configure",
+      "description": "Configure your WAHooks API key for the WhatsApp channel",
+      "command": "node",
+      "args": ["./dist/index.js", "--configure"]
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wahooks/channel",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "WhatsApp channel for Claude Code — chat with Claude via WhatsApp",
   "type": "module",
   "bin": {
@@ -11,7 +11,7 @@
     "build": "tsc",
     "prepublishOnly": "npm run build"
   },
-  "files": ["dist"],
+  "files": ["dist", "manifest.json"],
   "keywords": ["wahooks", "whatsapp", "claude-code", "channel", "mcp"],
   "license": "MIT",
   "repository": {