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

voicecc 1.2.13 → 1.3.0

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 (19) hide show

package/dashboard/dist/assets/index-CVP_3PYo.js +28 -0
package/dashboard/dist/index.html +1 -1
package/dashboard/routes/agents.ts +23 -1
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 +7 -0
package/voice-server/heartbeat.py +72 -5
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-CVP_3PYo.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/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.0",
   "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 */

package/server/services/whatsapp-groups.ts ADDED Viewed

@@ -0,0 +1,289 @@
+/**
+ * WhatsApp group management for VoiceCC agents.
+ *
+ * Manages the mapping between VoiceCC agents and WhatsApp groups,
+ * and persists mappings + session IDs to disk for resume support.
+ *
+ * Responsibilities:
+ * - Create/leave WhatsApp groups when agents are created/deleted
+ * - Sync all agent groups on WhatsApp connect (with duplicate detection)
+ * - Map groupJid to agentId for incoming message routing
+ * - Store/retrieve Claude session IDs per group for conversation resume
+ * - Persist mappings to ~/.voicecc/whatsapp/group-mappings.json
+ */
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
+import { getSocket } from "./whatsapp-manager.js";
+import { listAgents } from "./agent-store.js";
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+/** Prefix used for all VoiceCC WhatsApp group names */
+const GROUP_NAME_PREFIX = "[VoiceCC] ";
+/** Path to the persisted group mappings file */
+const MAPPINGS_FILE_PATH = join(
+  process.env.VOICECC_DIR ?? join(homedir(), ".voicecc"),
+  "whatsapp",
+  "group-mappings.json"
+);
+// ============================================================================
+// TYPES
+// ============================================================================
+/** Mapping between a WhatsApp group and a VoiceCC agent */
+export interface GroupMapping {
+  groupJid: string;
+  agentId: string;
+  lastSessionId: string | null;
+}
+// ============================================================================
+// STATE
+// ============================================================================
+/** In-memory mappings indexed by groupJid */
+let mappings: Map<string, GroupMapping> = new Map();
+// ============================================================================
+// MAIN HANDLERS
+// ============================================================================
+/**
+ * Create a WhatsApp group for a new agent and register the mapping.
+ * Requires an active Baileys socket connection.
+ *
+ * @param agentId - The agent identifier to create a group for
+ */
+export async function syncGroupsForNewAgent(agentId: string): Promise<void> {
+  const sock = getSocket();
+  if (!sock) {
+    throw new Error("WhatsApp socket is not connected");
+  }
+  // Check if a mapping already exists for this agent
+  const existing = findMappingByAgentId(agentId);
+  if (existing) {
+    console.log(`WhatsApp group already exists for agent "${agentId}" (${existing.groupJid})`);
+    return;
+  }
+  const groupName = formatGroupName(agentId);
+  const result = await sock.groupCreate(groupName, []);
+  const mapping: GroupMapping = {
+    groupJid: result.id,
+    agentId,
+    lastSessionId: null,
+  };
+  mappings.set(result.id, mapping);
+  await saveMappings();
+  console.log(`Created WhatsApp group "${groupName}" (${result.id}) for agent "${agentId}"`);
+}
+/**
+ * Leave the WhatsApp group for a deleted agent and remove the mapping.
+ * Requires an active Baileys socket connection.
+ *
+ * @param agentId - The agent identifier whose group should be left
+ */
+export async function syncGroupsForDeletedAgent(agentId: string): Promise<void> {
+  const sock = getSocket();
+  if (!sock) {
+    throw new Error("WhatsApp socket is not connected");
+  }
+  const mapping = findMappingByAgentId(agentId);
+  if (!mapping) {
+    console.log(`No WhatsApp group mapping found for agent "${agentId}"`);
+    return;
+  }
+  await sock.groupLeave(mapping.groupJid);
+  mappings.delete(mapping.groupJid);
+  await saveMappings();
+  console.log(`Left WhatsApp group (${mapping.groupJid}) for deleted agent "${agentId}"`);
+}
+/**
+ * Sync WhatsApp groups for all agents. For each agent without a mapping,
+ * checks if a group named [VoiceCC] <agentId> already exists (duplicate
+ * detection). If found, registers the existing group. If not, creates a new one.
+ *
+ * Called on WhatsApp connect to ensure all agents have groups.
+ */
+export async function syncAllGroups(): Promise<void> {
+  const sock = getSocket();
+  if (!sock) {
+    throw new Error("WhatsApp socket is not connected");
+  }
+  // Load persisted mappings first
+  await loadMappings();
+  const agents = await listAgents();
+  const agentsWithoutMapping = agents.filter(
+    (agent) => !findMappingByAgentId(agent.id)
+  );
+  if (agentsWithoutMapping.length === 0) {
+    console.log("All agents already have WhatsApp group mappings.");
+    return;
+  }
+  // Fetch existing WhatsApp groups for duplicate detection
+  const existingGroups = await sock.groupFetchAllParticipating();
+  const groupsByName = new Map<string, string>();
+  for (const [jid, metadata] of Object.entries(existingGroups)) {
+    const groupMetadata = metadata as { subject: string };
+    groupsByName.set(groupMetadata.subject, jid);
+  }
+  let synced = 0;
+  for (const agent of agentsWithoutMapping) {
+    const groupName = formatGroupName(agent.id);
+    const existingJid = groupsByName.get(groupName);
+    try {
+      if (existingJid) {
+        // Register existing group instead of creating a duplicate
+        const mapping: GroupMapping = {
+          groupJid: existingJid,
+          agentId: agent.id,
+          lastSessionId: null,
+        };
+        mappings.set(existingJid, mapping);
+        console.log(`Registered existing WhatsApp group "${groupName}" (${existingJid}) for agent "${agent.id}"`);
+      } else {
+        // Create a new group
+        const result = await sock.groupCreate(groupName, []);
+        const mapping: GroupMapping = {
+          groupJid: result.id,
+          agentId: agent.id,
+          lastSessionId: null,
+        };
+        mappings.set(result.id, mapping);
+        console.log(`Created WhatsApp group "${groupName}" (${result.id}) for agent "${agent.id}"`);
+      }
+      // Save after each successful creation so partial progress is persisted
+      await saveMappings();
+      synced++;
+      // Delay between group creations to avoid WhatsApp rate-limiting
+      if (synced < agentsWithoutMapping.length) {
+        await new Promise((resolve) => setTimeout(resolve, 5_000));
+      }
+    } catch (err: unknown) {
+      console.error(`Failed to sync WhatsApp group for agent "${agent.id}": ${err}`);
+    }
+  }
+  console.log(`WhatsApp group sync complete. ${synced}/${agentsWithoutMapping.length} agent(s) synced.`);
+}
+/**
+ * Look up which agent a WhatsApp group belongs to.
+ *
+ * @param groupJid - The WhatsApp group JID
+ * @returns The agent ID, or undefined if the group is not mapped
+ */
+export function getAgentIdForGroup(groupJid: string): string | undefined {
+  return mappings.get(groupJid)?.agentId;
+}
+/**
+ * Get the stored Claude session ID for a group (used for conversation resume).
+ *
+ * @param groupJid - The WhatsApp group JID
+ * @returns The last session ID, or null if none stored
+ */
+export function getLastSessionId(groupJid: string): string | null {
+  return mappings.get(groupJid)?.lastSessionId ?? null;
+}
+/**
+ * Update the stored Claude session ID for a group and persist to disk.
+ *
+ * @param groupJid - The WhatsApp group JID
+ * @param sessionId - The Claude session ID to store
+ */
+export async function setLastSessionId(groupJid: string, sessionId: string): Promise<void> {
+  const mapping = mappings.get(groupJid);
+  if (!mapping) {
+    throw new Error(`No mapping found for group "${groupJid}"`);
+  }
+  mapping.lastSessionId = sessionId;
+  await saveMappings();
+}
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/**
+ * Format the WhatsApp group name for an agent.
+ *
+ * @param agentId - The agent identifier
+ * @returns The formatted group name, e.g. "[VoiceCC] my-agent"
+ */
+export function formatGroupName(agentId: string): string {
+  return `${GROUP_NAME_PREFIX}${agentId}`;
+}
+/**
+ * Load group mappings from disk. Creates an empty mappings file if none exists.
+ * Called on startup and before syncAllGroups.
+ */
+export async function loadMappings(): Promise<void> {
+  try {
+    const raw = await readFile(MAPPINGS_FILE_PATH, "utf-8");
+    const parsed: GroupMapping[] = JSON.parse(raw);
+    mappings = new Map();
+    for (const mapping of parsed) {
+      mappings.set(mapping.groupJid, mapping);
+    }
+    console.log(`Loaded ${mappings.size} WhatsApp group mapping(s) from disk.`);
+  } catch {
+    // File does not exist yet -- start with empty mappings
+    mappings = new Map();
+  }
+}
+/**
+ * Persist current group mappings to disk as JSON.
+ */
+export async function saveMappings(): Promise<void> {
+  const data = Array.from(mappings.values());
+  await mkdir(dirname(MAPPINGS_FILE_PATH), { recursive: true });
+  await writeFile(MAPPINGS_FILE_PATH, JSON.stringify(data, null, 2), "utf-8");
+}
+/**
+ * Find a mapping by agent ID (reverse lookup).
+ *
+ * @param agentId - The agent identifier to search for
+ * @returns The mapping, or undefined if not found
+ */
+export function findMappingByAgentId(agentId: string): GroupMapping | undefined {
+  for (const mapping of mappings.values()) {
+    if (mapping.agentId === agentId) {
+      return mapping;
+    }
+  }
+  return undefined;
+}