discord-ops 0.22.0 → 0.23.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # discord-ops
 
+## 0.23.0
+
+### Minor Changes
+
+- bbc870b: Multi-bot architecture: bot personas, per-channel bot assignment, and per-project tool profile enforcement.
+
+  **Bot personas:** Named bots with identity metadata (`name`, `role`, `description`) configured in a top-level `bots` section. Each bot references a `token_env` and can have a `default_profile` restricting which tools it can use.
+
+  **Channel-level bot assignment:** Channels accept `{ "id": "...", "bot": "bot-name" }` to override which bot operates in that channel. Token resolution follows: channel bot → project bot → project `token_env` → default token.
+
+  **Per-project tool profile enforcement:** Runtime gate in the MCP server checks per-project `tool_profile` and per-bot `default_profile` on every tool call. Tools not in the effective profile return an error. Supports `profile_add`/`profile_remove` overrides.
+
+  **New tool:** `list_bots` — returns all configured bot personas with project assignments, channel overrides, and connection status. Does not expose token values.
+
+  **Validation:** `discord-ops validate` now checks bot references, profile names, and bot token availability.
+
+  Backwards compatible — existing configs without `bots` work unchanged. Channels accept both plain snowflake strings and `{ id, bot }` objects.
+
 ## 0.22.0
 
 ### Minor Changes

package/README.md

@@ -8,10 +8,11 @@ Agency-grade Discord MCP server with multi-guild project routing.
 
 ## Features
 
-- **48 MCP tools** — messaging, channels, moderation, roles, webhooks, audit log, threads, guilds, invites, permissions, search, 23 templates, OG embed unfurling, project introspection
+- **49 MCP tools** — messaging, channels, moderation, roles, webhooks, audit log, threads, guilds, invites, permissions, search, 23 templates, OG embed unfurling, project introspection
 - **Multi-guild project routing** — `send_message({ project: "my-app", channel: "builds" })` instead of raw channel IDs
 - **Notification routing** — map notification types (`ci_build`, `deploy`, `error`) to channels per project
 - **Owner pings** — configure project owners so releases, errors, and alerts auto-mention the right people
+- **Bot personas** — named bots with identity metadata, per-channel bot assignment, and per-bot tool profiles
 - **Multi-bot support** — manage multiple Discord bots from a single MCP server with per-project tokens
 - **Tool profiles** — load only the tools an agent needs; cut schema overhead by 85% with slim profiles
 - **Smart channel resolution** — channel params accept channel name or snowflake ID, with 4-layer fuzzy fallback
@@ -183,6 +184,56 @@ Projects can specify their own bot token via `token_env`:
 
 When all projects have `token_env`, the default `DISCORD_TOKEN` is optional. Each project connects with its own bot.
 
+### Bot personas
+
+Give bots names, roles, and per-channel assignment. This is ideal when your Discord server runs multiple bots with distinct personas (e.g., a community helper vs. a tech ops bot).
+
+```json
+{
+  "bots": {
+    "claire": {
+      "name": "Claire",
+      "role": "Community helper",
+      "description": "Handles support and community channels",
+      "token_env": "CLAIRE_TOKEN",
+      "default_profile": "messaging"
+    },
+    "courier": {
+      "name": "Clarity Courier",
+      "role": "Technical operations",
+      "token_env": "COURIER_TOKEN",
+      "default_profile": "full"
+    }
+  },
+  "projects": {
+    "clarity-house": {
+      "guild_id": "123456789012345678",
+      "bot": "courier",
+      "channels": {
+        "general": "111111111111111111",
+        "support": { "id": "222222222222222222", "bot": "claire" },
+        "dev-ops": "333333333333333333",
+        "ai-testing": { "id": "444444444444444444", "bot": "claire" }
+      },
+      "default_channel": "dev-ops",
+      "tool_profile": "full"
+    }
+  }
+}
+```
+
+**How it works:**
+
+- **`bots`** — named bot definitions with identity metadata and `token_env`
+- **`project.bot`** — default bot for the project (all channels use this bot unless overridden)
+- **Channel `bot` override** — individual channels can use a different bot: `{ "id": "...", "bot": "claire" }`
+- **`default_profile`** — per-bot tool profile (restricts which tools a bot can use at runtime)
+- **Token resolution** — channel bot → project bot → project `token_env` → default `DISCORD_TOKEN`
+- **Bot persona in routing** — resolved targets include `bot: { name, role }` metadata for agent context
+- **Backwards compatible** — `bots` is optional; channels accept both `"ID"` and `{ "id": "ID", "bot": "name" }` formats
+
+Use `list_bots` to see all configured bots, their project assignments, channel overrides, and connection status.
+
 ### Owner pings
 
 Configure project owners so that releases, errors, and alerts automatically prepend `@mentions`. This ensures the right people are always paged for critical events without hardcoding mentions in every message.
