@tinyclaw/plugin-channel-discord 1.1.0-staging.a410a62 → 2.0.0-dev.00575dc

package/dist/index.d.ts

@@ -15,6 +15,13 @@
  *   Prefixed to prevent collisions with web UI user IDs.
  */
 import type { ChannelPlugin } from '@tinyclaw/types';
+export interface DiscordRuntimeStatus {
+    enabled: boolean;
+    state: 'idle' | 'disabled' | 'starting' | 'connected' | 'error' | 'stopped';
+    readyTag: string | null;
+    lastError: string | null;
+}
+export declare function getDiscordRuntimeStatus(): DiscordRuntimeStatus;
 declare const discordPlugin: ChannelPlugin;
 /** Split a string into chunks without cutting words at boundaries. */
 export declare function splitIntoChunks(text: string, maxLength: number): string[];

package/dist/index.js

@@ -14,30 +14,50 @@
  * userId format: "discord:<discord-user-id>"
  *   Prefixed to prevent collisions with web UI user IDs.
  */
-import { Client, GatewayIntentBits, Partials, Events, } from 'discord.js';
 import { logger } from '@tinyclaw/logger';
-import { createDiscordPairingTools, DISCORD_TOKEN_SECRET_KEY, DISCORD_ENABLED_CONFIG_KEY, } from './pairing.js';
+import { Client, Events, GatewayIntentBits, Partials, } from 'discord.js';
+import { createDiscordPairingTools, DISCORD_ENABLED_CONFIG_KEY, DISCORD_TOKEN_SECRET_KEY, } from './pairing.js';
 let client = null;
