ralph-cli-sandboxed 0.4.0 → 0.4.2

package/dist/commands/chat.js

@@ -1,5 +1,5 @@
 /**
- * Chat command for managing Telegram (and other) chat integrations.
+ * Chat command for managing Telegram, Slack, and other chat integrations.
  * Allows ralph to receive commands and send notifications via chat services.
  */
 import { existsSync, readFileSync, writeFileSync } from "fs";
@@ -7,8 +7,10 @@ import { join, basename } from "path";
 import { spawn } from "child_process";
 import { loadConfig, getRalphDir, isRunningInContainer } from "../utils/config.js";
 import { createTelegramClient } from "../providers/telegram.js";
+import { createSlackClient } from "../providers/slack.js";
+import { createDiscordClient } from "../providers/discord.js";
 import { generateProjectId, formatStatusMessage, formatStatusForChat, } from "../utils/chat-client.js";
-import { getMessagesPath, sendMessage, waitForResponse, } from "../utils/message-queue.js";
+import { getMessagesPath, sendMessage, waitForResponse } from "../utils/message-queue.js";
 const CHAT_STATE_FILE = "chat-state.json";
 /**
  * Load chat state from .ralph/chat-state.json
@@ -220,6 +222,23 @@ async function handleCommand(command, client, config, state, debug) {
             saveChatState(state);
             break;
         }
+        case "stop": {
+            // Stop a running ralph run process in the sandbox
+            await client.sendMessage(chatId, `${state.projectName}: Stopping ralph run...`);
+            const response = await sendToSandbox("stop", [], debug, 10000);
+            if (response) {
+                if (response.success) {
+                    await client.sendMessage(chatId, `${state.projectName}: ${response.output}`);
+                }
+                else {
+                    await client.sendMessage(chatId, `${state.projectName}: ${response.error}`);
+                }
+            }
+            else {
+                await client.sendMessage(chatId, `${state.projectName}: No response from sandbox. Is 'ralph listen' running?`);
+            }
+            break;
+        }
         case "status": {
             // Try sandbox first, fall back to host
             const response = await sendToSandbox("status", [], debug, 5000);
@@ -253,7 +272,8 @@ async function handleCommand(command, client, config, state, debug) {
         }
         case "add": {
             if (args.length === 0) {
-                await client.sendMessage(chatId, `${state.projectName}: Usage: /add [task description]`);
+                const usage = client.provider === "slack" ? "/ralph add [task description]" : "/add [task description]";
+                await client.sendMessage(chatId, `${state.projectName}: Usage: ${usage}`);
                 return;
             }
             const description = args.join(" ");
@@ -268,7 +288,8 @@ async function handleCommand(command, client, config, state, debug) {
         }
         case "exec": {
             if (args.length === 0) {
-                await client.sendMessage(chatId, `${state.projectName}: Usage: /exec [command]`);
+                const usage = client.provider === "slack" ? "/ralph exec [command]" : "/exec [command]";
+                await client.sendMessage(chatId, `${state.projectName}: Usage: ${usage}`);
                 return;
             }
             // Send exec command to sandbox
@@ -286,22 +307,19 @@ async function handleCommand(command, client, config, state, debug) {
             }
             break;
         }
-        case "stop": {
-            await client.sendMessage(chatId, `${state.projectName}: Stop command received (not implemented yet)`);
-            break;
-        }
         case "action": {
             // Reload config to pick up new actions
             const freshConfig = loadConfig();
             const actions = freshConfig.daemon?.actions || {};
-            const actionNames = Object.keys(actions).filter(name => name !== "notify" && name !== "telegram_notify");
+            const actionNames = Object.keys(actions).filter((name) => name !== "notify" && name !== "telegram_notify");
             if (args.length === 0) {
                 // List available actions
+                const usage = client.provider === "slack" ? "/ralph action <name>" : "/action <name>";
                 if (actionNames.length === 0) {
                     await client.sendMessage(chatId, `${state.projectName}: No actions configured. Add actions to daemon.actions in config.json`);
                 }
                 else {
-                    await client.sendMessage(chatId, `${state.projectName}: Available actions: ${actionNames.join(", ")}\nUsage: /action <name>`);
+                    await client.sendMessage(chatId, `${state.projectName}: Available actions: ${actionNames.join(", ")}\nUsage: ${usage}`);
                 }
                 return;
             }
@@ -346,7 +364,8 @@ async function handleCommand(command, client, config, state, debug) {
         }
         case "claude": {
             if (args.length === 0) {
-                await client.sendMessage(chatId, `${state.projectName}: Usage: /claude [prompt]`);
+                const usage = client.provider === "slack" ? "/ralph <prompt>" : "/claude [prompt]";
+                await client.sendMessage(chatId, `${state.projectName}: Usage: ${usage}`);
                 return;
             }
             const prompt = args.join(" ");
@@ -380,15 +399,24 @@ async function handleCommand(command, client, config, state, debug) {
             break;
         }
         case "help": {
-            const helpText = `
-/run - Start automation
+            const isSlack = client.provider === "slack";
+            const helpText = isSlack
+                ? `/ralph help - This help
+/ralph status - PRD progress
+/ralph run [category] - Start automation
+/ralph stop - Stop automation
+/ralph add [desc] - Add task
+/ralph exec [cmd] - Shell command
+/ralph action [name] - Run action
+/ralph <prompt> - Run Claude Code`
+                : `/help - This help
 /status - PRD progress
+/run - Start automation
+/stop - Stop automation
 /add [desc] - Add task
 /exec [cmd] - Shell command
 /action [name] - Run action
-/claude [prompt] - Run Claude Code
-/help - This help
-`.trim();
+/claude [prompt] - Run Claude Code`;
             await client.sendMessage(chatId, helpText);
             break;
         }
@@ -397,21 +425,91 @@ async function handleCommand(command, client, config, state, debug) {
     }
 }
 /**
- * Start the chat daemon (listens for messages and handles commands).
+ * Create a chat client based on the provider configuration.
  */
