npm - voicecc - Versions diffs - 1.2.13 → 1.3.1 - Mend

voicecc 1.2.13 → 1.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (22) hide show

package/dashboard/dist/assets/index-ZP9Js-Pi.js +28 -0
package/dashboard/dist/index.html +1 -1
package/dashboard/routes/agents.ts +23 -1
package/dashboard/routes/chat.test.ts +94 -0
package/dashboard/routes/chat.ts +14 -7
package/dashboard/routes/integrations.ts +12 -1
package/dashboard/routes/whatsapp.ts +98 -0
package/dashboard/server.ts +2 -0
package/package.json +2 -1
package/server/index.ts +12 -0
package/server/services/agent-store.ts +1 -0
package/server/services/whatsapp-groups.ts +289 -0
package/server/services/whatsapp-integration.test.ts +343 -0
package/server/services/whatsapp-manager.ts +395 -0
package/server/services/whatsapp-message-handler.test.ts +272 -0
package/server/services/whatsapp-message-handler.ts +429 -0
package/voice-server/claude_session.py +68 -14
package/voice-server/config.py +8 -1
package/voice-server/config_reload_test.py +96 -0
package/voice-server/heartbeat.py +84 -23
package/voice-server/server.py +24 -24
package/dashboard/dist/assets/index-DbjqXBdo.js +0 -28

package/dashboard/dist/index.html CHANGED Viewed

@@ -4,7 +4,7 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Claude Voice</title>
-    <script type="module" crossorigin src="/assets/index-DbjqXBdo.js"></script>
+    <script type="module" crossorigin src="/assets/index-ZP9Js-Pi.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-DeN1WDo9.css">
   </head>
   <body>

package/dashboard/routes/agents.ts CHANGED Viewed

@@ -24,6 +24,8 @@ import {
 import type { AgentConfig } from "../../server/services/agent-store.js";
 import { readEnv } from "../../server/services/env.js";
 import { getTunnelUrl } from "../../server/services/tunnel.js";
+import { syncGroupsForNewAgent, syncGroupsForDeletedAgent } from "../../server/services/whatsapp-groups.js";
+import { isConnected as isWhatsAppConnected } from "../../server/services/whatsapp-manager.js";
 /** Base URL for the Python voice server API */
 const VOICE_API_URL = process.env.VOICE_SERVER_URL ?? "http://localhost:7861";
@@ -125,10 +127,20 @@ export function agentsRoutes(): Hono {
     try {
       await createAgent(body.id, body.soulMd, body.heartbeatMd, body.config);
-      return c.json({ success: true });
     } catch (err) {
       return c.json({ error: (err as Error).message }, 400);
     }
+    // Sync WhatsApp group if connected (non-blocking)
+    if (isWhatsAppConnected()) {
+      try {
+        await syncGroupsForNewAgent(body.id);
+      } catch (err) {
+        console.error(`[agents] Failed to create WhatsApp group for "${body.id}": ${(err as Error).message}`);
+      }
+    }
+    return c.json({ success: true });
   });
   /** Update an agent's config */
