agent-inbox 0.0.1 → 0.1.2

package/dist/mcp/mcp-server.js

@@ -0,0 +1,226 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+export class InboxMcpServer {
+    router;
+    storage;
+    defaultScope;
+    mcp;
+    registry = null;
+    constructor(router, storage, defaultScope = "default") {
+        this.router = router;
+        this.storage = storage;
+        this.defaultScope = defaultScope;
+        this.mcp = new McpServer({
+            name: "agent-inbox",
+            version: "0.1.0",
+        });
+        this.registerTools();
+    }
+    /**
+     * Attach a warm registry for federation-aware agent registration.
+     */
+    setRegistry(registry) {
+        this.registry = registry;
+    }
+    registerTools() {
+        this.mcp.tool("send_message", "Send a message to one or more agents. Supports replies (inReplyTo), threading (threadTag), and federated addressing (agent@system).", {
+            to: z
+                .union([z.string(), z.array(z.string())])
+                .describe("Recipient agent ID(s). Use 'agent@system' for federated addressing."),
+            body: z
+                .string()
+                .optional()
+                .describe("Plain text message body (shorthand for content)"),
+            content: z
+                .object({
+                type: z.string(),
+            })
+                .passthrough()
+                .optional()
+                .describe("Structured message content"),
+            from: z
+                .string()
+                .optional()
+                .describe("Sender agent ID (defaults to caller)"),
+            threadTag: z
+                .string()
+                .optional()
+                .describe("Thread tag for grouping related messages"),
+            inReplyTo: z
+                .string()
+                .optional()
+                .describe("Message ID this is a reply to"),
+            importance: z
+                .enum(["low", "normal", "high", "urgent"])
+                .optional()
+                .describe("Message importance level"),
+            subject: z.string().optional().describe("Message subject"),
+        }, async ({ to, body, content, from, threadTag, inReplyTo, importance, subject }) => {
+            const payload = content ?? body ?? "";
+            const senderId = from ?? "anonymous";
+            const message = await this.router.routeMessage({
+                from: senderId,
+                to,
+                payload,
+                threadTag,
+                inReplyTo,
+                importance,
+                subject,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ ok: true, messageId: message.id }),
+                    },
+                ],
+            };
+        });
+        this.mcp.tool("check_inbox", "Check inbox for messages addressed to an agent. Auto-registers the agent if not already registered.", {
+            agentId: z.string().describe("Agent ID to check inbox for"),
+            unreadOnly: z
+                .boolean()
+                .optional()
+                .describe("Only return unread messages (default true)"),
+            limit: z
+                .number()
+                .optional()
+                .describe("Max messages to return"),
+        }, async ({ agentId, unreadOnly, limit }) => {
+            // Auto-register the agent if not already known
+            this.ensureAgent(agentId);
+            const messages = this.storage.getInbox(agentId, {
+                unreadOnly: unreadOnly ?? true,
+                limit,
+            });
+            // Auto-mark as read
+            for (const msg of messages) {
+                this.router.markRead(msg.id, agentId);
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            count: messages.length,
+                            messages: messages.map((m) => ({
+                                id: m.id,
+                                from: m.sender_id,
+                                subject: m.subject,
+                                content: m.content,
+                                threadTag: m.thread_tag,
+                                importance: m.importance,
+                                createdAt: m.created_at,
+                                inReplyTo: m.in_reply_to,
+                            })),
+                        }),
+                    },
+                ],
+            };
+        });
+        this.mcp.tool("read_thread", "Read all messages in a thread (by thread_tag)", {
+            threadTag: z.string().describe("Thread tag to read"),
+            scope: z
+                .string()
+                .optional()
+                .describe("Scope (defaults to 'default')"),
+        }, async ({ threadTag, scope }) => {
+            const messages = this.storage.getThread({
+                threadTag,
+                scope: scope ?? this.defaultScope,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            threadTag,
+                            count: messages.length,
+                            messages: messages.map((m) => ({
+                                id: m.id,
+                                from: m.sender_id,
+                                content: m.content,
+                                createdAt: m.created_at,
+                                inReplyTo: m.in_reply_to,
+                            })),
+                        }),
+                    },
+                ],
+            };
+        });
+        this.mcp.tool("list_agents", "List agents registered in the inbox (local and optionally federated)", {
+            scope: z
+                .string()
+                .optional()
+                .describe("Filter by scope"),
+            includeFederated: z
+                .boolean()
+                .optional()
+                .describe("Include agents known from federation routing table"),
+        }, async ({ scope, includeFederated }) => {
+            const agents = this.storage.listAgents(scope);
+            const localList = agents.map((a) => ({
+                agentId: a.agent_id,
+                name: a.display_name,
+                scope: a.scope,
+                status: a.status,
+                program: a.program,
+                lastActive: a.last_active_at,
+                location: "local",
+            }));
+            let federatedList = [];
+            if (includeFederated && this.router.getFederation()) {
+                const federation = this.router.getFederation();
+                const routingTable = federation.routing.getTable();
+                federatedList = routingTable.map((entry) => ({
+                    agentId: entry.agentId,
+                    peerId: entry.peerId,
+                    status: entry.status,
+                    location: "federated",
+                }));
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            count: localList.length + federatedList.length,
+                            agents: [...localList, ...federatedList],
+                        }),
+                    },
+                ],
+            };
+        });
+    }
+    /** Auto-register an agent if not already known (lazy registration on first inbox check) */
+    ensureAgent(agentId) {
+        const existing = this.storage.listAgents().find((a) => a.agent_id === agentId);
+        if (existing)
+            return;
+        const now = new Date().toISOString();
+        const agent = {
+            agent_id: agentId,
+            scope: this.defaultScope,
+            status: "active",
+            metadata: {},
+            registered_at: now,
+            last_active_at: now,
+        };
+        if (this.registry) {
+            this.registry.register(agent);
+        }
+        else {
+            this.storage.putAgent(agent);
+        }
+    }
+    async start() {
+        const transport = new StdioServerTransport();
+        await this.mcp.connect(transport);
+    }
+    /** Expose for testing — returns the underlying McpServer */
+    get server() {
+        return this.mcp;
+    }
+}
+//# sourceMappingURL=mcp-server.js.map

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

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

