loudmouth-ai 0.1.0 → 0.2.0

package/extensions/twitch/src/twitch-client.ts

@@ -1,277 +0,0 @@
-import { RefreshingAuthProvider, StaticAuthProvider } from "@twurple/auth";
-import { ChatClient, LogLevel } from "@twurple/chat";
-import type { ClawdbotConfig } from "clawdbot/plugin-sdk";
-import type { ChannelLogSink, TwitchAccountConfig, TwitchChatMessage } from "./types.js";
-import { resolveTwitchToken } from "./token.js";
-import { normalizeToken } from "./utils/twitch.js";
-
-/**
- * Manages Twitch chat client connections
- */
-export class TwitchClientManager {
-  private clients = new Map<string, ChatClient>();
-  private messageHandlers = new Map<string, (message: TwitchChatMessage) => void>();
-
-  constructor(private logger: ChannelLogSink) {}
-
-  /**
-   * Create an auth provider for the account.
-   */
-  private async createAuthProvider(
-    account: TwitchAccountConfig,
-    normalizedToken: string,
-  ): Promise<StaticAuthProvider | RefreshingAuthProvider> {
-    if (!account.clientId) {
-      throw new Error("Missing Twitch client ID");
-    }
-
-    if (account.clientSecret) {
-      const authProvider = new RefreshingAuthProvider({
-        clientId: account.clientId,
-        clientSecret: account.clientSecret,
-      });
-
-      await authProvider
-        .addUserForToken({
-          accessToken: normalizedToken,
-          refreshToken: account.refreshToken ?? null,
-          expiresIn: account.expiresIn ?? null,
-          obtainmentTimestamp: account.obtainmentTimestamp ?? Date.now(),
-        })
-        .then((userId) => {
-          this.logger.info(
-            `Added user ${userId} to RefreshingAuthProvider for ${account.username}`,
-          );
-        })
-        .catch((err) => {
-          this.logger.error(
-            `Failed to add user to RefreshingAuthProvider: ${err instanceof Error ? err.message : String(err)}`,
-          );
-        });
-
-      authProvider.onRefresh((userId, token) => {
-        this.logger.info(
-          `Access token refreshed for user ${userId} (expires in ${token.expiresIn ? `${token.expiresIn}s` : "unknown"})`,
-        );
-      });
-
-      authProvider.onRefreshFailure((userId, error) => {
-        this.logger.error(`Failed to refresh access token for user ${userId}: ${error.message}`);
-      });
-
-      const refreshStatus = account.refreshToken
-        ? "automatic token refresh enabled"
-        : "token refresh disabled (no refresh token)";
-      this.logger.info(`Using RefreshingAuthProvider for ${account.username} (${refreshStatus})`);
-
-      return authProvider;
-    }
-
-    this.logger.info(`Using StaticAuthProvider for ${account.username} (no clientSecret provided)`);
-    return new StaticAuthProvider(account.clientId, normalizedToken);
-  }
-
-  /**
-   * Get or create a chat client for an account
-   */
-  async getClient(
-    account: TwitchAccountConfig,
-    cfg?: ClawdbotConfig,
-    accountId?: string,
-  ): Promise<ChatClient> {
-    const key = this.getAccountKey(account);
-
-    const existing = this.clients.get(key);
-    if (existing) {
-      return existing;
-    }
-
-    const tokenResolution = resolveTwitchToken(cfg, {
-      accountId,
-    });
-
-    if (!tokenResolution.token) {
-      this.logger.error(
-        `Missing Twitch token for account ${account.username} (set channels.twitch.accounts.${account.username}.token or CLAWDBOT_TWITCH_ACCESS_TOKEN for default)`,
-      );
-      throw new Error("Missing Twitch token");
-    }
-
-    this.logger.debug?.(`Using ${tokenResolution.source} token source for ${account.username}`);
-
-    if (!account.clientId) {
-      this.logger.error(`Missing Twitch client ID for account ${account.username}`);
-      throw new Error("Missing Twitch client ID");
-    }
-
-    const normalizedToken = normalizeToken(tokenResolution.token);
-
-    const authProvider = await this.createAuthProvider(account, normalizedToken);
-
-    const client = new ChatClient({
-      authProvider,
-      channels: [account.channel],
-      rejoinChannelsOnReconnect: true,
-      requestMembershipEvents: true,
-      logger: {
-        minLevel: LogLevel.WARNING,
-        custom: {
-          log: (level, message) => {
-            switch (level) {
-              case LogLevel.CRITICAL:
-                this.logger.error(`${message}`);
-                break;
-              case LogLevel.ERROR:
-                this.logger.error(`${message}`);
-                break;
-              case LogLevel.WARNING:
-                this.logger.warn(`${message}`);
-                break;
-              case LogLevel.INFO:
-                this.logger.info(`${message}`);
-                break;
-              case LogLevel.DEBUG:
-                this.logger.debug?.(`${message}`);
-                break;
-              case LogLevel.TRACE:
-                this.logger.debug?.(`${message}`);
-                break;
-            }
-          },
-        },
-      },
-    });
-
-    this.setupClientHandlers(client, account);
-
-    client.connect();
-
-    this.clients.set(key, client);
-    this.logger.info(`Connected to Twitch as ${account.username}`);
-
-    return client;
-  }
-
-  /**
-   * Set up message and event handlers for a client
-   */
-  private setupClientHandlers(client: ChatClient, account: TwitchAccountConfig): void {
-    const key = this.getAccountKey(account);
-
-    // Handle incoming messages
-    client.onMessage((channelName, _user, messageText, msg) => {
-      const handler = this.messageHandlers.get(key);
-      if (handler) {
-        const normalizedChannel = channelName.startsWith("#") ? channelName.slice(1) : channelName;
-        const from = `twitch:${msg.userInfo.userName}`;
-        const preview = messageText.slice(0, 100).replace(/\n/g, "\\n");
-        this.logger.debug?.(
-          `twitch inbound: channel=${normalizedChannel} from=${from} len=${messageText.length} preview="${preview}"`,
-        );
-
-        handler({
-          username: msg.userInfo.userName,
-          displayName: msg.userInfo.displayName,
-          userId: msg.userInfo.userId,
-          message: messageText,
-          channel: normalizedChannel,
-          id: msg.id,
-          timestamp: new Date(),
-          isMod: msg.userInfo.isMod,
-          isOwner: msg.userInfo.isBroadcaster,
-          isVip: msg.userInfo.isVip,
-          isSub: msg.userInfo.isSubscriber,
-          chatType: "group",
-        });
-      }
-    });
-
-    this.logger.info(`Set up handlers for ${key}`);
-  }
-
-  /**
-   * Set a message handler for an account
-   * @returns A function that removes the handler when called
-   */
-  onMessage(
-    account: TwitchAccountConfig,
-    handler: (message: TwitchChatMessage) => void,
-  ): () => void {
-    const key = this.getAccountKey(account);
-    this.messageHandlers.set(key, handler);
-    return () => {
-      this.messageHandlers.delete(key);
-    };
-  }
-
-  /**
-   * Disconnect a client
-   */
-  async disconnect(account: TwitchAccountConfig): Promise<void> {
-    const key = this.getAccountKey(account);
-    const client = this.clients.get(key);
-
-    if (client) {
-      client.quit();
-      this.clients.delete(key);
-      this.messageHandlers.delete(key);
-      this.logger.info(`Disconnected ${key}`);
-    }
-  }
-
-  /**
-   * Disconnect all clients
-   */
-  async disconnectAll(): Promise<void> {
-    this.clients.forEach((client) => client.quit());
-    this.clients.clear();
-    this.messageHandlers.clear();
-    this.logger.info(" Disconnected all clients");
-  }
-
-  /**
-   * Send a message to a channel
-   */
-  async sendMessage(
-    account: TwitchAccountConfig,
-    channel: string,
-    message: string,
-    cfg?: ClawdbotConfig,
-    accountId?: string,
-  ): Promise<{ ok: boolean; error?: string; messageId?: string }> {
-    try {
-      const client = await this.getClient(account, cfg, accountId);
-
-      // Generate a message ID (Twurple's say() doesn't return the message ID, so we generate one)
-      const messageId = crypto.randomUUID();
-
-      // Send message (Twurple handles rate limiting)
-      await client.say(channel, message);
-
-      return { ok: true, messageId };
-    } catch (error) {
-      this.logger.error(
-        `Failed to send message: ${error instanceof Error ? error.message : String(error)}`,
-      );
-      return {
-        ok: false,
-        error: error instanceof Error ? error.message : String(error),
-      };
-    }
-  }
-
-  /**
-   * Generate a unique key for an account
-   */
-  public getAccountKey(account: TwitchAccountConfig): string {
-    return `${account.username}:${account.channel}`;
-  }
-
-  /**
-   * Clear all clients and handlers (for testing)
-   */
-  _clearForTest(): void {
-    this.clients.clear();
-    this.messageHandlers.clear();
-  }
-}

