agentcord 0.1.0

package/src/commands.ts

@@ -0,0 +1,166 @@
+import {
+  SlashCommandBuilder,
+  REST,
+  Routes,
+  type RESTPostAPIChatInputApplicationCommandsJSONBody,
+} from 'discord.js';
+import { config } from './config.ts';
+
+export function getCommandDefinitions(): RESTPostAPIChatInputApplicationCommandsJSONBody[] {
+  const claude = new SlashCommandBuilder()
+    .setName('claude')
+    .setDescription('Manage Claude Code sessions')
+    .addSubcommand(sub =>
+      sub.setName('new')
+        .setDescription('Create a new Claude Code session')
+        .addStringOption(opt =>
+          opt.setName('name').setDescription('Session name').setRequired(true))
+        .addStringOption(opt =>
+          opt.setName('directory').setDescription('Working directory (default: configured default)')))
+    .addSubcommand(sub =>
+      sub.setName('list').setDescription('List active sessions'))
+    .addSubcommand(sub =>
+      sub.setName('end').setDescription('End the session in this channel'))
+    .addSubcommand(sub =>
+      sub.setName('continue').setDescription('Continue the last conversation'))
+    .addSubcommand(sub =>
+      sub.setName('stop').setDescription('Stop current generation'))
+    .addSubcommand(sub =>
+      sub.setName('output')
+        .setDescription('Show recent conversation output')
+        .addIntegerOption(opt =>
+          opt.setName('lines').setDescription('Number of lines (default 50)').setMinValue(1).setMaxValue(500)))
+    .addSubcommand(sub =>
+      sub.setName('attach').setDescription('Show tmux attach command for terminal access'))
+    .addSubcommand(sub =>
+      sub.setName('sync').setDescription('Reconnect orphaned tmux sessions'))
+    .addSubcommand(sub =>
+      sub.setName('model')
+        .setDescription('Change the model for this session')
+        .addStringOption(opt =>
+          opt.setName('model').setDescription('Model name (e.g. claude-sonnet-4-5-20250929)').setRequired(true)))
+    .addSubcommand(sub =>
+      sub.setName('verbose').setDescription('Toggle showing tool calls and results in this session'));
+
+  const shell = new SlashCommandBuilder()
+    .setName('shell')
+    .setDescription('Run shell commands in the session directory')
+    .addSubcommand(sub =>
+      sub.setName('run')
+        .setDescription('Execute a shell command')
+        .addStringOption(opt =>
+          opt.setName('command').setDescription('Command to run').setRequired(true)))
+    .addSubcommand(sub =>
+      sub.setName('processes').setDescription('List running processes'))
+    .addSubcommand(sub =>
+      sub.setName('kill')
+        .setDescription('Kill a running process')
+        .addIntegerOption(opt =>
+          opt.setName('pid').setDescription('Process ID to kill').setRequired(true)));
+
+  const agent = new SlashCommandBuilder()
+    .setName('agent')
+    .setDescription('Manage agent personas')
+    .addSubcommand(sub =>
+      sub.setName('use')
+        .setDescription('Switch to an agent persona')
+        .addStringOption(opt =>
+          opt.setName('persona')
+            .setDescription('Agent persona name')
+            .setRequired(true)
+            .addChoices(
+              { name: 'Code Reviewer', value: 'code-reviewer' },
+              { name: 'Architect', value: 'architect' },
+              { name: 'Debugger', value: 'debugger' },
+              { name: 'Security Analyst', value: 'security' },
+              { name: 'Performance Engineer', value: 'performance' },
+              { name: 'DevOps Engineer', value: 'devops' },
+              { name: 'General', value: 'general' },
+            )))
+    .addSubcommand(sub =>
+      sub.setName('list').setDescription('List available agent personas'))
+    .addSubcommand(sub =>
+      sub.setName('clear').setDescription('Clear agent persona'));
+
+  const project = new SlashCommandBuilder()
+    .setName('project')
+    .setDescription('Configure project settings')
+    .addSubcommand(sub =>
+      sub.setName('personality')
+        .setDescription('Set a custom personality for this project')
+        .addStringOption(opt =>
+          opt.setName('prompt').setDescription('System prompt for the project').setRequired(true)))
+    .addSubcommand(sub =>
+      sub.setName('personality-show').setDescription('Show the current project personality'))
+    .addSubcommand(sub =>
+      sub.setName('personality-clear').setDescription('Clear the project personality'))
+    .addSubcommand(sub =>
+      sub.setName('skill-add')
+        .setDescription('Add a skill (prompt template) to this project')
+        .addStringOption(opt =>
+          opt.setName('name').setDescription('Skill name').setRequired(true))
+        .addStringOption(opt =>
+          opt.setName('prompt').setDescription('Prompt template (use {input} for placeholder)').setRequired(true)))
+    .addSubcommand(sub =>
+      sub.setName('skill-remove')
+        .setDescription('Remove a skill')
+        .addStringOption(opt =>
+          opt.setName('name').setDescription('Skill name').setRequired(true)))
+    .addSubcommand(sub =>
+      sub.setName('skill-list').setDescription('List all skills for this project'))
+    .addSubcommand(sub =>
+      sub.setName('skill-run')
+        .setDescription('Execute a skill')
+        .addStringOption(opt =>
+          opt.setName('name').setDescription('Skill name').setRequired(true))
+        .addStringOption(opt =>
+          opt.setName('input').setDescription('Input to pass to the skill template')))
+    .addSubcommand(sub =>
+      sub.setName('mcp-add')
+        .setDescription('Add an MCP server to this project')
+        .addStringOption(opt =>
+          opt.setName('name').setDescription('Server name').setRequired(true))
+        .addStringOption(opt =>
+          opt.setName('command').setDescription('Command to run (e.g. npx my-mcp-server)').setRequired(true))
+        .addStringOption(opt =>
+          opt.setName('args').setDescription('Arguments (comma-separated)')))
+    .addSubcommand(sub =>
+      sub.setName('mcp-remove')
+        .setDescription('Remove an MCP server')
+        .addStringOption(opt =>
+          opt.setName('name').setDescription('Server name').setRequired(true)))
+    .addSubcommand(sub =>
+      sub.setName('mcp-list').setDescription('List configured MCP servers'))
+    .addSubcommand(sub =>
+      sub.setName('info').setDescription('Show project configuration'));
+
+  return [
+    claude.toJSON(),
+    shell.toJSON(),
+    agent.toJSON(),
+    project.toJSON(),
+  ];
+}
+
+export async function registerCommands(): Promise<void> {
+  const rest = new REST().setToken(config.token);
+  const commands = getCommandDefinitions();
+
+  try {
+    if (config.guildId) {
+      await rest.put(
+        Routes.applicationGuildCommands(config.clientId, config.guildId),
+        { body: commands },
+      );
+      console.log(`Registered ${commands.length} guild commands`);
+    } else {
+      await rest.put(
+        Routes.applicationCommands(config.clientId),
+        { body: commands },
+      );
+      console.log(`Registered ${commands.length} global commands (may take ~1hr to propagate)`);
+    }
+  } catch (err) {
+    console.error('Failed to register commands:', err);
+  }
+}