package/dist/push/notifier.d.ts

@@ -0,0 +1,49 @@
+import { EventEmitter } from "node:events";
+import type { Storage } from "../storage/interface.js";
+/**
+ * Push notification system for Agent Inbox.
+ *
+ * Agents can't receive server-initiated messages via MCP stdio transport,
+ * so we use the same injection pattern as claude-code-swarm:
+ *
+ * 1. New messages arrive → written to per-agent inbox files (NDJSON)
+ * 2. Agent's hook (UserPromptSubmit) reads the inbox file and injects
+ *    messages into the agent's context as formatted markdown
+ * 3. Agent sees new messages at the start of their next turn
+ *
+ * This class also supports webhook-style push for external consumers.
+ */
+export interface NotifierConfig {
+    /** Directory for per-agent inbox files */
+    inboxDir: string;
+    /** Optional webhook URLs to POST new messages to */
+    webhooks?: string[];
+}
+export interface InboxFileEntry {
+    messageId: string;
+    from: string;
+    to: string;
+    subject?: string;
+    content: unknown;
+    threadTag?: string;
+    importance: string;
+    timestamp: string;
+}
+export declare class PushNotifier {
+    private config;
+    private storage;
+    private webhooks;
+    constructor(config: NotifierConfig, storage: Storage, events: EventEmitter);
+    private onMessage;
+    /** Write a message to an agent's inbox file (NDJSON) */
+    private writeAgentInbox;
+    /** Read and format an agent's pending inbox as markdown (for hook injection) */
+    readAndClearAgentInbox(agentId: string): string | null;
+    /** Get the path to an agent's inbox file */
+    agentInboxPath(agentId: string): string;
+    /** Fire webhook notification (best-effort) */
+    private fireWebhook;
+}
+/** Format inbox entries as markdown for agent context injection */
+export declare function formatInboxMarkdown(entries: InboxFileEntry[]): string;
+//# sourceMappingURL=notifier.d.ts.map

