loudmouth-ai 0.1.0 → 0.2.0

package/extensions/voice-call/src/cli.ts

@@ -1,300 +0,0 @@
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-
-import type { Command } from "commander";
-
-import type { VoiceCallConfig } from "./config.js";
-import type { VoiceCallRuntime } from "./runtime.js";
-import { resolveUserPath } from "./utils.js";
-import {
-  cleanupTailscaleExposureRoute,
-  getTailscaleSelfInfo,
-  setupTailscaleExposureRoute,
-} from "./webhook.js";
-
-type Logger = {
-  info: (message: string) => void;
-  warn: (message: string) => void;
-  error: (message: string) => void;
-};
-
-function resolveMode(input: string): "off" | "serve" | "funnel" {
-  const raw = input.trim().toLowerCase();
-  if (raw === "serve" || raw === "off") return raw;
-  return "funnel";
-}
-
-function resolveDefaultStorePath(config: VoiceCallConfig): string {
-  const base =
-    config.store?.trim() || path.join(os.homedir(), "clawd", "voice-calls");
-  return path.join(resolveUserPath(base), "calls.jsonl");
-}
-
-function sleep(ms: number): Promise<void> {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-export function registerVoiceCallCli(params: {
-  program: Command;
-  config: VoiceCallConfig;
-  ensureRuntime: () => Promise<VoiceCallRuntime>;
-  logger: Logger;
-}) {
-  const { program, config, ensureRuntime, logger } = params;
-  const root = program
-    .command("voicecall")
-    .description("Voice call utilities")
-    .addHelpText("after", () => `\nDocs: https://docs.clawd.bot/cli/voicecall\n`);
-
-  root
-    .command("call")
-    .description("Initiate an outbound voice call")
-    .requiredOption(
-      "-m, --message <text>",
-      "Message to speak when call connects",
-    )
-    .option(
-      "-t, --to <phone>",
-      "Phone number to call (E.164 format, uses config toNumber if not set)",
-    )
-    .option(
-      "--mode <mode>",
-      "Call mode: notify (hangup after message) or conversation (stay open)",
-      "conversation",
-    )
-    .action(
-      async (options: { message: string; to?: string; mode?: string }) => {
-        const rt = await ensureRuntime();
-        const to = options.to ?? rt.config.toNumber;
-        if (!to) {
-          throw new Error("Missing --to and no toNumber configured");
-        }
-        const result = await rt.manager.initiateCall(to, undefined, {
-          message: options.message,
-          mode:
-            options.mode === "notify" || options.mode === "conversation"
-              ? options.mode
-              : undefined,
-        });
-        if (!result.success) {
-          throw new Error(result.error || "initiate failed");
-        }
-        // eslint-disable-next-line no-console
-        console.log(JSON.stringify({ callId: result.callId }, null, 2));
-      },
-    );
-
-  root
-    .command("start")
-    .description("Alias for voicecall call")
-    .requiredOption("--to <phone>", "Phone number to call")
-    .option("--message <text>", "Message to speak when call connects")
-    .option(
-      "--mode <mode>",
-      "Call mode: notify (hangup after message) or conversation (stay open)",
-      "conversation",
-    )
-    .action(
-      async (options: { to: string; message?: string; mode?: string }) => {
-        const rt = await ensureRuntime();
-        const result = await rt.manager.initiateCall(options.to, undefined, {
-          message: options.message,
-          mode:
-            options.mode === "notify" || options.mode === "conversation"
-              ? options.mode
-              : undefined,
-        });
-        if (!result.success) {
-          throw new Error(result.error || "initiate failed");
-        }
-        // eslint-disable-next-line no-console
-        console.log(JSON.stringify({ callId: result.callId }, null, 2));
-      },
-    );
-
-  root
-    .command("continue")
-    .description("Speak a message and wait for a response")
-    .requiredOption("--call-id <id>", "Call ID")
-    .requiredOption("--message <text>", "Message to speak")
-    .action(async (options: { callId: string; message: string }) => {
-      const rt = await ensureRuntime();
-      const result = await rt.manager.continueCall(
-        options.callId,
-        options.message,
-      );
-      if (!result.success) {
-        throw new Error(result.error || "continue failed");
-      }
-      // eslint-disable-next-line no-console
-      console.log(JSON.stringify(result, null, 2));
-    });
-
-  root
-    .command("speak")
-    .description("Speak a message without waiting for response")
-    .requiredOption("--call-id <id>", "Call ID")
-    .requiredOption("--message <text>", "Message to speak")
-    .action(async (options: { callId: string; message: string }) => {
-      const rt = await ensureRuntime();
-      const result = await rt.manager.speak(options.callId, options.message);
-      if (!result.success) {
-        throw new Error(result.error || "speak failed");
-      }
-      // eslint-disable-next-line no-console
-      console.log(JSON.stringify(result, null, 2));
-    });
-
-  root
-    .command("end")
-    .description("Hang up an active call")
-    .requiredOption("--call-id <id>", "Call ID")
-    .action(async (options: { callId: string }) => {
-      const rt = await ensureRuntime();
-      const result = await rt.manager.endCall(options.callId);
-      if (!result.success) {
-        throw new Error(result.error || "end failed");
-      }
-      // eslint-disable-next-line no-console
-      console.log(JSON.stringify(result, null, 2));
-    });
-
-  root
-    .command("status")
-    .description("Show call status")
-    .requiredOption("--call-id <id>", "Call ID")
-    .action(async (options: { callId: string }) => {
-      const rt = await ensureRuntime();
-      const call = rt.manager.getCall(options.callId);
-      // eslint-disable-next-line no-console
-      console.log(JSON.stringify(call ?? { found: false }, null, 2));
-    });
-
-  root
-    .command("tail")
-    .description(
-      "Tail voice-call JSONL logs (prints new lines; useful during provider tests)",
-    )
-    .option("--file <path>", "Path to calls.jsonl", resolveDefaultStorePath(config))
-    .option("--since <n>", "Print last N lines first", "25")
-    .option("--poll <ms>", "Poll interval in ms", "250")
-    .action(
-      async (options: { file: string; since?: string; poll?: string }) => {
-        const file = options.file;
-        const since = Math.max(0, Number(options.since ?? 0));
-        const pollMs = Math.max(50, Number(options.poll ?? 250));
-
-        if (!fs.existsSync(file)) {
-          logger.error(`No log file at ${file}`);
-          process.exit(1);
-        }
-
-        const initial = fs.readFileSync(file, "utf8");
-        const lines = initial.split("\n").filter(Boolean);
-        for (const line of lines.slice(Math.max(0, lines.length - since))) {
-          // eslint-disable-next-line no-console
-          console.log(line);
-        }
-
-        let offset = Buffer.byteLength(initial, "utf8");
-
-        for (;;) {
-          try {
-            const stat = fs.statSync(file);
-            if (stat.size < offset) {
-              offset = 0;
-            }
-            if (stat.size > offset) {
-              const fd = fs.openSync(file, "r");
-              try {
-                const buf = Buffer.alloc(stat.size - offset);
-                fs.readSync(fd, buf, 0, buf.length, offset);
-                offset = stat.size;
-                const text = buf.toString("utf8");
-                for (const line of text.split("\n").filter(Boolean)) {
-                  // eslint-disable-next-line no-console
-                  console.log(line);
-                }
-              } finally {
-                fs.closeSync(fd);
-              }
-            }
-          } catch {
-            // ignore and retry
-          }
-          await sleep(pollMs);
-        }
-      },
-    );
-
-  root
-    .command("expose")
-    .description("Enable/disable Tailscale serve/funnel for the webhook")
-    .option("--mode <mode>", "off | serve (tailnet) | funnel (public)", "funnel")
-    .option(
-      "--path <path>",
-      "Tailscale path to expose (recommend matching serve.path)",
-    )
-    .option("--port <port>", "Local webhook port")
-    .option("--serve-path <path>", "Local webhook path")
-    .action(
-      async (options: {
-        mode?: string;
-        port?: string;
-        path?: string;
-        servePath?: string;
-      }) => {
-        const mode = resolveMode(options.mode ?? "funnel");
-        const servePort = Number(options.port ?? config.serve.port ?? 3334);
-        const servePath = String(
-          options.servePath ?? config.serve.path ?? "/voice/webhook",
-        );
-        const tsPath = String(
-          options.path ?? config.tailscale?.path ?? servePath,
-        );
-
-        const localUrl = `http://127.0.0.1:${servePort}`;
-
-        if (mode === "off") {
-          await cleanupTailscaleExposureRoute({ mode: "serve", path: tsPath });
-          await cleanupTailscaleExposureRoute({ mode: "funnel", path: tsPath });
-          // eslint-disable-next-line no-console
-          console.log(JSON.stringify({ ok: true, mode: "off", path: tsPath }, null, 2));
-          return;
-        }
-
-        const publicUrl = await setupTailscaleExposureRoute({
-          mode,
-          path: tsPath,
-          localUrl,
-        });
-
-        const tsInfo = publicUrl ? null : await getTailscaleSelfInfo();
-        const enableUrl = tsInfo?.nodeId
-          ? `https://login.tailscale.com/f/${mode}?node=${tsInfo.nodeId}`
-          : null;
-
-        // eslint-disable-next-line no-console
-        console.log(
-          JSON.stringify(
-            {
-              ok: Boolean(publicUrl),
-              mode,
-              path: tsPath,
-              localUrl,
-              publicUrl,
-              hint: publicUrl
-                ? undefined
-                : {
-                    note: "Tailscale serve/funnel may be disabled on this tailnet (or require admin enable).",
-                    enableUrl,
-                  },
-            },
-            null,
-            2,
-          ),
-        );
-      },
-    );
-}

package/extensions/voice-call/src/config.test.ts

@@ -1,204 +0,0 @@
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-
-import { validateProviderConfig, resolveVoiceCallConfig, type VoiceCallConfig } from "./config.js";
-
-function createBaseConfig(
-  provider: "telnyx" | "twilio" | "plivo" | "mock",
-): VoiceCallConfig {
-  return {
-    enabled: true,
-    provider,
-    fromNumber: "+15550001234",
-    inboundPolicy: "disabled",
-    allowFrom: [],
-    outbound: { defaultMode: "notify", notifyHangupDelaySec: 3 },
-    maxDurationSeconds: 300,
-    silenceTimeoutMs: 800,
-    transcriptTimeoutMs: 180000,
-    ringTimeoutMs: 30000,
-    maxConcurrentCalls: 1,
-    serve: { port: 3334, bind: "127.0.0.1", path: "/voice/webhook" },
-    tailscale: { mode: "off", path: "/voice/webhook" },
-    tunnel: { provider: "none", allowNgrokFreeTier: false },
-    streaming: {
-      enabled: false,
-      sttProvider: "openai-realtime",
-      sttModel: "gpt-4o-transcribe",
-      silenceDurationMs: 800,
-      vadThreshold: 0.5,
-      streamPath: "/voice/stream",
-    },
-    skipSignatureVerification: false,
-    stt: { provider: "openai", model: "whisper-1" },
-    tts: { provider: "openai", model: "gpt-4o-mini-tts", voice: "coral" },
-    responseModel: "openai/gpt-4o-mini",
-    responseTimeoutMs: 30000,
-  };
-}
-
-describe("validateProviderConfig", () => {
-  const originalEnv = { ...process.env };
-
-  beforeEach(() => {
-    // Clear all relevant env vars before each test
-    delete process.env.TWILIO_ACCOUNT_SID;
-    delete process.env.TWILIO_AUTH_TOKEN;
-    delete process.env.TELNYX_API_KEY;
-    delete process.env.TELNYX_CONNECTION_ID;
-    delete process.env.PLIVO_AUTH_ID;
-    delete process.env.PLIVO_AUTH_TOKEN;
-  });
-
-  afterEach(() => {
-    // Restore original env
-    process.env = { ...originalEnv };
-  });
-
-  describe("twilio provider", () => {
-    it("passes validation when credentials are in config", () => {
-      const config = createBaseConfig("twilio");
-      config.twilio = { accountSid: "AC123", authToken: "secret" };
-
-      const result = validateProviderConfig(config);
-
-      expect(result.valid).toBe(true);
-      expect(result.errors).toEqual([]);
-    });
-
-    it("passes validation when credentials are in environment variables", () => {
-      process.env.TWILIO_ACCOUNT_SID = "AC123";
-      process.env.TWILIO_AUTH_TOKEN = "secret";
-      let config = createBaseConfig("twilio");
-      config = resolveVoiceCallConfig(config);
-
-      const result = validateProviderConfig(config);
-
-      expect(result.valid).toBe(true);
-      expect(result.errors).toEqual([]);
-    });
-
-    it("passes validation with mixed config and env vars", () => {
-      process.env.TWILIO_AUTH_TOKEN = "secret";
-      let config = createBaseConfig("twilio");
-      config.twilio = { accountSid: "AC123" };
-      config = resolveVoiceCallConfig(config);
-
-      const result = validateProviderConfig(config);
-
-      expect(result.valid).toBe(true);
-      expect(result.errors).toEqual([]);
-    });
-
-    it("fails validation when accountSid is missing everywhere", () => {
-      process.env.TWILIO_AUTH_TOKEN = "secret";
-      let config = createBaseConfig("twilio");
-      config = resolveVoiceCallConfig(config);
-
-      const result = validateProviderConfig(config);
-
-      expect(result.valid).toBe(false);
-      expect(result.errors).toContain(
-        "plugins.entries.voice-call.config.twilio.accountSid is required (or set TWILIO_ACCOUNT_SID env)",
-      );
-    });
-
-    it("fails validation when authToken is missing everywhere", () => {
-      process.env.TWILIO_ACCOUNT_SID = "AC123";
-      let config = createBaseConfig("twilio");
-      config = resolveVoiceCallConfig(config);
-
-      const result = validateProviderConfig(config);
-
-      expect(result.valid).toBe(false);
-      expect(result.errors).toContain(
-        "plugins.entries.voice-call.config.twilio.authToken is required (or set TWILIO_AUTH_TOKEN env)",
-      );
-    });
-  });
-
-  describe("telnyx provider", () => {
-    it("passes validation when credentials are in config", () => {
-      const config = createBaseConfig("telnyx");
-      config.telnyx = { apiKey: "KEY123", connectionId: "CONN456" };
-
-      const result = validateProviderConfig(config);
-
-      expect(result.valid).toBe(true);
-      expect(result.errors).toEqual([]);
-    });
-
-    it("passes validation when credentials are in environment variables", () => {
-      process.env.TELNYX_API_KEY = "KEY123";
-      process.env.TELNYX_CONNECTION_ID = "CONN456";
-      let config = createBaseConfig("telnyx");
-      config = resolveVoiceCallConfig(config);
-
-      const result = validateProviderConfig(config);
-
-      expect(result.valid).toBe(true);
-      expect(result.errors).toEqual([]);
-    });
-
-    it("fails validation when apiKey is missing everywhere", () => {
-      process.env.TELNYX_CONNECTION_ID = "CONN456";
-      let config = createBaseConfig("telnyx");
-      config = resolveVoiceCallConfig(config);
-
-      const result = validateProviderConfig(config);
-
-      expect(result.valid).toBe(false);
-      expect(result.errors).toContain(
-        "plugins.entries.voice-call.config.telnyx.apiKey is required (or set TELNYX_API_KEY env)",
-      );
-    });
-  });
-
-  describe("plivo provider", () => {
-    it("passes validation when credentials are in config", () => {
-      const config = createBaseConfig("plivo");
-      config.plivo = { authId: "MA123", authToken: "secret" };
-
-      const result = validateProviderConfig(config);
-
-      expect(result.valid).toBe(true);
-      expect(result.errors).toEqual([]);
-    });
-
-    it("passes validation when credentials are in environment variables", () => {
-      process.env.PLIVO_AUTH_ID = "MA123";
-      process.env.PLIVO_AUTH_TOKEN = "secret";
-      let config = createBaseConfig("plivo");
-      config = resolveVoiceCallConfig(config);
-
-      const result = validateProviderConfig(config);
-
-      expect(result.valid).toBe(true);
-      expect(result.errors).toEqual([]);
-    });
-
-    it("fails validation when authId is missing everywhere", () => {
-      process.env.PLIVO_AUTH_TOKEN = "secret";
-      let config = createBaseConfig("plivo");
-      config = resolveVoiceCallConfig(config);
-
-      const result = validateProviderConfig(config);
-
-      expect(result.valid).toBe(false);
-      expect(result.errors).toContain(
-        "plugins.entries.voice-call.config.plivo.authId is required (or set PLIVO_AUTH_ID env)",
-      );
-    });
-  });
-
-  describe("disabled config", () => {
-    it("skips validation when enabled is false", () => {
-      const config = createBaseConfig("twilio");
-      config.enabled = false;
-
-      const result = validateProviderConfig(config);
-
-      expect(result.valid).toBe(true);
-      expect(result.errors).toEqual([]);
-    });
-  });
-});