package/src/config.ts

@@ -0,0 +1,45 @@
+import 'dotenv/config';
+import type { Config } from './types.ts';
+
+function getEnvOrExit(name: string): string {
+  const value = process.env[name];
+  if (!value) {
+    console.error(`ERROR: ${name} environment variable is required`);
+    console.error('Set it in your .env file or export it before running');
+    process.exit(1);
+  }
+  return value;
+}
+
+export const config: Config = {
+  token: getEnvOrExit('DISCORD_TOKEN'),
+  clientId: getEnvOrExit('DISCORD_CLIENT_ID'),
+  guildId: process.env.DISCORD_GUILD_ID || null,
+  allowedUsers: process.env.ALLOWED_USERS?.split(',').map(id => id.trim()).filter(Boolean) || [],
+  allowAllUsers: process.env.ALLOW_ALL_USERS === 'true',
+  allowedPaths: process.env.ALLOWED_PATHS?.split(',').map(p => p.trim()).filter(Boolean) || [],
+  defaultDirectory: process.env.DEFAULT_DIRECTORY || process.cwd(),
+  messageRetentionDays: process.env.MESSAGE_RETENTION_DAYS
+    ? parseInt(process.env.MESSAGE_RETENTION_DAYS, 10)
+    : null,
+  rateLimitMs: process.env.RATE_LIMIT_MS
+    ? parseInt(process.env.RATE_LIMIT_MS, 10)
+    : 1000,
+};
+
+if (config.allowedUsers.length > 0) {
+  console.log(`User whitelist: ${config.allowedUsers.length} user(s) allowed`);
+} else if (config.allowAllUsers) {
+  console.warn('WARNING: ALLOW_ALL_USERS=true — anyone in the guild can use this bot');
+} else {
+  console.error('ERROR: Set ALLOWED_USERS or ALLOW_ALL_USERS=true');
+  process.exit(1);
+}
+
+if (config.allowedPaths.length > 0) {
+  console.log(`Path restrictions: ${config.allowedPaths.join(', ')}`);
+}
+
+if (config.messageRetentionDays) {
+  console.log(`Message retention: ${config.messageRetentionDays} day(s)`);
+}

