agent-inbox 0.1.9 → 0.2.0

package/dist/cli.d.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for agent-inbox.
+ *
+ * Usage:
+ *   agent-inbox              # IPC server mode (default)
+ *   agent-inbox mcp          # MCP stdio server (standalone or proxy if INBOX_SOCKET_PATH set)
+ *   agent-inbox mcp-proxy    # MCP proxy to existing IPC socket
+ *
+ * Environment variables:
+ *   INBOX_SOCKET_PATH   — IPC socket path (also triggers proxy mode for `mcp`)
+ *   INBOX_SQLITE_PATH   — SQLite DB path (default: in-memory)
+ *   INBOX_SCOPE          — Message scope (default: "default")
+ *   INBOX_AGENT_ID       — Agent ID for proxy mode (default: "anonymous")
+ *   INBOX_HTTP_PORT      — HTTP port for JSON-RPC (0 = disabled)
+ *   INBOX_MAP_ENABLED    — Enable MAP transport ("true")
+ *   INBOX_MAP_SERVER     — MAP server URL
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/cli.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for agent-inbox.
+ *
+ * Usage:
+ *   agent-inbox              # IPC server mode (default)
+ *   agent-inbox mcp          # MCP stdio server (standalone or proxy if INBOX_SOCKET_PATH set)
+ *   agent-inbox mcp-proxy    # MCP proxy to existing IPC socket
+ *
+ * Environment variables:
+ *   INBOX_SOCKET_PATH   — IPC socket path (also triggers proxy mode for `mcp`)
+ *   INBOX_SQLITE_PATH   — SQLite DB path (default: in-memory)
+ *   INBOX_SCOPE          — Message scope (default: "default")
+ *   INBOX_AGENT_ID       — Agent ID for proxy mode (default: "anonymous")
+ *   INBOX_HTTP_PORT      — HTTP port for JSON-RPC (0 = disabled)
+ *   INBOX_MAP_ENABLED    — Enable MAP transport ("true")
+ *   INBOX_MAP_SERVER     — MAP server URL
+ */
+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 { InboxMcpServer } from "./mcp/mcp-server.js";
+function defaultSocketPath() {
+    return path.join(os.homedir(), ".claude", "agent-inbox", "inbox.sock");
+}
+const mode = process.argv[2] ?? "mcp";
+if (mode === "mcp-proxy" || (mode === "mcp" && process.env.INBOX_SOCKET_PATH)) {
+    // MCP proxy mode — forward tool calls to an existing inbox IPC socket
+    const { InboxMcpProxy } = await import("./mcp/mcp-proxy.js");
+    const socketPath = process.env.INBOX_SOCKET_PATH ?? defaultSocketPath();
+    const agentId = process.env.INBOX_AGENT_ID ?? "anonymous";
+    const scope = process.env.INBOX_SCOPE ?? "default";
+    console.error(`[agent-inbox] MCP proxy mode → ${socketPath} (agent: ${agentId})`);
+    const proxy = new InboxMcpProxy(socketPath, agentId, scope);
+    proxy.start().catch((err) => {
+        console.error("MCP proxy failed:", err);
+        process.exit(1);
+    });
+}
+else if (mode === "mcp") {
+    // MCP standalone mode — stdio transport, own storage
+    const scope = process.env.INBOX_SCOPE ?? "default";
+    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, scope);
+    const _traceability = new TraceabilityLayer(storage, events);
+    const mcpServer = new InboxMcpServer(router, storage, scope);
+    console.error("[agent-inbox] MCP standalone mode (stdio)");
+    mcpServer.start().catch((err) => {
+        console.error("MCP server failed:", err);
+        process.exit(1);
+    });
+}
+else if (mode === "ipc") {
+    const { createAgentInbox } = await import("./index.js");
+    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);
+    });
+}
+else {
+    console.error(`Unknown mode: ${mode}`);
+    console.error("Usage: agent-inbox [mcp|mcp-proxy|ipc]");
+    process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "agent-inbox",
-  "version": "0.1.9",
+  "version": "0.2.0",
   "description": "Agent Inbox — message routing, traceability, and MCP tools for multi-agent systems",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "bin": {
+    "agent-inbox": "dist/cli.js"
+  },
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",

package/src/cli.ts

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+
+/**
+ * CLI entry point for agent-inbox.
+ *
+ * Usage:
+ *   agent-inbox              # IPC server mode (default)
+ *   agent-inbox mcp          # MCP stdio server (standalone or proxy if INBOX_SOCKET_PATH set)
+ *   agent-inbox mcp-proxy    # MCP proxy to existing IPC socket
+ *
+ * Environment variables:
+ *   INBOX_SOCKET_PATH   — IPC socket path (also triggers proxy mode for `mcp`)
+ *   INBOX_SQLITE_PATH   — SQLite DB path (default: in-memory)
+ *   INBOX_SCOPE          — Message scope (default: "default")
+ *   INBOX_AGENT_ID       — Agent ID for proxy mode (default: "anonymous")
+ *   INBOX_HTTP_PORT      — HTTP port for JSON-RPC (0 = disabled)
+ *   INBOX_MAP_ENABLED    — Enable MAP transport ("true")
+ *   INBOX_MAP_SERVER     — MAP server URL
+ */
+
+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 { InboxMcpServer } from "./mcp/mcp-server.js";
+import type { Storage } from "./storage/interface.js";
+
+function defaultSocketPath(): string {
+  return path.join(os.homedir(), ".claude", "agent-inbox", "inbox.sock");
+}
+
+const mode = process.argv[2] ?? "mcp";
+
+if (mode === "mcp-proxy" || (mode === "mcp" && process.env.INBOX_SOCKET_PATH)) {
+  // MCP proxy mode — forward tool calls to an existing inbox IPC socket
+  const { InboxMcpProxy } = await import("./mcp/mcp-proxy.js");
+  const socketPath = process.env.INBOX_SOCKET_PATH ?? defaultSocketPath();
+  const agentId = process.env.INBOX_AGENT_ID ?? "anonymous";
+  const scope = process.env.INBOX_SCOPE ?? "default";
+  console.error(`[agent-inbox] MCP proxy mode → ${socketPath} (agent: ${agentId})`);
+  const proxy = new InboxMcpProxy(socketPath, agentId, scope);
+  proxy.start().catch((err) => {
+    console.error("MCP proxy failed:", err);
+    process.exit(1);
+  });
+} else if (mode === "mcp") {
+  // MCP standalone mode — stdio transport, own storage
+  const scope = process.env.INBOX_SCOPE ?? "default";
+  const sqlitePath = process.env.INBOX_SQLITE_PATH;
+  const storage: Storage = sqlitePath
+    ? new SqliteStorage({ path: sqlitePath })
+    : new InMemoryStorage();
+  const events = new EventEmitter();
+  const router = new MessageRouter(storage, events, scope);
+  const _traceability = new TraceabilityLayer(storage, events);
+  const mcpServer = new InboxMcpServer(router, storage, scope);
+  console.error("[agent-inbox] MCP standalone mode (stdio)");
+  mcpServer.start().catch((err) => {
+    console.error("MCP server failed:", err);
+    process.exit(1);
+  });
+} else if (mode === "ipc") {
+  const { createAgentInbox } = await import("./index.js");
+  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);
+    });
+} else {
+  console.error(`Unknown mode: ${mode}`);
+  console.error("Usage: agent-inbox [mcp|mcp-proxy|ipc]");
+  process.exit(1);
+}