agent-inbox 0.0.1 → 0.1.1

package/dist/jsonrpc/mail-server.js

@@ -0,0 +1,284 @@
+import * as http from "node:http";
+import { ulid } from "ulid";
+export class MailJsonRpcServer {
+    storage;
+    router;
+    events;
+    methods = new Map();
+    httpServer = null;
+    subscribers = new Set();
+    constructor(storage, router, events) {
+        this.storage = storage;
+        this.router = router;
+        this.events = events;
+        this.registerMethods();
+        this.setupEventForwarding();
+    }
+    registerMethods() {
+        // mail/create — create a conversation
+        this.methods.set("mail/create", (params) => {
+            const now = new Date().toISOString();
+            const conv = {
+                id: params.id ?? `conv-${ulid()}`,
+                scope: params.scope ?? "default",
+                subject: params.subject,
+                status: "active",
+                participants: [],
+                metadata: params.metadata ?? {},
+                created_at: now,
+                updated_at: now,
+            };
+            this.storage.putConversation(conv);
+            return conv;
+        });
+        // mail/get — get conversation details
+        this.methods.set("mail/get", (params) => {
+            const conv = this.storage.getConversation(params.id);
+            if (!conv)
+                throw rpcError(-32001, "Conversation not found");
+            const turns = this.storage.getTurns(conv.id);
+            const threads = this.storage.getThreadsByConversation(conv.id);
+            return { conversation: conv, turns, threads };
+        });
+        // mail/list — list conversations
+        this.methods.set("mail/list", (params) => {
+            const conversations = this.storage.listConversations(params.scope);
+            return { conversations };
+        });
+        // mail/close — close a conversation
+        this.methods.set("mail/close", (params) => {
+            const conv = this.storage.getConversation(params.id);
+            if (!conv)
+                throw rpcError(-32001, "Conversation not found");
+            conv.status = "completed";
+            conv.updated_at = new Date().toISOString();
+            this.storage.putConversation(conv);
+            return { ok: true };
+        });
+        // mail/join — add self as participant
+        this.methods.set("mail/join", (params) => {
+            const conv = this.storage.getConversation(params.conversationId);
+            if (!conv)
+                throw rpcError(-32001, "Conversation not found");
+            const agentId = params.agentId;
+            if (!conv.participants.some((p) => p.agent_id === agentId)) {
+                conv.participants.push({
+                    agent_id: agentId,
+                    joined_at: new Date().toISOString(),
+                });
+                conv.updated_at = new Date().toISOString();
+                this.storage.putConversation(conv);
+            }
+            return { ok: true };
+        });
+        // mail/leave — remove self from conversation
+        this.methods.set("mail/leave", (params) => {
+            const conv = this.storage.getConversation(params.conversationId);
+            if (!conv)
+                throw rpcError(-32001, "Conversation not found");
+            const agentId = params.agentId;
+            conv.participants = conv.participants.filter((p) => p.agent_id !== agentId);
+            conv.updated_at = new Date().toISOString();
+            this.storage.putConversation(conv);
+            return { ok: true };
+        });
+        // mail/invite — add agent to conversation
+        this.methods.set("mail/invite", (params) => {
+            const conv = this.storage.getConversation(params.conversationId);
+            if (!conv)
+                throw rpcError(-32001, "Conversation not found");
+            const agentId = params.agentId;
+            if (!conv.participants.some((p) => p.agent_id === agentId)) {
+                conv.participants.push({
+                    agent_id: agentId,
+                    role: params.role,
+                    joined_at: new Date().toISOString(),
+                });
+                conv.updated_at = new Date().toISOString();
+                this.storage.putConversation(conv);
+            }
+            return { ok: true };
+        });
+        // mail/turn — add a turn to a conversation
+        this.methods.set("mail/turn", async (params) => {
+            const conv = this.storage.getConversation(params.conversationId);
+            if (!conv)
+                throw rpcError(-32001, "Conversation not found");
+            const turn = {
+                id: `turn-${ulid()}`,
+                conversation_id: conv.id,
+                participant_id: params.participantId,
+                source_message_id: params.sourceMessageId,
+                content_type: params.contentType ?? "text",
+                content: params.content,
+                thread_id: params.threadId,
+                in_reply_to: params.inReplyTo,
+                created_at: new Date().toISOString(),
+            };
+            this.storage.addTurn(turn);
+            conv.updated_at = turn.created_at;
+            this.storage.putConversation(conv);
+            return turn;
+        });
+        // mail/turns/list — list turns in a conversation
+        this.methods.set("mail/turns/list", (params) => {
+            const turns = this.storage.getTurns(params.conversationId);
+            return { turns };
+        });
+        // mail/thread/create — create a thread
+        this.methods.set("mail/thread/create", (params) => {
+            const thread = {
+                id: `thread-${ulid()}`,
+                conversation_id: params.conversationId,
+                root_turn_id: params.rootTurnId,
+                parent_thread_id: params.parentThreadId,
+                subject: params.subject,
+                created_at: new Date().toISOString(),
+            };
+            this.storage.putThread(thread);
+            return thread;
+        });
+        // mail/thread/list — list threads in a conversation
+        this.methods.set("mail/thread/list", (params) => {
+            const threads = this.storage.getThreadsByConversation(params.conversationId);
+            return { threads };
+        });
+        // mail/replay — replay conversation history (all turns, ordered)
+        this.methods.set("mail/replay", (params) => {
+            const conv = this.storage.getConversation(params.id);
+            if (!conv)
+                throw rpcError(-32001, "Conversation not found");
+            const turns = this.storage.getTurns(conv.id);
+            return {
+                conversation: conv,
+                turns,
+                threads: this.storage.getThreadsByConversation(conv.id),
+            };
+        });
+    }
+    /** Process a JSON-RPC request (used by both IPC and HTTP transports) */
+    async handleRequest(request) {
+        if (request.jsonrpc !== "2.0") {
+            return {
+                jsonrpc: "2.0",
+                id: request.id ?? null,
+                error: { code: -32600, message: "Invalid JSON-RPC version" },
+            };
+        }
+        const handler = this.methods.get(request.method);
+        if (!handler) {
+            return {
+                jsonrpc: "2.0",
+                id: request.id ?? null,
+                error: { code: -32601, message: `Method not found: ${request.method}` },
+            };
+        }
+        try {
+            const result = await handler(request.params ?? {});
+            return { jsonrpc: "2.0", id: request.id ?? null, result };
+        }
+        catch (err) {
+            if (isRpcError(err)) {
+                return {
+                    jsonrpc: "2.0",
+                    id: request.id ?? null,
+                    error: { code: err.code, message: err.message },
+                };
+            }
+            return {
+                jsonrpc: "2.0",
+                id: request.id ?? null,
+                error: { code: -32603, message: String(err) },
+            };
+        }
+    }
+    /** Start HTTP server for dashboard/external access */
+    async startHttp(port) {
+        return new Promise((resolve) => {
+            this.httpServer = http.createServer((req, res) => {
+                // SSE endpoint for map/subscribe
+                if (req.url === "/subscribe" && req.method === "GET") {
+                    this.handleSseSubscribe(res);
+                    return;
+                }
+                // JSON-RPC endpoint
+                if (req.method !== "POST") {
+                    res.writeHead(405, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({
+                        jsonrpc: "2.0",
+                        id: null,
+                        error: { code: -32600, message: "Method not allowed" },
+                    }));
+                    return;
+                }
+                let body = "";
+                req.on("data", (chunk) => {
+                    body += chunk;
+                });
+                req.on("end", async () => {
+                    try {
+                        const request = JSON.parse(body);
+                        const response = await this.handleRequest(request);
+                        res.writeHead(200, { "Content-Type": "application/json" });
+                        res.end(JSON.stringify(response));
+                    }
+                    catch {
+                        res.writeHead(400, { "Content-Type": "application/json" });
+                        res.end(JSON.stringify({
+                            jsonrpc: "2.0",
+                            id: null,
+                            error: { code: -32700, message: "Parse error" },
+                        }));
+                    }
+                });
+            });
+            this.httpServer.listen(port, () => resolve());
+        });
+    }
+    async stopHttp() {
+        // Close all SSE connections
+        for (const res of this.subscribers) {
+            res.end();
+        }
+        this.subscribers.clear();
+        return new Promise((resolve) => {
+            if (!this.httpServer)
+                return resolve();
+            this.httpServer.close(() => resolve());
+        });
+    }
+    /** SSE endpoint: stream events to subscribers */
+    handleSseSubscribe(res) {
+        res.writeHead(200, {
+            "Content-Type": "text/event-stream",
+            "Cache-Control": "no-cache",
+            Connection: "keep-alive",
+        });
+        res.write(":\n\n"); // SSE comment to establish connection
+        this.subscribers.add(res);
+        res.on("close", () => {
+            this.subscribers.delete(res);
+        });
+    }
+    /** Forward internal events to SSE subscribers */
+    setupEventForwarding() {
+        this.events.on("message.created", (msg) => {
+            this.broadcast("message.created", msg);
+        });
+    }
+    broadcast(eventType, data) {
+        const payload = `event: ${eventType}\ndata: ${JSON.stringify(data)}\n\n`;
+        for (const res of this.subscribers) {
+            res.write(payload);
+        }
+    }
+}
+function rpcError(code, message) {
+    const err = new Error(message);
+    err.code = code;
+    return err;
+}
+function isRpcError(err) {
+    return err instanceof Error && typeof err.code === "number";
+}
+//# sourceMappingURL=mail-server.js.map