package/extensions/twitch/src/types.ts

@@ -1,141 +0,0 @@
-/**
- * Twitch channel plugin types.
- *
- * This file defines Twitch-specific types. Generic channel types are imported
- * from Clawdbot core.
- */
-
-import type {
-  ChannelAccountSnapshot,
-  ChannelCapabilities,
-  ChannelLogSink,
-  ChannelMessageActionAdapter,
-  ChannelMessageActionContext,
-  ChannelMeta,
-} from "../../../src/channels/plugins/types.core.js";
-import type { ChannelPlugin } from "../../../src/channels/plugins/types.plugin.js";
-import type {
-  ChannelGatewayContext,
-  ChannelOutboundAdapter,
-  ChannelOutboundContext,
-  ChannelResolveKind,
-  ChannelResolveResult,
-  ChannelStatusAdapter,
-} from "../../../src/channels/plugins/types.adapters.js";
-import type { ClawdbotConfig } from "../../../src/config/config.js";
-import type { OutboundDeliveryResult } from "../../../src/infra/outbound/deliver.js";
-import type { RuntimeEnv } from "../../../src/runtime.js";
-
-// ============================================================================
-// Twitch-Specific Types
-// ============================================================================
-
-/**
- * Twitch user roles that can be allowed to interact with the bot
- */
-export type TwitchRole = "moderator" | "owner" | "vip" | "subscriber" | "all";
-
-/**
- * Account configuration for a Twitch channel
- */
-export interface TwitchAccountConfig {
-  /** Twitch username */
-  username: string;
-  /** Twitch OAuth access token (requires chat:read and chat:write scopes) */
-  accessToken: string;
-  /** Twitch client ID (from Twitch Developer Portal or twitchtokengenerator.com) */
-  clientId: string;
-  /** Channel name to join (required) */
-  channel: string;
-  /** Enable this account */
-  enabled?: boolean;
-  /** Allowlist of Twitch user IDs who can interact with the bot (use IDs for safety, not usernames) */
-  allowFrom?: Array<string>;
-  /** Roles allowed to interact with the bot (e.g., ["mod", "vip", "sub"]) */
-  allowedRoles?: TwitchRole[];
-  /** Require @mention to trigger bot responses */
-  requireMention?: boolean;
-  /** Twitch client secret (required for token refresh via RefreshingAuthProvider) */
-  clientSecret?: string;
-  /** Refresh token (required for automatic token refresh) */
-  refreshToken?: string;
-  /** Token expiry time in seconds (optional, for token refresh tracking) */
-  expiresIn?: number | null;
-  /** Timestamp when token was obtained (optional, for token refresh tracking) */
-  obtainmentTimestamp?: number;
-}
-
-/**
- * Message target for Twitch
- */
-export interface TwitchTarget {
-  /** Account ID */
-  accountId: string;
-  /** Channel name (defaults to account's channel) */
-  channel?: string;
-}
-
-/**
- * Twitch message from chat
- */
-export interface TwitchChatMessage {
-  /** Username of sender */
-  username: string;
-  /** Twitch user ID of sender (unique, persistent identifier) */
-  userId?: string;
-  /** Message text */
-  message: string;
-  /** Channel name */
-  channel: string;
-  /** Display name (may include special characters) */
-  displayName?: string;
-  /** Message ID */
-  id?: string;
-  /** Timestamp */
-  timestamp?: Date;
-  /** Whether the sender is a moderator */
-  isMod?: boolean;
-  /** Whether the sender is the channel owner/broadcaster */
-  isOwner?: boolean;
-  /** Whether the sender is a VIP */
-  isVip?: boolean;
-  /** Whether the sender is a subscriber */
-  isSub?: boolean;
-  /** Chat type */
-  chatType?: "group";
-}
-
-/**
- * Send result from Twitch client
- */
-export interface SendResult {
-  ok: boolean;
-  error?: string;
-  messageId?: string;
-}
-
-// Re-export core types for convenience
-export type {
-  ChannelAccountSnapshot,
-  ChannelGatewayContext,
-  ChannelLogSink,
-  ChannelMessageActionAdapter,
-  ChannelMessageActionContext,
-  ChannelMeta,
-  ChannelOutboundAdapter,
-  ChannelStatusAdapter,
-  ChannelCapabilities,
-  ChannelResolveKind,
-  ChannelResolveResult,
-  ChannelPlugin,
-  ChannelOutboundContext,
-  OutboundDeliveryResult,
-};
-
-// Import and re-export the schema type
-import type { TwitchConfigSchema } from "./config-schema.js";
-import type { z } from "zod";
-export type TwitchConfig = z.infer<typeof TwitchConfigSchema>;
-
-export type { ClawdbotConfig };
-export type { RuntimeEnv };

