@nookplot/runtime 0.5.85 → 0.5.87

package/dist/chat/chatEngine.js

@@ -0,0 +1,363 @@
+/**
+ * ChatEngine — Central conversational brain for multi-terminal agents.
+ *
+ * Loads the agent's soul document, builds personality-driven system prompts,
+ * recalls memory context, runs an agentic tool-use loop, and stores
+ * conversation history. All terminals (stdin, Telegram, Discord, OpenClaw)
+ * call `engine.chat(message, context)` and get back a response.
+ *
+ * @module chat/chatEngine
+ */
+import { readFile } from "node:fs/promises";
+import { ACTION_CATALOG, formatActionsForPrompt, getCategoryListing, getToolsInCategory, } from "../actionCatalog.js";
+import { UNTRUSTED_CONTENT_INSTRUCTION } from "../contentSafety.js";
+// ── Chat Actions (subset of CORE_ACTIONS suitable for conversations) ──
+const CHAT_ACTIONS = [
+    // Discovery & knowledge
+    "search_knowledge", "recall_memory", "store_memory", "read_feed",
+    "find_agents", "discover", "leaderboard",
+    // Communication
+    "send_dm", "send_channel_message",
+    // Identity
+    "my_profile", "check_balance", "check_reputation",
+    // Content
+    "publish_insight", "post_content", "comment_on_content",
+    // Social
+    "follow", "vote",
+    // Building
+    "create_project", "commit_files", "list_project_files", "read_project_file",
+    // Coordination
+    "available_subtasks", "claim_subtask",
+    // Meta
+    "browse_tools",
+];
+// ── ChatEngine ───────────────────────────────────────────────
+export class ChatEngine {
+    runtime;
+    options;
+    soul = null;
+    conversationHistory = [];
+    loadedCategories = new Set();
+    constructor(runtime, options = {}) {
+        this.runtime = runtime;
+        this.options = {
+            generateResponse: options.generateResponse,
+            model: options.model ?? "claude-sonnet-4-20250514",
+            provider: options.provider ?? "nookplot",
+            temperature: options.temperature ?? 0.7,
+            maxTokens: options.maxTokens ?? 1024,
+            soulPath: options.soulPath ?? "./soul.json",
+            enableMemory: options.enableMemory ?? true,
+            enableTools: options.enableTools ?? true,
+            maxToolCalls: options.maxToolCalls ?? 5,
+            verbose: options.verbose ?? false,
+        };
+    }
+    /** Agent display name (from soul or fallback). */
+    get agentName() {
+        return this.soul?.name ?? "Agent";
+    }
+    // ── Soul Loading ─────────────────────────────────────────
+    /**
+     * Load soul document from a local JSON file.
+     * Extracts identity, personality, and purpose for the system prompt.
+     */
+    async loadSoul(soulPath) {
+        const path = soulPath ?? this.options.soulPath;
+        try {
+            const raw = await readFile(path, "utf-8");
+            const doc = JSON.parse(raw);
+            this.soul = {
+                name: doc.identity?.name ?? "Agent",
+                tagline: doc.identity?.tagline,
+                description: doc.identity?.description,
+                traits: doc.personality?.traits,
+                communicationStyle: doc.personality?.communication?.style,
+                communicationTone: doc.personality?.communication?.tone,
+                verbosity: doc.personality?.communication?.verbosity,
+                quirks: doc.personality?.quirks,
+                mission: doc.purpose?.mission ?? "Be helpful and conversational.",
+                domains: doc.purpose?.domains,
+                goals: doc.purpose?.goals,
+                boundaries: doc.autonomy?.boundaries,
+            };
+            if (this.options.verbose) {
+                console.log(`[chat] Loaded soul: ${this.soul.name} — "${this.soul.tagline ?? this.soul.mission}"`);
+            }
+        }
+        catch {
+            if (this.options.verbose) {
+                console.log(`[chat] No soul.json found at ${path} — using defaults`);
+            }
+            this.soul = {
+                name: "Agent",
+                mission: "Be helpful and conversational.",
+            };
+        }
+    }
+    // ── Core Chat Method ─────────────────────────────────────
+    /**
+     * Process a user message and return the agent's response.
+     *
+     * Runs an agentic loop: build prompt → call LLM → if tool call → execute → feed back → repeat.
+     * Max iterations controlled by `maxToolCalls`.
+     */
+    async chat(message, context) {
+        // Ensure soul is loaded
+        if (!this.soul) {
+            await this.loadSoul();
+        }
+        // 1. Recall memory context
+        let memoryContext = "";
+        if (this.options.enableMemory) {
+            try {
+                const result = await this.runtime.memory.recall(message, { limit: 5 });
+                const memories = result;
+                if (Array.isArray(memories) && memories.length > 0) {
+                    memoryContext = memories.map((m) => m.content).join("\n---\n");
+                }
+            }
+            catch {
+                // Memory recall failure shouldn't block the response
+            }
+        }
+        // 2. Build system prompt
+        const systemPrompt = this.buildSystemPrompt(memoryContext, context);
+        // 3. Add user message to conversation history
+        this.conversationHistory.push({ role: "user", content: message });
+        // Keep conversation history manageable (last 20 messages)
+        if (this.conversationHistory.length > 20) {
+            this.conversationHistory = this.conversationHistory.slice(-20);
+        }
+        // 4. Agentic loop
+        let finalResponse = "";
+        let toolCallCount = 0;
+        while (toolCallCount <= this.options.maxToolCalls) {
+            // Build messages for LLM
+            const messages = [
+                { role: "system", content: systemPrompt },
+                ...this.conversationHistory,
+            ];
+            // Call LLM
+            const response = await this.callLLM(messages);
+            // Check if response contains a tool call
+            const actionMatch = response.match(/ACTION:\s*(\S+)/i);
+            if (actionMatch && this.options.enableTools && toolCallCount < this.options.maxToolCalls) {
+                const actionType = actionMatch[1].toLowerCase();
+                // Parse params
+                let payload = {};
+                const paramsMatch = response.match(/PARAMS:\s*(\{[\s\S]*\})/i);
+                if (paramsMatch) {
+                    try {
+                        payload = JSON.parse(paramsMatch[1]);
+                    }
+                    catch {
+                        if (this.options.verbose)
+                            console.log("[chat] Failed to parse PARAMS JSON");
+                    }
+                }
+                if (this.options.verbose) {
+                    console.log(`[chat] Tool call #${toolCallCount + 1}: ${actionType}`);
+                }
+                // Execute tool
+                const toolResult = await this.executeTool(actionType, payload);
+                // Add assistant response + tool result to history
+                this.conversationHistory.push({ role: "assistant", content: response });
+                this.conversationHistory.push({
+                    role: "user",
+                    content: `[Tool Result for ${actionType}]:\n${toolResult}`,
+                });
+                toolCallCount++;
+                continue;
+            }
+            // No tool call — this is the final response
+            // Strip any ACTION/PARAMS artifacts if present but tools disabled
+            finalResponse = response.replace(/ACTION:\s*\S+\s*\n?/i, "").replace(/PARAMS:\s*\{[\s\S]*\}\s*/i, "").trim();
+            if (!finalResponse)
+                finalResponse = response.trim();
+            break;
+        }
+        // 5. Add assistant response to conversation history
+        this.conversationHistory.push({ role: "assistant", content: finalResponse });
+        // 6. Store conversation in memory (fire-and-forget)
+        if (this.options.enableMemory) {
+            const platform = context?.platform ?? "unknown";
+            const sender = context?.senderName ?? context?.senderId ?? "user";
+            this.runtime.memory
+                .storeMemory("episodic", `[${platform}] ${sender}: ${message}\n${this.agentName}: ${finalResponse}`, {
+                tags: ["conversation", platform],
+            })
+                .catch(() => { });
+        }
+        return finalResponse;
+    }
+    /** Clear conversation history (e.g. on platform switch or reset). */
+    clearHistory() {
+        this.conversationHistory = [];
+        this.loadedCategories.clear();
+    }
+    // ── Private Methods ──────────────────────────────────────
+    /**
+     * Build the system prompt from soul document + memory context + tool list.
+     */
+    buildSystemPrompt(memoryContext, context) {
+        const parts = [];
+        // Soul identity
+        if (this.soul) {
+            parts.push(`You are ${this.soul.name}.`);
+            if (this.soul.tagline)
+                parts.push(this.soul.tagline);
+            if (this.soul.description)
+                parts.push(this.soul.description);
+            parts.push("");
+            // Mission
+            parts.push(`Mission: ${this.soul.mission}`);
+            if (this.soul.domains?.length) {
+                parts.push(`Domains: ${this.soul.domains.join(", ")}`);
+            }
+            if (this.soul.goals?.length) {
+                parts.push(`Goals: ${this.soul.goals.join("; ")}`);
+            }
+            parts.push("");
+            // Personality
+            if (this.soul.traits?.length) {
+                parts.push(`Personality traits: ${this.soul.traits.join(", ")}`);
+            }
+            if (this.soul.communicationStyle) {
+                parts.push(`Communication style: ${this.soul.communicationStyle}`);
+            }
+            if (this.soul.communicationTone) {
+                parts.push(`Tone: ${this.soul.communicationTone}`);
+            }
+            if (this.soul.verbosity) {
+                parts.push(`Verbosity: ${this.soul.verbosity}`);
+            }
+            if (this.soul.quirks?.length) {
+                parts.push(`Quirks: ${this.soul.quirks.join("; ")}`);
+            }
+            parts.push("");
+            // Boundaries
+            if (this.soul.boundaries?.length) {
+                parts.push(`Boundaries: ${this.soul.boundaries.join("; ")}`);
+            }
+        }
+        // Platform context
+        if (context?.platform) {
+            parts.push(`You are chatting on ${context.platform}.`);
+        }
+        // Memory context
+        if (memoryContext) {
+            parts.push("");
+            parts.push("Relevant memories from previous conversations:");
+            parts.push(memoryContext);
+        }
+        // Tool instructions
+        if (this.options.enableTools) {
+            parts.push("");
+            parts.push(UNTRUSTED_CONTENT_INSTRUCTION);
+            parts.push("");
+            parts.push("You have access to Nookplot tools. To use one, respond ONLY with:");
+            parts.push("ACTION: <tool_name>");
+            parts.push("PARAMS: <json object>");
+            parts.push("");
+            parts.push("Do NOT mix tool calls with regular text. If you need to use a tool, respond with ONLY the ACTION/PARAMS block. After seeing the tool result, you can then respond with text.");
+            parts.push("");
+            // Build available actions list
+            const availableActions = this.getAvailableActions();
+            parts.push("Available tools:");
+            parts.push(formatActionsForPrompt(availableActions));
+            parts.push("");
+            parts.push("If you don't need a tool, just respond normally with text.");
+        }
+        return parts.join("\n");
+    }
+    /**
+     * Get the current set of available actions (core + dynamically loaded categories).
+     */
+    getAvailableActions() {
+        const actions = new Set(CHAT_ACTIONS);
+        // Add dynamically loaded category tools
+        for (const category of this.loadedCategories) {
+            const tools = getToolsInCategory(category);
+            for (const toolName of tools) {
+                actions.add(toolName);
+            }
+        }
+        return Array.from(actions);
+    }
+    /**
+     * Call the LLM — via user-provided function or runtime.economy.inference().
+     */
+    async callLLM(messages) {
+        if (this.options.generateResponse) {
+            return this.options.generateResponse(messages);
+        }
+        const result = await this.runtime.economy.inference(messages, {
+            model: this.options.model,
+            provider: this.options.provider,
+            temperature: this.options.temperature,
+            maxTokens: this.options.maxTokens,
+        });
+        return result.content;
+    }
+    /**
+     * Execute a tool via the gateway's unified dispatch pipeline.
+     *
+     * Same flow as AutonomousAgent.handleActionRequest():
+     * - browse_tools → local category expansion
+     * - POST /v1/actions/execute → completed | sign_required | error
+     */
+    async executeTool(actionType, payload) {
+        try {
+            // browse_tools is handled locally
+            if (actionType === "browse_tools") {
+                const category = payload.category;
+                if (!category) {
+                    const listing = getCategoryListing();
+                    return `Available tool categories:\n${listing.map((c) => `- ${c.name} (${c.count} tools)`).join("\n")}\n\nUse browse_tools with a category to load those tools.`;
+                }
+                this.loadedCategories.add(category);
+                const tools = getToolsInCategory(category);
+                const toolDescriptions = tools.map((toolName) => {
+                    const info = ACTION_CATALOG[toolName];
+                    return info ? `- ${toolName}: ${info.description}` : `- ${toolName}`;
+                });
+                return `Loaded ${tools.length} tools from "${category}":\n${toolDescriptions.join("\n")}`;
+            }
+            // Unified dispatch via gateway
+            const toolName = `nookplot_${actionType}`;
+            const dispatchResult = await this.runtime.connection.request("POST", "/v1/actions/execute", { toolName, payload });
+            switch (dispatchResult.status) {
+                case "completed": {
+                    const result = dispatchResult.result ?? {};
+                    return typeof result === "string" ? result : JSON.stringify(result, null, 2);
+                }
+                case "sign_required": {
+                    // On-chain action: sign locally + relay
+                    if (!dispatchResult.forwardRequest || !dispatchResult.domain || !dispatchResult.types) {
+                        return `Error: sign_required but missing signing data for ${actionType}`;
+                    }
+                    const privateKey = this.runtime.connection.privateKey;
+                    if (!privateKey) {
+                        return `Error: Cannot sign on-chain transaction — no private key configured.`;
+                    }
+                    const { signForwardRequest } = await import("../signing.js");
+                    const signature = await signForwardRequest(privateKey, dispatchResult.domain, dispatchResult.types, dispatchResult.forwardRequest);
+                    const relayResult = await this.runtime.connection.request("POST", "/v1/relay", { ...dispatchResult.forwardRequest, signature });
+                    return `On-chain transaction submitted. TX hash: ${relayResult.txHash}`;
+                }
+                default:
+                    return dispatchResult.error
+                        ? `Error: ${dispatchResult.error}`
+                        : `Unexpected status: ${dispatchResult.status}`;
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (this.options.verbose)
+                console.error(`[chat] Tool execution failed: ${msg}`);
+            return `Error executing ${actionType}: ${msg}`;
+        }
+    }
+}
+//# sourceMappingURL=chatEngine.js.map

package/dist/chat/chatEngine.js.map

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

package/dist/chat/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Multi-Terminal Chat System — barrel export.
+ *
+ * Provides ChatEngine (central brain) and pluggable Terminal adapters
+ * for stdin, Telegram, Discord, and OpenClaw.
+ *
+ * @example
+ * ```ts
+ * import { ChatEngine, StdinTerminal, TelegramTerminal } from "@nookplot/runtime/chat";
+ *
+ * const engine = new ChatEngine(runtime, { soulPath: "./soul.json" });
+ * await engine.loadSoul();
+ *
+ * const terminals = [new StdinTerminal(engine)];
+ * if (process.env.TELEGRAM_BOT_TOKEN) {
+ *   terminals.push(new TelegramTerminal(engine, process.env.TELEGRAM_BOT_TOKEN));
+ * }
+ * await Promise.all(terminals.map(t => t.start()));
+ * ```
+ *
+ * @module chat
+ */
+export { ChatEngine } from "./chatEngine.js";
+export type { ChatEngineOptions, ChatContext } from "./chatEngine.js";
+export { Terminal } from "./terminal.js";
+export { StdinTerminal } from "./terminals/stdinTerminal.js";
+export { TelegramTerminal } from "./terminals/telegramTerminal.js";
+export { DiscordTerminal } from "./terminals/discordTerminal.js";
+export { OpenClawTerminal } from "./terminals/openclawTerminal.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/chat/index.js

@@ -0,0 +1,29 @@
+/**
+ * Multi-Terminal Chat System — barrel export.
+ *
+ * Provides ChatEngine (central brain) and pluggable Terminal adapters
+ * for stdin, Telegram, Discord, and OpenClaw.
+ *
+ * @example
+ * ```ts
+ * import { ChatEngine, StdinTerminal, TelegramTerminal } from "@nookplot/runtime/chat";
+ *
+ * const engine = new ChatEngine(runtime, { soulPath: "./soul.json" });
+ * await engine.loadSoul();
+ *
+ * const terminals = [new StdinTerminal(engine)];
+ * if (process.env.TELEGRAM_BOT_TOKEN) {
+ *   terminals.push(new TelegramTerminal(engine, process.env.TELEGRAM_BOT_TOKEN));
+ * }
+ * await Promise.all(terminals.map(t => t.start()));
+ * ```
+ *
+ * @module chat
+ */
+export { ChatEngine } from "./chatEngine.js";
+export { Terminal } from "./terminal.js";
+export { StdinTerminal } from "./terminals/stdinTerminal.js";
+export { TelegramTerminal } from "./terminals/telegramTerminal.js";
+export { DiscordTerminal } from "./terminals/discordTerminal.js";
+export { OpenClawTerminal } from "./terminals/openclawTerminal.js";
+//# sourceMappingURL=index.js.map

package/dist/chat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/chat/terminal.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Terminal — Abstract base class for I/O adapters.
+ *
+ * Each terminal handles platform-specific message receive/send,
+ * but delegates all thinking to the shared ChatEngine.
+ *
+ * @module chat/terminal
+ */
+import type { ChatEngine } from "./chatEngine.js";
+export declare abstract class Terminal {
+    protected engine: ChatEngine;
+    protected name: string;
+    constructor(engine: ChatEngine, name: string);
+    /** Start listening for messages. */
+    abstract start(): Promise<void>;
+    /** Stop the terminal gracefully. */
+    abstract stop(): Promise<void>;
+}
+//# sourceMappingURL=terminal.d.ts.map

package/dist/chat/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/chat/terminal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,8BAAsB,QAAQ;IAE1B,SAAS,CAAC,MAAM,EAAE,UAAU;IAC5B,SAAS,CAAC,IAAI,EAAE,MAAM;gBADZ,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM;IAGxB,oCAAoC;IACpC,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAE/B,oCAAoC;IACpC,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAC/B"}

package/dist/chat/terminal.js

@@ -0,0 +1,17 @@
+/**
+ * Terminal — Abstract base class for I/O adapters.
+ *
+ * Each terminal handles platform-specific message receive/send,
+ * but delegates all thinking to the shared ChatEngine.
+ *
+ * @module chat/terminal
+ */
+export class Terminal {
+    engine;
+    name;
+    constructor(engine, name) {
+        this.engine = engine;
+        this.name = name;
+    }
+}
+//# sourceMappingURL=terminal.js.map

package/dist/chat/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../../src/chat/terminal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,OAAgB,QAAQ;IAEhB;IACA;IAFZ,YACY,MAAkB,EAClB,IAAY;QADZ,WAAM,GAAN,MAAM,CAAY;QAClB,SAAI,GAAJ,IAAI,CAAQ;IACrB,CAAC;CAOL"}

package/dist/chat/terminals/discordTerminal.d.ts

@@ -0,0 +1,22 @@
+/**
+ * DiscordTerminal — Discord bot terminal using discord.js.
+ *
+ * Connects via WebSocket gateway, responds to mentions and DMs.
+ * discord.js is an optional peer dependency — only imported at runtime
+ * if `DISCORD_BOT_TOKEN` is set. No compile-time dependency on discord.js.
+ *
+ * User setup: Add `DISCORD_BOT_TOKEN=xxx` to `.env`.
+ *
+ * @module chat/terminals/discordTerminal
+ */
+import { Terminal } from "../terminal.js";
+import type { ChatEngine } from "../chatEngine.js";
+export declare class DiscordTerminal extends Terminal {
+    private botToken;
+    private client;
+    constructor(engine: ChatEngine, botToken: string);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private splitMessage;
+}
+//# sourceMappingURL=discordTerminal.d.ts.map

package/dist/chat/terminals/discordTerminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discordTerminal.d.ts","sourceRoot":"","sources":["../../../src/chat/terminals/discordTerminal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInD,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAa;gBAEf,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM;IAK1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4FtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,OAAO,CAAC,YAAY;CAgBrB"}

package/dist/chat/terminals/discordTerminal.js

@@ -0,0 +1,132 @@
+/**
+ * DiscordTerminal — Discord bot terminal using discord.js.
+ *
+ * Connects via WebSocket gateway, responds to mentions and DMs.
+ * discord.js is an optional peer dependency — only imported at runtime
+ * if `DISCORD_BOT_TOKEN` is set. No compile-time dependency on discord.js.
+ *
+ * User setup: Add `DISCORD_BOT_TOKEN=xxx` to `.env`.
+ *
+ * @module chat/terminals/discordTerminal
+ */
+import { Terminal } from "../terminal.js";
+/* eslint-disable @typescript-eslint/no-explicit-any */
+export class DiscordTerminal extends Terminal {
+    botToken;
+    client = null;
+    constructor(engine, botToken) {
+        super(engine, "discord");
+        this.botToken = botToken;
+    }
+    async start() {
+        // Dynamic import — discord.js is optional, no compile-time dependency
+        // Use a variable to prevent TypeScript from resolving the module at compile time
+        let discordJs;
+        try {
+            const moduleName = "discord.js";
+            discordJs = await import(/* webpackIgnore: true */ moduleName);
+        }
+        catch {
+            console.error("[discord] discord.js not installed. Run: npm install discord.js");
+            return;
+        }
+        const { Client, GatewayIntentBits, Partials } = discordJs;
+        const client = new Client({
+            intents: [
+                GatewayIntentBits.Guilds,
+                GatewayIntentBits.GuildMessages,
+                GatewayIntentBits.MessageContent,
+                GatewayIntentBits.DirectMessages,
+            ],
+            partials: [Partials.Channel], // Required for DMs
+        });
+        client.on("ready", () => {
+            console.log(`[discord] Connected as ${client.user?.tag ?? "unknown"}`);
+        });
+        client.on("messageCreate", async (message) => {
+            // Ignore bots (including self)
+            if (message.author.bot)
+                return;
+            // Only respond to DMs or when mentioned
+            const isDM = !message.guild;
+            const isMentioned = client.user && message.mentions.has(client.user);
+            if (!isDM && !isMentioned)
+                return;
+            // Strip the bot mention from the message text
+            let content = message.content;
+            if (isMentioned && client.user) {
+                content = content.replace(new RegExp(`<@!?${client.user.id}>`, "g"), "").trim();
+            }
+            if (!content)
+                return;
+            try {
+                // Show typing indicator
+                await message.channel.sendTyping();
+                const response = await this.engine.chat(content, {
+                    platform: "discord",
+                    senderId: message.author.id,
+                    senderName: message.author.displayName ?? message.author.username,
+                    channelId: message.channel.id,
+                });
+                // Discord has a 2000 char limit — split if needed
+                if (response.length <= 2000) {
+                    await message.reply(response);
+                }
+                else {
+                    // Split into chunks
+                    const chunks = this.splitMessage(response, 2000);
+                    for (let i = 0; i < chunks.length; i++) {
+                        if (i === 0) {
+                            await message.reply(chunks[i]);
+                        }
+                        else {
+                            await message.channel.send(chunks[i]);
+                        }
+                    }
+                }
+            }
+            catch (err) {
+                console.error("[discord] Message handling failed:", err instanceof Error ? err.message : err);
+                try {
+                    await message.reply("Sorry, I encountered an error processing your message.");
+                }
+                catch {
+                    // Best effort
+                }
+            }
+        });
+        try {
+            await client.login(this.botToken);
+            this.client = client;
+        }
+        catch (err) {
+            console.error("[discord] Login failed:", err instanceof Error ? err.message : err);
+            console.error("[discord] Check DISCORD_BOT_TOKEN in .env");
+        }
+    }
+    async stop() {
+        if (this.client) {
+            this.client.destroy();
+            this.client = null;
+        }
+    }
+    // ── Private ────────────────────────────────────────────────
+    splitMessage(text, maxLength) {
+        const chunks = [];
+        let remaining = text;
+        while (remaining.length > 0) {
+            if (remaining.length <= maxLength) {
+                chunks.push(remaining);
+                break;
+            }
+            // Try to split at a newline
+            let splitIndex = remaining.lastIndexOf("\n", maxLength);
+            if (splitIndex <= 0)
+                splitIndex = maxLength;
+            chunks.push(remaining.slice(0, splitIndex));
+            remaining = remaining.slice(splitIndex).trimStart();
+        }
+        return chunks;
+    }
+}
+//# sourceMappingURL=discordTerminal.js.map