@@ -365,12 +416,13 @@ Useful for sharing GitHub PRs, npm releases, blog posts, or any URL with rich pr
 | `list_threads`   | List active threads                    |
 | `archive_thread` | Archive (and optionally lock) a thread |
 
-### System (2 tools)
+### System (3 tools)
 
-| Tool            | Description                                                         |
-| --------------- | ------------------------------------------------------------------- |
-| `health_check`  | Bot status, version, connected guilds, and permission audit         |
-| `list_projects` | List all projects with guild mappings, token status, and validation |
+| Tool            | Description                                                          |
+| --------------- | -------------------------------------------------------------------- |
+| `health_check`  | Bot status, version, connected guilds, and permission audit          |
+| `list_projects` | List all projects with guild mappings, token status, and validation  |
+| `list_bots`     | List all bot personas with project assignments and channel overrides |
 
 ## Tool Profiles
 
@@ -380,9 +432,9 @@ Load only the tools an agent needs. Reduces schema token overhead by up to 85% f
 
 | Profile      | Tools | Description                                                                                            |
 | ------------ | ----- | ------------------------------------------------------------------------------------------------------ |
-| `full`       | 48    | All tools (default)                                                                                    |
-| `monitoring` | 6     | get_messages, send_message, add_reaction, create_thread, health_check, list_projects                   |
-| `readonly`   | 6     | get_messages, list_channels, list_members, get_guild, health_check, list_projects                      |
+| `full`       | 49    | All tools (default)                                                                                    |
+| `monitoring` | 7     | get_messages, send_message, add_reaction, create_thread, health_check, list_projects, list_bots        |
+| `readonly`   | 7     | get_messages, list_channels, list_members, get_guild, health_check, list_projects, list_bots           |
 | `moderation` | 7     | get_messages, kick_member, ban_member, timeout_member, delete_message, purge_messages, query_audit_log |
 | `messaging`  | 5     | add_reaction, delete_message, edit_message, get_messages, send_message                                 |
 | `channels`   | 7     | create_channel, delete_channel, edit_channel, get_channel, list_channels, purge_messages, set_slowmode |
