loudmouth-ai 0.1.0 → 0.2.0

package/extensions/tlon/src/urbit/sse-client.ts

@@ -1,367 +0,0 @@
-import { Readable } from "node:stream";
-
-export type UrbitSseLogger = {
-  log?: (message: string) => void;
-  error?: (message: string) => void;
-};
-
-type UrbitSseOptions = {
-  ship?: string;
-  onReconnect?: (client: UrbitSSEClient) => Promise<void> | void;
-  autoReconnect?: boolean;
-  maxReconnectAttempts?: number;
-  reconnectDelay?: number;
-  maxReconnectDelay?: number;
-  logger?: UrbitSseLogger;
-};
-
-export class UrbitSSEClient {
-  url: string;
-  cookie: string;
-  ship: string;
-  channelId: string;
-  channelUrl: string;
-  subscriptions: Array<{
-    id: number;
-    action: "subscribe";
-    ship: string;
-    app: string;
-    path: string;
-  }> = [];
-  eventHandlers = new Map<
-    number,
-    { event?: (data: unknown) => void; err?: (error: unknown) => void; quit?: () => void }
-  >();
-  aborted = false;
-  streamController: AbortController | null = null;
-  onReconnect: UrbitSseOptions["onReconnect"] | null;
-  autoReconnect: boolean;
-  reconnectAttempts = 0;
-  maxReconnectAttempts: number;
-  reconnectDelay: number;
-  maxReconnectDelay: number;
-  isConnected = false;
-  logger: UrbitSseLogger;
-
-  constructor(url: string, cookie: string, options: UrbitSseOptions = {}) {
-    this.url = url;
-    this.cookie = cookie.split(";")[0];
-    this.ship = options.ship?.replace(/^~/, "") ?? this.resolveShipFromUrl(url);
-    this.channelId = `${Math.floor(Date.now() / 1000)}-${Math.random().toString(36).substring(2, 8)}`;
-    this.channelUrl = `${url}/~/channel/${this.channelId}`;
-    this.onReconnect = options.onReconnect ?? null;
-    this.autoReconnect = options.autoReconnect !== false;
-    this.maxReconnectAttempts = options.maxReconnectAttempts ?? 10;
-    this.reconnectDelay = options.reconnectDelay ?? 1000;
-    this.maxReconnectDelay = options.maxReconnectDelay ?? 30000;
-    this.logger = options.logger ?? {};
-  }
-
-  private resolveShipFromUrl(url: string): string {
-    try {
-      const parsed = new URL(url);
-      const host = parsed.hostname;
-      if (host.includes(".")) {
-        return host.split(".")[0] ?? host;
-      }
-      return host;
-    } catch {
-      return "";
-    }
-  }
-
-  async subscribe(params: {
-    app: string;
-    path: string;
-    event?: (data: unknown) => void;
-    err?: (error: unknown) => void;
-    quit?: () => void;
-  }) {
-    const subId = this.subscriptions.length + 1;
-    const subscription = {
-      id: subId,
-      action: "subscribe",
-      ship: this.ship,
-      app: params.app,
-      path: params.path,
-    } as const;
-
-    this.subscriptions.push(subscription);
-    this.eventHandlers.set(subId, { event: params.event, err: params.err, quit: params.quit });
-
-    if (this.isConnected) {
-      try {
-        await this.sendSubscription(subscription);
-      } catch (error) {
-        const handler = this.eventHandlers.get(subId);
-        handler?.err?.(error);
-      }
-    }
-    return subId;
-  }
-
-  private async sendSubscription(subscription: {
-    id: number;
-    action: "subscribe";
-    ship: string;
-    app: string;
-    path: string;
-  }) {
-    const response = await fetch(this.channelUrl, {
-      method: "PUT",
-      headers: {
-        "Content-Type": "application/json",
-        Cookie: this.cookie,
-      },
-      body: JSON.stringify([subscription]),
-    });
-
-    if (!response.ok && response.status !== 204) {
-      const errorText = await response.text();
-      throw new Error(`Subscribe failed: ${response.status} - ${errorText}`);
-    }
-  }
-
-  async connect() {
-    const createResp = await fetch(this.channelUrl, {
-      method: "PUT",
-      headers: {
-        "Content-Type": "application/json",
-        Cookie: this.cookie,
-      },
-      body: JSON.stringify(this.subscriptions),
-    });
-
-    if (!createResp.ok && createResp.status !== 204) {
-      throw new Error(`Channel creation failed: ${createResp.status}`);
-    }
-
-    const pokeResp = await fetch(this.channelUrl, {
-      method: "PUT",
-      headers: {
-        "Content-Type": "application/json",
-        Cookie: this.cookie,
-      },
-      body: JSON.stringify([
-        {
-          id: Date.now(),
-          action: "poke",
-          ship: this.ship,
-          app: "hood",
-          mark: "helm-hi",
-          json: "Opening API channel",
-        },
-      ]),
-    });
-
-    if (!pokeResp.ok && pokeResp.status !== 204) {
-      throw new Error(`Channel activation failed: ${pokeResp.status}`);
-    }
-
-    await this.openStream();
-    this.isConnected = true;
-    this.reconnectAttempts = 0;
-  }
-
-  async openStream() {
-    const response = await fetch(this.channelUrl, {
-      method: "GET",
-      headers: {
-        Accept: "text/event-stream",
-        Cookie: this.cookie,
-      },
-    });
-
-    if (!response.ok) {
-      throw new Error(`Stream connection failed: ${response.status}`);
-    }
-
-    this.processStream(response.body).catch((error) => {
-      if (!this.aborted) {
-        this.logger.error?.(`Stream error: ${String(error)}`);
-        for (const { err } of this.eventHandlers.values()) {
-          if (err) err(error);
-        }
-      }
-    });
-  }
-
-  async processStream(body: ReadableStream<Uint8Array> | Readable | null) {
-    if (!body) return;
-    const stream = body instanceof ReadableStream ? Readable.fromWeb(body) : body;
-    let buffer = "";
-
-    try {
-      for await (const chunk of stream) {
-        if (this.aborted) break;
-        buffer += chunk.toString();
-        let eventEnd;
-        while ((eventEnd = buffer.indexOf("\n\n")) !== -1) {
-          const eventData = buffer.substring(0, eventEnd);
-          buffer = buffer.substring(eventEnd + 2);
-          this.processEvent(eventData);
-        }
-      }
-    } finally {
-      if (!this.aborted && this.autoReconnect) {
-        this.isConnected = false;
-        this.logger.log?.("[SSE] Stream ended, attempting reconnection...");
-        await this.attemptReconnect();
-      }
-    }
-  }
-
-  processEvent(eventData: string) {
-    const lines = eventData.split("\n");
-    let data: string | null = null;
-
-    for (const line of lines) {
-      if (line.startsWith("data: ")) {
-        data = line.substring(6);
-      }
-    }
-
-    if (!data) return;
-
-    try {
-      const parsed = JSON.parse(data) as { id?: number; json?: unknown; response?: string };
-
-      if (parsed.response === "quit") {
-        if (parsed.id) {
-          const handlers = this.eventHandlers.get(parsed.id);
-          if (handlers?.quit) handlers.quit();
-        }
-        return;
-      }
-
-      if (parsed.id && this.eventHandlers.has(parsed.id)) {
-        const { event } = this.eventHandlers.get(parsed.id) ?? {};
-        if (event && parsed.json) {
-          event(parsed.json);
-        }
-      } else if (parsed.json) {
-        for (const { event } of this.eventHandlers.values()) {
-          if (event) event(parsed.json);
-        }
-      }
-    } catch (error) {
-      this.logger.error?.(`Error parsing SSE event: ${String(error)}`);
-    }
-  }
-
-  async poke(params: { app: string; mark: string; json: unknown }) {
-    const pokeId = Date.now();
-    const pokeData = {
-      id: pokeId,
-      action: "poke",
-      ship: this.ship,
-      app: params.app,
-      mark: params.mark,
-      json: params.json,
-    };
-
-    const response = await fetch(this.channelUrl, {
-      method: "PUT",
-      headers: {
-        "Content-Type": "application/json",
-        Cookie: this.cookie,
-      },
-      body: JSON.stringify([pokeData]),
-    });
-
-    if (!response.ok && response.status !== 204) {
-      const errorText = await response.text();
-      throw new Error(`Poke failed: ${response.status} - ${errorText}`);
-    }
-
-    return pokeId;
-  }
-
-  async scry(path: string) {
-    const scryUrl = `${this.url}/~/scry${path}`;
-    const response = await fetch(scryUrl, {
-      method: "GET",
-      headers: {
-        Cookie: this.cookie,
-      },
-    });
-
-    if (!response.ok) {
-      throw new Error(`Scry failed: ${response.status} for path ${path}`);
-    }
-
-    return await response.json();
-  }
-
-  async attemptReconnect() {
-    if (this.aborted || !this.autoReconnect) {
-      this.logger.log?.("[SSE] Reconnection aborted or disabled");
-      return;
-    }
-
-    if (this.reconnectAttempts >= this.maxReconnectAttempts) {
-      this.logger.error?.(
-        `[SSE] Max reconnection attempts (${this.maxReconnectAttempts}) reached. Giving up.`,
-      );
-      return;
-    }
-
-    this.reconnectAttempts += 1;
-    const delay = Math.min(
-      this.reconnectDelay * Math.pow(2, this.reconnectAttempts - 1),
-      this.maxReconnectDelay,
-    );
-
-    this.logger.log?.(
-      `[SSE] Reconnection attempt ${this.reconnectAttempts}/${this.maxReconnectAttempts} in ${delay}ms...`,
-    );
-
-    await new Promise((resolve) => setTimeout(resolve, delay));
-
-    try {
-      this.channelId = `${Math.floor(Date.now() / 1000)}-${Math.random().toString(36).substring(2, 8)}`;
-      this.channelUrl = `${this.url}/~/channel/${this.channelId}`;
-
-      if (this.onReconnect) {
-        await this.onReconnect(this);
-      }
-
-      await this.connect();
-      this.logger.log?.("[SSE] Reconnection successful!");
-    } catch (error) {
-      this.logger.error?.(`[SSE] Reconnection failed: ${String(error)}`);
-      await this.attemptReconnect();
-    }
-  }
-
-  async close() {
-    this.aborted = true;
-    this.isConnected = false;
-
-    try {
-      const unsubscribes = this.subscriptions.map((sub) => ({
-        id: sub.id,
-        action: "unsubscribe",
-        subscription: sub.id,
-      }));
-
-      await fetch(this.channelUrl, {
-        method: "PUT",
-        headers: {
-          "Content-Type": "application/json",
-          Cookie: this.cookie,
-        },
-        body: JSON.stringify(unsubscribes),
-      });
-
-      await fetch(this.channelUrl, {
-        method: "DELETE",
-        headers: {
-          Cookie: this.cookie,
-        },
-      });
-    } catch (error) {
-      this.logger.error?.(`Error closing channel: ${String(error)}`);
-    }
-  }
-}