package/dist/push/notifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.d.ts","sourceRoot":"","sources":["../../src/push/notifier.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,YAAY;IAIrB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IAJjB,OAAO,CAAC,QAAQ,CAAW;gBAGjB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,OAAO,EACxB,MAAM,EAAE,YAAY;IAWtB,OAAO,CAAC,SAAS;IAYjB,wDAAwD;IACxD,OAAO,CAAC,eAAe;IAmBvB,gFAAgF;IAChF,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAkCtD,4CAA4C;IAC5C,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAMvC,8CAA8C;YAChC,WAAW;CAuB1B;AAED,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CA0BrE"}

package/dist/push/notifier.js

@@ -0,0 +1,150 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+export class PushNotifier {
+    config;
+    storage;
+    webhooks;
+    constructor(config, storage, events) {
+        this.config = config;
+        this.storage = storage;
+        this.webhooks = config.webhooks ?? [];
+        // Subscribe to message.created events
+        events.on("message.created", (msg) => this.onMessage(msg));
+        // Ensure inbox directory exists
+        fs.mkdirSync(config.inboxDir, { recursive: true });
+    }
+    onMessage(message) {
+        // Write to each recipient's per-agent inbox file
+        for (const recipient of message.recipients) {
+            this.writeAgentInbox(recipient.agent_id, message);
+        }
+        // Fire webhooks (best-effort)
+        for (const url of this.webhooks) {
+            this.fireWebhook(url, message).catch(() => { });
+        }
+    }
+    /** Write a message to an agent's inbox file (NDJSON) */
+    writeAgentInbox(agentId, message) {
+        const filePath = this.agentInboxPath(agentId);
+        const entry = {
+            messageId: message.id,
+            from: message.sender_id,
+            to: agentId,
+            subject: message.subject,
+            content: message.content,
+            threadTag: message.thread_tag,
+            importance: message.importance,
+            timestamp: message.created_at,
+        };
+        try {
+            fs.appendFileSync(filePath, JSON.stringify(entry) + "\n");
+        }
+        catch {
+            // Best-effort write
+        }
+    }
+    /** Read and format an agent's pending inbox as markdown (for hook injection) */
+    readAndClearAgentInbox(agentId) {
+        const filePath = this.agentInboxPath(agentId);
+        let raw;
+        try {
+            raw = fs.readFileSync(filePath, "utf-8").trim();
+        }
+        catch {
+            return null;
+        }
+        if (!raw)
+            return null;
+        // Parse entries
+        const entries = [];
+        for (const line of raw.split("\n")) {
+            if (!line.trim())
+                continue;
+            try {
+                entries.push(JSON.parse(line));
+            }
+            catch {
+                // Skip malformed lines
+            }
+        }
+        if (entries.length === 0)
+            return null;
+        // Clear the file
+        try {
+            fs.writeFileSync(filePath, "");
+        }
+        catch {
+            // Best-effort clear
+        }
+        return formatInboxMarkdown(entries);
+    }
+    /** Get the path to an agent's inbox file */
+    agentInboxPath(agentId) {
+        // Sanitize agentId for use as filename
+        const safe = agentId.replace(/[^a-zA-Z0-9_-]/g, "_");
+        return path.join(this.config.inboxDir, `${safe}.inbox.jsonl`);
+    }
+    /** Fire webhook notification (best-effort) */
+    async fireWebhook(url, message) {
+        try {
+            await fetch(url, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    event: "message.created",
+                    message: {
+                        id: message.id,
+                        from: message.sender_id,
+                        recipients: message.recipients.map((r) => r.agent_id),
+                        content: message.content,
+                        threadTag: message.thread_tag,
+                        importance: message.importance,
+                        createdAt: message.created_at,
+                    },
+                }),
+                signal: AbortSignal.timeout(5000),
+            });
+        }
+        catch {
+            // Best-effort
+        }
+    }
+}
+/** Format inbox entries as markdown for agent context injection */
+export function formatInboxMarkdown(entries) {
+    const lines = [];
+    lines.push(`## [Inbox] ${entries.length} new message(s)\n`);
+    for (const entry of entries) {
+        const age = formatAge(entry.timestamp);
+        const priority = entry.importance !== "normal" ? ` [${entry.importance}]` : "";
+        const subject = entry.subject ? ` — ${entry.subject}` : "";
+        const thread = entry.threadTag ? ` (thread: ${entry.threadTag})` : "";
+        lines.push(`**From ${entry.from}** (${age} ago)${priority}${subject}${thread}`);
+        // Format content
+        const content = entry.content;
+        if (content && typeof content === "object" && content.type === "text") {
+            lines.push(`> ${content.text}`);
+        }
+        else if (typeof entry.content === "string") {
+            lines.push(`> ${entry.content}`);
+        }
+        else {
+            lines.push(`> \`${JSON.stringify(content)}\``);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+function formatAge(timestamp) {
+    const diff = Date.now() - new Date(timestamp).getTime();
+    if (diff < 1000)
+        return "<1s";
+    if (diff < 60_000)
+        return `${Math.floor(diff / 1000)}s`;
+    if (diff < 3600_000)
+        return `${Math.floor(diff / 60_000)}m`;
+    if (diff < 86400_000)
+        return `${Math.floor(diff / 3600_000)}h`;
+    return `${Math.floor(diff / 86400_000)}d`;
+}
+//# sourceMappingURL=notifier.js.map

package/dist/push/notifier.js.map

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

package/dist/registry/warm-registry.d.ts

@@ -0,0 +1,63 @@
+import { EventEmitter } from "node:events";
+import type { Agent, AgentRegistryConfig, WarmAgentStatus } from "../types.js";
+import type { Storage } from "../storage/interface.js";
+/**
+ * Warm agent registry with active/away/expired lifecycle.
+ *
+ * Wraps the storage layer to add TTL-based status management.
+ * Agents transition: active → away (on disconnect) → expired (after grace period).
+ */
+export declare class WarmRegistry {
+    private storage;
+    private events;
+    private entries;
+    private config;
+    constructor(storage: Storage, events: EventEmitter, config?: Partial<AgentRegistryConfig>);
+    /**
+     * Register an agent. First-wins — rejects if ID is taken by an active/away agent.
+     * Returns true if registered, false if ID conflict.
+     */
+    register(agent: Agent): boolean;
+    /**
+     * Mark an agent as disconnected. Starts grace period timer.
+     */
+    disconnect(agentId: string): boolean;
+    /**
+     * Reconnect a previously disconnected agent.
+     * Cancels grace period and restores active status.
+     */
+    reconnect(agentId: string): boolean;
+    /**
+     * Transition agent to expired. Not routable, but retained for audit.
+     */
+    expire(agentId: string): void;
+    /**
+     * Fully remove an agent from the registry.
+     */
+    remove(agentId: string): void;
+    /**
+     * Check if an agent is routable (active or away).
+     */
+    isRoutable(agentId: string): boolean;
+    /**
+     * Get the warm status of an agent.
+     */
+    getStatus(agentId: string): WarmAgentStatus | "unknown";
+    /**
+     * List all entries with their warm status.
+     */
+    listEntries(): Array<{
+        agentId: string;
+        warmStatus: WarmAgentStatus;
+    }>;
+    /**
+     * List all routable agent IDs.
+     */
+    listRoutable(): string[];
+    /**
+     * Clean up all timers. Call on shutdown.
+     */
+    destroy(): void;
+    private clearTimers;
+}
+//# sourceMappingURL=warm-registry.d.ts.map

package/dist/registry/warm-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warm-registry.d.ts","sourceRoot":"","sources":["../../src/registry/warm-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,KAAK,EACL,mBAAmB,EACnB,eAAe,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAgBvD;;;;;GAKG;AACH,qBAAa,YAAY;IAKrB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;IALhB,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,MAAM,CAAsB;gBAG1B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,YAAY,EAC5B,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAKvC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAsB/B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAuBpC;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAoBnC;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAqB7B;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAU7B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAMpC;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAKvD;;OAEG;IACH,WAAW,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,eAAe,CAAA;KAAE,CAAC;IAOtE;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAMxB;;OAEG;IACH,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,WAAW;CAUpB"}