voicecc 1.0.7

package/dashboard/routes/integrations.ts

@@ -0,0 +1,154 @@
+/**
+ * Integration enable/disable API routes.
+ *
+ * Manages the enabled state of integrations (Twilio, Browser Call).
+ * Enabling an integration persists the flag to .env and immediately starts
+ * the service (plus tunnel as a dependency). Disabling stops it.
+ *
+ * - GET / -- returns enabled state for each integration
+ * - POST /:name -- sets enabled state and starts/stops the service
+ */
+
+import { Hono } from "hono";
+import { readEnv, writeEnvKey } from "../../services/env.js";
+import { startTwilioServer, stopTwilioServer, isRunning as isTwilioRunning } from "../../services/twilio-manager.js";
+import { startBrowserCallServer, stopBrowserCallServer, isBrowserCallRunning } from "../../services/browser-call-manager.js";
+import { startTunnel, stopTunnel, isTunnelRunning, getTunnelUrl } from "../../services/tunnel.js";
+
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+
+/** Map of integration names to their .env key */
+const INTEGRATION_ENV_KEYS: Record<string, string> = {
+  twilio: "TWILIO_ENABLED",
+  "browser-call": "BROWSER_CALL_ENABLED",
+};
+
+// ============================================================================
+// STATE
+// ============================================================================
+
+/** Dashboard port -- set by server.ts after the Hono server starts */
+let dashboardPort = 0;
+
+/**
+ * Set the dashboard port for starting integration servers.
+ *
+ * @param port - The dashboard server port
+ */
+export function setDashboardPort(port: number): void {
+  dashboardPort = port;
+}
+
+// ============================================================================
+// ROUTES
+// ============================================================================
+
+/**
+ * Create Hono route group for integration enable/disable operations.
+ *
+ * @returns Hono instance with GET / and POST /:name routes
+ */
+export function integrationsRoutes(): Hono {
+  const app = new Hono();
+
+  /** Get enabled state for all integrations */
+  app.get("/", async (c) => {
+    const envVars = await readEnv();
+    return c.json({
+      twilio: { enabled: envVars.TWILIO_ENABLED === "true" },
+      browserCall: { enabled: envVars.BROWSER_CALL_ENABLED === "true" },
+    });
+  });
+
+  /** Set enabled state for a specific integration and start/stop it */
+  app.post("/:name", async (c) => {
+    const name = c.req.param("name");
+    const envKey = INTEGRATION_ENV_KEYS[name];
+
+    if (!envKey) {
+      return c.json({ error: `Unknown integration: ${name}` }, 400);
+    }
+
+    const body = await c.req.json<{ enabled: boolean }>();
+    if (typeof body.enabled !== "boolean") {
+      return c.json({ error: "Missing 'enabled' boolean in request body" }, 400);
+    }
+
+    await writeEnvKey(envKey, String(body.enabled));
+
+    try {
+      if (body.enabled) {
+        await startIntegration(name);
+      } else {
+        stopIntegration(name);
+      }
+      return c.json({ success: true });
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Failed to update integration";
+      return c.json({ error: message }, 500);
+    }
+  });
+
+  return app;
+}
+
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+
+/**
+ * Start an integration and its tunnel dependency.
+ *
+ * @param name - Integration name ("twilio" or "browser-call")
+ */
+async function startIntegration(name: string): Promise<void> {
+  const envVars = await readEnv();
+  const tunnelPort = parseInt(envVars.TWILIO_PORT || "8080", 10);
+
+  // Start tunnel if not already running
+  if (!isTunnelRunning()) {
+    await startTunnel(tunnelPort);
+  }
+
+  if (name === "twilio") {
+    if (!envVars.TWILIO_AUTH_TOKEN) {
+      throw new Error("TWILIO_AUTH_TOKEN is not configured. Set your Twilio credentials first.");
+    }
+    if (isBrowserCallRunning()) {
+      throw new Error("Browser call server is already running on this port");
+    }
+    if (!isTwilioRunning()) {
+      await startTwilioServer(dashboardPort, getTunnelUrl() ?? undefined);
+    }
+  } else if (name === "browser-call") {
+    if (isTwilioRunning()) {
+      throw new Error("Twilio server is already running on this port");
+    }
+    if (!isBrowserCallRunning()) {
+      await startBrowserCallServer(dashboardPort);
+    }
+  }
+}
+
+/**
+ * Stop an integration and tunnel if no other consumer needs it.
+ *
+ * @param name - Integration name ("twilio" or "browser-call")
+ */
+function stopIntegration(name: string): void {
+  if (name === "twilio") {
+    stopTwilioServer();
+    // Only stop tunnel if browser call is also stopped
+    if (!isBrowserCallRunning()) {
+      stopTunnel();
+    }
+  } else if (name === "browser-call") {
+    stopBrowserCallServer();
+    // Only stop tunnel if Twilio is also stopped
+    if (!isTwilioRunning()) {
+      stopTunnel();
+    }
+  }
+}