package/extensions/twitch/src/utils/markdown.ts

@@ -1,92 +0,0 @@
-/**
- * Markdown utilities for Twitch chat
- *
- * Twitch chat doesn't support markdown formatting, so we strip it before sending.
- * Based on Clawdbot's markdownToText in src/agents/tools/web-fetch-utils.ts.
- */
-
-/**
- * Strip markdown formatting from text for Twitch compatibility.
- *
- * Removes images, links, bold, italic, strikethrough, code blocks, inline code,
- * headers, and list formatting. Replaces newlines with spaces since Twitch
- * is a single-line chat medium.
- *
- * @param markdown - The markdown text to strip
- * @returns Plain text with markdown removed
- */
-export function stripMarkdownForTwitch(markdown: string): string {
-  return (
-    markdown
-      // Images
-      .replace(/!\[[^\]]*]\([^)]+\)/g, "")
-      // Links
-      .replace(/\[([^\]]+)]\([^)]+\)/g, "$1")
-      // Bold (**text**)
-      .replace(/\*\*([^*]+)\*\*/g, "$1")
-      // Bold (__text__)
-      .replace(/__([^_]+)__/g, "$1")
-      // Italic (*text*)
-      .replace(/\*([^*]+)\*/g, "$1")
-      // Italic (_text_)
-      .replace(/_([^_]+)_/g, "$1")
-      // Strikethrough (~~text~~)
-      .replace(/~~([^~]+)~~/g, "$1")
-      // Code blocks
-      .replace(/```[\s\S]*?```/g, (block) => block.replace(/```[^\n]*\n?/g, "").replace(/```/g, ""))
-      // Inline code
-      .replace(/`([^`]+)`/g, "$1")
-      // Headers
-      .replace(/^#{1,6}\s+/gm, "")
-      // Lists
-      .replace(/^\s*[-*+]\s+/gm, "")
-      .replace(/^\s*\d+\.\s+/gm, "")
-      // Normalize whitespace
-      .replace(/\r/g, "") // Remove carriage returns
-      .replace(/[ \t]+\n/g, "\n") // Remove trailing spaces before newlines
-      .replace(/\n/g, " ") // Replace newlines with spaces (for Twitch)
-      .replace(/[ \t]{2,}/g, " ") // Reduce multiple spaces to single
-      .trim()
-  );
-}
-
-/**
- * Simple word-boundary chunker for Twitch (500 char limit).
- * Strips markdown before chunking to avoid breaking markdown patterns.
- *
- * @param text - The text to chunk
- * @param limit - Maximum characters per chunk (Twitch limit is 500)
- * @returns Array of text chunks
- */
-export function chunkTextForTwitch(text: string, limit: number): string[] {
-  // First, strip markdown
-  const cleaned = stripMarkdownForTwitch(text);
-  if (!cleaned) return [];
-  if (limit <= 0) return [cleaned];
-  if (cleaned.length <= limit) return [cleaned];
-
-  const chunks: string[] = [];
-  let remaining = cleaned;
-
-  while (remaining.length > limit) {
-    // Find the last space before the limit
-    const window = remaining.slice(0, limit);
-    const lastSpaceIndex = window.lastIndexOf(" ");
-
-    if (lastSpaceIndex === -1) {
-      // No space found, hard split at limit
-      chunks.push(window);
-      remaining = remaining.slice(limit);
-    } else {
-      // Split at the last space
-      chunks.push(window.slice(0, lastSpaceIndex));
-      remaining = remaining.slice(lastSpaceIndex + 1);
-    }
-  }
-
-  if (remaining) {
-    chunks.push(remaining);
-  }
-
-  return chunks;
-}

package/extensions/twitch/src/utils/twitch.ts

@@ -1,78 +0,0 @@
-/**
- * Twitch-specific utility functions
- */
-
-/**
- * Normalize Twitch channel names.
- *
- * Removes the '#' prefix if present, converts to lowercase, and trims whitespace.
- * Twitch channel names are case-insensitive and don't use the '#' prefix in the API.
- *
- * @param channel - The channel name to normalize
- * @returns Normalized channel name
- *
- * @example
- * normalizeTwitchChannel("#TwitchChannel") // "twitchchannel"
- * normalizeTwitchChannel("MyChannel") // "mychannel"
- */
-export function normalizeTwitchChannel(channel: string): string {
-  const trimmed = channel.trim().toLowerCase();
-  return trimmed.startsWith("#") ? trimmed.slice(1) : trimmed;
-}
-
-/**
- * Create a standardized error message for missing target.
- *
- * @param provider - The provider name (e.g., "Twitch")
- * @param hint - Optional hint for how to fix the issue
- * @returns Error object with descriptive message
- */
-export function missingTargetError(provider: string, hint?: string): Error {
-  return new Error(`Delivering to ${provider} requires target${hint ? ` ${hint}` : ""}`);
-}
-
-/**
- * Generate a unique message ID for Twitch messages.
- *
- * Twurple's say() doesn't return the message ID, so we generate one
- * for tracking purposes.
- *
- * @returns A unique message ID
- */
-export function generateMessageId(): string {
-  return `${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;
-}
-
-/**
- * Normalize OAuth token by removing the "oauth:" prefix if present.
- *
- * Twurple doesn't require the "oauth:" prefix, so we strip it for consistency.
- *
- * @param token - The OAuth token to normalize
- * @returns Normalized token without "oauth:" prefix
- *
- * @example
- * normalizeToken("oauth:abc123") // "abc123"
- * normalizeToken("abc123") // "abc123"
- */
-export function normalizeToken(token: string): string {
-  return token.startsWith("oauth:") ? token.slice(6) : token;
-}
-
-/**
- * Check if an account is properly configured with required credentials.
- *
- * @param account - The Twitch account config to check
- * @returns true if the account has required credentials
- */
-export function isAccountConfigured(
-  account: {
-    username?: string;
-    accessToken?: string;
-    clientId?: string;
-  },
-  resolvedToken?: string | null,
-): boolean {
-  const token = resolvedToken ?? account?.accessToken;
-  return Boolean(account?.username && token && account?.clientId);
-}

