@songsid/agend 0.0.1

package/dist/channel/mcp-server.js

@@ -0,0 +1,288 @@
+#!/usr/bin/env node
+/**
+ * MCP Tool Server for agend.
+ *
+ * Runs as a SEPARATE process (CLI's child via --mcp-config).
+ * Communicates with the daemon through a Unix socket IPC connection.
+ * Provides standard MCP tools (reply, send_to_instance, etc.) — no
+ * CLI-specific channel protocol. Works with any MCP-compatible CLI.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ListToolsRequestSchema, CallToolRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { basename, dirname, join } from "node:path";
+import { writeFileSync, readFileSync, unlinkSync } from "node:fs";
+import { IpcClient } from "./ipc-bridge.js";
+import { TOOLS } from "./mcp-tools.js";
+import { buildFleetInstructions } from "../instructions.js";
+// ---------------------------------------------------------------------------
+// Configuration
+// ---------------------------------------------------------------------------
+const SOCKET_PATH = process.env.AGEND_SOCKET_PATH ?? "";
+const IPC_TIMEOUT_MS = 30_000;
+const SLOW_IPC_TIMEOUT_MS = 60_000;
+const SLOW_TOOLS = new Set(["start_instance", "create_instance", "delete_instance", "replace_instance"]);
+// ---------------------------------------------------------------------------
+// Safety nets
+// ---------------------------------------------------------------------------
+// Parent death detection: primary mechanism is process.ppid polling (see main).
+// On macOS, libuv/kqueue does not reliably emit stdin 'end' when the parent
+// dies — the broken pipe causes a CPU spin instead. ppid polling is the only
+// cross-platform reliable method. stdin listeners are kept as a fast path
+// for Linux (where epoll may correctly emit EOF).
+const PARENT_PID = process.ppid;
+function isOrphaned() {
+    return process.ppid === 1 || process.ppid !== PARENT_PID;
+}
+process.on("unhandledRejection", (err) => {
+    process.stderr.write(`agend: unhandled rejection: ${err}\n`);
+});
+process.on("uncaughtException", (err) => {
+    process.stderr.write(`agend: uncaught exception: ${err}\n`);
+});
+// ---------------------------------------------------------------------------
+// IPC client with request-response
+// ---------------------------------------------------------------------------
+let ipc = null;
+let ipcConnected = false;
+let requestCounter = 0;
+let reconnecting = false;
+let reconnectAttempts = 0;
+const MAX_RECONNECT_ATTEMPTS = 20; // ~60s of retries
+const pendingRequests = new Map();
+function setupIpcListeners(client) {
+    client.on("message", (msg) => {
+        // Graceful shutdown: daemon tells us it's shutting down — skip reconnect
+        if (msg.type === "shutdown") {
+            process.stderr.write("agend: daemon shutting down — exiting gracefully\n");
+            process.exit(0);
+        }
+        if (typeof msg.requestId === "number" && pendingRequests.has(msg.requestId)) {
+            const pending = pendingRequests.get(msg.requestId);
+            pendingRequests.delete(msg.requestId);
+            clearTimeout(pending.timer);
+            if (msg.error) {
+                pending.reject(new Error(String(msg.error)));
+            }
+            else {
+                pending.resolve(msg.result);
+            }
+        }
+    });
+    client.on("disconnect", () => {
+        ipcConnected = false;
+        process.stderr.write("agend: IPC disconnected — will reconnect\n");
+        // Reject all pending requests
+        for (const [id, pending] of pendingRequests) {
+            clearTimeout(pending.timer);
+            pending.reject(new Error("IPC disconnected"));
+            pendingRequests.delete(id);
+        }
+        scheduleReconnect();
+    });
+}
+async function connectIpc() {
+    try {
+        const client = new IpcClient(SOCKET_PATH);
+        await client.connect();
+        ipc = client;
+        ipcConnected = true;
+        reconnecting = false;
+        reconnectAttempts = 0;
+        setupIpcListeners(client);
+        // AGEND_INSTANCE_NAME: set by daemon via tmux env (internal sessions)
+        // AGEND_SESSION_NAME: set in .mcp.json env (external sessions, optional custom name)
+        // Fallback: unique name from working directory + PID (avoids collision when
+        // multiple Claude Code sessions work on the same project)
+        const sessionName = process.env.AGEND_INSTANCE_NAME
+            ?? process.env.AGEND_SESSION_NAME
+            ?? `external-${basename(process.cwd())}-${process.pid}`;
+        client.send({ type: "mcp_ready", sessionName });
+        process.stderr.write("agend: connected to daemon IPC\n");
+    }
+    catch (err) {
+        process.stderr.write(`agend: failed to connect to daemon IPC: ${err}\n`);
+        ipcConnected = false;
+        scheduleReconnect();
+    }
+}
+function scheduleReconnect() {
+    if (reconnecting)
+        return;
+    if (isOrphaned()) {
+        process.stderr.write("agend: orphaned (parent died) during reconnect — exiting\n");
+        process.exit(0);
+    }
+    reconnectAttempts++;
+    if (reconnectAttempts > MAX_RECONNECT_ATTEMPTS) {
+        process.stderr.write(`agend: max reconnect attempts (${MAX_RECONNECT_ATTEMPTS}) exceeded — exiting\n`);
+        process.exit(1);
+    }
+    reconnecting = true;
+    const delay = 3000;
+    process.stderr.write(`agend: reconnecting in ${delay}ms (attempt ${reconnectAttempts}/${MAX_RECONNECT_ATTEMPTS})...\n`);
+    setTimeout(() => {
+        reconnecting = false;
+        connectIpc();
+    }, delay);
+}
+function ipcRequest(tool, args) {
+    return new Promise((resolve, reject) => {
+        if (!ipcConnected || !ipc) {
+            reject(new Error("Not connected to daemon IPC (retrying connection in background)"));
+            return;
+        }
+        const timeoutMs = SLOW_TOOLS.has(tool) ? SLOW_IPC_TIMEOUT_MS : IPC_TIMEOUT_MS;
+        const requestId = ++requestCounter;
+        const timer = setTimeout(() => {
+            pendingRequests.delete(requestId);
+            reject(new Error(`IPC request timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+        pendingRequests.set(requestId, { resolve, reject, timer });
+        try {
+            ipc.send({ type: "tool_call", tool, args, requestId });
+        }
+        catch (err) {
+            pendingRequests.delete(requestId);
+            clearTimeout(timer);
+            ipcConnected = false;
+            reject(new Error(`IPC send failed: ${err}`));
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// MCP Server
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// MCP instructions — thin wrapper around shared buildFleetInstructions().
+// Phase 1 (dual track): MCP instructions kept as fallback for backends that
+// read the MCP instructions field. Content delegates to the shared module
+// to avoid drift between MCP and additive system prompt paths.
+// ---------------------------------------------------------------------------
+function buildMcpInstructions() {
+    const workflowEnv = process.env.AGEND_WORKFLOW;
+    let workflow;
+    if (workflowEnv === "false")
+        workflow = false;
+    else if (workflowEnv)
+        workflow = workflowEnv;
+    let decisions;
+    if (process.env.AGEND_DECISIONS) {
+        try {
+            decisions = JSON.parse(process.env.AGEND_DECISIONS);
+        }
+        catch { /* skip */ }
+    }
+    return buildFleetInstructions({
+        instanceName: process.env.AGEND_INSTANCE_NAME ?? "unknown",
+        workingDirectory: process.env.AGEND_WORKING_DIR ?? process.cwd(),
+        displayName: process.env.AGEND_DISPLAY_NAME,
+        description: process.env.AGEND_DESCRIPTION,
+        customPrompt: process.env.AGEND_CUSTOM_PROMPT,
+        workflow,
+        decisions,
+    });
+}
+const mcp = new Server({ name: "agend", version: "0.3.0" }, {
+    capabilities: {
+        tools: {},
+    },
+    instructions: buildMcpInstructions(),
+});
+// --- Tool definitions (see mcp-tools.ts) ---
+import { TOOL_SETS } from "./mcp-tools.js";
+export { TOOLS } from "./mcp-tools.js";
+const toolSet = process.env.AGEND_TOOL_SET;
+let activeTools;
+if (!toolSet || toolSet === "full") {
+    activeTools = TOOLS;
+}
+else if (TOOL_SETS[toolSet]) {
+    activeTools = TOOLS.filter(t => TOOL_SETS[toolSet].includes(t.name));
+}
+else {
+    process.stderr.write(`agend: ERROR — unknown AGEND_TOOL_SET "${toolSet}", valid: ${Object.keys(TOOL_SETS).join(", ")}. Using "full".\n`);
+    activeTools = TOOLS;
+}
+mcp.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: activeTools }));
+// --- Tool call handler ---
+mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const args = (req.params.arguments ?? {});
+    try {
+        const result = await ipcRequest(req.params.name, args);
+        const text = typeof result === "string" ? result : JSON.stringify(result ?? "ok");
+        return { content: [{ type: "text", text }] };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+async function main() {
+    if (!SOCKET_PATH) {
+        process.stderr.write("agend: AGEND_SOCKET_PATH environment variable is required\n");
+        process.exit(1);
+    }
+    // Start MCP stdio transport FIRST — must be ready before the CLI sends
+    // the initialize request. IPC connection can happen in parallel.
+    const transport = new StdioServerTransport();
+    await mcp.connect(transport);
+    // Parent death detection.
+    // Primary: ppid polling — works on all platforms, immune to libuv/kqueue bugs.
+    // Secondary: stdin end/close/error — may fire faster on Linux (epoll handles
+    // broken pipes correctly), but fails on macOS (libuv CPU spin, no EOF emit).
+    // mcp.onclose only fires on explicit transport.close(), kept for completeness.
+    mcp.onclose = () => {
+        process.stderr.write("agend: MCP transport closed — exiting\n");
+        process.exit(0);
+    };
+    process.stdin.on("end", () => {
+        process.stderr.write("agend: stdin EOF (parent exited) — exiting\n");
+        process.exit(0);
+    });
+    process.stdin.on("close", () => {
+        process.stderr.write("agend: stdin closed (parent exited) — exiting\n");
+        process.exit(0);
+    });
+    process.stdin.on("error", () => {
+        process.stderr.write("agend: stdin error (parent exited) — exiting\n");
+        process.exit(0);
+    });
+    // Primary orphan detection: poll parent PID every 5 seconds.
+    setInterval(() => {
+        if (isOrphaned()) {
+            process.stderr.write("agend: parent process died (ppid changed) — exiting\n");
+            process.exit(0);
+        }
+    }, 5_000);
+    // Write PID file so daemon can kill orphan MCP servers on crash respawn.
+    // Derived from AGEND_SOCKET_PATH (e.g. ~/.agend/instances/foo/channel.sock).
+    const pidFile = join(dirname(SOCKET_PATH), "channel.mcp.pid");
+    writeFileSync(pidFile, String(process.pid));
+    process.on("exit", () => {
+        try {
+            if (readFileSync(pidFile, "utf-8").trim() === String(process.pid))
+                unlinkSync(pidFile);
+        }
+        catch { /* already cleaned up */ }
+    });
+    // Connect to daemon IPC (will auto-reconnect on disconnect)
+    await connectIpc();
+    // Immediate orphan check — don't let an orphan announce itself to the daemon
+    if (isOrphaned()) {
+        process.stderr.write("agend: orphaned before ready — exiting\n");
+        process.exit(0);
+    }
+    process.stderr.write("agend: MCP server running\n");
+}
+main().catch((err) => {
+    process.stderr.write(`agend: fatal error: ${err}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=mcp-server.js.map

package/dist/channel/mcp-server.js.map

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

package/dist/channel/mcp-tools.d.ts

@@ -0,0 +1,17 @@
+/** Narrow JSON-schema fragment shape that MCP tool listings need. */
+type JsonSchemaObject = {
+    type: "object";
+    properties?: Record<string, unknown>;
+    required?: string[];
+    additionalProperties?: unknown;
+    [k: string]: unknown;
+};
+type ToolDef = {
+    name: string;
+    description: string;
+    inputSchema: JsonSchemaObject;
+};
+export declare const TOOLS: ToolDef[];
+/** Predefined tool profiles to reduce token overhead per instance. */
+export declare const TOOL_SETS: Record<string, string[]>;
+export {};

package/dist/channel/mcp-tools.js

@@ -0,0 +1,110 @@
+/**
+ * MCP tool definitions. Schemas come from src/outbound-schemas.ts so runtime
+ * validation and the JSON Schema surfaced to agents share one source.
+ *
+ * Kept free of runtime side effects — safe to import from tests and tools
+ * without pulling in channel infrastructure.
+ */
+import { z } from "zod";
+import * as schemas from "../outbound-schemas.js";
+/** Strip `$schema`/`$defs` that some MCP clients reject. */
+function toToolInputSchema(schema) {
+    const raw = z.toJSONSchema(schema);
+    const { $schema: _s, $defs: _d, ...rest } = raw;
+    if (rest.type !== "object") {
+        throw new Error("Expected object-typed zod schema for MCP tool input");
+    }
+    return rest;
+}
+/**
+ * Build the tool list. The `[schema, description]` pairs keep the declaration
+ * terse and guarantee every tool has both a description and a schema.
+ */
+const DEFS = [
+    ["reply", schemas.ReplyArgs,
+        "Reply on the channel. Routing is handled automatically — do not pass chat_id or thread_id."],
+    ["react", schemas.ReactArgs,
+        "Add an emoji reaction to a channel message."],
+    ["edit_message", schemas.EditMessageArgs,
+        "Edit a message the bot previously sent. Useful for interim progress updates."],
+    ["download_attachment", schemas.DownloadAttachmentArgs,
+        "Download a file attachment from a channel message. Returns the local file path ready to Read."],
+    ["create_schedule", schemas.CreateScheduleArgs,
+        "Create a cron-based schedule. When triggered, sends a message to the target instance."],
+    ["list_schedules", schemas.ListSchedulesArgs,
+        "List all schedules. Optionally filter by target instance."],
+    ["update_schedule", schemas.UpdateScheduleArgs,
+        "Update an existing schedule. Only include fields you want to change."],
+    ["delete_schedule", schemas.DeleteScheduleArgs,
+        "Delete a schedule by ID."],
+    ["task", schemas.TaskBoardArgs,
+        "Manage fleet task board. Actions: create (new task), list (show tasks), claim (assign to self), done (mark complete), update (change status/priority/assignee)."],
+    ["post_decision", schemas.PostDecisionArgs,
+        "Record a decision. scope='project' (default) is visible to instances sharing this working directory. scope='fleet' is visible to ALL instances regardless of directory — use for workflow rules, review policies, and team conventions."],
+    ["list_decisions", schemas.ListDecisionsArgs,
+        "List active decisions for this project. Returns decisions that were recorded by any instance sharing this working directory."],
+    ["update_decision", schemas.UpdateDecisionArgs,
+        "Update or archive an existing decision."],
+    ["broadcast", schemas.BroadcastArgs,
+        "Send a message to multiple instances at once. Priority: team > targets > tags > all running."],
+    ["send_to_instance", schemas.SendToInstanceArgs,
+        "Send a message to another instance. Use for cross-instance communication."],
+    ["request_information", schemas.RequestInformationArgs,
+        "Ask another instance a question and expect a reply. Wrapper around send_to_instance with request_kind=query and requires_reply=true."],
+    ["delegate_task", schemas.DelegateTaskArgs,
+        "Delegate a task to another instance and expect a result report back. Wrapper around send_to_instance with request_kind=task and requires_reply=true."],
+    ["report_result", schemas.ReportResultArgs,
+        "Report results back to an instance that delegated a task or asked a question. Wrapper around send_to_instance with request_kind=report."],
+    ["create_team", schemas.CreateTeamArgs,
+        "Create a named group of instances for targeted broadcasting. Teams persist across restarts."],
+    ["delete_team", schemas.DeleteTeamArgs,
+        "Dissolve a team. Does not affect the member instances."],
+    ["list_teams", schemas.ListTeamsArgs,
+        "List all teams with their members and running status."],
+    ["update_team", schemas.UpdateTeamArgs,
+        "Add or remove members from an existing team. Duplicates are ignored."],
+    ["describe_instance", schemas.DescribeInstanceArgs,
+        "Get detailed information about a specific instance: description, working directory, status, tags, and recent activity."],
+    ["list_instances", schemas.ListInstancesArgs,
+        "List all currently running instances that you can send messages to."],
+    ["start_instance", schemas.StartInstanceArgs,
+        "Start a stopped instance by name."],
+    ["restart_instance", schemas.RestartInstanceArgs,
+        "Restart a running instance. Reloads fleet config and restarts the instance."],
+    ["create_instance", schemas.CreateInstanceArgs,
+        "Create a new instance bound to a project directory with a channel topic. If directory is omitted, a workspace is auto-created at ~/.agend/workspaces/<instance-name>."],
+    ["delete_instance", schemas.DeleteInstanceArgs,
+        "Delete an instance: stop daemon, remove config, optionally delete topic."],
+    ["replace_instance", schemas.ReplaceInstanceArgs,
+        "Replace an instance with a fresh one. Collects handover context from the old instance (or falls back to daemon ring buffer), deletes it, creates a new instance with the same config, and sends the handover context to the new instance."],
+    ["set_display_name", schemas.SetDisplayNameArgs,
+        "Set your display name. This name will be shown in Telegram messages, activity logs, and when other agents refer to you."],
+    ["set_description", schemas.SetDescriptionArgs,
+        "Set your role description. This is injected into your system prompt as your role definition. Takes effect on next context rotation."],
+    ["checkout_repo", schemas.CheckoutRepoArgs,
+        "Mount another repo as a read-only worktree. Returns a local path you can Read files from. Use instance name or absolute path as source."],
+    ["release_repo", schemas.ReleaseRepoArgs,
+        "Remove a previously checked-out repo worktree."],
+    ["deploy_template", schemas.DeployTemplateArgs,
+        "Deploy a fleet template — creates instances and optionally a team in one operation."],
+    ["teardown_deployment", schemas.TeardownDeploymentArgs,
+        "Tear down a template deployment — stops and deletes all instances and team."],
+    ["list_deployments", schemas.ListDeploymentsArgs,
+        "List active template deployments with their instances and status."],
+];
+export const TOOLS = DEFS.map(([name, schema, description]) => ({
+    name,
+    description,
+    inputSchema: toToolInputSchema(schema),
+}));
+/** Predefined tool profiles to reduce token overhead per instance. */
+export const TOOL_SETS = {
+    full: TOOLS.map(t => t.name),
+    standard: [
+        "reply", "react", "edit_message",
+        "send_to_instance", "broadcast", "list_instances", "describe_instance",
+        "list_decisions", "post_decision", "task", "set_display_name", "set_description",
+    ],
+    minimal: ["reply", "send_to_instance", "list_decisions", "download_attachment"],
+};
+//# sourceMappingURL=mcp-tools.js.map

package/dist/channel/mcp-tools.js.map

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

package/dist/channel/message-bus.d.ts

@@ -0,0 +1,17 @@
+import { EventEmitter } from "node:events";
+import type { ChannelAdapter, OutboundMessage, Target, ApprovalResponse, PermissionPrompt } from "./types.js";
+export declare class MessageBus extends EventEmitter {
+    private adapters;
+    private logger?;
+    setLogger(logger: {
+        warn(obj: unknown, msg?: string): void;
+        error(msg: string): void;
+    }): void;
+    register(adapter: ChannelAdapter): void;
+    unregister(adapterId: string): void;
+    getAdapter(id: string): ChannelAdapter | undefined;
+    getAllAdapters(): ChannelAdapter[];
+    send(target: Target, msg: OutboundMessage): Promise<void>;
+    private sendVia;
+    requestApproval(prompt: PermissionPrompt): Promise<ApprovalResponse>;
+}

package/dist/channel/message-bus.js

@@ -0,0 +1,86 @@
+import { EventEmitter } from "node:events";
+const APPROVAL_TIMEOUT_MS = 120_000;
+export class MessageBus extends EventEmitter {
+    adapters = new Map();
+    logger;
+    setLogger(logger) {
+        this.logger = logger;
+    }
+    register(adapter) {
+        this.adapters.set(adapter.id, adapter);
+        adapter.on("message", (msg) => this.emit("message", msg));
+    }
+    unregister(adapterId) { this.adapters.delete(adapterId); }
+    getAdapter(id) { return this.adapters.get(id); }
+    getAllAdapters() { return [...this.adapters.values()]; }
+    async send(target, msg) {
+        if (target.adapterId) {
+            const adapter = this.adapters.get(target.adapterId);
+            if (!adapter)
+                throw new Error(`Adapter ${target.adapterId} not found`);
+            await this.sendVia(adapter, target, msg);
+        }
+        else {
+            const results = await Promise.allSettled([...this.adapters.values()].map(a => this.sendVia(a, target, msg)));
+            for (const r of results) {
+                if (r.status === "rejected") {
+                    this.logger?.warn({ err: r.reason }, "Adapter send failed");
+                }
+            }
+        }
+    }
+    async sendVia(adapter, target, msg) {
+        if (msg.filePath) {
+            await adapter.sendFile(target.chatId, msg.filePath, { threadId: target.threadId });
+        }
+        else if (msg.text) {
+            await adapter.sendText(target.chatId, msg.text, {
+                threadId: target.threadId, replyTo: msg.replyTo, format: msg.format,
+            });
+        }
+    }
+    requestApproval(prompt) {
+        return new Promise((resolve) => {
+            const controller = new AbortController();
+            const handles = [];
+            let resolved = false;
+            const timeout = setTimeout(() => {
+                if (resolved)
+                    return;
+                resolved = true;
+                controller.abort();
+                handles.forEach(h => h.cancel());
+                resolve({ decision: "deny", respondedBy: { channelType: "timeout", userId: "" } });
+            }, APPROVAL_TIMEOUT_MS);
+            if (this.adapters.size === 0) {
+                clearTimeout(timeout);
+                resolve({ decision: "deny", respondedBy: { channelType: "none", userId: "" } });
+                return;
+            }
+            let adapterFailures = 0;
+            for (const adapter of this.adapters.values()) {
+                adapter.sendApproval(prompt, (decision) => {
+                    if (resolved)
+                        return;
+                    resolved = true;
+                    clearTimeout(timeout);
+                    controller.abort();
+                    handles.forEach(h => h.cancel());
+                    resolve({ decision, respondedBy: { channelType: adapter.type, userId: adapter.id } });
+                }, controller.signal).then(handle => handles.push(handle)).catch(err => {
+                    this.logger?.warn({ err }, "Failed to send approval prompt via adapter");
+                    adapterFailures++;
+                    if (adapterFailures === this.adapters.size) {
+                        if (resolved)
+                            return;
+                        resolved = true;
+                        clearTimeout(timeout);
+                        this.logger?.error("All adapters failed to send approval prompt, auto-denying");
+                        resolve({ decision: "deny", reason: "All channel adapters failed to send approval prompt" });
+                    }
+                });
+            }
+        });
+    }
+}
+//# sourceMappingURL=message-bus.js.map

package/dist/channel/message-bus.js.map

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

package/dist/channel/message-queue.d.ts

@@ -0,0 +1,39 @@
+import type { QueuedMessage } from "./types.js";
+interface QueueSender {
+    send(chatId: string, threadId: string | undefined, text: string): Promise<{
+        messageId: string;
+    }>;
+    edit(chatId: string, messageId: string, text: string): Promise<void>;
+    sendFile(chatId: string, threadId: string | undefined, filePath: string): Promise<{
+        messageId: string;
+    }>;
+}
+export declare class MessageQueue {
+    private sender;
+    private queues;
+    private stopped;
+    private logger?;
+    constructor(sender: QueueSender, logger?: {
+        warn(obj: unknown, msg?: string): void;
+    });
+    private queueKey;
+    private getOrCreateQueue;
+    enqueue(chatId: string, threadId: string | undefined, msg: QueuedMessage): void;
+    start(): void;
+    stop(): void;
+    private runWorker;
+    /**
+     * Synchronously extracts items from the queue and returns the extracted items
+     * plus an async work function. The work function does the actual sending.
+     * This split allows us to know which items to re-queue if the work fails.
+     */
+    private prepareNext;
+    /**
+     * Merges all adjacent content messages at the front of the queue.
+     * Respects the 4096 char limit per chunk.
+     * Returns merged chunks plus the original consumed items (for re-queuing on error).
+     */
+    private mergeContentMessages;
+    private sleep;
+}
+export {};