package/extensions/twitch/CHANGELOG.md

@@ -1,21 +0,0 @@
-# Changelog
-
-## 2026.1.23
-
-### Features
-
-- Initial Twitch plugin release
-- Twitch chat integration via @twurple (IRC connection)
-- Multi-account support with per-channel configuration
-- Access control via user ID allowlists and role-based restrictions
-- Automatic token refresh with RefreshingAuthProvider
-- Environment variable fallback for default account token
-- Message actions support
-- Status monitoring and probing
-- Outbound message delivery with markdown stripping
-
-### Improvements
-
-- Added proper configuration schema with Zod validation
-- Added plugin descriptor (clawdbot.plugin.json)
-- Added comprehensive README and documentation

package/extensions/twitch/README.md

@@ -1,89 +0,0 @@
-# @clawdbot/twitch
-
-Twitch channel plugin for Clawdbot.
-
-## Install (local checkout)
-
-```bash
-clawdbot plugins install ./extensions/twitch
-```
-
-## Install (npm)
-
-```bash
-clawdbot plugins install @clawdbot/twitch
-```
-
-Onboarding: select Twitch and confirm the install prompt to fetch the plugin automatically.
-
-## Config
-
-Minimal config (simplified single-account):
-
-**⚠️ Important:** `requireMention` defaults to `true`. Add access control (`allowFrom` or `allowedRoles`) to prevent unauthorized users from triggering the bot.
-
-```json5
-{
-  channels: {
-    twitch: {
-      enabled: true,
-      username: "clawdbot",
-      accessToken: "oauth:abc123...", // OAuth Access Token (add oauth: prefix)
-      clientId: "xyz789...", // Client ID from Token Generator
-      channel: "vevisk", // Channel to join (required)
-      allowFrom: ["123456789"], // (recommended) Your Twitch user ID only (Convert your twitch username to ID at https://www.streamweasels.com/tools/convert-twitch-username-%20to-user-id/)
-    },
-  },
-}
-```
-
-**Access control options:**
-
-- `requireMention: false` - Disable the default mention requirement to respond to all messages
-- `allowFrom: ["your_user_id"]` - Restrict to your Twitch user ID only (find your ID at https://www.twitchangles.com/xqc or similar)
-- `allowedRoles: ["moderator", "vip", "subscriber"]` - Restrict to specific roles
-
-Multi-account config (advanced):
-
-```json5
-{
-  channels: {
-    twitch: {
-      enabled: true,
-      accounts: {
-        default: {
-          username: "clawdbot",
-          accessToken: "oauth:abc123...",
-          clientId: "xyz789...",
-          channel: "vevisk",
-        },
-        channel2: {
-          username: "clawdbot",
-          accessToken: "oauth:def456...",
-          clientId: "uvw012...",
-          channel: "secondchannel",
-        },
-      },
-    },
-  },
-}
-```
-
-## Setup
-
-1. Create a dedicated Twitch account for the bot, then generate credentials: [Twitch Token Generator](https://twitchtokengenerator.com/)
-   - Select **Bot Token**
-   - Verify scopes `chat:read` and `chat:write` are selected
-   - Copy the **Access Token** to `token` property
-   - Copy the **Client ID** to `clientId` property
-2. Start the gateway
-
-## Full documentation
-
-See https://docs.clawd.bot/channels/twitch for:
-
-- Token refresh setup
-- Access control patterns
-- Multi-account configuration
-- Troubleshooting
-- Capabilities & limits

package/extensions/twitch/clawdbot.plugin.json

@@ -1,9 +0,0 @@
-{
-  "id": "twitch",
-  "channels": ["twitch"],
-  "configSchema": {
-    "type": "object",
-    "additionalProperties": false,
-    "properties": {}
-  }
-}

package/extensions/twitch/index.ts

@@ -1,20 +0,0 @@
-import type { ClawdbotPluginApi } from "clawdbot/plugin-sdk";
-import { emptyPluginConfigSchema } from "clawdbot/plugin-sdk";
-
-import { twitchPlugin } from "./src/plugin.js";
-import { setTwitchRuntime } from "./src/runtime.js";
-
-export { monitorTwitchProvider } from "./src/monitor.js";
-
-const plugin = {
-  id: "twitch",
-  name: "Twitch",
-  description: "Twitch channel plugin",
-  configSchema: emptyPluginConfigSchema(),
-  register(api: ClawdbotPluginApi) {
-    setTwitchRuntime(api.runtime);
-    api.registerChannel({ plugin: twitchPlugin as any });
-  },
-};
-
-export default plugin;

package/extensions/twitch/package.json

@@ -1,20 +0,0 @@
-{
-  "name": "@clawdbot/twitch",
-  "version": "2026.1.23",
-  "description": "Clawdbot Twitch channel plugin",
-  "type": "module",
-  "dependencies": {
-    "@twurple/api": "^8.0.3",
-    "@twurple/auth": "^8.0.3",
-    "@twurple/chat": "^8.0.3",
-    "zod": "^4.3.5"
-  },
-  "devDependencies": {
-    "clawdbot": "workspace:*"
-  },
-  "clawdbot": {
-    "extensions": [
-      "./index.ts"
-    ]
-  }
-}