agent-inbox 0.0.1 → 0.1.1

package/dist/index.js

@@ -1,19 +1,218 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-module.exports = __toCommonJS(index_exports);
+import { EventEmitter } from "node:events";
+import * as path from "node:path";
+import * as os from "node:os";
+import { InMemoryStorage } from "./storage/memory.js";
+import { SqliteStorage } from "./storage/sqlite.js";
+import { MessageRouter } from "./router/message-router.js";
+import { TraceabilityLayer } from "./traceability/traceability.js";
+import { IpcServer } from "./ipc/ipc-server.js";
+import { MapClient } from "./map/map-client.js";
+import { InboxMcpServer } from "./mcp/mcp-server.js";
+import { MailJsonRpcServer } from "./jsonrpc/mail-server.js";
+import { PushNotifier } from "./push/notifier.js";
+import { ConnectionManager } from "./federation/connection-manager.js";
+import { WarmRegistry } from "./registry/warm-registry.js";
+export { InMemoryStorage } from "./storage/memory.js";
+export { SqliteStorage } from "./storage/sqlite.js";
+export { MessageRouter, normalizeContent } from "./router/message-router.js";
+export { TraceabilityLayer } from "./traceability/traceability.js";
+export { IpcServer } from "./ipc/ipc-server.js";
+export { MapClient } from "./map/map-client.js";
+export { InboxMcpServer } from "./mcp/mcp-server.js";
+export { MailJsonRpcServer } from "./jsonrpc/mail-server.js";
+export { PushNotifier, formatInboxMarkdown } from "./push/notifier.js";
+export { ConnectionManager } from "./federation/connection-manager.js";
+export { WarmRegistry } from "./registry/warm-registry.js";
+export { RoutingEngine } from "./federation/routing-engine.js";
+export { DeliveryQueue } from "./federation/delivery-queue.js";
+export { TrustManager } from "./federation/trust.js";
+export { parseAddress, formatAddress, isRemoteAddress, isBroadcastAddress, } from "./federation/address.js";
+function defaultSocketPath() {
+    const home = os.homedir();
+    return path.join(home, ".claude", "agent-inbox", "inbox.sock");
+}
+function defaultInboxJsonlPath() {
+    const home = os.homedir();
+    return path.join(home, ".claude", "agent-inbox", "inbox.jsonl");
+}
+function defaultInboxDir() {
+    const home = os.homedir();
+    return path.join(home, ".claude", "agent-inbox", "inboxes");
+}
+function defaultSqlitePath() {
+    const home = os.homedir();
+    return path.join(home, ".claude", "agent-inbox", "inbox.db");
+}
+function loadConfig() {
+    return {
+        socketPath: process.env.INBOX_SOCKET_PATH ?? defaultSocketPath(),
+        scope: process.env.INBOX_SCOPE ?? "default",
+        map: {
+            enabled: process.env.INBOX_MAP_ENABLED === "true",
+            server: process.env.INBOX_MAP_SERVER,
+            scope: process.env.INBOX_MAP_SCOPE ?? process.env.INBOX_SCOPE ?? "default",
+            systemId: process.env.INBOX_MAP_SYSTEM_ID ?? "agent-inbox",
+        },
+    };
+}
+export async function createAgentInbox(opts = {}) {
+    const config = { ...loadConfig(), ...opts.config };
+    // 1. Storage — SQLite if path provided, otherwise in-memory
+    const storage = opts.sqlitePath
+        ? new SqliteStorage({ path: opts.sqlitePath })
+        : new InMemoryStorage();
+    // 2. Event bus (internal)
+    const events = new EventEmitter();
+    // 3. Message router
+    const router = new MessageRouter(storage, events, config.scope);
+    // 4. Traceability layer (subscribes to message.created events)
+    const traceability = new TraceabilityLayer(storage, events);
+    // 5. Push notifier (per-agent inbox files + webhooks)
+    const notifier = new PushNotifier({ inboxDir: defaultInboxDir(), webhooks: opts.webhooks }, storage, events);
+    // 6. MAP client (connects first to obtain SDK class for federation)
+    const mapClient = new MapClient(storage, router, events, defaultInboxJsonlPath());
+    if (opts.connection) {
+        // External connection — borrow it, don't manage its lifecycle
+        mapClient.useConnection(opts.connection);
+    }
+    else if (config.map?.enabled) {
+        const connected = await mapClient.connect(config.map);
+        if (connected) {
+            // Replay missed messages from MAP server
+            const replayed = await mapClient.replayMissed();
+            if (replayed > 0) {
+                console.error(`Replayed ${replayed} missed messages from MAP server`);
+            }
+        }
+    }
+    // 7. Federation (optional) — inject SDK class from MapClient if available
+    let federation = null;
+    let registry = null;
+    if (opts.enableFederation || config.federation?.peers?.length) {
+        registry = new WarmRegistry(storage, events, config.federation?.registry);
+        const sdkClass = mapClient.getAgentConnectionClass() ?? undefined;
+        federation = new ConnectionManager(events, config.federation, {
+            sdkClass,
+            onIncomingMessage: ({ from, peerId, payload, meta }) => {
+                // Delegate incoming federation messages to the router.
+                // The targetAgent in meta tells us which local agent this is for.
+                const targetAgent = meta?.targetAgent ?? from;
+                router.routeMessage({
+                    from: `${from}@${peerId}`,
+                    to: targetAgent,
+                    payload,
+                    scope: meta?.scope,
+                    subject: meta?.subject,
+                    importance: meta?.importance,
+                    threadTag: meta?.threadTag,
+                    inReplyTo: meta?.inReplyTo,
+                    metadata: meta,
+                }).catch((err) => {
+                    console.error(`Failed to route incoming federation message from ${from}@${peerId}: ${err instanceof Error ? err.message : err}`);
+                });
+            },
+        });
+        router.setFederation(federation);
+        // Tier 2 system ID resolution: update from MAP systemInfo if available
+        const mapSystemName = mapClient.getSystemName();
+        if (mapSystemName) {
+            federation.updateSystemIdFromMap(mapSystemName);
+        }
+        // Connect to configured federation peers
+        if (config.federation?.peers) {
+            for (const peer of config.federation.peers) {
+                try {
+                    await federation.federate(peer);
+                    console.error(`Federated with peer: ${peer.systemId} (${peer.url})`);
+                }
+                catch (err) {
+                    console.error(`Failed to federate with ${peer.systemId}: ${err instanceof Error ? err.message : err}`);
+                }
+            }
+        }
+        // Start delivery queue tick timer
+        federation.queue.startTicking();
+    }
+    // 8. JSON-RPC server (mail/* methods)
+    const jsonRpc = new MailJsonRpcServer(storage, router, events);
+    if (opts.httpPort && opts.httpPort > 0) {
+        await jsonRpc.startHttp(opts.httpPort);
+        console.error(`JSON-RPC HTTP server listening on port ${opts.httpPort}`);
+    }
+    // 9. IPC server (UNIX socket — handles both NDJSON commands and JSON-RPC inline)
+    const socketPath = config.socketPath ?? defaultSocketPath();
+    const ipcServer = new IpcServer(socketPath, router, storage, jsonRpc);
+    await ipcServer.start();
+    const stop = async () => {
+        await ipcServer.stop();
+        await jsonRpc.stopHttp();
+        await mapClient.disconnect();
+        if (federation)
+            await federation.destroy();
+        if (registry)
+            registry.destroy();
+        if ("close" in storage && typeof storage.close === "function") {
+            storage.close();
+        }
+    };
+    return {
+        storage,
+        router,
+        traceability,
+        ipcServer,
+        mapClient,
+        jsonRpc,
+        notifier,
+        federation,
+        registry,
+        events,
+        stop,
+    };
+}
+// CLI entry point
+const isMainModule = process.argv[1] &&
+    (process.argv[1].endsWith("/index.js") ||
+        process.argv[1].endsWith("/index.ts"));
+if (isMainModule) {
+    const mode = process.argv[2] ?? "ipc";
+    if (mode === "mcp") {
+        // MCP-only mode (stdio transport for Claude Code integration)
+        const config = loadConfig();
+        const sqlitePath = process.env.INBOX_SQLITE_PATH;
+        const storage = sqlitePath
+            ? new SqliteStorage({ path: sqlitePath })
+            : new InMemoryStorage();
+        const events = new EventEmitter();
+        const router = new MessageRouter(storage, events, config.scope);
+        const _traceability = new TraceabilityLayer(storage, events);
+        const mcpServer = new InboxMcpServer(router, storage, config.scope);
+        mcpServer.start().catch((err) => {
+            console.error("MCP server failed:", err);
+            process.exit(1);
+        });
+    }
+    else {
+        // IPC server mode (default)
+        const httpPort = process.env.INBOX_HTTP_PORT
+            ? parseInt(process.env.INBOX_HTTP_PORT, 10)
+            : 0;
+        const sqlitePath = process.env.INBOX_SQLITE_PATH;
+        createAgentInbox({ httpPort, sqlitePath })
+            .then((inbox) => {
+            console.error(`Agent Inbox IPC server listening on ${process.env.INBOX_SOCKET_PATH ?? defaultSocketPath()}`);
+            process.on("SIGINT", async () => {
+                await inbox.stop();
+                process.exit(0);
+            });
+            process.on("SIGTERM", async () => {
+                await inbox.stop();
+                process.exit(0);
+            });
+        })
+            .catch((err) => {
+            console.error("Failed to start Agent Inbox:", err);
+            process.exit(1);
+        });
+    }
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export {};\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,20 @@
+import type { IpcCommand, IpcResponse } from "../types.js";
+import type { Storage } from "../storage/interface.js";
+import type { MessageRouter } from "../router/message-router.js";
+import type { MailJsonRpcServer } from "../jsonrpc/mail-server.js";
+export declare class IpcServer {
+    private socketPath;
+    private router;
+    private storage;
+    private jsonRpc?;
+    private server;
+    constructor(socketPath: string, router: MessageRouter, storage: Storage, jsonRpc?: MailJsonRpcServer | undefined);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private handleConnection;
+    private processLine;
+    handleCommand(command: IpcCommand): Promise<IpcResponse>;
+    private handleSend;
+    private handleNotify;
+}
+//# sourceMappingURL=ipc-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ipc-server.d.ts","sourceRoot":"","sources":["../../src/ipc/ipc-server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,qBAAa,SAAS;IAIlB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO,CAAC;IANlB,OAAO,CAAC,MAAM,CAA2B;gBAG/B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,iBAAiB,YAAA;IAG/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B,OAAO,CAAC,gBAAgB;YA6BV,WAAW;IAqBnB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;YAoBhD,UAAU;IAoBxB,OAAO,CAAC,YAAY;CAkCrB"}

package/dist/ipc/ipc-server.js

@@ -0,0 +1,152 @@
+import * as net from "node:net";
+import * as fs from "node:fs";
+import * as path from "node:path";
+export class IpcServer {
+    socketPath;
+    router;
+    storage;
+    jsonRpc;
+    server = null;
+    constructor(socketPath, router, storage, jsonRpc) {
+        this.socketPath = socketPath;
+        this.router = router;
+        this.storage = storage;
+        this.jsonRpc = jsonRpc;
+    }
+    async start() {
+        // Clean up stale socket file
+        try {
+            fs.unlinkSync(this.socketPath);
+        }
+        catch {
+            // Doesn't exist, fine
+        }
+        // Ensure directory exists
+        const dir = path.dirname(this.socketPath);
+        fs.mkdirSync(dir, { recursive: true });
+        return new Promise((resolve, reject) => {
+            this.server = net.createServer((conn) => this.handleConnection(conn));
+            this.server.on("error", reject);
+            this.server.listen(this.socketPath, () => resolve());
+        });
+    }
+    async stop() {
+        return new Promise((resolve) => {
+            if (!this.server)
+                return resolve();
+            this.server.close(() => {
+                try {
+                    fs.unlinkSync(this.socketPath);
+                }
+                catch {
+                    // Already gone
+                }
+                resolve();
+            });
+        });
+    }
+    handleConnection(conn) {
+        let buffer = "";
+        conn.on("data", (data) => {
+            buffer += data.toString();
+            // Process complete lines (NDJSON)
+            let newlineIdx;
+            while ((newlineIdx = buffer.indexOf("\n")) !== -1) {
+                const line = buffer.slice(0, newlineIdx).trim();
+                buffer = buffer.slice(newlineIdx + 1);
+                if (!line)
+                    continue;
+                this.processLine(line)
+                    .then((response) => {
+                    conn.write(JSON.stringify(response) + "\n");
+                })
+                    .catch((err) => {
+                    conn.write(JSON.stringify({ ok: false, error: String(err) }) + "\n");
+                });
+            }
+        });
+        conn.on("error", () => {
+            // Client disconnected, ignore
+        });
+    }
+    async processLine(line) {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            return { ok: false, error: "Invalid JSON" };
+        }
+        // Detect JSON-RPC requests (have "jsonrpc" field) vs IPC commands (have "action" field)
+        if (parsed.jsonrpc === "2.0" && typeof parsed.method === "string") {
+            if (this.jsonRpc) {
+                return this.jsonRpc.handleRequest(parsed);
+            }
+            return { jsonrpc: "2.0", id: parsed.id ?? null, error: { code: -32603, message: "JSON-RPC not configured" } };
+        }
+        return this.handleCommand(parsed);
+    }
+    async handleCommand(command) {
+        switch (command.action) {
+            case "ping":
+                return { ok: true, pid: process.pid };
+            case "send":
+                return this.handleSend(command);
+            case "notify":
+                return this.handleNotify(command);
+            case "emit":
+                // For Phase 1, emit is acknowledged but not forwarded to MAP
+                return { ok: true };
+            default:
+                return { ok: false, error: `Unknown action: ${command.action}` };
+        }
+    }
+    async handleSend(command) {
+        try {
+            const message = await this.router.routeMessage({
+                from: command.from,
+                to: command.to,
+                payload: command.payload,
+                scope: command.scope,
+                threadTag: command.threadTag,
+                inReplyTo: command.inReplyTo,
+                importance: command.importance,
+                metadata: command.meta,
+            });
+            return { ok: true, messageId: message.id };
+        }
+        catch (err) {
+            return { ok: false, error: String(err) };
+        }
+    }
+    handleNotify(command) {
+        const event = command.event;
+        if (event.type === "agent.spawn" && event.agent) {
+            const now = new Date().toISOString();
+            const agent = {
+                agent_id: event.agent.agentId,
+                display_name: event.agent.name,
+                scope: event.agent.scopes?.[0] ?? "default",
+                status: "active",
+                metadata: event.agent.metadata ?? {},
+                registered_at: now,
+                last_active_at: now,
+            };
+            this.storage.putAgent(agent);
+            return { ok: true };
+        }
+        if (event.type === "agent.done") {
+            const agentId = event.agentId ?? event.agent?.agentId;
+            if (agentId) {
+                const agent = this.storage.getAgent(agentId);
+                if (agent) {
+                    agent.status = "offline";
+                    this.storage.putAgent(agent);
+                }
+            }
+            return { ok: true };
+        }
+        return { ok: true };
+    }
+}
+//# sourceMappingURL=ipc-server.js.map

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

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