@@ -146,6 +158,16 @@ export function agentsRoutes(): Hono {
   /** Delete an agent by ID */
   app.delete("/:id", async (c) => {
     const id = c.req.param("id");
+    // Leave WhatsApp group before deleting agent (non-blocking)
+    if (isWhatsAppConnected()) {
+      try {
+        await syncGroupsForDeletedAgent(id);
+      } catch (err) {
+        console.error(`[agents] Failed to leave WhatsApp group for "${id}": ${(err as Error).message}`);
+      }
+    }
     try {
       await deleteAgent(id);
       return c.json({ success: true });

package/dashboard/routes/chat.test.ts ADDED Viewed

@@ -0,0 +1,94 @@
+/**
+ * Tests for chat proxy route -- verifies resumeSessionId forwarding.
+ *
+ * Run: npx tsx --test dashboard/routes/chat.test.ts
+ */
+import { test, describe, afterEach } from "node:test";
+import { strict as assert } from "node:assert";
+import { chatRoutes } from "./chat.js";
+// ============================================================================
+// HELPERS
+// ============================================================================
+const originalFetch = globalThis.fetch;
+/** Restore global fetch after each test */
+afterEach(() => {
+  globalThis.fetch = originalFetch;
+});
+/**
+ * Build a Hono Request to POST /send with the given JSON body.
+ * Uses x-forwarded-for: 127.0.0.1 to bypass device token validation.
+ *
+ * @param body - JSON body to send
+ * @returns Response from the Hono app
+ */
+async function postSend(body: Record<string, unknown>): Promise<Response> {
+  const app = chatRoutes();
+  const req = new Request("http://localhost/send", {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "x-forwarded-for": "127.0.0.1",
+    },
+    body: JSON.stringify(body),
+  });
+  return app.request(req);
+}
+// ============================================================================
+// TESTS
+// ============================================================================
+describe("POST /send - resumeSessionId forwarding", () => {
+  test("forwards resumeSessionId as resume_session_id to Python", async () => {
+    let capturedBody: Record<string, unknown> | undefined;
+    globalThis.fetch = async (input: RequestInfo | URL, init?: RequestInit) => {
+      const bodyText = typeof init?.body === "string" ? init.body : "";
+      capturedBody = JSON.parse(bodyText);
+      // Return a minimal SSE response so the handler succeeds
+      return new Response("data: done\n\n", {
+        status: 200,
+        headers: { "Content-Type": "text/event-stream" },
+      });
+    };
+    await postSend({
+      token: "test-token",
+      agentId: "agent-1",
+      text: "hello",
+      resumeSessionId: "ses_abc123",
+    });
+    assert.ok(capturedBody, "fetch should have been called");
+    assert.equal(capturedBody!.resume_session_id, "ses_abc123");
+    assert.equal(capturedBody!.session_key, "test-token");
+    assert.equal(capturedBody!.text, "hello");
+  });
+  test("omits resume_session_id when resumeSessionId is absent", async () => {
+    let capturedBody: Record<string, unknown> | undefined;
+    globalThis.fetch = async (input: RequestInfo | URL, init?: RequestInit) => {
+      const bodyText = typeof init?.body === "string" ? init.body : "";
+      capturedBody = JSON.parse(bodyText);
+      return new Response("data: done\n\n", {
+        status: 200,
+        headers: { "Content-Type": "text/event-stream" },
+      });
+    };
+    await postSend({
+      token: "test-token",
+      text: "hello",
+    });
+    assert.ok(capturedBody, "fetch should have been called");
+    assert.equal("resume_session_id" in capturedBody!, false, "resume_session_id should not be present");
+  });
+});

package/dashboard/routes/chat.ts CHANGED Viewed

@@ -30,6 +30,7 @@ interface ChatSendBody {
   token: string;
   agentId?: string;
   text: string;
+  resumeSessionId?: string;
 }
 /** Request body for POST /stop and /close */
@@ -66,24 +67,30 @@ export function chatRoutes(): Hono {
       return c.json({ error: "Missing 'token' field" }, 400);
     }
-    // Validate device token (localhost bypass via x-forwarded-for)
+    // Validate device token (localhost bypass via x-forwarded-for, resume bypass for dashboard)
     const forwarded = c.req.header("x-forwarded-for") ?? "";
     const isLocalhost = forwarded === "127.0.0.1";
+    const isResumeFlow = !!body.resumeSessionId;
-    if (!isLocalhost && !isValidDeviceToken(body.token)) {
+    if (!isLocalhost && !isResumeFlow && !isValidDeviceToken(body.token)) {
       return c.json({ error: "Invalid device token" }, 401);
     }
     // Proxy to Python server
     try {
+      const pythonBody: Record<string, string | undefined> = {
+        session_key: body.token,
+        agent_id: body.agentId,
+        text: body.text.trim(),
+      };
+      if (body.resumeSessionId) {
+        pythonBody.resume_session_id = body.resumeSessionId;
+      }
       const response = await fetch(`${VOICE_SERVER_URL}/chat/send`, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-          session_key: body.token,
-          agent_id: body.agentId,
-          text: body.text.trim(),
-        }),
+        body: JSON.stringify(pythonBody),
       });
       if (!response.ok && !response.headers.get("content-type")?.includes("text/event-stream")) {

package/dashboard/routes/integrations.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 /**
  * Integration enable/disable API routes.
  *
- * Manages the enabled state of toggleable integrations (Twilio).
+ * Manages the enabled state of toggleable integrations (Twilio, WhatsApp).
  * Browser calling is always enabled and not toggleable.
  *
  * - GET / -- returns enabled state for each integration
@@ -12,6 +12,7 @@ import { Hono } from "hono";
 import { readEnv, writeEnvKey } from "../../server/services/env.js";
 import { startTwilioServer, stopTwilioServer, isRunning as isTwilioRunning } from "../../server/services/twilio-manager.js";
 import { isTunnelRunning, getTunnelUrl } from "../../server/services/tunnel.js";
+import { startWhatsApp, stopWhatsApp } from "../../server/services/whatsapp-manager.js";
 // ============================================================================
 // CONSTANTS
@@ -20,6 +21,7 @@ import { isTunnelRunning, getTunnelUrl } from "../../server/services/tunnel.js";
 /** Map of integration names to their .env key */
 const INTEGRATION_ENV_KEYS: Record<string, string> = {
   twilio: "TWILIO_ENABLED",
+  whatsapp: "WHATSAPP_ENABLED",
 };
 // ============================================================================
@@ -55,6 +57,7 @@ export function integrationsRoutes(): Hono {
     const envVars = await readEnv();
     return c.json({
       twilio: { enabled: envVars.TWILIO_ENABLED === "true" },
+      whatsapp: { enabled: envVars.WHATSAPP_ENABLED === "true" },
     });
   });
@@ -113,6 +116,10 @@ async function startIntegration(name: string): Promise<void> {
       await startTwilioServer(dashboardPort, getTunnelUrl() ?? undefined);
     }
   }
+  if (name === "whatsapp") {
+    await startWhatsApp();
+  }
 }
 /**
@@ -124,4 +131,8 @@ function stopIntegration(name: string): void {
   if (name === "twilio") {
     stopTwilioServer();
   }
+  if (name === "whatsapp") {
+    stopWhatsApp();
+  }
 }

package/dashboard/routes/whatsapp.ts ADDED Viewed

@@ -0,0 +1,98 @@
+/**
+ * WhatsApp management API routes.
+ *
+ * Provides endpoints for checking WhatsApp connection status (including QR code),
+ * listing current group-to-agent mappings, and sending outbound messages.
+ *
+ * Responsibilities:
+ * - GET /status -- returns connection state and QR code string
+ * - GET /groups -- lists current group mappings with agent IDs
+ * - POST /send -- sends a message to an agent's WhatsApp group (used by heartbeat)
+ */
+import { Hono } from "hono";
+import { getConnectionState, isConnected, getSocket } from "../../server/services/whatsapp-manager.js";
+import { loadMappings, findMappingByAgentId } from "../../server/services/whatsapp-groups.js";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { homedir } from "node:os";
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+/** Path to the persisted group mappings file */
+const MAPPINGS_FILE_PATH = join(
+  process.env.VOICECC_DIR ?? join(homedir(), ".voicecc"),
+  "whatsapp",
+  "group-mappings.json"
+);
+// ============================================================================
+// ROUTES
+// ============================================================================
+/**
+ * Create Hono route group for WhatsApp operations.
+ *
+ * @returns Hono instance with GET /status, GET /groups, and POST /send routes
+ */
+export function whatsappRoutes(): Hono {
+  const app = new Hono();
+  /** Get WhatsApp connection state and QR code string */
+  app.get("/status", (c) => {
+    const state = getConnectionState();
+    return c.json(state);
+  });
+  /** List current group mappings with agent IDs */
+  app.get("/groups", async (c) => {
+    try {
+      const raw = await readFile(MAPPINGS_FILE_PATH, "utf-8");
+      const groups = JSON.parse(raw);
+      return c.json({ groups });
+    } catch {
+      // No mappings file yet -- return empty list
+      return c.json({ groups: [] });
+    }
+  });
+  /**
+   * Send a message to an agent's WhatsApp group.
+   * Used by the Python heartbeat when outboundChannel is "whatsapp".
+   *
+   * Body: { agentId: string, text: string }
+   * Returns 404 if no group mapping found, 503 if WhatsApp not connected.
+   */
+  app.post("/send", async (c) => {
+    const body = await c.req.json<{ agentId: string; text: string }>();
+    const { agentId, text } = body;
+    if (!agentId || !text) {
+      return c.json({ error: "agentId and text are required" }, 400);
+    }
+    if (!isConnected()) {
+      return c.json({ error: "WhatsApp is not connected" }, 503);
+    }
+    const sock = getSocket();
+    if (!sock) {
+      return c.json({ error: "WhatsApp socket not available" }, 503);
+    }
+    // Reverse lookup: find the groupJid for this agentId
+    const mapping = findMappingByAgentId(agentId);
+    if (!mapping) {
+      return c.json({ error: `No WhatsApp group mapping found for agent "${agentId}"` }, 404);
+    }
+    await sock.sendMessage(mapping.groupJid, { text: `[voicecc] ${text}` });
+    console.log(`[whatsapp] Sent outbound message to group ${mapping.groupJid} for agent "${agentId}"`);
+    return c.json({ ok: true });
+  });
+  return app;
+}