package/src/index.ts

@@ -0,0 +1,18 @@
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+const envPath = resolve(process.cwd(), '.env');
+
+if (!existsSync(envPath)) {
+  console.log('\x1b[33mNo .env file found in the current directory.\x1b[0m');
+  console.log('Run \x1b[36magentcord setup\x1b[0m to configure.\n');
+  process.exit(1);
+}
+
+const { startBot } = await import('./bot.ts');
+
+console.log('agentcord starting...');
+startBot().catch(err => {
+  console.error('Fatal error:', err);
+  process.exit(1);
+});

package/src/message-handler.ts

@@ -0,0 +1,60 @@
+import type { Message, TextChannel } from 'discord.js';
+import { config } from './config.ts';
+import * as sessions from './session-manager.ts';
+import { handleOutputStream } from './output-handler.ts';
+import { isUserAllowed } from './utils.ts';
+
+const userLastMessage = new Map<string, number>();
+
+export async function handleMessage(message: Message): Promise<void> {
+  if (message.author.bot) return;
+
+  // Only handle messages in session channels
+  const session = sessions.getSessionByChannel(message.channelId);
+  if (!session) return;
+
+  // Auth check
+  if (!isUserAllowed(message.author.id, config.allowedUsers, config.allowAllUsers)) {
+    return;
+  }
+
+  // Rate limit
+  const now = Date.now();
+  const lastMsg = userLastMessage.get(message.author.id) || 0;
+  if (now - lastMsg < config.rateLimitMs) {
+    await message.react('⏳');
+    return;
+  }
+  userLastMessage.set(message.author.id, now);
+
+  // Interrupt current generation if active
+  if (session.isGenerating) {
+    sessions.abortSession(session.id);
+    // Wait for the abort to finish (up to 5s)
+    const deadline = Date.now() + 5000;
+    while (session.isGenerating && Date.now() < deadline) {
+      await new Promise(r => setTimeout(r, 100));
+    }
+    if (session.isGenerating) {
+      await message.reply({
+        content: 'Could not interrupt the current generation. Try `/claude stop`.',
+        allowedMentions: { repliedUser: false },
+      });
+      return;
+    }
+  }
+
+  const content = message.content.trim();
+  if (!content) return;
+
+  try {
+    const channel = message.channel as TextChannel;
+    const stream = sessions.sendPrompt(session.id, content);
+    await handleOutputStream(stream, channel, session.id, session.verbose);
+  } catch (err: unknown) {
+    await message.reply({
+      content: `Error: ${(err as Error).message}`,
+      allowedMentions: { repliedUser: false },
+    });
+  }
+}