@suzuke/agend 0.0.1 → 1.0.2

package/dist/channel/message-queue.js

@@ -0,0 +1,248 @@
+const MAX_MESSAGE_LENGTH = 4096;
+const WORKER_IDLE_WAIT_MS = 200;
+const WORKER_BETWEEN_MS = 50;
+const MAX_BACKOFF_MS = 30_000;
+const FLOOD_CONTROL_THRESHOLD_MS = 10_000;
+const INITIAL_BACKOFF_MS = 1_000;
+function is429Error(err) {
+    if (err instanceof Error) {
+        const e = err;
+        if (e.status === 429)
+            return true;
+        if (e.code === 429)
+            return true;
+        if (e.response?.status === 429)
+            return true;
+        if (e.message.includes("429") || e.message.toLowerCase().includes("too many requests"))
+            return true;
+    }
+    return false;
+}
+function splitText(text) {
+    const chunks = [];
+    let offset = 0;
+    while (offset < text.length) {
+        chunks.push(text.slice(offset, offset + MAX_MESSAGE_LENGTH));
+        offset += MAX_MESSAGE_LENGTH;
+    }
+    return chunks;
+}
+export class MessageQueue {
+    sender;
+    queues = new Map();
+    stopped = true;
+    logger;
+    constructor(sender, logger) {
+        this.sender = sender;
+        this.logger = logger;
+    }
+    queueKey(chatId, threadId) {
+        return threadId != null ? `${chatId}:${threadId}` : `${chatId}:`;
+    }
+    getOrCreateQueue(chatId, threadId) {
+        const key = this.queueKey(chatId, threadId);
+        let state = this.queues.get(key);
+        if (!state) {
+            state = {
+                key: { chatId, threadId },
+                items: [],
+                backoffMs: INITIAL_BACKOFF_MS,
+                backoffUntil: 0,
+                running: false,
+            };
+            this.queues.set(key, state);
+        }
+        return state;
+    }
+    enqueue(chatId, threadId, msg) {
+        const state = this.getOrCreateQueue(chatId, threadId);
+        state.items.push(msg);
+        // If worker is already running, it will pick this up automatically.
+        // If queue was started and worker is not running, restart it.
+        if (!this.stopped && !state.running) {
+            this.runWorker(state);
+        }
+    }
+    start() {
+        this.stopped = false;
+        // Start workers for any queues that already have items
+        for (const state of this.queues.values()) {
+            if (!state.running && state.items.length > 0) {
+                this.runWorker(state);
+            }
+        }
+    }
+    stop() {
+        this.stopped = true;
+        // Clear all queues
+        for (const state of this.queues.values()) {
+            state.items = [];
+        }
+    }
+    async runWorker(state) {
+        if (state.running)
+            return;
+        state.running = true;
+        while (!this.stopped) {
+            // Apply backoff if needed
+            const now = Date.now();
+            if (state.backoffUntil > now) {
+                const waitMs = state.backoffUntil - now;
+                await this.sleep(Math.min(waitMs, 100));
+                continue;
+            }
+            // Apply flood control: drop status_update items if backoff > threshold
+            if (state.backoffMs > FLOOD_CONTROL_THRESHOLD_MS) {
+                const before = state.items.length;
+                state.items = state.items.filter(item => item.type !== "status_update");
+                if (before !== state.items.length) {
+                    // Items were dropped; reset backoff now that we've cleaned up
+                }
+            }
+            if (state.items.length === 0) {
+                await this.sleep(WORKER_IDLE_WAIT_MS);
+                continue;
+            }
+            // Pop and process next item(s)
+            const { items: pendingItems, work } = this.prepareNext(state);
+            if (!work) {
+                await this.sleep(WORKER_IDLE_WAIT_MS);
+                continue;
+            }
+            try {
+                await work();
+                // Reset backoff on success
+                state.backoffMs = INITIAL_BACKOFF_MS;
+                state.backoffUntil = 0;
+                await this.sleep(WORKER_BETWEEN_MS);
+            }
+            catch (err) {
+                if (is429Error(err)) {
+                    // Re-insert the consumed items back at the front of the queue
+                    state.items.unshift(...pendingItems);
+                    // Exponential backoff, cap at MAX_BACKOFF_MS
+                    state.backoffUntil = Date.now() + state.backoffMs;
+                    state.backoffMs = Math.min(state.backoffMs * 2, MAX_BACKOFF_MS);
+                }
+                else {
+                    // Non-rate-limit error: drop the item to avoid infinite loops
+                    this.logger?.warn({ err, chatId: state.key.chatId }, "Message dropped due to non-retryable error");
+                    state.backoffMs = INITIAL_BACKOFF_MS;
+                    state.backoffUntil = 0;
+                    await this.sleep(WORKER_BETWEEN_MS);
+                }
+            }
+        }
+        state.running = false;
+    }
+    /**
+     * 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.
+     */
+    prepareNext(state) {
+        const { chatId, threadId } = state.key;
+        const first = state.items[0];
+        if (!first)
+            return { items: [], work: null };
+        if (first.type === "content") {
+            const { merged, consumed } = this.mergeContentMessages(state);
+            const work = async () => {
+                for (const chunk of merged) {
+                    if (chunk.filePath) {
+                        await this.sender.sendFile(chatId, threadId, chunk.filePath);
+                    }
+                    else if (chunk.text) {
+                        const parts = splitText(chunk.text);
+                        for (const part of parts) {
+                            await this.sender.send(chatId, threadId, part);
+                        }
+                    }
+                }
+            };
+            return { items: consumed, work };
+        }
+        else if (first.type === "status_update") {
+            state.items.shift();
+            const item = first;
+            const work = async () => {
+                if (item.editMessageId) {
+                    await this.sender.edit(chatId, item.editMessageId, item.text ?? "");
+                }
+                else {
+                    await this.sender.send(chatId, threadId, item.text ?? "");
+                }
+            };
+            return { items: [item], work };
+        }
+        else if (first.type === "status_clear") {
+            state.items.shift();
+            return { items: [first], work: async () => { } };
+        }
+        return { items: [], work: null };
+    }
+    /**
+     * 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).
+     */
+    mergeContentMessages(state) {
+        // Collect all leading content items
+        const consumed = [];
+        while (state.items.length > 0 && state.items[0].type === "content") {
+            consumed.push(state.items.shift());
+        }
+        const merged = [];
+        let currentText = "";
+        for (const item of consumed) {
+            if (item.filePath) {
+                // Flush any pending text first
+                if (currentText.length > 0) {
+                    const parts = splitText(currentText);
+                    for (const part of parts) {
+                        merged.push({ text: part });
+                    }
+                    currentText = "";
+                }
+                merged.push({ filePath: item.filePath });
+            }
+            else if (item.text) {
+                // Try to append to current text, splitting if necessary
+                const combined = currentText + item.text;
+                if (combined.length <= MAX_MESSAGE_LENGTH) {
+                    currentText = combined;
+                }
+                else {
+                    // Flush current accumulated text first
+                    if (currentText.length > 0) {
+                        const parts = splitText(currentText);
+                        for (const part of parts) {
+                            merged.push({ text: part });
+                        }
+                        currentText = "";
+                    }
+                    // Now handle item.text which might itself be long
+                    if (item.text.length <= MAX_MESSAGE_LENGTH) {
+                        currentText = item.text;
+                    }
+                    else {
+                        const parts = splitText(item.text);
+                        const lastPart = parts.pop();
+                        for (const part of parts) {
+                            merged.push({ text: part });
+                        }
+                        currentText = lastPart;
+                    }
+                }
+            }
+        }
+        if (currentText.length > 0) {
+            merged.push({ text: currentText });
+        }
+        return { merged, consumed };
+    }
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=message-queue.js.map

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

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

package/dist/channel/tool-router.d.ts

@@ -0,0 +1,6 @@
+import type { ChannelAdapter } from "./types.js";
+/**
+ * Route a channel tool call (reply, react, edit_message, download_attachment)
+ * to the adapter. Returns true if handled, false if unknown tool.
+ */
+export declare function routeToolCall(adapter: ChannelAdapter, tool: string, args: Record<string, unknown>, threadId: string | undefined, respond: (result: unknown, error?: string) => void): boolean;

package/dist/channel/tool-router.js

@@ -0,0 +1,69 @@
+import { homedir } from "node:os";
+import { resolve, sep } from "node:path";
+import { realpathSync, existsSync } from "node:fs";
+const STATE_DIR = resolve(homedir(), ".agend") + sep;
+const INBOX_SEG = sep + "inbox" + sep;
+/** Block files inside the state dir (except inbox/) from being sent out. */
+function assertSendable(filePath) {
+    let resolved;
+    try {
+        resolved = realpathSync(filePath);
+    }
+    catch {
+        if (!existsSync(filePath))
+            return; // truly missing — let adapter handle
+        throw new Error(`Blocked: cannot resolve path ${filePath}`);
+    }
+    if (resolved.startsWith(STATE_DIR) && !resolved.includes(INBOX_SEG)) {
+        throw new Error(`Blocked: refusing to send state file ${filePath}`);
+    }
+}
+/**
+ * Route a channel tool call (reply, react, edit_message, download_attachment)
+ * to the adapter. Returns true if handled, false if unknown tool.
+ */
+export function routeToolCall(adapter, tool, args, threadId, respond) {
+    const chatId = args.chat_id ?? "";
+    switch (tool) {
+        case "reply": {
+            const files = Array.isArray(args.files) ? args.files : [];
+            try {
+                for (const f of files)
+                    assertSendable(f);
+            }
+            catch (e) {
+                respond(null, e.message);
+                return true;
+            }
+            const replyThreadId = args.thread_id ?? threadId;
+            adapter.sendText(chatId, args.text ?? "", {
+                threadId: replyThreadId,
+                replyTo: args.reply_to,
+            }).then(async (sent) => {
+                for (const filePath of files) {
+                    await adapter.sendFile(chatId, filePath, { threadId: replyThreadId });
+                }
+                respond(sent);
+            }).catch(e => respond(null, e.message));
+            return true;
+        }
+        case "react":
+            adapter.react(chatId, args.message_id ?? "", args.emoji ?? "")
+                .then(() => respond("ok"))
+                .catch(e => respond(null, e.message));
+            return true;
+        case "edit_message":
+            adapter.editMessage(chatId, args.message_id ?? "", args.text ?? "")
+                .then(() => respond("ok"))
+                .catch(e => respond(null, e.message));
+            return true;
+        case "download_attachment":
+            adapter.downloadAttachment(args.file_id ?? "")
+                .then(path => respond(path))
+                .catch(e => respond(null, e.message));
+            return true;
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=tool-router.js.map

package/dist/channel/tool-router.js.map

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

package/dist/channel/tool-tracker.d.ts

@@ -0,0 +1,13 @@
+import type { ChannelAdapter } from "./types.js";
+export declare class ToolTracker {
+    private adapter;
+    private chatId;
+    private threadId?;
+    private statusMessageId;
+    private lines;
+    constructor(adapter: ChannelAdapter, chatId: string, threadId?: string | undefined);
+    onToolUse(toolName: string, input: unknown): Promise<void>;
+    onToolResult(toolName: string, _output: unknown): Promise<void>;
+    reset(): void;
+    private summarizeTool;
+}

package/dist/channel/tool-tracker.js

@@ -0,0 +1,58 @@
+export class ToolTracker {
+    adapter;
+    chatId;
+    threadId;
+    statusMessageId = null;
+    lines = [];
+    constructor(adapter, chatId, threadId) {
+        this.adapter = adapter;
+        this.chatId = chatId;
+        this.threadId = threadId;
+    }
+    async onToolUse(toolName, input) {
+        const summary = this.summarizeTool(toolName, input);
+        this.lines.push(`🔧 ${summary}`);
+        if (!this.statusMessageId) {
+            // First tool — send new message
+            const sent = await this.adapter.sendText(this.chatId, this.lines.join("\n"), { threadId: this.threadId });
+            this.statusMessageId = sent.messageId;
+        }
+        else {
+            // Subsequent — edit existing
+            await this.adapter.editMessage(this.chatId, this.statusMessageId, this.lines.join("\n"));
+        }
+    }
+    async onToolResult(toolName, _output) {
+        // Find the last line matching this tool and mark it done
+        for (let i = this.lines.length - 1; i >= 0; i--) {
+            if (this.lines[i].includes(toolName) && this.lines[i].startsWith("🔧")) {
+                this.lines[i] = this.lines[i].replace("🔧", "✅");
+                break;
+            }
+        }
+        if (this.statusMessageId) {
+            await this.adapter.editMessage(this.chatId, this.statusMessageId, this.lines.join("\n"));
+        }
+    }
+    reset() {
+        this.statusMessageId = null;
+        this.lines = [];
+    }
+    summarizeTool(name, input) {
+        const inp = input;
+        if (name === "Read")
+            return `Read: ${inp.file_path ?? ""}`;
+        if (name === "Edit")
+            return `Edit: ${inp.file_path ?? ""}`;
+        if (name === "Write")
+            return `Write: ${inp.file_path ?? ""}`;
+        if (name === "Bash")
+            return `Bash: ${String(inp.command ?? "").slice(0, 60)}`;
+        if (name === "Glob")
+            return `Glob: ${inp.pattern ?? ""}`;
+        if (name === "Grep")
+            return `Grep: ${inp.pattern ?? ""}`;
+        return name;
+    }
+}
+//# sourceMappingURL=tool-tracker.js.map

package/dist/channel/tool-tracker.js.map

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

package/dist/channel/types.d.ts

@@ -0,0 +1,116 @@
+import { EventEmitter } from "node:events";
+export interface Choice {
+    id: string;
+    label: string;
+}
+export interface InstanceStatusData {
+    name: string;
+    status: "running" | "stopped" | "crashed" | "paused";
+    contextPct: number | null;
+    costCents: number;
+}
+export interface AlertData {
+    type: "hang" | "cost_warn" | "cost_limit" | "schedule_deferred" | "rotation";
+    instanceName: string;
+    message: string;
+    choices?: Choice[];
+}
+export interface ChannelAdapter extends EventEmitter {
+    readonly type: string;
+    readonly id: string;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    sendText(chatId: string, text: string, opts?: SendOpts): Promise<SentMessage>;
+    sendFile(chatId: string, filePath: string, opts?: SendOpts): Promise<SentMessage>;
+    editMessage(chatId: string, messageId: string, text: string): Promise<void>;
+    react(chatId: string, messageId: string, emoji: string): Promise<void>;
+    sendApproval(prompt: PermissionPrompt, callback: (decision: "approve" | "approve_always" | "deny") => void, signal?: AbortSignal, threadId?: string): Promise<ApprovalHandle>;
+    downloadAttachment(fileId: string): Promise<string>;
+    handlePairing(chatId: string, userId: string): Promise<string>;
+    confirmPairing(code: string): Promise<boolean>;
+    readonly topology: "topics" | "channels" | "flat";
+    setChatId(chatId: string): void;
+    getChatId(): string | null;
+    promptUser(chatId: string, text: string, choices: Choice[], opts?: SendOpts): Promise<string>;
+    notifyAlert(chatId: string, alert: AlertData, opts?: SendOpts): Promise<SentMessage>;
+    createTopic?(name: string): Promise<number>;
+    topicExists?(topicId: number): Promise<boolean>;
+    closeForumTopic?(threadId: number): Promise<void>;
+    reopenForumTopic?(threadId: number): Promise<void>;
+    editForumTopic?(threadId: number, opts: {
+        name?: string;
+        iconCustomEmojiId?: string;
+    }): Promise<void>;
+    getTopicIconStickers?(): Promise<{
+        customEmojiId: string;
+        emoji: string;
+    }[]>;
+}
+export interface ApprovalHandle {
+    cancel(): void;
+}
+export interface SendOpts {
+    threadId?: string;
+    replyTo?: string;
+    format?: "text" | "markdown";
+    chunkLimit?: number;
+}
+export interface SentMessage {
+    messageId: string;
+    chatId: string;
+    threadId?: string;
+}
+export interface OutboundMessage {
+    text?: string;
+    filePath?: string;
+    threadId?: string;
+    replyTo?: string;
+    format?: "text" | "markdown";
+}
+export interface InboundMessage {
+    source: string;
+    adapterId: string;
+    chatId: string;
+    threadId?: string;
+    messageId: string;
+    userId: string;
+    username: string;
+    text: string;
+    timestamp: Date;
+    attachments?: Attachment[];
+    replyTo?: string;
+    replyToText?: string;
+}
+export interface Attachment {
+    kind: "photo" | "document" | "audio" | "voice" | "video" | "sticker";
+    fileId: string;
+    localPath?: string;
+    mime?: string;
+    size?: number;
+    filename?: string;
+    transcription?: string;
+}
+export interface PermissionPrompt {
+    tool_name: string;
+    description: string;
+    input_preview?: string;
+}
+export interface ApprovalResponse {
+    decision: "approve" | "approve_always" | "deny";
+    respondedBy?: {
+        channelType: string;
+        userId: string;
+    };
+    reason?: string;
+}
+export interface Target {
+    adapterId?: string;
+    chatId: string;
+    threadId?: string;
+}
+export interface QueuedMessage {
+    type: "content" | "status_update" | "status_clear";
+    text?: string;
+    filePath?: string;
+    editMessageId?: string;
+}

package/dist/channel/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/channel/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/channel/types.ts"],"names":[],"mappings":""}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};