package/extensions/twitch/test/setup.ts

@@ -1,7 +0,0 @@
-/**
- * Vitest setup file for Twitch plugin tests.
- *
- * Re-exports the root test setup to avoid duplication.
- */
-
-export * from "../../../test/setup.js";

package/extensions/voice-call/CHANGELOG.md

@@ -1,72 +0,0 @@
-# Changelog
-
-## 2026.1.25
-
-### Changes
-- Breaking: voice-call TTS now uses core `messages.tts` (plugin TTS config deep‑merges with core).
-- Telephony TTS supports OpenAI + ElevenLabs; Edge TTS is ignored for calls.
-- Removed legacy `tts.model`/`tts.voice`/`tts.instructions` plugin fields.
-
-## 2026.1.23
-
-### Changes
-- Version alignment with core Clawdbot release numbers.
-
-## 2026.1.22
-
-### Changes
-- Version alignment with core Clawdbot release numbers.
-
-## 2026.1.21
-
-### Changes
-- Version alignment with core Clawdbot release numbers.
-
-## 2026.1.20
-
-### Changes
-- Version alignment with core Clawdbot release numbers.
-
-## 2026.1.17-1
-
-### Changes
-- Version alignment with core Clawdbot release numbers.
-
-## 2026.1.17
-
-### Changes
-- Version alignment with core Clawdbot release numbers.
-
-## 2026.1.16
-
-### Changes
-- Version alignment with core Clawdbot release numbers.
-
-## 2026.1.15
-
-### Changes
-- Version alignment with core Clawdbot release numbers.
-
-## 2026.1.14
-
-### Changes
-- Version alignment with core Clawdbot release numbers.
-
-## 0.1.0
-
-### Highlights
-- First public release of the @clawdbot/voice-call plugin.
-
-### Features
-- Providers: Twilio (Programmable Voice + Media Streams), Telnyx (Call Control v2), and mock provider for local dev.
-- Call flows: outbound notify vs. conversation modes, configurable auto‑hangup, and multi‑turn continuation.
-- Inbound handling: policy controls (disabled/allowlist/open), allowlist matching, and inbound greeting.
-- Webhooks: built‑in server with configurable bind/port/path plus `publicUrl` override.
-- Exposure helpers: ngrok + Tailscale serve/funnel; dev‑only signature bypass for ngrok free tier.
-- Streaming: OpenAI Realtime STT over media WebSocket with partial + final transcripts.
-- Speech: OpenAI TTS (model/voice/instructions) with Twilio `<Say>` fallback.
-- Tooling: `voice_call` tool actions for initiate/continue/speak/end/status.
-- Gateway RPC: `voicecall.initiate|continue|speak|end|status` (+ legacy `voicecall.start`).
-- CLI: `clawdbot voicecall` commands (call/start/continue/speak/end/status/tail/expose).
-- Observability: JSONL call logs and `voicecall tail` for live inspection.
-- Response controls: `responseModel`, `responseSystemPrompt`, and `responseTimeoutMs` for auto‑responses.