+const runtimeStatus = {
+    enabled: false,
+    state: 'idle',
+    readyTag: null,
+    lastError: null,
+};
+export function getDiscordRuntimeStatus() {
+    return { ...runtimeStatus };
+}
 const discordPlugin = {
     id: '@tinyclaw/plugin-channel-discord',
     name: 'Discord',
     description: 'Connect Tiny Claw to a Discord bot',
     type: 'channel',
     version: '0.1.0',
+    channelPrefix: 'discord',
     getPairingTools(secrets, configManager) {
         return createDiscordPairingTools(secrets, configManager);
     },
     async start(context) {
         const isEnabled = context.configManager.get(DISCORD_ENABLED_CONFIG_KEY);
+        runtimeStatus.enabled = Boolean(isEnabled);
         if (!isEnabled) {
+            runtimeStatus.state = 'disabled';
+            runtimeStatus.readyTag = null;
+            runtimeStatus.lastError = null;
             logger.info('Discord plugin: not enabled — run pairing to enable');
             return;
         }
         const token = await context.secrets.retrieve(DISCORD_TOKEN_SECRET_KEY);
         if (!token) {
+            runtimeStatus.state = 'error';
+            runtimeStatus.readyTag = null;
+            runtimeStatus.lastError = 'Discord bot token not found in secrets';
             logger.warn('Discord plugin: enabled but no token found — re-pair to fix');
             return;
         }
+        runtimeStatus.state = 'starting';
+        runtimeStatus.readyTag = null;
+        runtimeStatus.lastError = null;
         client = new Client({
             intents: [
                 GatewayIntentBits.Guilds,
@@ -48,23 +68,28 @@ const discordPlugin = {
             partials: [Partials.Channel],
         });
         client.once(Events.ClientReady, (readyClient) => {
+            runtimeStatus.state = 'connected';
+            runtimeStatus.readyTag = readyClient.user.tag;
+            runtimeStatus.lastError = null;
             logger.info(`Discord bot ready: ${readyClient.user.tag}`);
         });
+        client.on(Events.Error, (error) => {
+            runtimeStatus.state = 'error';
+            runtimeStatus.readyTag = null;
+            runtimeStatus.lastError = error.message;
+            logger.error('Discord plugin: client error', error);
+        });
         client.on(Events.MessageCreate, async (msg) => {
             // Ignore messages from bots (including self)
             if (msg.author.bot)
                 return;
             const isDM = msg.channel.isDMBased();
-            const isMention = client?.user
-                ? msg.mentions.users.has(client.user.id)
-                : false;
+            const isMention = client?.user ? msg.mentions.users.has(client.user.id) : false;
             // Only respond to DMs or @mentions
             if (!isDM && !isMention)
                 return;
             // Strip @mention tokens from guild messages
-            const rawContent = msg.content
-                .replace(/<@!?[\d]+>/g, '')
-                .trim();
+            const rawContent = msg.content.replace(/<@!?[\d]+>/g, '').trim();
             if (!rawContent)
                 return;
             // Prefix userId to isolate Discord sessions from web UI sessions
@@ -97,8 +122,48 @@ const discordPlugin = {
                 }
             }
         });
-        await client.login(token);
-        logger.info('Discord bot connected');
+        try {
+            await client.login(token);
+            logger.info('Discord bot connected');
+        }
+        catch (error) {
+            runtimeStatus.state = 'error';
+            runtimeStatus.readyTag = null;
+            runtimeStatus.lastError = error instanceof Error ? error.message : String(error);
+            if (client) {
+                client.destroy();
+                client = null;
+            }
+            throw error;
+        }
+    },
+    async sendToUser(userId, message) {
+        if (!client) {
+            throw new Error('Discord client is not connected');
+        }
+        // Parse the Discord user ID from the prefixed format "discord:<id>"
+        const discordId = userId.replace(/^discord:/, '');
+        if (!discordId) {
+            throw new Error(`Invalid Discord userId: ${userId}`);
+        }
+        try {
+            const user = await client.users.fetch(discordId);
+            const text = message.content;
+            if (text.length <= 2000) {
+                await user.send(text);
+            }
+            else {
+                const chunks = splitIntoChunks(text, 1900);
+                for (const chunk of chunks) {
+                    await user.send(chunk);
+                }
+            }
+            logger.info(`Discord: sent outbound message to ${userId}`);
+        }
+        catch (err) {
+            logger.error(`Discord: failed to send to ${userId}`, err);
+            throw err;
+        }
     },
     async stop() {
         if (client) {
@@ -106,6 +171,8 @@ const discordPlugin = {
             client = null;
             logger.info('Discord bot disconnected');
         }
+        runtimeStatus.state = runtimeStatus.enabled ? 'stopped' : 'disabled';
+        runtimeStatus.readyTag = null;
     },
 };
 /** Split a string into chunks without cutting words at boundaries. */

package/dist/pairing.d.ts

@@ -9,7 +9,7 @@
  * These tools are injected into the agent's tool list at boot so the agent
  * can invoke them conversationally when a user asks to connect Discord.
  */
-import type { Tool, SecretsManagerInterface, ConfigManagerInterface } from '@tinyclaw/types';
+import type { ConfigManagerInterface, SecretsManagerInterface, Tool } from '@tinyclaw/types';
 /** Secret key for the Discord bot token. */
 export declare const DISCORD_TOKEN_SECRET_KEY: string;
 /** Config key for the enabled flag. */

package/dist/pairing.js

@@ -21,6 +21,7 @@ export function createDiscordPairingTools(secrets, configManager) {
         {
             name: 'discord_pair',
             description: 'Pair Tiny Claw with a Discord bot. ' +
+                'If the user has not provided a bot token yet, first walk them through creating one in the Discord Developer Portal and ask them to paste it here. ' +
                 'Stores the bot token securely and enables the Discord channel plugin. ' +
                 'After pairing, call tinyclaw_restart to connect the bot. ' +
                 'To get a token: go to https://discord.com/developers/applications, ' +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tinyclaw/plugin-channel-discord",
-  "version": "1.1.0-staging.a410a62",
+  "version": "2.0.0-dev.00575dc",
   "description": "Discord channel plugin for Tiny Claw",
   "license": "GPL-3.0",
   "author": "Waren Gonzaga",
@@ -32,8 +32,8 @@
     "build": "tsc -p tsconfig.json"
   },
   "dependencies": {
-    "@tinyclaw/logger": "workspace:*",
-    "@tinyclaw/types": "workspace:*",
+    "@tinyclaw/logger": "2.0.0",
+    "@tinyclaw/types": "2.0.0",
     "discord.js": "^14.0.0"
   }
 }