package/dist/jsonrpc/mail-server.js.map

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

package/dist/map/map-client.d.ts

@@ -0,0 +1,91 @@
+import { EventEmitter } from "node:events";
+import type { Storage } from "../storage/interface.js";
+import type { MessageRouter } from "../router/message-router.js";
+import type { InboxConfig } from "../types.js";
+/**
+ * Wrapper around @multi-agent-protocol/sdk for Agent Inbox's MAP connection.
+ *
+ * The MAP SDK is an optional peer dependency. This client gracefully degrades
+ * to a no-op when the SDK is not installed.
+ */
+export declare class MapClient {
+    private storage;
+    private router;
+    private events;
+    private inboxJsonlPath?;
+    private conn;
+    private agentConnectionClass;
+    private externalConn;
+    constructor(storage: Storage, router: MessageRouter, events: EventEmitter, inboxJsonlPath?: string | undefined);
+    connect(config: NonNullable<InboxConfig["map"]>): Promise<boolean>;
+    /**
+     * Use an externally-created MAP connection instead of creating one.
+     * The caller owns the connection lifecycle — disconnect() will detach
+     * but not close it. Incoming messages are still routed into storage.
+     */
+    useConnection(conn: MapConnection): void;
+    disconnect(): Promise<void>;
+    sendViaMap(target: {
+        agentId?: string;
+        scope?: string;
+    }, payload: unknown): Promise<boolean>;
+    get connected(): boolean;
+    /**
+     * Get the underlying MAP connection, if connected.
+     * Returns the full AgentConnection instance from the SDK, exposing
+     * lifecycle methods (spawn, updateState, callExtension) beyond
+     * what Agent Inbox uses internally for messaging.
+     */
+    getConnection(): MapConnection | null;
+    /**
+     * Get the system name from the MAP connection, if available.
+     * This is used for Tier 2 system ID resolution (MAP systemInfo).
+     */
+    getSystemName(): string | undefined;
+    /**
+     * Get the AgentConnection class from the MAP SDK, if available.
+     * Used to inject the SDK into ConnectionManager for federation peer connections.
+     */
+    getAgentConnectionClass(): MapAgentConnectionClass | null;
+    /**
+     * Startup replay: query MAP server for messages received while offline.
+     * Compares MAP server's message history against local storage and ingests
+     * any missing messages. Falls back to trusting local storage if the query fails.
+     */
+    replayMissed(): Promise<number>;
+    private findExistingMessage;
+    private handleIncoming;
+    private appendToInboxJsonl;
+}
+export interface IncomingMapMessage {
+    from: string;
+    payload: unknown;
+    timestamp?: string;
+    meta?: {
+        priority?: string;
+        [key: string]: unknown;
+    };
+}
+export interface MapConnection {
+    send(to: {
+        agentId?: string;
+        scope?: string;
+    }, payload: unknown, meta?: Record<string, unknown>): Promise<void>;
+    onMessage(handler: (msg: IncomingMapMessage) => void): void;
+    disconnect(): Promise<void>;
+    spawn?(opts: {
+        agentId: string;
+        name?: string;
+        role?: string;
+        scopes?: string[];
+        metadata?: Record<string, unknown>;
+    }): Promise<unknown>;
+    updateState?(state: string): Promise<void>;
+    updateMetadata?(metadata: Record<string, unknown>): Promise<void>;
+    callExtension?(name: string, params: Record<string, unknown>): Promise<unknown>;
+    systemName?: string;
+}
+export interface MapAgentConnectionClass {
+    connect(server: string, opts: unknown): Promise<MapConnection>;
+}
+//# sourceMappingURL=map-client.d.ts.map