package/dist/jsonrpc/mail-server.d.ts

@@ -0,0 +1,45 @@
+import { EventEmitter } from "node:events";
+import type { Storage } from "../storage/interface.js";
+import type { MessageRouter } from "../router/message-router.js";
+/**
+ * MAP mail/* JSON-RPC 2.0 endpoint.
+ * Serves over both UNIX socket (IPC inline) and HTTP (dashboard access).
+ */
+interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    id?: string | number | null;
+    method: string;
+    params?: Record<string, unknown>;
+}
+interface JsonRpcResponse {
+    jsonrpc: "2.0";
+    id: string | number | null;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export declare class MailJsonRpcServer {
+    private storage;
+    private router;
+    private events;
+    private methods;
+    private httpServer;
+    private subscribers;
+    constructor(storage: Storage, router: MessageRouter, events: EventEmitter);
+    private registerMethods;
+    /** Process a JSON-RPC request (used by both IPC and HTTP transports) */
+    handleRequest(request: JsonRpcRequest): Promise<JsonRpcResponse>;
+    /** Start HTTP server for dashboard/external access */
+    startHttp(port: number): Promise<void>;
+    stopHttp(): Promise<void>;
+    /** SSE endpoint: stream events to subscribers */
+    private handleSseSubscribe;
+    /** Forward internal events to SSE subscribers */
+    private setupEventForwarding;
+    private broadcast;
+}
+export {};
+//# sourceMappingURL=mail-server.d.ts.map

package/dist/jsonrpc/mail-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-server.d.ts","sourceRoot":"","sources":["../../src/jsonrpc/mail-server.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAIjE;;;GAGG;AAEH,UAAU,cAAc;IACtB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC3D;AAMD,qBAAa,iBAAiB;IAM1B,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;IAPhB,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,WAAW,CAAkC;gBAG3C,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,YAAY;IAM9B,OAAO,CAAC,eAAe;IAmKvB,wEAAwE;IAClE,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAqCtE,sDAAsD;IAChD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDtC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAa/B,iDAAiD;IACjD,OAAO,CAAC,kBAAkB;IAc1B,iDAAiD;IACjD,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,SAAS;CAMlB"}