@poolzin/pool-bot 2026.1.26 → 2026.1.29

package/extensions/telegram/index.ts

@@ -1,5 +1,5 @@
-import type { ClawdbotPluginApi } from "clawdbot/plugin-sdk";
-import { emptyPluginConfigSchema } from "clawdbot/plugin-sdk";
+import type { MoltbotPluginApi } from "poolbot/plugin-sdk";
+import { emptyPluginConfigSchema } from "poolbot/plugin-sdk";
 
 import { telegramPlugin } from "./src/channel.js";
 import { setTelegramRuntime } from "./src/runtime.js";
@@ -9,7 +9,7 @@ const plugin = {
   name: "Telegram",
   description: "Telegram channel plugin",
   configSchema: emptyPluginConfigSchema(),
-  register(api: ClawdbotPluginApi) {
+  register(api: MoltbotPluginApi) {
     setTelegramRuntime(api.runtime);
     api.registerChannel({ plugin: telegramPlugin });
   },

package/extensions/telegram/package.json

@@ -1,9 +1,9 @@
 {
-  "name": "@clawdbot/telegram",
-  "version": "2026.1.24",
+  "name": "@poolbot/telegram",
+  "version": "2026.1.26",
   "type": "module",
-  "description": "Clawdbot Telegram channel plugin",
-  "clawdbot": {
+  "description": "Moltbot Telegram channel plugin",
+  "poolbot": {
     "extensions": [
       "./index.ts"
     ]

package/extensions/telegram/src/channel.ts

@@ -23,9 +23,9 @@ import {
   TelegramConfigSchema,
   type ChannelMessageActionAdapter,
   type ChannelPlugin,
-  type ClawdbotConfig,
+  type MoltbotConfig,
   type ResolvedTelegramAccount,
-} from "clawdbot/plugin-sdk";
+} from "poolbot/plugin-sdk";
 
 import { getTelegramRuntime } from "./runtime.js";
 
@@ -408,7 +408,7 @@ export const telegramPlugin: ChannelPlugin<ResolvedTelegramAccount> = {
     },
     logoutAccount: async ({ accountId, cfg }) => {
       const envToken = process.env.TELEGRAM_BOT_TOKEN?.trim() ?? "";
-      const nextCfg = { ...cfg } as ClawdbotConfig;
+      const nextCfg = { ...cfg } as MoltbotConfig;
       const nextTelegram = cfg.channels?.telegram ? { ...cfg.channels.telegram } : undefined;
       let cleared = false;
       let changed = false;

package/extensions/telegram/src/runtime.ts

@@ -1,4 +1,4 @@
-import type { PluginRuntime } from "clawdbot/plugin-sdk";
+import type { PluginRuntime } from "poolbot/plugin-sdk";
 
 let runtime: PluginRuntime | null = null;
 

package/extensions/tlon/README.md

@@ -2,4 +2,4 @@
 
 Tlon/Urbit channel plugin for Clawdbot. Supports DMs, group mentions, and thread replies.
 
-Docs: https://docs.clawd.bot/channels/tlon
+Docs: https://docs.molt.bot/channels/tlon

package/extensions/tlon/index.ts

@@ -1,5 +1,5 @@
-import type { ClawdbotPluginApi } from "clawdbot/plugin-sdk";
-import { emptyPluginConfigSchema } from "clawdbot/plugin-sdk";
+import type { MoltbotPluginApi } from "poolbot/plugin-sdk";
+import { emptyPluginConfigSchema } from "poolbot/plugin-sdk";
 
 import { tlonPlugin } from "./src/channel.js";
 import { setTlonRuntime } from "./src/runtime.js";
@@ -9,7 +9,7 @@ const plugin = {
   name: "Tlon",
   description: "Tlon/Urbit channel plugin",
   configSchema: emptyPluginConfigSchema(),
-  register(api: ClawdbotPluginApi) {
+  register(api: MoltbotPluginApi) {
     setTlonRuntime(api.runtime);
     api.registerChannel({ plugin: tlonPlugin });
   },

package/extensions/tlon/package.json

@@ -1,9 +1,9 @@
 {
-  "name": "@clawdbot/tlon",
-  "version": "2026.1.24",
+  "name": "@poolbot/tlon",
+  "version": "2026.1.26",
   "type": "module",
-  "description": "Clawdbot Tlon/Urbit channel plugin",
-  "clawdbot": {
+  "description": "Moltbot Tlon/Urbit channel plugin",
+  "poolbot": {
     "extensions": [
       "./index.ts"
     ],
@@ -18,7 +18,7 @@
       "quickstartAllowFrom": true
     },
     "install": {
-      "npmSpec": "@clawdbot/tlon",
+      "npmSpec": "@poolbot/tlon",
       "localPath": "extensions/tlon",
       "defaultChoice": "npm"
     }

package/extensions/tlon/src/channel.ts

@@ -2,13 +2,13 @@ import type {
   ChannelOutboundAdapter,
   ChannelPlugin,
   ChannelSetupInput,
-  ClawdbotConfig,
-} from "clawdbot/plugin-sdk";
+  MoltbotConfig,
+} from "poolbot/plugin-sdk";
 import {
   applyAccountNameToChannelSection,
   DEFAULT_ACCOUNT_ID,
   normalizeAccountId,
-} from "clawdbot/plugin-sdk";
+} from "poolbot/plugin-sdk";
 
 import { resolveTlonAccount, listTlonAccountIds } from "./types.js";
 import { formatTargetHint, normalizeShip, parseTlonTarget } from "./targets.js";
@@ -30,10 +30,10 @@ type TlonSetupInput = ChannelSetupInput & {
 };
 
 function applyTlonSetupConfig(params: {
-  cfg: ClawdbotConfig;
+  cfg: MoltbotConfig;
   accountId: string;
   input: TlonSetupInput;
-}): ClawdbotConfig {
+}): MoltbotConfig {
   const { cfg, accountId, input } = params;
   const useDefault = accountId === DEFAULT_ACCOUNT_ID;
   const namedConfig = applyAccountNameToChannelSection({
@@ -108,7 +108,7 @@ const tlonOutbound: ChannelOutboundAdapter = {
     return { ok: true, to: parsed.nest };
   },
   sendText: async ({ cfg, to, text, accountId, replyToId, threadId }) => {
-    const account = resolveTlonAccount(cfg as ClawdbotConfig, accountId ?? undefined);
+    const account = resolveTlonAccount(cfg as MoltbotConfig, accountId ?? undefined);
     if (!account.configured || !account.ship || !account.url || !account.code) {
       throw new Error("Tlon account not configured");
     }
@@ -188,8 +188,8 @@ export const tlonPlugin: ChannelPlugin = {
   reload: { configPrefixes: ["channels.tlon"] },
   configSchema: tlonChannelConfigSchema,
   config: {
-    listAccountIds: (cfg) => listTlonAccountIds(cfg as ClawdbotConfig),
-    resolveAccount: (cfg, accountId) => resolveTlonAccount(cfg as ClawdbotConfig, accountId ?? undefined),
+    listAccountIds: (cfg) => listTlonAccountIds(cfg as MoltbotConfig),
+    resolveAccount: (cfg, accountId) => resolveTlonAccount(cfg as MoltbotConfig, accountId ?? undefined),
     defaultAccountId: () => "default",
     setAccountEnabled: ({ cfg, accountId, enabled }) => {
       const useDefault = !accountId || accountId === "default";
@@ -203,7 +203,7 @@ export const tlonPlugin: ChannelPlugin = {
               enabled,
             },
           },
-        } as ClawdbotConfig;
+        } as MoltbotConfig;
       }
       return {
         ...cfg,
@@ -220,7 +220,7 @@ export const tlonPlugin: ChannelPlugin = {
             },
           },
         },
-      } as ClawdbotConfig;
+      } as MoltbotConfig;
     },
     deleteAccount: ({ cfg, accountId }) => {
       const useDefault = !accountId || accountId === "default";
@@ -232,7 +232,7 @@ export const tlonPlugin: ChannelPlugin = {
             ...cfg.channels,
             tlon: rest,
           },
-        } as ClawdbotConfig;
+        } as MoltbotConfig;
       }
       const { [accountId]: removed, ...remainingAccounts } = cfg.channels?.tlon?.accounts ?? {};
       return {
@@ -244,7 +244,7 @@ export const tlonPlugin: ChannelPlugin = {
             accounts: remainingAccounts,
           },
         },
-      } as ClawdbotConfig;
+      } as MoltbotConfig;
     },
     isConfigured: (account) => account.configured,
     describeAccount: (account) => ({
@@ -260,14 +260,14 @@ export const tlonPlugin: ChannelPlugin = {
     resolveAccountId: ({ accountId }) => normalizeAccountId(accountId),
     applyAccountName: ({ cfg, accountId, name }) =>
       applyAccountNameToChannelSection({
-        cfg: cfg as ClawdbotConfig,
+        cfg: cfg as MoltbotConfig,
         channelKey: "tlon",
         accountId,
         name,
       }),
     validateInput: ({ cfg, accountId, input }) => {
       const setupInput = input as TlonSetupInput;
-      const resolved = resolveTlonAccount(cfg as ClawdbotConfig, accountId ?? undefined);
+      const resolved = resolveTlonAccount(cfg as MoltbotConfig, accountId ?? undefined);
       const ship = setupInput.ship?.trim() || resolved.ship;
       const url = setupInput.url?.trim() || resolved.url;
       const code = setupInput.code?.trim() || resolved.code;
@@ -278,7 +278,7 @@ export const tlonPlugin: ChannelPlugin = {
     },
     applyAccountConfig: ({ cfg, accountId, input }) =>
       applyTlonSetupConfig({
-        cfg: cfg as ClawdbotConfig,
+        cfg: cfg as MoltbotConfig,
         accountId,
         input: input as TlonSetupInput,
       }),

package/extensions/tlon/src/config-schema.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { buildChannelConfigSchema } from "clawdbot/plugin-sdk";
+import { buildChannelConfigSchema } from "poolbot/plugin-sdk";
 
 const ShipSchema = z.string().min(1);
 const ChannelNestSchema = z.string().min(1);

package/extensions/tlon/src/monitor/discovery.ts

@@ -1,4 +1,4 @@
-import type { RuntimeEnv } from "clawdbot/plugin-sdk";
+import type { RuntimeEnv } from "poolbot/plugin-sdk";
 
 import { formatChangesDate } from "./utils.js";
 

package/extensions/tlon/src/monitor/history.ts

@@ -1,4 +1,4 @@
-import type { RuntimeEnv } from "clawdbot/plugin-sdk";
+import type { RuntimeEnv } from "poolbot/plugin-sdk";
 
 import { extractMessageText } from "./utils.js";
 

package/extensions/tlon/src/monitor/index.ts

@@ -1,6 +1,6 @@
 import { format } from "node:util";
 
-import type { RuntimeEnv, ReplyPayload, ClawdbotConfig } from "clawdbot/plugin-sdk";
+import type { RuntimeEnv, ReplyPayload, MoltbotConfig } from "poolbot/plugin-sdk";
 
 import { getTlonRuntime } from "../runtime.js";
 import { resolveTlonAccount } from "../types.js";
@@ -31,7 +31,7 @@ type ChannelAuthorization = {
 };
 
 function resolveChannelAuthorization(
-  cfg: ClawdbotConfig,
+  cfg: MoltbotConfig,
   channelNest: string,
 ): { mode: "restricted" | "open"; allowedShips: string[] } {
   const tlonConfig = cfg.channels?.tlon as
@@ -49,7 +49,7 @@ function resolveChannelAuthorization(
 
 export async function monitorTlonProvider(opts: MonitorTlonOpts = {}): Promise<void> {
   const core = getTlonRuntime();
-  const cfg = core.config.loadConfig() as ClawdbotConfig;
+  const cfg = core.config.loadConfig() as MoltbotConfig;
   if (cfg.channels?.tlon?.enabled === false) return;
 
   const logger = core.logging.getChildLogger({ module: "tlon-auto-reply" });

package/extensions/tlon/src/onboarding.ts

@@ -5,11 +5,11 @@ import {
   normalizeAccountId,
   type ChannelOnboardingAdapter,
   type WizardPrompter,
-} from "clawdbot/plugin-sdk";
+} from "poolbot/plugin-sdk";
 
 import { listTlonAccountIds, resolveTlonAccount } from "./types.js";
 import type { TlonResolvedAccount } from "./types.js";
-import type { ClawdbotConfig } from "clawdbot/plugin-sdk";
+import type { MoltbotConfig } from "poolbot/plugin-sdk";
 
 const channel = "tlon" as const;
 
@@ -18,7 +18,7 @@ function isConfigured(account: TlonResolvedAccount): boolean {
 }
 
 function applyAccountConfig(params: {
-  cfg: ClawdbotConfig;
+  cfg: MoltbotConfig;
   accountId: string;
   input: {
     name?: string;
@@ -29,7 +29,7 @@ function applyAccountConfig(params: {
     dmAllowlist?: string[];
     autoDiscoverChannels?: boolean;
   };
-}): ClawdbotConfig {
+}): MoltbotConfig {
   const { cfg, accountId, input } = params;
   const useDefault = accountId === DEFAULT_ACCOUNT_ID;
   const base = cfg.channels?.tlon ?? {};

package/extensions/tlon/src/runtime.ts

@@ -1,4 +1,4 @@
-import type { PluginRuntime } from "clawdbot/plugin-sdk";
+import type { PluginRuntime } from "poolbot/plugin-sdk";
 
 let runtime: PluginRuntime | null = null;
 

package/extensions/tlon/src/types.ts

@@ -1,4 +1,4 @@
-import type { ClawdbotConfig } from "clawdbot/plugin-sdk";
+import type { MoltbotConfig } from "poolbot/plugin-sdk";
 
 export type TlonResolvedAccount = {
   accountId: string;
@@ -14,7 +14,7 @@ export type TlonResolvedAccount = {
   showModelSignature: boolean | null;
 };
 
-export function resolveTlonAccount(cfg: ClawdbotConfig, accountId?: string | null): TlonResolvedAccount {
+export function resolveTlonAccount(cfg: MoltbotConfig, accountId?: string | null): TlonResolvedAccount {
   const base = cfg.channels?.tlon as
     | {
         name?: string;
@@ -75,7 +75,7 @@ export function resolveTlonAccount(cfg: ClawdbotConfig, accountId?: string | nul
   };
 }
 
-export function listTlonAccountIds(cfg: ClawdbotConfig): string[] {
+export function listTlonAccountIds(cfg: MoltbotConfig): string[] {
   const base = cfg.channels?.tlon as
     | { ship?: string; accounts?: Record<string, Record<string, unknown>> }
     | undefined;

package/extensions/tlon/src/urbit/send.ts

@@ -63,16 +63,28 @@ export async function sendGroupMessage({
   const story = [{ inline: [text] }];
   const sentAt = Date.now();
 
+  // Format reply ID as @ud (with dots) - required for Tlon to recognize thread replies
+  let formattedReplyId = replyToId;
+  if (replyToId && /^\d+$/.test(replyToId)) {
+    try {
+      formattedReplyId = formatUd(BigInt(replyToId));
+    } catch {
+      // Fall back to raw ID if formatting fails
+    }
+  }
+
   const action = {
     channel: {
       nest: `chat/${hostShip}/${channelName}`,
-      action: replyToId
+      action: formattedReplyId
         ? {
-            reply: {
-              id: replyToId,
-              delta: {
-                add: {
-                  memo: {
+            // Thread reply - needs post wrapper around reply action
+            // ReplyActionAdd takes Memo: {content, author, sent} - no kind/blob/meta
+            post: {
+              reply: {
+                id: formattedReplyId,
+                action: {
+                  add: {
                     content: story,
                     author: fromShip,
                     sent: sentAt,
@@ -82,6 +94,7 @@ export async function sendGroupMessage({
             },
           }
         : {
+            // Regular post
             post: {
               add: {
                 content: story,

package/extensions/twitch/CHANGELOG.md

@@ -0,0 +1,21 @@
+# 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 (poolbot.plugin.json)
+- Added comprehensive README and documentation

package/extensions/twitch/README.md

@@ -0,0 +1,89 @@
+# @poolbot/twitch
+
+Twitch channel plugin for Clawdbot.
+
+## Install (local checkout)
+
+```bash
+poolbot plugins install ./extensions/twitch
+```
+
+## Install (npm)
+
+```bash
+poolbot plugins install @poolbot/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: "poolbot",
+      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: "poolbot",
+          accessToken: "oauth:abc123...",
+          clientId: "xyz789...",
+          channel: "vevisk",
+        },
+        channel2: {
+          username: "poolbot",
+          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.molt.bot/channels/twitch for:
+
+- Token refresh setup
+- Access control patterns
+- Multi-account configuration
+- Troubleshooting
+- Capabilities & limits

package/extensions/twitch/index.ts

@@ -0,0 +1,20 @@
+import type { MoltbotPluginApi } from "poolbot/plugin-sdk";
+import { emptyPluginConfigSchema } from "poolbot/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: MoltbotPluginApi) {
+    setTwitchRuntime(api.runtime);
+    api.registerChannel({ plugin: twitchPlugin as any });
+  },
+};
+
+export default plugin;

package/extensions/twitch/node_modules/.bin/poolbot

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/root/pool-bot-src/dist/node_modules:/root/pool-bot-src/node_modules:/root/node_modules:/node_modules:/root/pool-bot-src/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/root/pool-bot-src/dist/node_modules:/root/pool-bot-src/node_modules:/root/node_modules:/node_modules:/root/pool-bot-src/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../moltbot/dist/entry.js" "$@"
+else
+  exec node  "$basedir/../moltbot/dist/entry.js" "$@"
+fi

package/extensions/twitch/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@poolbot/twitch",
+  "version": "2026.1.26",
+  "description": "Moltbot 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": {
+    "poolbot": "workspace:*"
+  },
+  "poolbot": {
+    "extensions": [
+      "./index.ts"
+    ]
+  }
+}

package/extensions/twitch/poolbot.plugin.json

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