package/dist/map/map-client.d.ts.map

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

package/dist/map/map-client.js

@@ -0,0 +1,202 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { normalizeContent } from "../router/message-router.js";
+import { ulid } from "ulid";
+/**
+ * Wrapper around @multi-agent-protocol/sdk for Agent Inbox's MAP connection.
+ *
+ * The MAP SDK is an optional peer dependency. This client gracefully degrades
+ * to a no-op when the SDK is not installed.
+ */
+export class MapClient {
+    storage;
+    router;
+    events;
+    inboxJsonlPath;
+    conn = null;
+    agentConnectionClass = null;
+    externalConn = false;
+    constructor(storage, router, events, inboxJsonlPath) {
+        this.storage = storage;
+        this.router = router;
+        this.events = events;
+        this.inboxJsonlPath = inboxJsonlPath;
+    }
+    async connect(config) {
+        if (!config.enabled || !config.server)
+            return false;
+        let AgentConnection;
+        try {
+            // Dynamic import — optional peer dependency
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const sdk = await Function('return import("@multi-agent-protocol/sdk")')();
+            AgentConnection = sdk.AgentConnection;
+            this.agentConnectionClass = AgentConnection;
+        }
+        catch {
+            // MAP SDK not installed — standalone mode
+            return false;
+        }
+        try {
+            this.conn = await AgentConnection.connect(config.server, {
+                name: "agent-inbox",
+                role: "inbox",
+                scopes: [config.scope ?? "default"],
+                capabilities: { trajectory: { canReport: false } },
+                metadata: {
+                    systemId: config.systemId ?? "agent-inbox",
+                    type: "agent-inbox",
+                },
+                reconnection: {
+                    enabled: true,
+                    maxRetries: 5,
+                    baseDelayMs: 1000,
+                    maxDelayMs: 30000,
+                },
+            });
+            this.conn.onMessage((msg) => {
+                this.handleIncoming(msg);
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Use an externally-created MAP connection instead of creating one.
+     * The caller owns the connection lifecycle — disconnect() will detach
+     * but not close it. Incoming messages are still routed into storage.
+     */
+    useConnection(conn) {
+        this.conn = conn;
+        this.externalConn = true;
+        conn.onMessage((msg) => {
+            this.handleIncoming(msg);
+        });
+    }
+    async disconnect() {
+        if (this.conn) {
+            if (!this.externalConn) {
+                await this.conn.disconnect();
+            }
+            this.conn = null;
+        }
+    }
+    async sendViaMap(target, payload) {
+        if (!this.conn)
+            return false;
+        try {
+            await this.conn.send(target, payload);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    get connected() {
+        return this.conn !== null;
+    }
+    /**
+     * Get the underlying MAP connection, if connected.
+     * Returns the full AgentConnection instance from the SDK, exposing
+     * lifecycle methods (spawn, updateState, callExtension) beyond
+     * what Agent Inbox uses internally for messaging.
+     */
+    getConnection() {
+        return this.conn;
+    }
+    /**
+     * Get the system name from the MAP connection, if available.
+     * This is used for Tier 2 system ID resolution (MAP systemInfo).
+     */
+    getSystemName() {
+        if (!this.conn)
+            return undefined;
+        return this.conn.systemName;
+    }
+    /**
+     * Get the AgentConnection class from the MAP SDK, if available.
+     * Used to inject the SDK into ConnectionManager for federation peer connections.
+     */
+    getAgentConnectionClass() {
+        return this.agentConnectionClass;
+    }
+    /**
+     * Startup replay: query MAP server for messages received while offline.
+     * Compares MAP server's message history against local storage and ingests
+     * any missing messages. Falls back to trusting local storage if the query fails.
+     */
+    async replayMissed() {
+        if (!this.conn)
+            return 0;
+        try {
+            // Query MAP server for recent messages via extension
+            const result = await this.conn.callExtension?.("mail/recent", { limit: 200 });
+            if (!result || !Array.isArray(result.messages))
+                return 0;
+            let ingested = 0;
+            for (const msg of result.messages) {
+                // Check if we already have this message (by timestamp + sender dedup)
+                const existing = this.findExistingMessage(msg);
+                if (!existing) {
+                    this.handleIncoming(msg);
+                    ingested++;
+                }
+            }
+            return ingested;
+        }
+        catch {
+            // MAP server doesn't support mail/recent or query failed
+            // Fall back to trusting local storage
+            return 0;
+        }
+    }
+    findExistingMessage(msg) {
+        // Simple dedup: check if a message with the same sender and timestamp exists
+        if (!msg.timestamp)
+            return false;
+        const candidates = this.storage.searchMessages(msg.from);
+        return candidates.some((m) => m.sender_id === msg.from && m.created_at === msg.timestamp);
+    }
+    handleIncoming(msg) {
+        const now = new Date().toISOString();
+        const content = normalizeContent(msg.payload);
+        // Store as a message
+        const message = {
+            id: ulid(),
+            scope: "default",
+            sender_id: msg.from,
+            recipients: [],
+            content,
+            importance: msg.meta?.priority === "high" ? "high" : "normal",
+            metadata: msg.meta ?? {},
+            created_at: msg.timestamp ?? now,
+        };
+        this.storage.putMessage(message);
+        this.events.emit("message.created", message);
+        // Append to inbox.jsonl if configured
+        if (this.inboxJsonlPath) {
+            this.appendToInboxJsonl(msg);
+        }
+    }
+    appendToInboxJsonl(msg) {
+        if (!this.inboxJsonlPath)
+            return;
+        try {
+            const dir = path.dirname(this.inboxJsonlPath);
+            fs.mkdirSync(dir, { recursive: true });
+            const line = JSON.stringify({
+                from: msg.from,
+                timestamp: msg.timestamp ?? new Date().toISOString(),
+                payload: msg.payload,
+                meta: msg.meta,
+            });
+            fs.appendFileSync(this.inboxJsonlPath, line + "\n");
+        }
+        catch {
+            // Best-effort write
+        }
+    }
+}
+//# sourceMappingURL=map-client.js.map

package/dist/map/map-client.js.map

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

package/dist/mcp/mcp-server.d.ts

@@ -0,0 +1,23 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Storage } from "../storage/interface.js";
+import type { MessageRouter } from "../router/message-router.js";
+import type { WarmRegistry } from "../registry/warm-registry.js";
+export declare class InboxMcpServer {
+    private router;
+    private storage;
+    private defaultScope;
+    private mcp;
+    private registry;
+    constructor(router: MessageRouter, storage: Storage, defaultScope?: string);
+    /**
+     * Attach a warm registry for federation-aware agent registration.
+     */
+    setRegistry(registry: WarmRegistry): void;
+    private registerTools;
+    /** Auto-register an agent if not already known (lazy registration on first inbox check) */
+    private ensureAgent;
+    start(): Promise<void>;
+    /** Expose for testing — returns the underlying McpServer */
+    get server(): McpServer;
+}
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,qBAAa,cAAc;IAKvB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,YAAY;IANtB,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,QAAQ,CAA6B;gBAGnC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,OAAO,EAChB,YAAY,GAAE,MAAkB;IAU1C;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAIzC,OAAO,CAAC,aAAa;IA8MrB,2FAA2F;IAC3F,OAAO,CAAC,WAAW;IAuBb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,4DAA4D;IAC5D,IAAI,MAAM,IAAI,SAAS,CAEtB;CACF"}