agent-mailbox-core 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Core types for Agent Mailbox
+ */
+/** Message priority levels */
+export type Priority = "high" | "normal" | "low";
+/** Message delivery status */
+export type DeliveryStatus = "pending" | "delivered" | "read" | "acked" | "expired" | "dead";
+/** Configuration options for the mailbox */
+export interface MailboxConfig {
+    /** Path to SQLite database file. Defaults to ':memory:' */
+    dbPath?: string;
+    /** Default message TTL in seconds. Defaults to 86400 (24h) */
+    defaultTTL?: number;
+    /** Visibility timeout in seconds after message is fetched. Defaults to 300 (5min) */
+    visibilityTimeout?: number;
+    /** Max retry attempts before moving to DLQ. Defaults to 3 */
+    maxRetries?: number;
+    /** Max message body size in bytes. Defaults to 65536 (64KB) */
+    maxBodySize?: number;
+    /** Rate limit: max messages per agent per minute. Defaults to 60 */
+    rateLimitPerMinute?: number;
+    /** Enable WAL mode for better concurrency. Defaults to true */
+    walMode?: boolean;
+    /** Cleanup interval in seconds. 0 disables auto-cleanup. Defaults to 300 (5min) */
+    cleanupInterval?: number;
+}
+/** Resolved config with all defaults applied */
+export interface ResolvedConfig {
+    dbPath: string;
+    defaultTTL: number;
+    visibilityTimeout: number;
+    maxRetries: number;
+    maxBodySize: number;
+    rateLimitPerMinute: number;
+    walMode: boolean;
+    cleanupInterval: number;
+}
+/** A message in the mailbox */
+export interface Message {
+    id: number;
+    from_agent: string;
+    to_agent: string;
+    subject: string;
+    body: string;
+    thread_id: string;
+    priority: Priority;
+    status: DeliveryStatus;
+    ttl_seconds: number;
+    idempotency_key: string | null;
+    trace_id: string | null;
+    receive_count: number;
+    visible_after: string | null;
+    session_id: string;
+    created_at: string;
+    read_at: string | null;
+    ack_at: string | null;
+    expires_at: string;
+}
+/** Options for sending a message */
+export interface SendOptions {
+    from: string;
+    to: string;
+    subject: string;
+    body: string;
+    threadId?: string;
+    priority?: Priority;
+    ttlSeconds?: number;
+    idempotencyKey?: string;
+    traceId?: string;
+    sessionId?: string;
+}
+/** Options for reading inbox */
+export interface InboxOptions {
+    agent: string;
+    limit?: number;
+    includeRead?: boolean;
+}
+/** Options for searching messages */
+export interface SearchOptions {
+    query: string;
+    limit?: number;
+    agent?: string;
+}
+/** A conversation thread */
+export interface Thread {
+    id: string;
+    subject: string;
+    participants: string;
+    message_count: number;
+    unread_count: number;
+    last_message_at: string;
+}
+/** Result of sending a message */
+export interface SendResult {
+    messageId: number;
+    threadId: string;
+    idempotencyKey: string | null;
+}
+/** Dead letter entry */
+export interface DeadLetter {
+    id: number;
+    original_message_id: number;
+    from_agent: string;
+    to_agent: string;
+    subject: string;
+    body: string;
+    thread_id: string;
+    reason: string;
+    moved_at: string;
+}
+/** Metrics snapshot */
+export interface MailboxMetrics {
+    totalMessages: number;
+    pendingMessages: number;
+    deliveredMessages: number;
+    deadLetters: number;
+    activeThreads: number;
+    messagesPerAgent: Record<string, number>;
+    avgDeliveryTimeMs: number | null;
+}
+/** Agent info for registry */
+export interface AgentInfo {
+    name: string;
+    role?: string;
+    lastActive: string | null;
+    messageCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "agent-mailbox-core",
+  "version": "1.0.0",
+  "description": "Production-grade inter-agent messaging for multi-agent AI systems. SQLite-backed with FTS5 search, visibility timeouts, dead letter queues, typed payloads, and more.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./plugin": {
+      "import": "./dist/plugin.js",
+      "types": "./dist/plugin.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir dist --target bun && bun build ./src/plugin.ts --outdir dist --target bun && bun x tsc --emitDeclarationOnly --outDir dist",
+    "test": "bun test",
+    "lint": "bun x tsc --noEmit",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "agent",
+    "mailbox",
+    "multi-agent",
+    "messaging",
+    "sqlite",
+    "fts5",
+    "queue",
+    "ai",
+    "llm",
+    "opencode",
+    "plugin",
+    "inter-agent",
+    "communication"
+  ],
+  "author": "lleontor705",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lleontor705/agent-mailbox.git"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@opencode-ai/plugin": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.2.26",
+    "@types/bun": "^1.2.0",
+    "typescript": "^5.7.0"
+  }
+}