package/dashboard/server.ts CHANGED Viewed

@@ -35,6 +35,7 @@ import { agentsRoutes } from "./routes/agents.js";
 import { versionRoutes } from "./routes/version.js";
 import { chatRoutes } from "./routes/chat.js";
 import { voiceRoutes } from "./routes/voice.js";
+import { whatsappRoutes } from "./routes/whatsapp.js";
 import { loadDeviceTokens } from "../server/services/device-pairing.js";
 // ============================================================================
@@ -90,6 +91,7 @@ export function createApp(): Hono {
   app.route("/api/version", versionRoutes());
   app.route("/api/chat", chatRoutes());
   app.route("/api/voice", voiceRoutes());
+  app.route("/api/whatsapp", whatsappRoutes());
   // Status endpoint (user CLAUDE.md conflict check)
   app.get("/api/status", async (c) => {

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "voicecc",
-  "version": "1.2.13",
+  "version": "1.3.1",
   "description": "Voice Agent Platform running on Claude Code -- create and deploy conversational voice agents with ElevenLabs STT/TTS and VAD",
   "repository": {
     "type": "git",
@@ -40,6 +40,7 @@
     "@anthropic-ai/sdk": "^0.39.0",
     "@hono/node-server": "^1.19.9",
     "archiver": "^7.0.1",
+    "baileys": "6.7.21",
     "cloudflared": "^0.7.1",
     "dotenv": "^16.4.0",
     "hono": "^4.12.0",

package/server/index.ts CHANGED Viewed

@@ -33,6 +33,7 @@ import { startDashboard } from "../dashboard/server.js";
 import { readEnv } from "./services/env.js";
 import { startTunnel, stopTunnel, isTunnelRunning, getTunnelUrl } from "./services/tunnel.js";
 import { startTwilioServer } from "./services/twilio-manager.js";
+import { startWhatsApp, stopWhatsApp } from "./services/whatsapp-manager.js";
 /** Base URL for the Python FastAPI server (for tunnel URL notification) */
 const VOICE_SERVER_API_URL = process.env.VOICE_SERVER_URL ?? "http://localhost:7861";
@@ -252,10 +253,21 @@ async function main(): Promise<void> {
     }
   }
+  // Auto-start WhatsApp if enabled
+  if (envVars.WHATSAPP_ENABLED === "true") {
+    console.log("WhatsApp integration enabled, starting...");
+    try {
+      await startWhatsApp();
+    } catch (err) {
+      console.error(`WhatsApp auto-start failed: ${err}`);
+    }
+  }
   // Graceful shutdown: stop tunnel subprocess, then clean up status file
   const shutdown = () => {
     stopPythonVoiceServer();
     stopTunnel();
+    stopWhatsApp();
     cleanupStatusFile();
     process.exit(0);
   };

package/server/services/agent-store.ts CHANGED Viewed

@@ -58,6 +58,7 @@ export interface AgentConfig {
   heartbeatTimeoutMinutes?: number;
   enabled: boolean;
   voice?: AgentVoiceConfig;
+  outboundChannel?: "call" | "whatsapp";
 }
 /** Full agent data including all file contents */