synabun 1.3.0

package/mcp-server/src/tools/discord-onboarding.ts

@@ -0,0 +1,228 @@
+import { z } from 'zod';
+import * as discord from '../services/discord.js';
+import { text } from './response.js';
+
+export const discordOnboardingSchema = {
+  action: z.enum(['get', 'set_welcome', 'set_rules', 'set_verification', 'set_onboarding'] as const)
+    .describe('Action: get (current config), set_welcome (welcome screen), set_rules (rules channel), set_verification (level), set_onboarding (prompts & defaults).'),
+  guild_id: z.string().optional()
+    .describe('Guild ID. Defaults to DISCORD_GUILD_ID env var.'),
+  description: z.string().optional()
+    .describe('Welcome screen description text (set_welcome).'),
+  welcome_channels: z.array(z.record(z.unknown())).optional()
+    .describe('Welcome screen channels: [{channel_id, description, emoji_name?}] (set_welcome).'),
+  rules_channel: z.string().optional()
+    .describe('Channel name or ID for rules (set_rules).'),
+  system_channel: z.string().optional()
+    .describe('Channel name or ID for system messages (set_rules).'),
+  verification_level: z.enum(['none', 'low', 'medium', 'high', 'very_high'] as const).optional()
+    .describe('Verification level (set_verification). none=unrestricted, low=email, medium=5min, high=10min, very_high=phone.'),
+  prompts: z.array(z.record(z.unknown())).optional()
+    .describe('Onboarding prompts array (set_onboarding). Each: {title, options: [{title, description?, emoji_name?, channel_ids?, role_ids?}], single_select?, required?, in_onboarding?}'),
+  default_channels: z.array(z.string()).optional()
+    .describe('Default channel IDs for new members (set_onboarding).'),
+  enabled: z.boolean().optional()
+    .describe('Enable/disable onboarding (set_onboarding).'),
+};
+
+export const discordOnboardingDescription =
+  'Discord server onboarding and setup. Actions: get, set_welcome, set_rules, set_verification, set_onboarding.';
+
+// ── Get ────────────────────────────────────────────────────────
+
+async function handleGet(guildId: string) {
+  // Fetch guild info, welcome screen, and onboarding in sequence
+  const guildRes = await discord.getGuild(guildId);
+  const welcomeRes = await discord.getWelcomeScreen(guildId);
+  const onboardingRes = await discord.getOnboarding(guildId);
+
+  const lines: string[] = ['**Server Setup Status:**\n'];
+
+  // Guild settings
+  if (guildRes.ok && guildRes.data) {
+    const g = guildRes.data as {
+      verification_level: number;
+      rules_channel_id?: string;
+      system_channel_id?: string;
+      features: string[];
+    };
+    const verificationNames = ['None', 'Low (email)', 'Medium (5min)', 'High (10min)', 'Very High (phone)'];
+    lines.push(`Verification: ${verificationNames[g.verification_level] || g.verification_level}`);
+    lines.push(`Rules channel: ${g.rules_channel_id || 'not set'}`);
+    lines.push(`System channel: ${g.system_channel_id || 'not set'}`);
+    const hasWelcome = g.features.includes('WELCOME_SCREEN_ENABLED');
+    lines.push(`Welcome screen: ${hasWelcome ? 'enabled' : 'disabled'}`);
+    const hasCommunity = g.features.includes('COMMUNITY');
+    lines.push(`Community: ${hasCommunity ? 'enabled' : 'disabled'}`);
+    lines.push('');
+  }
+
+  // Welcome screen
+  if (welcomeRes.ok && welcomeRes.data) {
+    const w = welcomeRes.data as {
+      description?: string;
+      welcome_channels: { channel_id: string; description: string; emoji_name?: string }[];
+    };
+    lines.push('**Welcome Screen:**');
+    lines.push(`Description: ${w.description || '(none)'}`);
+    if (w.welcome_channels.length > 0) {
+      for (const ch of w.welcome_channels) {
+        lines.push(`  <#${ch.channel_id}> — ${ch.description}${ch.emoji_name ? ` ${ch.emoji_name}` : ''}`);
+      }
+    } else {
+      lines.push('  (no channels configured)');
+    }
+    lines.push('');
+  } else {
+    lines.push('**Welcome Screen:** not configured or requires Community\n');
+  }
+
+  // Onboarding
+  if (onboardingRes.ok && onboardingRes.data) {
+    const o = onboardingRes.data as {
+      guild_id: string;
+      prompts: { title: string; options: { title: string }[]; single_select: boolean; required: boolean }[];
+      default_channel_ids: string[];
+      enabled: boolean;
+    };
+    lines.push('**Onboarding:**');
+    lines.push(`Enabled: ${o.enabled}`);
+    lines.push(`Default channels: ${o.default_channel_ids.length > 0 ? o.default_channel_ids.map(id => `<#${id}>`).join(', ') : 'none'}`);
+    if (o.prompts.length > 0) {
+      lines.push(`Prompts (${o.prompts.length}):`);
+      for (const p of o.prompts) {
+        const opts = p.options.map(opt => opt.title).join(', ');
+        lines.push(`  "${p.title}" (${p.options.length} options${p.required ? ', required' : ''}${p.single_select ? ', single' : ', multi'}): ${opts}`);
+      }
+    } else {
+      lines.push('Prompts: none');
+    }
+  } else {
+    lines.push('**Onboarding:** not configured');
+  }
+
+  return text(lines.join('\n'));
+}
+
+// ── Set Welcome ────────────────────────────────────────────────
+
+async function handleSetWelcome(guildId: string, args: {
+  description?: string;
+  welcome_channels?: Record<string, unknown>[];
+}) {
+  const data: Record<string, unknown> = { enabled: true };
+  if (args.description !== undefined) data.description = args.description;
+  if (args.welcome_channels) data.welcome_channels = args.welcome_channels;
+
+  const res = await discord.setWelcomeScreen(guildId, data);
+  if (res.error) return text(res.error);
+
+  return text(`Updated welcome screen.${args.description ? ` Description: "${args.description}"` : ''}${args.welcome_channels ? ` Channels: ${args.welcome_channels.length}` : ''}`);
+}
+
+// ── Set Rules ──────────────────────────────────────────────────
+
+async function handleSetRules(guildId: string, args: {
+  rules_channel?: string;
+  system_channel?: string;
+}) {
+  if (!args.rules_channel && !args.system_channel) {
+    return text('Provide rules_channel and/or system_channel.');
+  }
+
+  const data: Record<string, unknown> = {};
+
+  if (args.rules_channel) {
+    const ch = await discord.resolveChannel(args.rules_channel, guildId);
+    if ('error' in ch) return text(`Rules channel: ${ch.error}`);
+    data.rules_channel_id = ch.id;
+  }
+
+  if (args.system_channel) {
+    const ch = await discord.resolveChannel(args.system_channel, guildId);
+    if ('error' in ch) return text(`System channel: ${ch.error}`);
+    data.system_channel_id = ch.id;
+  }
+
+  const res = await discord.editGuildSettings(guildId, data);
+  if (res.error) return text(res.error);
+
+  const changes = Object.entries(data).map(([k, v]) => `${k}: ${v}`).join(', ');
+  return text(`Updated guild settings: ${changes}`);
+}
+
+// ── Set Verification ───────────────────────────────────────────
+
+async function handleSetVerification(guildId: string, args: { verification_level?: string }) {
+  if (!args.verification_level) {
+    return text('verification_level is required.');
+  }
+
+  const level = discord.VERIFICATION_LEVELS[args.verification_level];
+  if (level === undefined) {
+    return text(`Unknown verification level "${args.verification_level}". Use: none, low, medium, high, very_high.`);
+  }
+
+  const res = await discord.editGuildSettings(guildId, { verification_level: level });
+  if (res.error) return text(res.error);
+
+  return text(`Set verification level to ${args.verification_level} (${level}).`);
+}
+
+// ── Set Onboarding ─────────────────────────────────────────────
+
+async function handleSetOnboarding(guildId: string, args: {
+  prompts?: Record<string, unknown>[];
+  default_channels?: string[];
+  enabled?: boolean;
+}) {
+  // GET current onboarding first, then merge
+  const currentRes = await discord.getOnboarding(guildId);
+  const current = (currentRes.ok && currentRes.data)
+    ? currentRes.data as Record<string, unknown>
+    : { prompts: [], default_channel_ids: [], enabled: false };
+
+  const data: Record<string, unknown> = { ...current };
+  if (args.prompts !== undefined) data.prompts = args.prompts;
+  if (args.default_channels !== undefined) data.default_channel_ids = args.default_channels;
+  if (args.enabled !== undefined) data.enabled = args.enabled;
+
+  const res = await discord.setOnboarding(guildId, data);
+  if (res.error) return text(res.error);
+
+  const changes: string[] = [];
+  if (args.enabled !== undefined) changes.push(`enabled: ${args.enabled}`);
+  if (args.prompts) changes.push(`prompts: ${args.prompts.length}`);
+  if (args.default_channels) changes.push(`default channels: ${args.default_channels.length}`);
+
+  return text(`Updated onboarding: ${changes.join(', ')}`);
+}
+
+// ── Main dispatcher ────────────────────────────────────────────
+
+export async function handleDiscordOnboarding(args: {
+  action: string;
+  guild_id?: string;
+  description?: string;
+  welcome_channels?: Record<string, unknown>[];
+  rules_channel?: string;
+  system_channel?: string;
+  verification_level?: string;
+  prompts?: Record<string, unknown>[];
+  default_channels?: string[];
+  enabled?: boolean;
+}) {
+  const resolved = await discord.resolveGuildId(args.guild_id);
+  if ('error' in resolved) return text(resolved.error);
+  const guildId = resolved.guildId;
+
+  switch (args.action) {
+    case 'get': return handleGet(guildId);
+    case 'set_welcome': return handleSetWelcome(guildId, args);
+    case 'set_rules': return handleSetRules(guildId, args);
+    case 'set_verification': return handleSetVerification(guildId, args);
+    case 'set_onboarding': return handleSetOnboarding(guildId, args);
+    default:
+      return text(`Unknown action "${args.action}". Use: get, set_welcome, set_rules, set_verification, set_onboarding.`);
+  }
+}

package/mcp-server/src/tools/discord-role.ts

@@ -0,0 +1,209 @@
+import { z } from 'zod';
+import * as discord from '../services/discord.js';
+import { text } from './response.js';
+
+export const discordRoleSchema = {
+  action: z.enum(['create', 'edit', 'delete', 'list', 'assign', 'remove'] as const)
+    .describe('Action: create, edit, delete, list, assign (to member), remove (from member).'),
+  guild_id: z.string().optional()
+    .describe('Guild ID. Defaults to DISCORD_GUILD_ID env var.'),
+  role: z.string().optional()
+    .describe('Role name or ID (required for edit/delete/assign/remove).'),
+  name: z.string().optional()
+    .describe('Role name (create required, edit optional).'),
+  color: z.string().optional()
+    .describe('Hex color e.g. "#ff0000" (create/edit).'),
+  hoist: z.boolean().optional()
+    .describe('Display separately in sidebar (create/edit).'),
+  mentionable: z.boolean().optional()
+    .describe('Allow @mention by anyone (create/edit).'),
+  permissions: z.string().optional()
+    .describe('Permission flags, comma-separated (create/edit). E.g. "SEND_MESSAGES,MANAGE_CHANNELS".'),
+  position: z.number().optional()
+    .describe('Sort position (edit only).'),
+  member: z.string().optional()
+    .describe('User name or ID (assign/remove actions).'),
+  reason: z.string().optional()
+    .describe('Audit log reason.'),
+};
+
+export const discordRoleDescription =
+  'Discord role management. Actions: create, edit, delete, list, assign (role to member), remove (role from member).';
+
+// ── Create ─────────────────────────────────────────────────────
+
+async function handleCreate(guildId: string, args: {
+  name?: string; color?: string; hoist?: boolean;
+  mentionable?: boolean; permissions?: string;
+}) {
+  if (!args.name) {
+    return text('name is required for create action.');
+  }
+
+  const data: Record<string, unknown> = { name: args.name };
+
+  if (args.color) {
+    const hex = args.color.replace('#', '');
+    data.color = parseInt(hex, 16);
+  }
+  if (args.hoist !== undefined) data.hoist = args.hoist;
+  if (args.mentionable !== undefined) data.mentionable = args.mentionable;
+  if (args.permissions) {
+    try {
+      data.permissions = discord.resolvePermissions(args.permissions);
+    } catch (err) {
+      return text((err as Error).message);
+    }
+  }
+
+  const res = await discord.createRole(guildId, data);
+  if (res.error) return text(res.error);
+
+  const role = res.data as { id: string; name: string; color: number };
+  const colorStr = role.color ? ` #${role.color.toString(16).padStart(6, '0')}` : '';
+  return text(`Created role @${role.name} (${role.id})${colorStr}`);
+}
+
+// ── Edit ───────────────────────────────────────────────────────
+
+async function handleEdit(guildId: string, args: {
+  role?: string; name?: string; color?: string; hoist?: boolean;
+  mentionable?: boolean; permissions?: string; position?: number;
+}) {
+  if (!args.role) {
+    return text('role is required for edit action.');
+  }
+
+  const resolved = await discord.resolveRole(args.role, guildId);
+  if ('error' in resolved) return text(resolved.error);
+
+  const data: Record<string, unknown> = {};
+  if (args.name !== undefined) data.name = args.name;
+  if (args.color !== undefined) {
+    const hex = args.color.replace('#', '');
+    data.color = parseInt(hex, 16);
+  }
+  if (args.hoist !== undefined) data.hoist = args.hoist;
+  if (args.mentionable !== undefined) data.mentionable = args.mentionable;
+  if (args.permissions) {
+    try {
+      data.permissions = discord.resolvePermissions(args.permissions);
+    } catch (err) {
+      return text((err as Error).message);
+    }
+  }
+
+  if (Object.keys(data).length === 0 && args.position === undefined) {
+    return text('No changes specified.');
+  }
+
+  const res = await discord.editRole(guildId, resolved.id, data);
+  if (res.error) return text(res.error);
+
+  return text(`Updated role @${resolved.name} (${resolved.id}).`);
+}
+
+// ── Delete ─────────────────────────────────────────────────────
+
+async function handleDelete(guildId: string, args: { role?: string }) {
+  if (!args.role) {
+    return text('role is required for delete action.');
+  }
+
+  const resolved = await discord.resolveRole(args.role, guildId);
+  if ('error' in resolved) return text(resolved.error);
+
+  const res = await discord.deleteRole(guildId, resolved.id);
+  if (res.error) return text(res.error);
+
+  return text(`Deleted role @${resolved.name} (${resolved.id}).`);
+}
+
+// ── List ───────────────────────────────────────────────────────
+
+async function handleList(guildId: string) {
+  const roles = await discord.getGuildRoles(guildId);
+  if ('error' in roles) return text((roles as { error: string }).error);
+
+  const list = (roles as { id: string; name: string; color: number; position: number; managed?: boolean; mentionable?: boolean; hoist?: boolean; permissions: string }[])
+    .sort((a, b) => b.position - a.position);
+
+  const lines = list.map(r => {
+    const color = r.color ? ` #${r.color.toString(16).padStart(6, '0')}` : '';
+    const flags: string[] = [];
+    if (r.hoist) flags.push('hoisted');
+    if (r.mentionable) flags.push('mentionable');
+    if (r.managed) flags.push('managed');
+    const flagStr = flags.length > 0 ? ` [${flags.join(', ')}]` : '';
+    return `  @${r.name} (${r.id})${color}${flagStr}`;
+  });
+
+  return text(`Roles (${list.length}):\n${lines.join('\n')}`);
+}
+
+// ── Assign ─────────────────────────────────────────────────────
+
+async function handleAssign(guildId: string, args: { role?: string; member?: string }) {
+  if (!args.role) return text('role is required for assign action.');
+  if (!args.member) return text('member is required for assign action.');
+
+  const roleResolved = await discord.resolveRole(args.role, guildId);
+  if ('error' in roleResolved) return text(roleResolved.error);
+
+  const userResolved = await discord.resolveUser(args.member, guildId);
+  if ('error' in userResolved) return text(userResolved.error);
+
+  const res = await discord.addMemberRole(guildId, userResolved.id, roleResolved.id);
+  if (res.error) return text(res.error);
+
+  return text(`Assigned @${roleResolved.name} to ${userResolved.name}.`);
+}
+
+// ── Remove ─────────────────────────────────────────────────────
+
+async function handleRemove(guildId: string, args: { role?: string; member?: string }) {
+  if (!args.role) return text('role is required for remove action.');
+  if (!args.member) return text('member is required for remove action.');
+
+  const roleResolved = await discord.resolveRole(args.role, guildId);
+  if ('error' in roleResolved) return text(roleResolved.error);
+
+  const userResolved = await discord.resolveUser(args.member, guildId);
+  if ('error' in userResolved) return text(userResolved.error);
+
+  const res = await discord.removeMemberRole(guildId, userResolved.id, roleResolved.id);
+  if (res.error) return text(res.error);
+
+  return text(`Removed @${roleResolved.name} from ${userResolved.name}.`);
+}
+
+// ── Main dispatcher ────────────────────────────────────────────
+
+export async function handleDiscordRole(args: {
+  action: string;
+  guild_id?: string;
+  role?: string;
+  name?: string;
+  color?: string;
+  hoist?: boolean;
+  mentionable?: boolean;
+  permissions?: string;
+  position?: number;
+  member?: string;
+  reason?: string;
+}) {
+  const resolved = await discord.resolveGuildId(args.guild_id);
+  if ('error' in resolved) return text(resolved.error);
+  const guildId = resolved.guildId;
+
+  switch (args.action) {
+    case 'create': return handleCreate(guildId, args);
+    case 'edit': return handleEdit(guildId, args);
+    case 'delete': return handleDelete(guildId, args);
+    case 'list': return handleList(guildId);
+    case 'assign': return handleAssign(guildId, args);
+    case 'remove': return handleRemove(guildId, args);
+    default:
+      return text(`Unknown action "${args.action}". Use: create, edit, delete, list, assign, remove.`);
+  }
+}

package/mcp-server/src/tools/discord-thread.ts

@@ -0,0 +1,110 @@
+import { z } from 'zod';
+import * as discord from '../services/discord.js';
+import { text } from './response.js';
+
+export const discordThreadSchema = {
+  action: z.enum(['create', 'archive', 'unarchive', 'lock', 'delete'] as const)
+    .describe('Action: create, archive, unarchive, lock, delete.'),
+  guild_id: z.string().optional()
+    .describe('Guild ID for channel name resolution. Defaults to DISCORD_GUILD_ID env var.'),
+  channel: z.string().optional()
+    .describe('Parent channel name or ID (create only).'),
+  thread: z.string().optional()
+    .describe('Thread ID (required for archive/unarchive/lock/delete).'),
+  name: z.string().optional()
+    .describe('Thread name (create required).'),
+  message_id: z.string().optional()
+    .describe('Create thread from this message (create only). Omit for standalone thread.'),
+  auto_archive: z.number().optional()
+    .describe('Auto-archive duration in minutes: 60, 1440, 4320, or 10080 (create only).'),
+  private: z.boolean().optional()
+    .describe('Create private thread (create only, default false).'),
+};
+
+export const discordThreadDescription =
+  'Discord thread management. Actions: create (from message or standalone), archive, unarchive, lock, delete.';
+
+// ── Create ─────────────────────────────────────────────────────
+
+async function handleCreate(args: {
+  channel?: string; name?: string; message_id?: string;
+  auto_archive?: number; private?: boolean; guild_id?: string;
+}) {
+  if (!args.channel) return text('channel is required for create action.');
+  if (!args.name) return text('name is required for create action.');
+
+  let channelId = args.channel;
+  if (!/^\d{17,20}$/.test(channelId)) {
+    const resolved = await discord.resolveGuildId(args.guild_id);
+    if ('error' in resolved) return text(resolved.error);
+    const ch = await discord.resolveChannel(args.channel, resolved.guildId);
+    if ('error' in ch) return text(ch.error);
+    channelId = ch.id;
+  }
+
+  const data: Record<string, unknown> = {
+    name: args.name,
+    auto_archive_duration: args.auto_archive || 1440,
+  };
+
+  let res: discord.DiscordResponse;
+
+  if (args.message_id) {
+    // Create thread from message
+    res = await discord.createThreadFromMessage(channelId, args.message_id, data);
+  } else {
+    // Standalone thread
+    data.type = args.private ? 12 : 11; // 11 = public, 12 = private
+    res = await discord.createThread(channelId, data);
+  }
+
+  if (res.error) return text(res.error);
+
+  const thread = res.data as { id: string; name: string };
+  return text(`Created thread "${thread.name}" (${thread.id})${args.message_id ? ` from message ${args.message_id}` : ''}.`);
+}
+
+// ── Archive / Unarchive / Lock ─────────────────────────────────
+
+async function handleModify(args: { thread?: string }, updates: Record<string, unknown>, actionName: string) {
+  if (!args.thread) return text(`thread ID is required for ${actionName} action.`);
+
+  const res = await discord.modifyThread(args.thread, updates);
+  if (res.error) return text(res.error);
+
+  return text(`Thread ${args.thread} ${actionName}d.`);
+}
+
+// ── Delete ─────────────────────────────────────────────────────
+
+async function handleDelete(args: { thread?: string }) {
+  if (!args.thread) return text('thread ID is required for delete action.');
+
+  const res = await discord.deleteThread(args.thread);
+  if (res.error) return text(res.error);
+
+  return text(`Deleted thread ${args.thread}.`);
+}
+
+// ── Main dispatcher ────────────────────────────────────────────
+
+export async function handleDiscordThread(args: {
+  action: string;
+  guild_id?: string;
+  channel?: string;
+  thread?: string;
+  name?: string;
+  message_id?: string;
+  auto_archive?: number;
+  private?: boolean;
+}) {
+  switch (args.action) {
+    case 'create': return handleCreate(args);
+    case 'archive': return handleModify(args, { archived: true }, 'archive');
+    case 'unarchive': return handleModify(args, { archived: false }, 'unarchive');
+    case 'lock': return handleModify(args, { locked: true }, 'lock');
+    case 'delete': return handleDelete(args);
+    default:
+      return text(`Unknown action "${args.action}". Use: create, archive, unarchive, lock, delete.`);
+  }
+}