package/dashboard/routes/mcp-servers.ts

@@ -0,0 +1,198 @@
+/**
+ * MCP servers list API route.
+ *
+ * Runs `claude mcp list` and parses the output into structured entries:
+ * - GET /        -- list all configured MCP servers with connection status
+ * - POST /add    -- add a new MCP server by running `claude mcp add` directly
+ * - POST /:name/auth -- open Terminal to guide user through MCP server auth
+ */
+
+import { Hono } from "hono";
+import { execFile } from "child_process";
+import { homedir } from "os";
+import { join } from "path";
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+/** Parsed MCP server entry */
+interface McpServerEntry {
+  name: string;
+  url: string;
+  type: "http" | "stdio";
+  status: "connected" | "failed" | "needs_auth";
+  scope: "project" | "user" | "local";
+}
+
+// ============================================================================
+// ROUTES
+// ============================================================================
+
+/**
+ * Create Hono route group for MCP server operations.
+ *
+ * @returns Hono instance with GET / route
+ */
+export function mcpServersRoutes(): Hono {
+  const app = new Hono();
+
+  /** List MCP servers from Claude CLI, including scope from `mcp get` */
+  app.get("/", async (c) => {
+    const claudePath = join(homedir(), ".local", "bin", "claude");
+    const output = await new Promise<string>((resolve) => {
+      execFile(claudePath, ["mcp", "list"], { timeout: 15000 }, (err, stdout, stderr) => {
+        if (err) {
+          console.error("[mcp-servers] execFile error:", err.message);
+          console.error("[mcp-servers] stderr:", stderr);
+          resolve(stderr || err.message);
+          return;
+        }
+        resolve(stdout);
+      });
+    });
+
+    const servers = parseMcpListOutput(output);
+
+    // Fetch scope for each server in parallel via `claude mcp get <name>`
+    await Promise.all(
+      servers.map((server) =>
+        new Promise<void>((resolve) => {
+          execFile(claudePath, ["mcp", "get", server.name], { timeout: 10000 }, (err, stdout) => {
+            if (!err && stdout) {
+              server.scope = parseScopeFromGet(stdout);
+            }
+            resolve();
+          });
+        })
+      )
+    );
+
+    return c.json({ servers });
+  });
+
+  /** Add a new MCP server by running `claude mcp add` directly */
+  app.post("/add", async (c) => {
+    const { name, url, transport, scope } = await c.req.json<{
+      name: string;
+      url: string;
+      transport: string;
+      scope: string;
+    }>();
+
+    const claudePath = join(homedir(), ".local", "bin", "claude");
+    const args = ["mcp", "add", "--transport", transport, "--scope", scope, name, url];
+
+    return new Promise((resolve) => {
+      execFile(claudePath, args, { timeout: 15000 }, (err, stdout, stderr) => {
+        if (err) {
+          console.error("[mcp-servers] add error:", err.message);
+          console.error("[mcp-servers] stderr:", stderr);
+          resolve(c.json({ error: stderr || err.message }, 500));
+          return;
+        }
+        resolve(c.json({ success: true, output: stdout }));
+      });
+    });
+  });
+
+  /** Open Claude Code in Terminal to guide user through MCP server auth */
+  app.post("/:name/auth", async (c) => {
+    const { name } = c.req.param();
+    const claudePath = join(homedir(), ".local", "bin", "claude");
+
+    const prompt = `Please guide the user through authenticating the ${name} MCP server. Tell them to type /mcp. Be to the point, concise, use bullet points and bold.`;
+    // Escape double quotes for AppleScript string
+    const escapedPrompt = prompt.replace(/"/g, '\\"');
+    const script = `tell application "Terminal"
+  activate
+  do script "${claudePath} \\"${escapedPrompt}\\""
+end tell`;
+
+    return new Promise((resolve) => {
+      execFile("osascript", ["-e", script], (err) => {
+        if (err) {
+          resolve(c.json({ error: err.message }, 500));
+          return;
+        }
+        resolve(c.json({ success: true }));
+      });
+    });
+  });
+
+  /** Remove an MCP server by running `claude mcp remove` */
+  app.delete("/:name", async (c) => {
+    const { name } = c.req.param();
+    const claudePath = join(homedir(), ".local", "bin", "claude");
+    const args = ["mcp", "remove", name];
+
+    return new Promise((resolve) => {
+      execFile(claudePath, args, { timeout: 15000 }, (err, stdout, stderr) => {
+        if (err) {
+          console.error("[mcp-servers] remove error:", err.message);
+          resolve(c.json({ error: stderr || err.message }, 500));
+          return;
+        }
+        resolve(c.json({ success: true, output: stdout }));
+      });
+    });
+  });
+
+  return app;
+}
+
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+
+/**
+ * Parse the text output of `claude mcp list` into structured entries.
+ * Each line has the format: `<name>: <url-or-command> - <icon> <status>`
+ *
+ * @param output - Raw CLI output
+ * @returns Array of parsed MCP server entries
+ */
+function parseMcpListOutput(output: string): McpServerEntry[] {
+  const servers: McpServerEntry[] = [];
+  const lines = output.split("\n");
+
+  for (const line of lines) {
+    const match = line.match(/^(\S+): (.+?) - (?:\u2713|\u2717|\u26A0)\s*(.+)$/);
+    if (!match) continue;
+
+    const name = match[1];
+    let urlOrCommand = match[2].trim();
+    const statusText = match[3].trim().toLowerCase();
+
+    const isHttp = urlOrCommand.includes("(HTTP)");
+    const type: "http" | "stdio" = isHttp ? "http" : "stdio";
+    urlOrCommand = urlOrCommand.replace(/\s*\(HTTP\)\s*$/, "").trim();
+
+    let status: McpServerEntry["status"] = "failed";
+    if (statusText.includes("connected")) {
+      status = "connected";
+    } else if (statusText.includes("auth")) {
+      status = "needs_auth";
+    }
+
+    servers.push({ name, url: urlOrCommand, type, status, scope: "local" });
+  }
+
+  return servers;
+}
+
+/**
+ * Parse the scope from `claude mcp get <name>` output.
+ * Looks for "Scope: ..." line and maps to our scope type.
+ *
+ * @param output - Raw CLI output from `claude mcp get`
+ * @returns Parsed scope
+ */
+function parseScopeFromGet(output: string): McpServerEntry["scope"] {
+  const match = output.match(/Scope:\s*(.+)/i);
+  if (!match) return "local";
+  const scopeText = match[1].toLowerCase();
+  if (scopeText.includes("user")) return "user";
+  if (scopeText.includes("project")) return "project";
+  return "local";
+}

package/dashboard/routes/settings.ts

@@ -0,0 +1,64 @@
+/**
+ * Settings (.env) API routes.
+ *
+ * Read and write .env configuration with secret masking:
+ * - GET / -- read .env with masked secrets
+ * - POST / -- merge incoming key-value pairs into .env
+ */
+
+import { Hono } from "hono";
+import { readEnv, writeEnvFile } from "../../services/env.js";
+
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+
+/** Keys that should be masked when reading settings */
+const MASKED_KEYS = ["TWILIO_AUTH_TOKEN", "TWILIO_API_KEY_SECRET"];
+
+// ============================================================================
+// ROUTES
+// ============================================================================
+
+/**
+ * Create Hono route group for settings operations.
+ *
+ * @returns Hono instance with GET / and POST / routes
+ */
+export function settingsRoutes(): Hono {
+  const app = new Hono();
+
+  /** Read .env settings with masked secrets */
+  app.get("/", async (c) => {
+    const settings = await readEnv();
+
+    // Mask auth tokens -- show only last 4 chars
+    for (const key of MASKED_KEYS) {
+      if (settings[key]) {
+        const val = settings[key];
+        settings[key] = val.length > 4 ? "****" + val.slice(-4) : "****" + val;
+      }
+    }
+
+    return c.json(settings);
+  });
+
+  /** Merge incoming settings into .env, preserving masked values */
+  app.post("/", async (c) => {
+    const incoming = await c.req.json<Record<string, string>>();
+    const settings = await readEnv();
+
+    for (const [key, value] of Object.entries(incoming)) {
+      // If auth tokens are masked, preserve the existing value
+      if (MASKED_KEYS.includes(key) && value.startsWith("****")) {
+        continue;
+      }
+      settings[key] = value;
+    }
+
+    await writeEnvFile(settings);
+    return c.json({ success: true });
+  });
+
+  return app;
+}

package/dashboard/routes/tunnel.ts

@@ -0,0 +1,66 @@
+/**
+ * Tunnel management API routes.
+ *
+ * Delegates to the tunnel service for cloudflared lifecycle operations:
+ * - GET /check -- is cloudflared installed
+ * - GET /status -- running state + public URL
+ * - POST /start -- start tunnel
+ * - POST /stop -- stop tunnel
+ */
+
+import { Hono } from "hono";
+import {
+  checkCloudflaredInstalled,
+  isTunnelRunning,
+  getTunnelUrl,
+  getTunnelStartedAt,
+  startTunnel,
+  stopTunnel,
+} from "../../services/tunnel.js";
+import { readEnv } from "../../services/env.js";
+
+// ============================================================================
+// ROUTES
+// ============================================================================
+
+/**
+ * Create Hono route group for tunnel operations.
+ *
+ * @returns Hono instance with check, status, start, stop routes
+ */
+export function tunnelRoutes(): Hono {
+  const app = new Hono();
+
+  /** Check if cloudflared is installed */
+  app.get("/check", async (c) => {
+    const installed = await checkCloudflaredInstalled();
+    return c.json({ installed });
+  });
+
+  /** Get tunnel running status and URL */
+  app.get("/status", (c) => {
+    return c.json({ running: isTunnelRunning(), url: getTunnelUrl(), startedAt: getTunnelStartedAt() });
+  });
+
+  /** Start tunnel */
+  app.post("/start", async (c) => {
+    const envVars = await readEnv();
+    const port = parseInt(envVars.TWILIO_PORT || "8080", 10);
+
+    try {
+      const url = await startTunnel(port);
+      return c.json({ success: true, url });
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Failed to start tunnel";
+      return c.json({ error: message }, 500);
+    }
+  });
+
+  /** Stop tunnel */
+  app.post("/stop", (c) => {
+    stopTunnel();
+    return c.json({ success: true });
+  });
+
+  return app;
+}

package/dashboard/routes/twilio.ts

@@ -0,0 +1,120 @@
+/**
+ * Twilio PSTN server management API routes.
+ *
+ * Manages the Twilio voice server lifecycle for PSTN phone calls:
+ * - GET /status -- server running state and tunnel URL
+ * - POST /start -- start tunnel + twilio server
+ * - POST /stop -- stop twilio server + tunnel
+ * - GET /phone-numbers -- fetch phone numbers from Twilio API
+ */
+
+import { Hono } from "hono";
+import { readEnv } from "../../services/env.js";
+import { startTwilioServer, stopTwilioServer, getStatus } from "../../services/twilio-manager.js";
+import { startTunnel, stopTunnel, getTunnelUrl, isTunnelRunning } from "../../services/tunnel.js";
+import { isBrowserCallRunning } from "../../services/browser-call-manager.js";
+
+// ============================================================================
+// STATE
+// ============================================================================
+
+/** Dashboard port -- set by server.ts when calling setDashboardPort */
+let dashboardPort = 0;
+
+/**
+ * Set the dashboard port for twilio-server proxying.
+ * Called by server.ts after the Hono server starts listening.
+ *
+ * @param port - The dashboard server port
+ */
+export function setDashboardPort(port: number): void {
+  dashboardPort = port;
+}
+
+// ============================================================================
+// ROUTES
+// ============================================================================
+
+/**
+ * Create Hono route group for Twilio operations.
+ *
+ * @returns Hono instance with status, start, stop, phone-numbers routes
+ */
+export function twilioRoutes(): Hono {
+  const app = new Hono();
+
+  /** Get Twilio server status */
+  app.get("/status", async (c) => {
+    const status = await getStatus();
+    return c.json({ running: status.running, tunnelUrl: getTunnelUrl() });
+  });
+
+  /** Start tunnel + Twilio server */
+  app.post("/start", async (c) => {
+    try {
+      // Port conflict check: browser-server uses the same port
+      if (isBrowserCallRunning()) {
+        return c.json({ error: "Browser call server is already running on this port" }, 409);
+      }
+
+      const envVars = await readEnv();
+      const port = parseInt(envVars.TWILIO_PORT || "8080", 10);
+
+      if (!isTunnelRunning()) {
+        await startTunnel(port);
+      }
+      const status = await getStatus();
+      if (!status.running) {
+        await startTwilioServer(dashboardPort, getTunnelUrl() ?? undefined);
+      }
+      return c.json({ success: true });
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Failed to start";
+      return c.json({ error: message }, 500);
+    }
+  });
+
+  /** Stop Twilio server. Only stops tunnel if browser call is also stopped. */
+  app.post("/stop", (c) => {
+    stopTwilioServer();
+    if (!isBrowserCallRunning()) {
+      stopTunnel();
+    }
+    return c.json({ success: true });
+  });
+
+  /** Fetch phone numbers from Twilio API */
+  app.get("/phone-numbers", async (c) => {
+    const envVars = await readEnv();
+    const accountSid = envVars.TWILIO_ACCOUNT_SID;
+    const authToken = envVars.TWILIO_AUTH_TOKEN;
+
+    if (!accountSid || !authToken) {
+      return c.json({ error: "TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN must be set" }, 400);
+    }
+
+    const apiUrl = `https://api.twilio.com/2010-04-01/Accounts/${accountSid}/IncomingPhoneNumbers.json`;
+    const auth = Buffer.from(`${accountSid}:${authToken}`).toString("base64");
+
+    const apiRes = await fetch(apiUrl, {
+      headers: { Authorization: `Basic ${auth}` },
+    });
+
+    if (!apiRes.ok) {
+      const body = await apiRes.text();
+      return c.json({ error: `Twilio API error: ${body}` }, apiRes.status as 400);
+    }
+
+    const data = await apiRes.json();
+    const numbers = (data.incoming_phone_numbers ?? []).map(
+      (n: { phone_number: string; friendly_name: string }) => ({
+        phoneNumber: n.phone_number,
+        friendlyName: n.friendly_name,
+      })
+    );
+
+    return c.json({ numbers });
+  });
+
+  return app;
+}

package/dashboard/routes/voice.ts

@@ -0,0 +1,48 @@
+/**
+ * Voice sidecar launch route.
+ *
+ * Opens Terminal.app and starts the voice sidecar process:
+ * - POST /start -- opens Terminal via osascript
+ */
+
+import { Hono } from "hono";
+import { execFile } from "child_process";
+
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+
+const VOICE_CMD = `cd ${process.cwd()} && npx tsx sidecar/index.ts`;
+
+// ============================================================================
+// ROUTES
+// ============================================================================
+
+/**
+ * Create Hono route group for voice operations.
+ *
+ * @returns Hono instance with POST /start route
+ */
+export function voiceRoutes(): Hono {
+  const app = new Hono();
+
+  /** Open Terminal.app and start the voice sidecar */
+  app.post("/start", async (c) => {
+    const script = `tell application "Terminal"
+  activate
+  do script "${VOICE_CMD}"
+end tell`;
+
+    return new Promise((resolve) => {
+      execFile("osascript", ["-e", script], (err) => {
+        if (err) {
+          resolve(c.json({ error: err.message }, 500));
+          return;
+        }
+        resolve(c.json({ success: true }));
+      });
+    });
+  });
+
+  return app;
+}