acp-discord 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Randy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,112 @@
+# acp-discord
+
+Discord bot that connects coding agents (Claude Code, Codex, etc.) to Discord channels via the [Agent Client Protocol (ACP)](https://agentclientprotocol.org/).
+
+Send a message in Discord, get AI coding assistance back — with tool call visualization, permission prompts, and real-time streaming.
+
+## Features
+
+- **Slash commands & mentions** — `/ask <message>` or `@bot message`
+- **Real-time streaming** — agent responses stream into Discord with smart message splitting
+- **Tool call visualization** — see what the agent is doing with emoji status indicators
+- **Permission UI** — Discord buttons for approving/denying agent actions
+- **Multi-agent support** — different channels can use different agents
+- **Daemon mode** — runs in background with auto-start (systemd/launchd)
+- **Interactive setup** — guided `init` wizard for first-time configuration
+
+## Prerequisites
+
+- Node.js >= 18
+- A Discord bot token ([create one here](https://discord.com/developers/applications))
+- **An ACP-compatible coding agent installed and working** — the `init` wizard uses an agent to help generate your config. For example, install [Claude Code](https://docs.anthropic.com/en/docs/claude-code) and verify it runs with `claude --version`.
+
+## Quick Start
+
+```bash
+# Run the setup wizard (interactive, agent-driven)
+npx acp-discord init
+
+# Start the daemon
+npx acp-discord daemon start
+```
+
+## Configuration
+
+Config lives at `~/.acp-discord/config.toml`:
+
+```toml
+[discord]
+token = "your-discord-bot-token"
+
+[agents.claude]
+command = "claude-code"
+args = ["--acp"]
+cwd = "/path/to/your/project"
+idle_timeout = 600  # seconds, optional
+
+[channels.1234567890123456]
+agent = "claude"
+cwd = "/override/path"  # optional, per-channel override
+```
+
+### Discord Bot Setup
+
+1. Go to [Discord Developer Portal](https://discord.com/developers/applications)
+2. Create a new application → Bot → copy the token
+3. Enable **Message Content Intent** under Bot settings
+4. Invite the bot to your server with `bot` + `applications.commands` scopes
+5. Copy the channel ID(s) you want the bot to respond in (right-click channel → Copy Channel ID)
+
+## Usage
+
+### CLI Commands
+
+```bash
+# Interactive setup wizard
+acp-discord init
+
+# Daemon management
+acp-discord daemon start    # Start in background
+acp-discord daemon run      # Run in foreground (for service managers)
+acp-discord daemon stop     # Graceful shutdown
+acp-discord daemon status   # Check if running
+
+# Auto-start on boot
+acp-discord daemon enable   # Setup systemd (Linux) / launchd (macOS)
+acp-discord daemon disable  # Remove auto-start
+```
+
+### Discord Commands
+
+| Command | Description |
+|---------|-------------|
+| `/ask <message>` | Send a prompt to the coding agent |
+| `@bot <message>` | Mention the bot to send a prompt |
+
+### Development
+
+```bash
+pnpm dev          # Run with tsx (auto-reload)
+pnpm test         # Run tests
+pnpm test:watch   # Watch mode
+```
+
+## Architecture
+
+```
+Discord User
+    ↓  slash command / mention
+Discord Bot (discord.js)
+    ↓  channel routing
+Session Manager (per-channel sessions)
+    ↓  spawn agent subprocess
+ACP Client (JSON-RPC over stdio)
+    ↓  prompt / permissions / tool calls
+Agent (claude-code, codex, etc.)
+    ↑
+Discord messages, embeds, buttons
+```
+
+## License
+
+MIT

package/dist/chunk-SITRIFHO.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+
+// src/cli/pid.ts
+import { readFileSync, writeFileSync, unlinkSync, existsSync, mkdirSync } from "fs";
+import { dirname } from "path";
+function writePid(pidPath, pid) {
+  mkdirSync(dirname(pidPath), { recursive: true });
+  writeFileSync(pidPath, String(pid), "utf-8");
+}
+function readPid(pidPath) {
+  if (!existsSync(pidPath)) return null;
+  const content = readFileSync(pidPath, "utf-8").trim();
+  const pid = parseInt(content, 10);
+  return isNaN(pid) ? null : pid;
+}
+function removePid(pidPath) {
+  if (existsSync(pidPath)) unlinkSync(pidPath);
+}
+function isDaemonRunning(pidPath) {
+  const pid = readPid(pidPath);
+  if (pid === null) return false;
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// src/shared/config.ts
+import { parse } from "smol-toml";
+import { readFileSync as readFileSync2 } from "fs";
+function parseConfig(toml) {
+  const raw = parse(toml);
+  const discord = raw.discord;
+  if (!discord?.token || typeof discord.token !== "string") {
+    throw new Error("Missing required: discord.token");
+  }
+  if (discord.token.trim().length === 0) {
+    throw new Error("discord.token must not be empty");
+  }
+  const agents = raw.agents;
+  if (!agents || Object.keys(agents).length === 0) {
+    throw new Error("Missing required: at least one agent in [agents.*]");
+  }
+  const parsedAgents = {};
+  for (const [name, agent] of Object.entries(agents)) {
+    if (!agent.command || typeof agent.command !== "string") {
+      throw new Error(`agents.${name}.command must be a non-empty string`);
+    }
+    if (agent.args !== void 0) {
+      if (!Array.isArray(agent.args) || !agent.args.every((a) => typeof a === "string")) {
+        throw new Error(`agents.${name}.args must be an array of strings`);
+      }
+    }
+    if (agent.idle_timeout !== void 0) {
+      if (typeof agent.idle_timeout !== "number" || agent.idle_timeout <= 0) {
+        throw new Error(`agents.${name}.idle_timeout must be a positive number`);
+      }
+    }
+    if (agent.cwd !== void 0 && typeof agent.cwd !== "string") {
+      throw new Error(`agents.${name}.cwd must be a string`);
+    }
+    parsedAgents[name] = {
+      command: agent.command,
+      args: agent.args ?? [],
+      cwd: typeof agent.cwd === "string" ? agent.cwd : process.cwd(),
+      idle_timeout: typeof agent.idle_timeout === "number" ? agent.idle_timeout : 600
+    };
+  }
+  const channels = raw.channels ?? {};
+  const parsedChannels = {};
+  for (const [id, ch] of Object.entries(channels)) {
+    const agentRef = ch.agent ?? "default";
+    if (typeof agentRef !== "string") {
+      throw new Error(`channels.${id}.agent must be a string`);
+    }
+    if (!parsedAgents[agentRef]) {
+      throw new Error(`channels.${id}.agent references unknown agent "${agentRef}"`);
+    }
+    if (ch.cwd !== void 0 && typeof ch.cwd !== "string") {
+      throw new Error(`channels.${id}.cwd must be a string`);
+    }
+    parsedChannels[id] = {
+      agent: agentRef,
+      cwd: ch.cwd ? String(ch.cwd) : void 0
+    };
+  }
+  return {
+    discord: { token: String(discord.token) },
+    agents: parsedAgents,
+    channels: parsedChannels
+  };
+}
+function loadConfig(configPath) {
+  const content = readFileSync2(configPath, "utf-8");
+  return parseConfig(content);
+}
+function resolveChannelConfig(config, channelId) {
+  const channelConf = config.channels[channelId];
+  if (!channelConf) return null;
+  const agentConf = config.agents[channelConf.agent];
+  if (!agentConf) return null;
+  return {
+    channelId,
+    agent: {
+      ...agentConf,
+      cwd: channelConf.cwd ?? agentConf.cwd
+    }
+  };
+}
+
+export {
+  writePid,
+  readPid,
+  removePid,
+  isDaemonRunning,
+  parseConfig,
+  loadConfig,
+  resolveChannelConfig
+};
+//# sourceMappingURL=chunk-SITRIFHO.js.map

package/dist/chunk-SITRIFHO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/pid.ts","../src/shared/config.ts"],"sourcesContent":["import { readFileSync, writeFileSync, unlinkSync, existsSync, mkdirSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\n\nexport function writePid(pidPath: string, pid: number): void {\n  mkdirSync(dirname(pidPath), { recursive: true });\n  writeFileSync(pidPath, String(pid), \"utf-8\");\n}\n\nexport function readPid(pidPath: string): number | null {\n  if (!existsSync(pidPath)) return null;\n  const content = readFileSync(pidPath, \"utf-8\").trim();\n  const pid = parseInt(content, 10);\n  return isNaN(pid) ? null : pid;\n}\n\nexport function removePid(pidPath: string): void {\n  if (existsSync(pidPath)) unlinkSync(pidPath);\n}\n\nexport function isDaemonRunning(pidPath: string): boolean {\n  const pid = readPid(pidPath);\n  if (pid === null) return false;\n  try {\n    process.kill(pid, 0); // signal 0 = check if process exists\n    return true;\n  } catch {\n    return false;\n  }\n}\n","import { parse } from \"smol-toml\";\nimport { readFileSync } from \"node:fs\";\nimport type { AppConfig, ResolvedChannelConfig } from \"./types.js\";\n\nexport function parseConfig(toml: string): AppConfig {\n  const raw = parse(toml) as Record<string, unknown>;\n\n  const discord = raw.discord as Record<string, unknown> | undefined;\n  if (!discord?.token || typeof discord.token !== \"string\") {\n    throw new Error(\"Missing required: discord.token\");\n  }\n  if (discord.token.trim().length === 0) {\n    throw new Error(\"discord.token must not be empty\");\n  }\n\n  const agents = raw.agents as Record<string, Record<string, unknown>> | undefined;\n  if (!agents || Object.keys(agents).length === 0) {\n    throw new Error(\"Missing required: at least one agent in [agents.*]\");\n  }\n\n  const parsedAgents: AppConfig[\"agents\"] = {};\n  for (const [name, agent] of Object.entries(agents)) {\n    // Validate command is a non-empty string\n    if (!agent.command || typeof agent.command !== \"string\") {\n      throw new Error(`agents.${name}.command must be a non-empty string`);\n    }\n\n    // Validate args is an array of strings\n    if (agent.args !== undefined) {\n      if (!Array.isArray(agent.args) || !agent.args.every((a: unknown) => typeof a === \"string\")) {\n        throw new Error(`agents.${name}.args must be an array of strings`);\n      }\n    }\n\n    // Validate idle_timeout is a positive number\n    if (agent.idle_timeout !== undefined) {\n      if (typeof agent.idle_timeout !== \"number\" || agent.idle_timeout <= 0) {\n        throw new Error(`agents.${name}.idle_timeout must be a positive number`);\n      }\n    }\n\n    // Validate cwd is a string if provided\n    if (agent.cwd !== undefined && typeof agent.cwd !== \"string\") {\n      throw new Error(`agents.${name}.cwd must be a string`);\n    }\n\n    parsedAgents[name] = {\n      command: agent.command,\n      args: (agent.args as string[]) ?? [],\n      cwd: typeof agent.cwd === \"string\" ? agent.cwd : process.cwd(),\n      idle_timeout: typeof agent.idle_timeout === \"number\" ? agent.idle_timeout : 600,\n    };\n  }\n\n  const channels = (raw.channels ?? {}) as Record<string, Record<string, unknown>>;\n  const parsedChannels: AppConfig[\"channels\"] = {};\n  for (const [id, ch] of Object.entries(channels)) {\n    const agentRef = ch.agent ?? \"default\";\n    if (typeof agentRef !== \"string\") {\n      throw new Error(`channels.${id}.agent must be a string`);\n    }\n    if (!parsedAgents[agentRef]) {\n      throw new Error(`channels.${id}.agent references unknown agent \"${agentRef}\"`);\n    }\n    if (ch.cwd !== undefined && typeof ch.cwd !== \"string\") {\n      throw new Error(`channels.${id}.cwd must be a string`);\n    }\n\n    parsedChannels[id] = {\n      agent: agentRef,\n      cwd: ch.cwd ? String(ch.cwd) : undefined,\n    };\n  }\n\n  return {\n    discord: { token: String(discord.token) },\n    agents: parsedAgents,\n    channels: parsedChannels,\n  };\n}\n\nexport function loadConfig(configPath: string): AppConfig {\n  const content = readFileSync(configPath, \"utf-8\");\n  return parseConfig(content);\n}\n\nexport function resolveChannelConfig(\n  config: AppConfig,\n  channelId: string,\n): ResolvedChannelConfig | null {\n  const channelConf = config.channels[channelId];\n  if (!channelConf) return null;\n\n  const agentConf = config.agents[channelConf.agent];\n  if (!agentConf) return null;\n\n  return {\n    channelId,\n    agent: {\n      ...agentConf,\n      cwd: channelConf.cwd ?? agentConf.cwd,\n    },\n  };\n}\n"],"mappings":"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","names":["readFileSync"]}

package/dist/daemon.d.ts

@@ -0,0 +1,3 @@
+declare function runDaemon(): Promise<void>;
+
+export { runDaemon };