@@ -484,10 +536,12 @@ Any tool name accepted by the MCP server works here — `send_message`, `send_te
 
 ### Token resolution
 
-1. If `DISCORD_OPS_TOKEN_ENV` is set, its value names the env var holding the default token (e.g., `DISCORD_OPS_TOKEN_ENV=MY_BOT_TOKEN` reads `MY_BOT_TOKEN`).
-2. Otherwise, the default token comes from `DISCORD_TOKEN`.
-3. Per-project tokens override the default: if a project config has `"token_env": "ORG_A_TOKEN"`, that project's bot uses `ORG_A_TOKEN`.
-4. If all projects have `token_env` set with valid values, no default token is needed at all.
+1. **Channel-level bot** — if the channel has a `bot` override, use that bot's `token_env`
+2. **Project-level bot** — if the project has a `bot`, use that bot's `token_env`
+3. **Project-level `token_env`** — project's own token env var
+4. **Default token** — `DISCORD_TOKEN` (or custom via `DISCORD_OPS_TOKEN_ENV`)
+
+If `DISCORD_OPS_TOKEN_ENV` is set, its value names the env var holding the default token (e.g., `DISCORD_OPS_TOKEN_ENV=MY_BOT_TOKEN` reads `MY_BOT_TOKEN`). If all projects have `token_env` or `bot` set, no default token is needed.
 
 ## CI/CD Integration
 
@@ -720,22 +774,33 @@ Full `~/.discord-ops.json` schema with all options:
 
 ```json
 {
+  "bots": {
+    "my-bot": {
+      "name": "My Bot",
+      "role": "General purpose",
+      "description": "Handles all operations",
+      "token_env": "MY_BOT_TOKEN",
+      "default_profile": "full"
+    }
+  },
   "projects": {
     "my-app": {
       "guild_id": "123456789012345678",
       "token_env": "MY_APP_DISCORD_TOKEN",
+      "bot": "my-bot",
       "channels": {
         "dev": "CHANNEL_ID",
         "builds": "CHANNEL_ID",
         "releases": "CHANNEL_ID",
-        "alerts": "CHANNEL_ID"
+        "alerts": "CHANNEL_ID",
+        "support": { "id": "CHANNEL_ID", "bot": "my-bot" }
       },
       "default_channel": "dev",
       "owners": ["USER_SNOWFLAKE_ID"],
       "notify_owners_on": ["release", "error", "alert"],
       "tool_profile": "full",
-      "tool_profile_add": [],
-      "tool_profile_remove": [],
+      "profile_add": [],
+      "profile_remove": [],
       "notification_routing": {
         "ci_build": "builds",
         "deploy": "builds",
@@ -755,20 +820,31 @@ Full `~/.discord-ops.json` schema with all options:
 }
 ```
 
-| Field                  | Description                                                       |
-| ---------------------- | ----------------------------------------------------------------- |
-| `guild_id`             | Discord server (guild) snowflake ID                               |
-| `token_env`            | Env var name for this project's bot token                         |
-| `channels`             | Alias → channel ID map; `channel: "builds"` resolves here first   |
-| `default_channel`      | Channel used when no `channel` param is provided                  |
-| `owners`               | User snowflake IDs to mention on matching notification types      |
-| `notify_owners_on`     | Notification types that trigger owner pings (`"dev"` never pings) |
-| `tool_profile`         | Base tool profile for this project (`full`, `monitoring`, etc.)   |
-| `tool_profile_add`     | Additional tools to load on top of the base profile               |
-| `tool_profile_remove`  | Tools to exclude from the base profile                            |
-| `notification_routing` | Per-project override of global notification → channel routing     |
+**Global fields:**
+
+| Field                  | Description                                                                           |
+| ---------------------- | ------------------------------------------------------------------------------------- |
+| `bots`                 | Named bot personas with `name`, `role`, `description`, `token_env`, `default_profile` |
+| `default_project`      | Project used when no `project` param is provided                                      |
+| `notification_routing` | Global notification type → channel alias routing                                      |
+
+**Project fields:**
+
+| Field                  | Description                                                                           |
+| ---------------------- | ------------------------------------------------------------------------------------- |
+| `guild_id`             | Discord server (guild) snowflake ID                                                   |
+| `token_env`            | Env var name for this project's bot token                                             |
+| `bot`                  | Default bot persona for this project (references a key in `bots`)                     |
+| `channels`             | Alias → channel ID or `{ id, bot }` map; `channel: "builds"` resolves here first      |
+| `default_channel`      | Channel used when no `channel` param is provided                                      |
+| `owners`               | User snowflake IDs to mention on matching notification types                          |
+| `notify_owners_on`     | Notification types that trigger owner pings (`"dev"` never pings)                     |
+| `tool_profile`         | Base tool profile for this project (`full`, `monitoring`, etc.) — enforced at runtime |
+| `profile_add`          | Additional tools to load on top of the base profile                                   |
+| `profile_remove`       | Tools to exclude from the base profile                                                |
+| `notification_routing` | Per-project override of global notification → channel routing                         |
 
-> **Note:** `tool_profile`, `tool_profile_add`, and `tool_profile_remove` in project config are not yet implemented in the config schema. Use CLI flags `--profile` and `--tools` instead.
+Per-project profiles are enforced at runtime — all tools stay registered on the MCP server, but tool calls are filtered when the resolved project or bot has a profile set. This means agents can discover all tools via MCP schema, but per-project restrictions are applied on each call.
 
 ## Multi-Organization Troubleshooting
 
@@ -777,6 +853,9 @@ Full `~/.discord-ops.json` schema with all options:
 Run `discord-ops validate` to check your config without connecting to Discord. It detects:
 
 - Missing `token_env` values (env var not set)
+- Bot references (`project.bot`, channel `bot`) pointing to undefined bots
+- Invalid `default_profile` or `tool_profile` values
+- Missing bot `token_env` environment variables
 - Duplicate guild IDs across projects with different tokens
 - `default_channel` referencing a nonexistent alias
 - `default_project` pointing to a nonexistent project

package/dist/cli/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/cli/validate.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CA0BjD"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/cli/validate.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAyFjD"}

package/dist/cli/validate.js

@@ -1,4 +1,5 @@
 import { loadConfig } from "../config/index.js";
+import { isProfileName } from "../profiles/index.js";
 /**
  * Validates the discord-ops configuration files.
  * Loads global and per-project configs and reports any issues.
@@ -7,8 +8,12 @@ export async function runValidate() {
     try {
         const config = loadConfig();
         const projectCount = Object.keys(config.global.projects).length;
+        const botCount = Object.keys(config.global.bots ?? {}).length;
         console.log("Configuration valid.");
         console.log(`  Projects: ${projectCount}`);
+        if (botCount > 0) {
+            console.log(`  Bots: ${botCount}`);
+        }
         if (config.global.default_project) {
             console.log(`  Default project: ${config.global.default_project}`);
         }
@@ -21,6 +26,49 @@ export async function runValidate() {
         else {
             console.warn("  Warning: No default token configured (DISCORD_TOKEN not set)");
         }
+        // Validate bot references and profiles
+        const warnings = [];
+        const errors = [];
+        const bots = config.global.bots ?? {};
+        // Validate bot personas
+        for (const [botKey, bot] of Object.entries(bots)) {
+            if (!process.env[bot.token_env]) {
+                warnings.push(`Bot "${botKey}": token_env "${bot.token_env}" is not set in environment`);
+            }
+            if (bot.default_profile && !isProfileName(bot.default_profile)) {
+                errors.push(`Bot "${botKey}": default_profile "${bot.default_profile}" is not a valid profile name`);
+            }
+        }
+        // Validate project-level bot and profile references
+        for (const [projectName, project] of Object.entries(config.global.projects)) {
+            // Check project.bot reference
+            if (project.bot && !bots[project.bot]) {
+                errors.push(`Project "${projectName}": bot "${project.bot}" is not defined in the bots section`);
+            }
+            // Check project tool_profile
+            if (project.tool_profile && !isProfileName(project.tool_profile)) {
+                errors.push(`Project "${projectName}": tool_profile "${project.tool_profile}" is not a valid profile name`);
+            }
+            // Check channel-level bot overrides
+            for (const [alias, channelConfig] of Object.entries(project.channels)) {
+                if (typeof channelConfig === "object" && channelConfig.bot) {
+                    if (!bots[channelConfig.bot]) {
+                        errors.push(`Project "${projectName}", channel "${alias}": bot "${channelConfig.bot}" is not defined in the bots section`);
+                    }
+                }
+            }
+        }
+        // Report warnings
+        for (const warning of warnings) {
+            console.warn(`  Warning: ${warning}`);
+        }
+        // Report errors
+        if (errors.length > 0) {
+            for (const error of errors) {
+                console.error(`  Error: ${error}`);
+            }
+            process.exit(1);
+        }
     }
     catch (err) {
         console.error("Configuration invalid:", err instanceof Error ? err.message : String(err));

package/dist/cli/validate.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/cli/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAE5B,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;QAEhE,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,eAAe,YAAY,EAAE,CAAC,CAAC;QAE3C,IAAI,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,sBAAsB,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,iCAAiC,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/cli/validate.ts"],"names":[],"mappings":"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"}

package/dist/config/index.d.ts

@@ -1,13 +1,32 @@
-import { type GlobalConfig, type PerProjectConfig } from "./schema.js";
+import { type GlobalConfig, type PerProjectConfig, type BotPersona } from "./schema.js";
 export interface LoadedConfig {
     global: GlobalConfig;
     perProject?: PerProjectConfig;
     defaultToken?: string;
 }
+/**
+ * Resolves the token for a named bot from the bots config section.
+ */
+export declare function getTokenForBot(botName: string, config: LoadedConfig): string;
+/**
+ * Resolves the token for a specific channel within a project.
+ * Checks channel-level bot override first, then falls back to project-level.
+ */
+export declare function getTokenForChannel(projectName: string, channelAlias: string, config: LoadedConfig): string;
+/**
+ * Returns bot persona metadata for agent context.
+ * Checks channel-level bot override first, then project-level bot.
+ */
+export declare function getBotPersona(projectName: string, channelAlias?: string, config?: LoadedConfig): (BotPersona & {
+    key: string;
+}) | undefined;
 /**
  * Resolves the token for a given project.
- * If the project has `token_env`, reads that env var.
- * Otherwise falls back to the default DISCORD_TOKEN.
+ *
+ * Token resolution priority:
+ *  1. Project-level bot (project.bot → bots[name].token_env)
+ *  2. Project-level token_env (existing behavior)
+ *  3. Default DISCORD_TOKEN (existing behavior)
  */
 export declare function getTokenForProject(projectName: string, config: LoadedConfig): string;
 /**
@@ -19,5 +38,5 @@ export declare function getTokenForProject(projectName: string, config: LoadedCo
  *  3. Direct params always work regardless
  */
 export declare function loadConfig(): LoadedConfig;
-export { type GlobalConfig, type PerProjectConfig } from "./schema.js";
+export { type GlobalConfig, type PerProjectConfig, type BotPersona } from "./schema.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAgBpF;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,YAAY,CAwCzC;AA4DD,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAChB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAU5E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,YAAY,GACnB,MAAM,CAcR;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,YAAY,GACpB,CAAC,UAAU,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAyB5C;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CA2BpF;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,YAAY,CAgDzC;AA4DD,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/config/index.js

@@ -3,13 +3,85 @@ import { resolve, join } from "node:path";
 import { homedir } from "node:os";
 import { logger } from "../utils/logger.js";
 import { GlobalConfigSchema, PerProjectConfigSchema, } from "./schema.js";
+/**
+ * Resolves the token for a named bot from the bots config section.
+ */
+export function getTokenForBot(botName, config) {
+    const bot = config.global.bots?.[botName];
+    if (!bot) {
+        throw new Error(`Bot "${botName}" not found in bots config`);
+    }
+    const token = process.env[bot.token_env];
+    if (!token) {
+        throw new Error(`Bot "${botName}": token_env "${bot.token_env}" is not set in environment`);
+    }
+    return token;
+}
+/**
+ * Resolves the token for a specific channel within a project.
+ * Checks channel-level bot override first, then falls back to project-level.
+ */
+export function getTokenForChannel(projectName, channelAlias, config) {
+    const project = config.global.projects[projectName];
+    if (!project) {
+        throw new Error(`Project "${projectName}" not found in config`);
+    }
+    // Check channel-level bot override
+    const channelConfig = project.channels[channelAlias];
+    if (channelConfig && typeof channelConfig === "object" && channelConfig.bot) {
+        return getTokenForBot(channelConfig.bot, config);
+    }
+    // Fall back to project-level resolution
+    return getTokenForProject(projectName, config);
+}
+/**
+ * Returns bot persona metadata for agent context.
+ * Checks channel-level bot override first, then project-level bot.
+ */
+export function getBotPersona(projectName, channelAlias, config) {
+    if (!config)
+        return undefined;
+    const project = config.global.projects[projectName];
+    if (!project)
+        return undefined;
+    const bots = config.global.bots;
+    if (!bots)
+        return undefined;
+    // Check channel-level bot override
+    if (channelAlias) {
+        const channelConfig = project.channels[channelAlias];
+        if (channelConfig && typeof channelConfig === "object" && channelConfig.bot) {
+            const bot = bots[channelConfig.bot];
+            if (bot)
+                return { ...bot, key: channelConfig.bot };
+        }
+    }
+    // Check project-level bot
+    if (project.bot) {
+        const bot = bots[project.bot];
+        if (bot)
+            return { ...bot, key: project.bot };
+    }
+    return undefined;
+}
 /**
  * Resolves the token for a given project.
- * If the project has `token_env`, reads that env var.
- * Otherwise falls back to the default DISCORD_TOKEN.
+ *
+ * Token resolution priority:
+ *  1. Project-level bot (project.bot → bots[name].token_env)
+ *  2. Project-level token_env (existing behavior)
+ *  3. Default DISCORD_TOKEN (existing behavior)
  */
 export function getTokenForProject(projectName, config) {
     const project = config.global.projects[projectName];
+    // Check project-level bot reference first
+    if (project?.bot && config.global.bots?.[project.bot]) {
+        const bot = config.global.bots[project.bot];
+        const token = process.env[bot.token_env];
+        if (token)
+            return token;
+        logger.warn(`Bot "${project.bot}" token_env "${bot.token_env}" for project "${projectName}" is not set, falling back`);
+    }
     if (project?.token_env) {
         const token = process.env[project.token_env];
         if (token)
@@ -42,14 +114,22 @@ export function loadConfig() {
     const defaultToken = process.env[tokenEnvName] || undefined;
     const global = loadGlobalConfig();
     const perProject = loadPerProjectConfig();
-    // Option B: if no default token, validate that all projects have their own token_env
+    // Option B: if no default token, validate that all projects have their own token_env or bot reference
     if (!defaultToken) {
         const projectEntries = Object.entries(global.projects);
         if (projectEntries.length === 0) {
             throw new Error(`${tokenEnvName} environment variable is required (no projects with token_env configured)`);
         }
         const missing = projectEntries
-            .filter(([, p]) => !p.token_env || !process.env[p.token_env])
+            .filter(([, p]) => {
+            // Project has a bot reference — check if the bot's token_env is set
+            if (p.bot && global.bots?.[p.bot]) {
+                const bot = global.bots[p.bot];
+                return !process.env[bot.token_env];
+            }
+            // Fallback to direct token_env check
+            return !p.token_env || !process.env[p.token_env];
+        })
             .map(([name]) => name);
         if (missing.length > 0) {
             throw new Error(`${tokenEnvName} is not set, and these projects lack a valid token_env: ${missing.join(", ")}`);

package/dist/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"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"}

package/dist/config/profiles.d.ts

@@ -3,12 +3,19 @@ export interface ResolvedProject {
     name: string;
     guildId: string;
     channels: Record<string, string>;
+    channelBots: Record<string, string>;
     defaultChannel?: string;
     notificationRouting?: Record<string, string>;
+    bot?: string;
+    toolProfile?: string;
+    toolProfileAdd?: string[];
+    toolProfileRemove?: string[];
 }
 /**
  * Resolves a project from global + per-project config.
  * Per-project notification_routing overrides global.
+ * Normalizes ChannelConfigSchema union values — extracts plain IDs into `channels`
+ * and collects bot overrides into `channelBots`.
  */
 export declare function resolveProject(projectName: string, globalConfig: GlobalConfig, perProjectConfig?: PerProjectConfig): ResolvedProject | undefined;
 /**

package/dist/config/profiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/config/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAElE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,EAC1B,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,eAAe,GAAG,SAAS,CAiB7B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,YAAY,EAC1B,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,MAAM,GAAG,SAAS,CAEpB"}
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/config/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAElE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AASD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,EAC1B,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,eAAe,GAAG,SAAS,CAiC7B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,YAAY,EAC1B,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,MAAM,GAAG,SAAS,CAEpB"}

package/dist/config/profiles.js

@@ -1,6 +1,14 @@
+/**
+ * Normalizes a channel config value (string or object) to a plain channel ID.
+ */
+function normalizeChannelId(value) {
+    return typeof value === "string" ? value : value.id;
+}
 /**
  * Resolves a project from global + per-project config.
  * Per-project notification_routing overrides global.
+ * Normalizes ChannelConfigSchema union values — extracts plain IDs into `channels`
+ * and collects bot overrides into `channelBots`.
  */
 export function resolveProject(projectName, globalConfig, perProjectConfig) {
     const project = globalConfig.projects[projectName];
@@ -11,12 +19,26 @@ export function resolveProject(projectName, globalConfig, perProjectConfig) {
         ...globalConfig.notification_routing,
         ...perProjectConfig?.notification_routing,
     };
+    // Normalize channels: extract plain IDs and collect bot overrides
+    const channels = {};
+    const channelBots = {};
+    for (const [alias, value] of Object.entries(project.channels)) {
+        channels[alias] = normalizeChannelId(value);
+        if (typeof value === "object" && value.bot) {
+            channelBots[alias] = value.bot;
+        }
+    }
     return {
         name: projectName,
         guildId: project.guild_id,
-        channels: project.channels,
+        channels,
+        channelBots,
         defaultChannel: project.default_channel,
         notificationRouting,
+        bot: project.bot,
+        toolProfile: project.tool_profile,
+        toolProfileAdd: project.profile_add,
+        toolProfileRemove: project.profile_remove,
     };
 }
 /**

package/dist/config/profiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/config/profiles.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,WAAmB,EACnB,YAA0B,EAC1B,gBAAmC;IAEnC,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACnD,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAE/B,2DAA2D;IAC3D,MAAM,mBAAmB,GAAG;QAC1B,GAAG,YAAY,CAAC,oBAAoB;QACpC,GAAG,gBAAgB,EAAE,oBAAoB;KAC1C,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO,CAAC,QAAQ;QACzB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,cAAc,EAAE,OAAO,CAAC,eAAe;QACvC,mBAAmB;KACpB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,YAA0B,EAC1B,gBAAmC;IAEnC,OAAO,gBAAgB,EAAE,OAAO,IAAI,YAAY,CAAC,eAAe,CAAC;AACnE,CAAC"}
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/config/profiles.ts"],"names":[],"mappings":"AAeA;;GAEG;AACH,SAAS,kBAAkB,CAAC,KAA4C;IACtE,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,WAAmB,EACnB,YAA0B,EAC1B,gBAAmC;IAEnC,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACnD,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAE/B,2DAA2D;IAC3D,MAAM,mBAAmB,GAAG;QAC1B,GAAG,YAAY,CAAC,oBAAoB;QACpC,GAAG,gBAAgB,EAAE,oBAAoB;KAC1C,CAAC;IAEF,kEAAkE;IAClE,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,MAAM,WAAW,GAA2B,EAAE,CAAC;IAE/C,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9D,QAAQ,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;YAC3C,WAAW,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO,CAAC,QAAQ;QACzB,QAAQ;QACR,WAAW;QACX,cAAc,EAAE,OAAO,CAAC,eAAe;QACvC,mBAAmB;QACnB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,WAAW,EAAE,OAAO,CAAC,YAAY;QACjC,cAAc,EAAE,OAAO,CAAC,WAAW;QACnC,iBAAiB,EAAE,OAAO,CAAC,cAAc;KAC1C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,YAA0B,EAC1B,gBAAmC;IAEnC,OAAO,gBAAgB,EAAE,OAAO,IAAI,YAAY,CAAC,eAAe,CAAC;AACnE,CAAC"}