clementine-agent 1.0.0

package/dist/channels/discord-agent-bot.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Clementine TypeScript — Discord agent bot client.
+ *
+ * A discord.js Client wrapper for a single agent.
+ * Handles: DMs + guild channel messages → gateway → stream response.
+ * Slash commands: /plan, /deep, /quick, /opus, /model, /clear, /help.
+ *
+ * Channel discovery (in priority order):
+ *   1. Explicit `discordChannelId` from agent config
+ *   2. Auto-discover by matching `channelName` in the guild
+ *   3. Falls back to listening in ALL text channels the bot can see
+ *
+ * DMs are always enabled for the owner.
+ */
+import { EmbedBuilder } from 'discord.js';
+import type { AgentProfile } from '../types.js';
+import type { Gateway } from '../gateway/router.js';
+import type { CronScheduler } from '../gateway/heartbeat.js';
+export interface AgentBotConfig {
+    slug: string;
+    token: string;
+    ownerId: string;
+    profile: AgentProfile;
+    /** Explicit channel IDs to listen in. If empty, auto-discovered on connect. */
+    channelIds?: string[];
+    /** CronScheduler for building agent-scoped status embeds. */
+    cronScheduler?: CronScheduler;
+    /** Discord user IDs allowed to interact (in addition to owner). Empty = owner only. */
+    allowedUsers?: string[];
+}
+export type AgentBotStatus = 'offline' | 'connecting' | 'online' | 'error';
+export declare class AgentBotClient {
+    private client;
+    private config;
+    private gateway;
+    private status;
+    private errorMessage?;
+    /** Resolved channel IDs (set on ready, after auto-discovery). */
+    private resolvedChannelIds;
+    /** Pinned status embed message (edited in-place on state changes). */
+    private statusEmbedMessage;
+    private statusEmbedDebounce;
+    /** Check if a user is authorized to interact with this agent bot. */
+    private isAuthorized;
+    /** Check if a user is the owner (not just an allowed member). */
+    private isOwner;
+    /** Return the session key prefix for channel sessions based on user role. */
+    private channelPrefix;
+    /** Return the session key prefix for DM sessions based on user role. */
+    private dmPrefix;
+    constructor(config: AgentBotConfig, gateway: Gateway);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getStatus(): {
+        status: AgentBotStatus;
+        botTag?: string;
+        avatarUrl?: string;
+        error?: string;
+    };
+    getChannelIds(): string[];
+    /**
+     * Discover which channels this bot should listen in.
+     *
+     * Priority:
+     * 1. Explicit channelIds from config (e.g. discordChannelId in agent.md)
+     * 2. Match by channelName in any guild the bot is in
+     * 3. All text channels the bot can see (fallback for simple setups)
+     */
+    private discoverChannels;
+    /**
+     * Send a notification to the owner's DMs on behalf of this agent bot.
+     * Used by BotManager.sendAsAgent() for cron result routing.
+     */
+    sendNotification(text: string, embed?: EmbedBuilder): Promise<void>;
+    /** Send a startup status embed to the owner's DMs. */
+    private sendStartupStatus;
+    private buildAgentStatusEmbed;
+    private sendOrUpdateStatusEmbed;
+    /**
+     * Receive an inter-agent team message. Posts an embed showing the incoming
+     * message, then triggers the agent to process and respond in-channel.
+     */
+    /** Track recent team message content hashes to prevent duplicate embeds. */
+    private recentTeamMessageHashes;
+    receiveTeamMessage(fromName: string, fromSlug: string, content: string): Promise<string>;
+    private handleInteraction;
+    /** Check if this bot participates in a shared team chat channel. */
+    isTeamChat(): boolean;
+    /**
+     * Check if this agent is being addressed in a team chat message.
+     * Matches: @mention, agent name, agent slug, or broadcast keywords.
+     */
+    private isAddressedInTeamChat;
+    /**
+     * Collect recent messages from other bots in the same channel for context.
+     * Returns a formatted string of the last N messages from other agents.
+     */
+    private gatherTeamChatContext;
+    private handleMessage;
+}
+//# sourceMappingURL=discord-agent-bot.d.ts.map