-async function startChat(config, debug) {
-    // Check that Telegram is configured
+function createChatClient(config, debug) {
+    const provider = config.chat?.provider || "telegram";
+    if (provider === "slack") {
+        // Check that Slack is configured
+        if (!config.chat?.slack?.botToken) {
+            console.error("Error: Slack bot token not configured");
+            console.error("Set chat.slack.botToken in .ralph/config.json");
+            console.error("Get a token from your Slack app settings: https://api.slack.com/apps");
+            process.exit(1);
+        }
+        if (!config.chat?.slack?.appToken) {
+            console.error("Error: Slack app token not configured");
+            console.error("Set chat.slack.appToken in .ralph/config.json");
+            console.error("Enable Socket Mode in your Slack app and generate an app token");
+            process.exit(1);
+        }
+        if (!config.chat?.slack?.signingSecret) {
+            console.error("Error: Slack signing secret not configured");
+            console.error("Set chat.slack.signingSecret in .ralph/config.json");
+            console.error("Find your signing secret in Slack app Basic Information");
+            process.exit(1);
+        }
+        if (config.chat.slack.enabled === false) {
+            console.error("Error: Slack is disabled in config (slack.enabled = false)");
+            process.exit(1);
+        }
+        return {
+            client: createSlackClient({
+                botToken: config.chat.slack.botToken,
+                appToken: config.chat.slack.appToken,
+                signingSecret: config.chat.slack.signingSecret,
+                allowedChannelIds: config.chat.slack.allowedChannelIds,
+            }, debug),
+            provider: "slack",
+            allowedChatIds: config.chat.slack.allowedChannelIds,
+        };
+    }
+    if (provider === "discord") {
+        // Check that Discord is configured
+        if (!config.chat?.discord?.botToken) {
+            console.error("Error: Discord bot token not configured");
+            console.error("Set chat.discord.botToken in .ralph/config.json");
+            console.error("Get a token from the Discord Developer Portal: https://discord.com/developers/applications");
+            process.exit(1);
+        }
+        if (config.chat.discord.enabled === false) {
+            console.error("Error: Discord is disabled in config (discord.enabled = false)");
+            process.exit(1);
+        }
+        return {
+            client: createDiscordClient({
+                botToken: config.chat.discord.botToken,
+                allowedGuildIds: config.chat.discord.allowedGuildIds,
+                allowedChannelIds: config.chat.discord.allowedChannelIds,
+            }, debug),
+            provider: "discord",
+            allowedChatIds: config.chat.discord.allowedChannelIds,
+        };
+    }
+    // Default to Telegram
     if (!config.chat?.telegram?.botToken) {
         console.error("Error: Telegram bot token not configured");
         console.error("Set chat.telegram.botToken in .ralph/config.json");
         console.error("Get a token from @BotFather on Telegram");
         process.exit(1);
     }
-    // Check if Telegram is explicitly disabled
     if (config.chat.telegram.enabled === false) {
         console.error("Error: Telegram is disabled in config (telegram.enabled = false)");
         process.exit(1);
     }
+    return {
+        client: createTelegramClient({
+            botToken: config.chat.telegram.botToken,
+            allowedChatIds: config.chat.telegram.allowedChatIds,
+        }, debug),
+        provider: "telegram",
+        allowedChatIds: config.chat.telegram.allowedChatIds,
+    };
+}
+/**
+ * Start the chat daemon (listens for messages and handles commands).
+ */
+async function startChat(config, debug) {
     // Create or load chat state
     let state = loadChatState();
     const projectId = getOrCreateProjectId();
@@ -424,15 +522,12 @@ async function startChat(config, debug) {
         };
         saveChatState(state);
     }
-    // Create Telegram client
-    const client = createTelegramClient({
-        botToken: config.chat.telegram.botToken,
-        allowedChatIds: config.chat.telegram.allowedChatIds,
-    }, debug);
+    // Create chat client based on provider
+    const { client, provider, allowedChatIds } = createChatClient(config, debug);
     console.log("Ralph Chat Daemon");
     console.log("-".repeat(40));
     console.log(`Project: ${projectName}`);
-    console.log(`Provider: ${config.chat.provider}`);
+    console.log(`Provider: ${provider}`);
     console.log("");
     // Connect and start listening
     try {
@@ -442,21 +537,34 @@ async function startChat(config, debug) {
                 return Promise.resolve();
             }
             : undefined);
-        console.log("Connected to Telegram!");
+        const providerName = provider === "slack" ? "Slack" : provider === "discord" ? "Discord" : "Telegram";
+        console.log(`Connected to ${providerName}!`);
         console.log("");
-        console.log("Commands (send in Telegram):");
-        console.log("  /run         - Start ralph automation");
-        console.log("  /status      - Show PRD progress");
-        console.log("  /add ...     - Add new task to PRD");
-        console.log("  /exec ...    - Execute shell command");
-        console.log("  /action ...  - Run daemon action");
-        console.log("  /claude ...  - Run Claude Code with prompt (YOLO mode)");
-        console.log("  /help        - Show help");
+        console.log(`Commands (send in ${providerName}):`);
+        if (provider === "slack") {
+            console.log("  /ralph help       - Show help");
+            console.log("  /ralph status     - Show PRD progress");
+            console.log("  /ralph run        - Start ralph automation");
+            console.log("  /ralph stop       - Stop running automation");
+            console.log("  /ralph add ...    - Add new task to PRD");
+            console.log("  /ralph exec ...   - Execute shell command");
+            console.log("  /ralph action ... - Run daemon action");
+            console.log("  /ralph <prompt>   - Run Claude Code with prompt");
+        }
+        else {
+            console.log("  /run         - Start ralph automation");
+            console.log("  /status      - Show PRD progress");
+            console.log("  /add ...     - Add new task to PRD");
+            console.log("  /exec ...    - Execute shell command");
+            console.log("  /action ...  - Run daemon action");
+            console.log("  /claude ...  - Run Claude Code with prompt (YOLO mode)");
+            console.log("  /help        - Show help");
+        }
         console.log("");
         console.log("Press Ctrl+C to stop the daemon.");
         // Send connected message to all allowed chats
-        if (config.chat.telegram.allowedChatIds && config.chat.telegram.allowedChatIds.length > 0) {
-            for (const chatId of config.chat.telegram.allowedChatIds) {
+        if (allowedChatIds && allowedChatIds.length > 0) {
+            for (const chatId of allowedChatIds) {
                 try {
                     await client.sendMessage(chatId, `${projectName} connected`);
                 }
@@ -476,8 +584,8 @@ async function startChat(config, debug) {
     const shutdown = async () => {
         console.log("\nShutting down chat daemon...");
         // Send disconnected message to all allowed chats
-        if (config.chat?.telegram?.allowedChatIds) {
-            for (const chatId of config.chat.telegram.allowedChatIds) {
+        if (allowedChatIds && allowedChatIds.length > 0) {
+            for (const chatId of allowedChatIds) {
                 try {
                     await client.sendMessage(chatId, `${projectName} disconnected`);
                 }
@@ -518,7 +626,51 @@ function showStatus(config) {
         console.log("State: not initialized (run 'ralph chat start' to initialize)");
     }
     console.log("");
-    if (config.chat.provider === "telegram") {
+    if (config.chat.provider === "slack") {
+        if (config.chat.slack?.botToken &&
+            config.chat.slack?.appToken &&
+            config.chat.slack?.signingSecret) {
+            console.log("Slack: configured");
+            if (config.chat.slack.allowedChannelIds && config.chat.slack.allowedChannelIds.length > 0) {
+                console.log(`Allowed channels: ${config.chat.slack.allowedChannelIds.join(", ")}`);
+            }
+            else {
+                console.log("Allowed channels: all (no restrictions)");
+            }
+        }
+        else {
+            const missing = [];
+            if (!config.chat.slack?.botToken)
+                missing.push("botToken");
+            if (!config.chat.slack?.appToken)
+                missing.push("appToken");
+            if (!config.chat.slack?.signingSecret)
+                missing.push("signingSecret");
+            console.log(`Slack: not configured (missing: ${missing.join(", ")})`);
+        }
+    }
+    else if (config.chat.provider === "discord") {
+        if (config.chat.discord?.botToken) {
+            console.log("Discord: configured");
+            if (config.chat.discord.allowedGuildIds && config.chat.discord.allowedGuildIds.length > 0) {
+                console.log(`Allowed guilds: ${config.chat.discord.allowedGuildIds.join(", ")}`);
+            }
+            else {
+                console.log("Allowed guilds: all (no restrictions)");
+            }
+            if (config.chat.discord.allowedChannelIds &&
+                config.chat.discord.allowedChannelIds.length > 0) {
+                console.log(`Allowed channels: ${config.chat.discord.allowedChannelIds.join(", ")}`);
+            }
+            else {
+                console.log("Allowed channels: all (no restrictions)");
+            }
+        }
+        else {
+            console.log("Discord: not configured (missing botToken)");
+        }
+    }
+    else if (config.chat.provider === "telegram") {
         if (config.chat.telegram?.botToken) {
             console.log("Telegram: configured");
             if (config.chat.telegram.allowedChatIds && config.chat.telegram.allowedChatIds.length > 0) {
@@ -541,23 +693,68 @@ async function testChat(config, chatId) {
         console.error("Error: Chat is not enabled in config.json");
         process.exit(1);
     }
-    if (!config.chat.telegram?.botToken) {
-        console.error("Error: Telegram bot token not configured");
-        process.exit(1);
+    const provider = config.chat.provider || "telegram";
+    let client;
+    let targetChatId;
+    if (provider === "slack") {
+        if (!config.chat.slack?.botToken ||
+            !config.chat.slack?.appToken ||
+            !config.chat.slack?.signingSecret) {
+            console.error("Error: Slack configuration incomplete");
+            console.error("Required: botToken, appToken, signingSecret");
+            process.exit(1);
+        }
+        targetChatId = chatId || config.chat.slack.allowedChannelIds?.[0];
+        if (!targetChatId) {
+            console.error("Error: No channel ID specified and no allowed channel IDs configured");
+            console.error("Usage: ralph chat test <channel_id>");
+            console.error("Or add channel IDs to chat.slack.allowedChannelIds in config.json");
+            process.exit(1);
+        }
+        client = createSlackClient({
+            botToken: config.chat.slack.botToken,
+            appToken: config.chat.slack.appToken,
+            signingSecret: config.chat.slack.signingSecret,
+            allowedChannelIds: config.chat.slack.allowedChannelIds,
+        });
     }
-    // If no chat ID provided, use the first allowed chat ID
-    const targetChatId = chatId || (config.chat.telegram.allowedChatIds?.[0]);
-    if (!targetChatId) {
-        console.error("Error: No chat ID specified and no allowed chat IDs configured");
-        console.error("Usage: ralph chat test <chat_id>");
-        console.error("Or add chat IDs to chat.telegram.allowedChatIds in config.json");
-        process.exit(1);
+    else if (provider === "discord") {
+        if (!config.chat.discord?.botToken) {
+            console.error("Error: Discord bot token not configured");
+            process.exit(1);
+        }
+        targetChatId = chatId || config.chat.discord.allowedChannelIds?.[0];
+        if (!targetChatId) {
+            console.error("Error: No channel ID specified and no allowed channel IDs configured");
+            console.error("Usage: ralph chat test <channel_id>");
+            console.error("Or add channel IDs to chat.discord.allowedChannelIds in config.json");
+            process.exit(1);
+        }
+        client = createDiscordClient({
+            botToken: config.chat.discord.botToken,
+            allowedGuildIds: config.chat.discord.allowedGuildIds,
+            allowedChannelIds: config.chat.discord.allowedChannelIds,
+        });
     }
-    const client = createTelegramClient({
-        botToken: config.chat.telegram.botToken,
-        allowedChatIds: config.chat.telegram.allowedChatIds,
-    });
-    console.log(`Testing connection to chat ${targetChatId}...`);
+    else {
+        // Telegram
+        if (!config.chat.telegram?.botToken) {
+            console.error("Error: Telegram bot token not configured");
+            process.exit(1);
+        }
+        targetChatId = chatId || config.chat.telegram.allowedChatIds?.[0];
+        if (!targetChatId) {
+            console.error("Error: No chat ID specified and no allowed chat IDs configured");
+            console.error("Usage: ralph chat test <chat_id>");
+            console.error("Or add chat IDs to chat.telegram.allowedChatIds in config.json");
+            process.exit(1);
+        }
+        client = createTelegramClient({
+            botToken: config.chat.telegram.botToken,
+            allowedChatIds: config.chat.telegram.allowedChatIds,
+        });
+    }
+    console.log(`Testing connection to ${provider} chat ${targetChatId}...`);
     try {
         // Just connect to verify credentials
         await client.connect(() => Promise.resolve());
@@ -584,7 +781,7 @@ export async function chat(args) {
     // Show help
     if (subcommand === "help" || subcommand === "--help" || subcommand === "-h" || !subcommand) {
         console.log(`
-ralph chat - Chat client integration (Telegram, etc.)
+ralph chat - Chat client integration (Telegram, Slack, Discord)
 
 USAGE:
   ralph chat start [--debug]  Start the chat daemon
@@ -595,6 +792,7 @@ USAGE:
 CONFIGURATION:
   Configure chat in .ralph/config.json:
 
+  Telegram:
   {
     "chat": {
       "enabled": true,
@@ -606,6 +804,33 @@ CONFIGURATION:
     }
   }
 
+  Slack:
+  {
+    "chat": {
+      "enabled": true,
+      "provider": "slack",
+      "slack": {
+        "botToken": "xoxb-YOUR-BOT-TOKEN",
+        "appToken": "xapp-YOUR-APP-TOKEN",
+        "signingSecret": "YOUR_SIGNING_SECRET",
+        "allowedChannelIds": ["C01234567"]
+      }
+    }
+  }
+
+  Discord:
+  {
+    "chat": {
+      "enabled": true,
+      "provider": "discord",
+      "discord": {
+        "botToken": "YOUR_BOT_TOKEN",
+        "allowedGuildIds": ["123456789"],
+        "allowedChannelIds": ["987654321"]
+      }
+    }
+  }
+
 TELEGRAM SETUP:
   1. Create a bot with @BotFather on Telegram
   2. Copy the bot token to chat.telegram.botToken
@@ -616,8 +841,40 @@ TELEGRAM SETUP:
      Example: https://api.telegram.org/bot123456:ABC-xyz/getUpdates
   5. Add the chat ID to chat.telegram.allowedChatIds (optional security)
 
+SLACK SETUP:
+  1. Create a Slack app at https://api.slack.com/apps
+  2. Enable Socket Mode in the app settings
+  3. Generate an App-Level Token with connections:write scope (xapp-...)
+  4. Under OAuth & Permissions, add these Bot Token Scopes:
+     - chat:write (send messages)
+     - channels:history (read public channel messages)
+     - groups:history (read private channel messages)
+     - im:history (read direct messages)
+     - commands (for slash commands, optional)
+  5. Install the app to your workspace
+  6. Copy the Bot User OAuth Token (xoxb-...) to chat.slack.botToken
+  7. Copy the App Token (xapp-...) to chat.slack.appToken
+  8. Copy the Signing Secret to chat.slack.signingSecret
+  9. Invite the bot to channels: /invite @your-bot-name
+  10. Add channel IDs to chat.slack.allowedChannelIds (optional security)
+
+DISCORD SETUP:
+  1. Create an application at https://discord.com/developers/applications
+  2. Go to "Bot" section and click "Add Bot"
+  3. Enable these Privileged Gateway Intents:
+     - MESSAGE CONTENT INTENT (to read message content)
+  4. Copy the bot token to chat.discord.botToken
+  5. Go to "OAuth2" > "URL Generator":
+     - Select scopes: bot, applications.commands
+     - Select permissions: Send Messages, Read Message History, Use Slash Commands
+  6. Use the generated URL to invite the bot to your server
+  7. Get your guild (server) ID: Enable Developer Mode in Discord settings,
+     then right-click your server and "Copy Server ID"
+  8. Get channel IDs: Right-click a channel and "Copy Channel ID"
+  9. Add IDs to allowedGuildIds and allowedChannelIds (optional security)
+
 CHAT COMMANDS:
-  Once connected, send commands to your Telegram bot:
+  Once connected, send commands to your bot:
 
   /run            - Start ralph automation
   /status         - Show PRD progress
@@ -629,8 +886,8 @@ CHAT COMMANDS:
   /help           - Show help
 
 SECURITY:
-  - Use allowedChatIds to restrict which chats can control ralph
-  - Never share your bot token
+  - Use allowedChatIds/allowedChannelIds/allowedGuildIds to restrict access
+  - Never share your bot tokens
   - The daemon should run on the host, not in the container
 
 DAEMON ACTIONS:
@@ -651,16 +908,22 @@ DAEMON ACTIONS:
     }
   }
 
-  Then trigger them via Telegram: /action build or /action deploy
+  Then trigger them via chat: /action build or /action deploy
 
 EXAMPLES:
   # Start the chat daemon
   ralph chat start
 
-  # Test the connection
+  # Test the connection (Telegram)
   ralph chat test 123456789
 
-  # In Telegram:
+  # Test the connection (Slack)
+  ralph chat test C01234567
+
+  # Test the connection (Discord)
+  ralph chat test 123456789012345678
+
+  # In Telegram/Slack/Discord:
   /run              # Start ralph automation
   /status           # Show task progress
   /add Fix login    # Add new task

package/dist/commands/config.js

@@ -44,8 +44,9 @@ SECTIONS:
   Docker      Ports, volumes, environment, packages
   Daemon      Actions, socket path
   Claude      MCP servers, skills
-  Chat        Telegram integration
+  Chat        Telegram, Slack, Discord integration
   Notify      Notification settings
+  LLM         LLM provider configuration (Anthropic, OpenAI, Ollama)
 `;
     console.log(helpText.trim());
 }

package/dist/commands/daemon.d.ts

@@ -1,8 +1,5 @@
-export interface DaemonAction {
-    command: string;
-    description?: string;
-    ntfyUrl?: string;
-}
+import { DaemonAction } from "../utils/daemon-actions.js";
+export type { DaemonAction };
 export interface DaemonConfig {
     enabled?: boolean;
     actions?: Record<string, DaemonAction>;