@suzuke/agend 0.0.1 → 1.0.2

package/dist/channel/mcp-tools.js

@@ -0,0 +1,346 @@
+/** Pure tool schema definitions — no runtime dependencies, safe to import in tests. */
+export const TOOLS = [
+    {
+        name: "reply",
+        description: "Reply on the channel. Pass chat_id from the inbound message. Optionally pass reply_to (message_id) for threading, and files (absolute paths) to attach. IMPORTANT: chat_id and thread_id must come from the inbound <channel> message — never infer them from instance names or topic_ids.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                chat_id: {
+                    type: "string",
+                    description: "chat_id from the inbound <channel> block. Do NOT use an instance's topic_id here.",
+                },
+                text: { type: "string" },
+                reply_to: {
+                    type: "string",
+                    description: "Message ID to thread under. Use message_id from the inbound <channel> block.",
+                },
+                thread_id: {
+                    type: "string",
+                    description: "Telegram topic thread ID. Use thread_id from the inbound <channel> block only. Never set this to an instance's topic_id from list_instances.",
+                },
+                files: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Absolute file paths to attach.",
+                },
+                format: {
+                    type: "string",
+                    enum: ["text", "markdown"],
+                    description: "Rendering mode. Default: 'text'.",
+                },
+            },
+            required: ["chat_id", "text"],
+        },
+    },
+    {
+        name: "react",
+        description: "Add an emoji reaction to a channel message.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                chat_id: { type: "string" },
+                message_id: { type: "string" },
+                emoji: { type: "string" },
+            },
+            required: ["chat_id", "message_id", "emoji"],
+        },
+    },
+    {
+        name: "edit_message",
+        description: "Edit a message the bot previously sent. Useful for interim progress updates.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                chat_id: { type: "string" },
+                message_id: { type: "string" },
+                text: { type: "string" },
+                format: {
+                    type: "string",
+                    enum: ["text", "markdown"],
+                    description: "Rendering mode. Default: 'text'.",
+                },
+            },
+            required: ["chat_id", "message_id", "text"],
+        },
+    },
+    {
+        name: "download_attachment",
+        description: "Download a file attachment from a channel message. Returns the local file path ready to Read.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                file_id: {
+                    type: "string",
+                    description: "The attachment_file_id from inbound meta",
+                },
+            },
+            required: ["file_id"],
+        },
+    },
+    {
+        name: "create_schedule",
+        description: "Create a cron-based schedule. When triggered, sends a message to the target instance.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                cron: { type: "string", description: "Cron expression, e.g. '0 7 * * *' (every day at 7 AM)" },
+                message: { type: "string", description: "Message to inject when triggered" },
+                target: { type: "string", description: "Target instance name. Defaults to this instance if omitted." },
+                label: { type: "string", description: "Human-readable name for this schedule" },
+                timezone: { type: "string", description: "IANA timezone, e.g. 'Asia/Taipei'. Defaults to Asia/Taipei." },
+            },
+            required: ["cron", "message"],
+        },
+    },
+    {
+        name: "list_schedules",
+        description: "List all schedules. Optionally filter by target instance.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                target: { type: "string", description: "Filter by target instance name" },
+            },
+        },
+    },
+    {
+        name: "update_schedule",
+        description: "Update an existing schedule. Only include fields you want to change.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "string", description: "Schedule ID" },
+                cron: { type: "string", description: "New cron expression" },
+                message: { type: "string", description: "New message" },
+                target: { type: "string", description: "New target instance" },
+                label: { type: "string", description: "New label" },
+                timezone: { type: "string", description: "New timezone" },
+                enabled: { type: "boolean", description: "Enable/disable the schedule" },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "delete_schedule",
+        description: "Delete a schedule by ID.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "string", description: "Schedule ID to delete" },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "send_to_instance",
+        description: "Send a message to another Claude instance. The message appears in their channel as a passive notification — they decide whether to respond. Use this to share information, request reviews, or coordinate work across instances.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                instance_name: {
+                    type: "string",
+                    description: "Name of the target instance (e.g., 'ccplugin', 'blog-t1385'). Use list_instances to see available instances.",
+                },
+                message: {
+                    type: "string",
+                    description: "The message to send to the target instance.",
+                },
+                request_kind: {
+                    type: "string",
+                    enum: ["query", "task", "report", "update"],
+                    description: "Categorizes the message intent. 'query' = asking a question, 'task' = delegating work, 'report' = returning results, 'update' = status notification.",
+                },
+                requires_reply: {
+                    type: "boolean",
+                    description: "Whether you expect the recipient to respond. Default: false.",
+                },
+                correlation_id: {
+                    type: "string",
+                    description: "Echo this from a previous message to link request-response pairs.",
+                },
+                task_summary: {
+                    type: "string",
+                    description: "Brief summary of the task or request (shown in logs and Telegram visibility posts).",
+                },
+                working_directory: {
+                    type: "string",
+                    description: "Working directory context to pass along (e.g. the repo path you are working in).",
+                },
+                branch: {
+                    type: "string",
+                    description: "Git branch context to pass along.",
+                },
+            },
+            required: ["instance_name", "message"],
+        },
+    },
+    {
+        name: "request_information",
+        description: "Ask another instance a question and expect a reply. Wrapper around send_to_instance with request_kind=query and requires_reply=true.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                target_instance: {
+                    type: "string",
+                    description: "Name of the instance to ask.",
+                },
+                question: {
+                    type: "string",
+                    description: "The question to ask.",
+                },
+                context: {
+                    type: "string",
+                    description: "Optional context to help the recipient answer.",
+                },
+            },
+            required: ["target_instance", "question"],
+        },
+    },
+    {
+        name: "delegate_task",
+        description: "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.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                target_instance: {
+                    type: "string",
+                    description: "Name of the instance to delegate to.",
+                },
+                task: {
+                    type: "string",
+                    description: "Description of the task to perform.",
+                },
+                success_criteria: {
+                    type: "string",
+                    description: "How the recipient should judge if the task is complete.",
+                },
+                context: {
+                    type: "string",
+                    description: "Optional background context for the task.",
+                },
+            },
+            required: ["target_instance", "task"],
+        },
+    },
+    {
+        name: "report_result",
+        description: "Report results back to an instance that delegated a task or asked a question. Wrapper around send_to_instance with request_kind=report.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                target_instance: {
+                    type: "string",
+                    description: "Name of the instance to report to.",
+                },
+                correlation_id: {
+                    type: "string",
+                    description: "The correlation_id from the original request.",
+                },
+                summary: {
+                    type: "string",
+                    description: "Summary of the result.",
+                },
+                artifacts: {
+                    type: "string",
+                    description: "Optional details: file paths, commit hashes, URLs, etc.",
+                },
+            },
+            required: ["target_instance", "summary"],
+        },
+    },
+    {
+        name: "describe_instance",
+        description: "Get detailed information about a specific instance: description, working directory, status, tags, and recent activity.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Instance name to describe.",
+                },
+            },
+            required: ["name"],
+        },
+    },
+    {
+        name: "list_instances",
+        description: "List all currently running instances that you can send messages to.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "start_instance",
+        description: "Start a stopped AgEnD instance. Use list_instances() first to check available instances and their status. " +
+            "Only needed when the target instance status is 'stopped'.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "The instance name to start (from list_instances)",
+                },
+            },
+            required: ["name"],
+        },
+    },
+    {
+        name: "create_instance",
+        description: "Create a new AgEnD instance bound to a project directory, with a new Telegram topic. " +
+            "Use this when the user wants to add a new project to the fleet. " +
+            "The directory must exist. Returns the instance name and topic ID.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                directory: {
+                    type: "string",
+                    description: "Absolute path or ~-prefixed path to the project directory",
+                },
+                topic_name: {
+                    type: "string",
+                    description: "Name for the Telegram topic. Defaults to directory basename.",
+                },
+                description: {
+                    type: "string",
+                    description: "Human-readable description of what this instance does (e.g., 'Daily secretary for scheduling and reminders').",
+                },
+                model: {
+                    type: "string",
+                    description: "Claude model to use for this instance. Omit to use the default (usually opus).",
+                    enum: ["sonnet", "opus", "haiku"],
+                },
+                backend: {
+                    type: "string",
+                    description: "CLI backend to use. Defaults to claude-code.",
+                    enum: ["claude-code", "gemini-cli", "codex", "opencode"],
+                },
+                branch: {
+                    type: "string",
+                    description: "Git branch name. When specified, creates a git worktree from the directory's repo and uses it as the working directory. If the branch doesn't exist, it will be created.",
+                },
+            },
+            required: ["directory"],
+        },
+    },
+    {
+        name: "delete_instance",
+        description: "Delete a AgEnD instance: stop daemon, remove from fleet config, clean up worktree if applicable, and optionally delete the Telegram topic. " +
+            "Use this when an instance is no longer needed (e.g., feature branch work is done).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "The instance name to delete (from list_instances)",
+                },
+                delete_topic: {
+                    type: "boolean",
+                    description: "Whether to also delete the Telegram topic. Defaults to false.",
+                },
+            },
+            required: ["name"],
+        },
+    },
+];
+//# 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 {};