agent-inbox 0.0.1 → 0.1.1

package/dist/registry/warm-registry.js

@@ -0,0 +1,173 @@
+const DEFAULT_CONFIG = {
+    gracePeriodMs: 60_000,
+    retainExpiredMs: 3_600_000,
+    requeueOnReconnect: true,
+};
+/**
+ * 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 class WarmRegistry {
+    storage;
+    events;
+    entries = new Map();
+    config;
+    constructor(storage, events, config) {
+        this.storage = storage;
+        this.events = events;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * 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) {
+        const existing = this.entries.get(agent.agent_id);
+        if (existing && (existing.warmStatus === "active" || existing.warmStatus === "away")) {
+            return false; // ID conflict
+        }
+        // Clear any existing timers
+        if (existing) {
+            this.clearTimers(existing);
+        }
+        this.entries.set(agent.agent_id, {
+            agentId: agent.agent_id,
+            warmStatus: "active",
+        });
+        agent.status = "active";
+        this.storage.putAgent(agent);
+        this.events.emit("registry.registered", agent.agent_id);
+        return true;
+    }
+    /**
+     * Mark an agent as disconnected. Starts grace period timer.
+     */
+    disconnect(agentId) {
+        const entry = this.entries.get(agentId);
+        if (!entry || entry.warmStatus !== "active")
+            return false;
+        entry.warmStatus = "away";
+        entry.disconnectedAt = new Date().toISOString();
+        // Start grace period timer
+        entry.graceTimer = setTimeout(() => {
+            this.expire(agentId);
+        }, this.config.gracePeriodMs);
+        // Update storage
+        const agent = this.storage.getAgent(agentId);
+        if (agent) {
+            agent.status = "idle"; // Map "away" to "idle" in the existing AgentStatus type
+            this.storage.putAgent(agent);
+        }
+        this.events.emit("registry.disconnected", agentId);
+        return true;
+    }
+    /**
+     * Reconnect a previously disconnected agent.
+     * Cancels grace period and restores active status.
+     */
+    reconnect(agentId) {
+        const entry = this.entries.get(agentId);
+        if (!entry)
+            return false;
+        if (entry.warmStatus !== "away")
+            return false;
+        this.clearTimers(entry);
+        entry.warmStatus = "active";
+        entry.disconnectedAt = undefined;
+        const agent = this.storage.getAgent(agentId);
+        if (agent) {
+            agent.status = "active";
+            agent.last_active_at = new Date().toISOString();
+            this.storage.putAgent(agent);
+        }
+        this.events.emit("registry.reconnected", agentId);
+        return true;
+    }
+    /**
+     * Transition agent to expired. Not routable, but retained for audit.
+     */
+    expire(agentId) {
+        const entry = this.entries.get(agentId);
+        if (!entry)
+            return;
+        this.clearTimers(entry);
+        entry.warmStatus = "expired";
+        const agent = this.storage.getAgent(agentId);
+        if (agent) {
+            agent.status = "offline";
+            this.storage.putAgent(agent);
+        }
+        // Schedule cleanup after retainExpiredMs
+        entry.expireTimer = setTimeout(() => {
+            this.remove(agentId);
+        }, this.config.retainExpiredMs);
+        this.events.emit("registry.expired", agentId);
+    }
+    /**
+     * Fully remove an agent from the registry.
+     */
+    remove(agentId) {
+        const entry = this.entries.get(agentId);
+        if (entry) {
+            this.clearTimers(entry);
+            this.entries.delete(agentId);
+        }
+        this.storage.removeAgent(agentId);
+        this.events.emit("registry.removed", agentId);
+    }
+    /**
+     * Check if an agent is routable (active or away).
+     */
+    isRoutable(agentId) {
+        const entry = this.entries.get(agentId);
+        if (!entry)
+            return false;
+        return entry.warmStatus === "active" || entry.warmStatus === "away";
+    }
+    /**
+     * Get the warm status of an agent.
+     */
+    getStatus(agentId) {
+        const entry = this.entries.get(agentId);
+        return entry?.warmStatus ?? "unknown";
+    }
+    /**
+     * List all entries with their warm status.
+     */
+    listEntries() {
+        return Array.from(this.entries.values()).map((e) => ({
+            agentId: e.agentId,
+            warmStatus: e.warmStatus,
+        }));
+    }
+    /**
+     * List all routable agent IDs.
+     */
+    listRoutable() {
+        return Array.from(this.entries.values())
+            .filter((e) => e.warmStatus === "active" || e.warmStatus === "away")
+            .map((e) => e.agentId);
+    }
+    /**
+     * Clean up all timers. Call on shutdown.
+     */
+    destroy() {
+        for (const entry of this.entries.values()) {
+            this.clearTimers(entry);
+        }
+        this.entries.clear();
+    }
+    clearTimers(entry) {
+        if (entry.graceTimer) {
+            clearTimeout(entry.graceTimer);
+            entry.graceTimer = undefined;
+        }
+        if (entry.expireTimer) {
+            clearTimeout(entry.expireTimer);
+            entry.expireTimer = undefined;
+        }
+    }
+}
+//# sourceMappingURL=warm-registry.js.map

package/dist/registry/warm-registry.js.map

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

package/dist/router/message-router.d.ts

@@ -0,0 +1,44 @@
+import { EventEmitter } from "node:events";
+import type { Message, MessageContent, Recipient, RecipientKind, Importance } from "../types.js";
+import type { Storage } from "../storage/interface.js";
+import type { ConnectionManager } from "../federation/connection-manager.js";
+export interface SendOptions {
+    from: string;
+    to: string | string[] | {
+        agent_id: string;
+        kind?: RecipientKind;
+    }[];
+    payload: unknown;
+    scope?: string;
+    threadTag?: string;
+    inReplyTo?: string;
+    importance?: Importance;
+    conversationId?: string;
+    subject?: string;
+    metadata?: Record<string, unknown>;
+}
+export declare class MessageRouter {
+    private storage;
+    private events;
+    private defaultScope;
+    private federation;
+    constructor(storage: Storage, events: EventEmitter, defaultScope?: string);
+    /**
+     * Attach a federation connection manager for cross-system routing.
+     */
+    setFederation(federation: ConnectionManager): void;
+    routeMessage(opts: SendOptions): Promise<Message>;
+    markRead(messageId: string, agentId: string): boolean;
+    markAcknowledged(messageId: string, agentId: string): boolean;
+    resolveRecipients(to: string | string[] | {
+        agent_id: string;
+        kind?: RecipientKind;
+    }[]): Recipient[];
+    isLocal(agentId: string): boolean;
+    /**
+     * Get the federation connection manager (if attached).
+     */
+    getFederation(): ConnectionManager | null;
+}
+export declare function normalizeContent(payload: unknown): MessageContent;
+//# sourceMappingURL=message-router.d.ts.map

package/dist/router/message-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-router.d.ts","sourceRoot":"","sources":["../../src/router/message-router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,SAAS,EACT,aAAa,EACb,UAAU,EACX,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAG7E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,aAAa,CAAA;KAAE,EAAE,CAAC;IACrE,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,qBAAa,aAAa;IAItB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,YAAY;IALtB,OAAO,CAAC,UAAU,CAAkC;gBAG1C,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,YAAY,EACpB,YAAY,GAAE,MAAkB;IAG1C;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAI5C,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAmEvD,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAUrD,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAU7D,iBAAiB,CACf,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,aAAa,CAAA;KAAE,EAAE,GACnE,SAAS,EAAE;IAed,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAOjC;;OAEG;IACH,aAAa,IAAI,iBAAiB,GAAG,IAAI;CAG1C;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAajE"}

package/dist/router/message-router.js

@@ -0,0 +1,137 @@
+import { ulid } from "ulid";
+import { parseAddress, isRemoteAddress } from "../federation/address.js";
+export class MessageRouter {
+    storage;
+    events;
+    defaultScope;
+    federation = null;
+    constructor(storage, events, defaultScope = "default") {
+        this.storage = storage;
+        this.events = events;
+        this.defaultScope = defaultScope;
+    }
+    /**
+     * Attach a federation connection manager for cross-system routing.
+     */
+    setFederation(federation) {
+        this.federation = federation;
+    }
+    async routeMessage(opts) {
+        const recipients = this.resolveRecipients(opts.to);
+        const content = normalizeContent(opts.payload);
+        const scope = opts.scope ?? this.defaultScope;
+        const now = new Date().toISOString();
+        // If replying, inherit thread_tag and scope from the parent message
+        let threadTag = opts.threadTag;
+        let conversationId = opts.conversationId;
+        if (opts.inReplyTo) {
+            const parent = this.storage.getMessage(opts.inReplyTo);
+            if (parent) {
+                threadTag = threadTag ?? parent.thread_tag;
+                conversationId = conversationId ?? parent.conversation_id;
+            }
+        }
+        const message = {
+            id: ulid(),
+            scope,
+            sender_id: opts.from,
+            recipients,
+            subject: opts.subject,
+            content,
+            thread_tag: threadTag,
+            in_reply_to: opts.inReplyTo,
+            conversation_id: conversationId,
+            importance: opts.importance ?? "normal",
+            metadata: opts.metadata ?? {},
+            created_at: now,
+        };
+        // Mark local recipients as delivered; route remote ones via federation
+        for (const r of message.recipients) {
+            const addr = parseAddress(r.agent_id);
+            if (!isRemoteAddress(addr) && this.isLocal(r.agent_id)) {
+                r.delivered_at = now;
+            }
+        }
+        this.storage.putMessage(message);
+        // Update sender's last_active_at
+        const sender = this.storage.getAgent(opts.from);
+        if (sender) {
+            sender.last_active_at = now;
+            this.storage.putAgent(sender);
+        }
+        this.events.emit("message.created", message);
+        // Route remote recipients via federation
+        if (this.federation) {
+            const hasRemote = message.recipients.some((r) => isRemoteAddress(parseAddress(r.agent_id)));
+            if (hasRemote) {
+                // Fire-and-forget federation routing (results tracked via events)
+                this.federation.route(message).catch(() => {
+                    // Federation routing failures are handled by the delivery queue
+                });
+            }
+        }
+        return message;
+    }
+    markRead(messageId, agentId) {
+        const msg = this.storage.getMessage(messageId);
+        if (!msg)
+            return false;
+        const recipient = msg.recipients.find((r) => r.agent_id === agentId);
+        if (!recipient)
+            return false;
+        recipient.read_at = new Date().toISOString();
+        this.storage.putMessage(msg);
+        return true;
+    }
+    markAcknowledged(messageId, agentId) {
+        const msg = this.storage.getMessage(messageId);
+        if (!msg)
+            return false;
+        const recipient = msg.recipients.find((r) => r.agent_id === agentId);
+        if (!recipient)
+            return false;
+        recipient.ack_at = new Date().toISOString();
+        this.storage.putMessage(msg);
+        return true;
+    }
+    resolveRecipients(to) {
+        if (typeof to === "string") {
+            return [{ agent_id: to, kind: "to" }];
+        }
+        if (Array.isArray(to)) {
+            return to.map((item) => {
+                if (typeof item === "string") {
+                    return { agent_id: item, kind: "to" };
+                }
+                return { agent_id: item.agent_id, kind: item.kind ?? "to" };
+            });
+        }
+        return [{ agent_id: String(to), kind: "to" }];
+    }
+    isLocal(agentId) {
+        // Remote addresses are never local
+        const addr = parseAddress(agentId);
+        if (isRemoteAddress(addr))
+            return false;
+        return this.storage.getAgent(agentId) !== undefined;
+    }
+    /**
+     * Get the federation connection manager (if attached).
+     */
+    getFederation() {
+        return this.federation;
+    }
+}
+export function normalizeContent(payload) {
+    if (typeof payload === "string") {
+        return { type: "text", text: payload };
+    }
+    if (payload !== null &&
+        typeof payload === "object" &&
+        "type" in payload &&
+        typeof payload.type === "string") {
+        return payload;
+    }
+    return { type: "data", data: payload };
+}
+//# sourceMappingURL=message-router.js.map

package/dist/router/message-router.js.map

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

package/dist/storage/interface.d.ts

@@ -0,0 +1,31 @@
+import type { Agent, Message, Conversation, Turn, Thread } from "../types.js";
+export interface InboxQuery {
+    unreadOnly?: boolean;
+    limit?: number;
+    since?: string;
+}
+export interface ThreadQuery {
+    threadTag: string;
+    scope: string;
+}
+export interface Storage {
+    getAgent(agentId: string): Agent | undefined;
+    putAgent(agent: Agent): void;
+    listAgents(scope?: string): Agent[];
+    removeAgent(agentId: string): boolean;
+    getMessage(id: string): Message | undefined;
+    putMessage(message: Message): Message;
+    getInbox(agentId: string, opts?: InboxQuery): Message[];
+    getThread(query: ThreadQuery): Message[];
+    getSentMessages(agentId: string, limit?: number): Message[];
+    searchMessages(query: string, scope?: string): Message[];
+    getConversation(id: string): Conversation | undefined;
+    putConversation(conversation: Conversation): Conversation;
+    listConversations(scope?: string): Conversation[];
+    addTurn(turn: Turn): void;
+    getTurns(conversationId: string): Turn[];
+    getThread2(id: string): Thread | undefined;
+    putThread(thread: Thread): Thread;
+    getThreadsByConversation(conversationId: string): Thread[];
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/storage/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/storage/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,OAAO,EACP,YAAY,EACZ,IAAI,EACJ,MAAM,EACP,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,OAAO;IAEtB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAAC;IACpC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAGtC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAC5C,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,EAAE,CAAC;IACxD,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,EAAE,CAAC;IACzC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC;IAC5D,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC;IAGzD,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IACtD,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,YAAY,CAAC;IAC1D,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;IAGlD,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,EAAE,CAAC;IAGzC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC5D"}

package/dist/storage/interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interface.js.map

package/dist/storage/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/storage/interface.ts"],"names":[],"mappings":""}

package/dist/storage/memory.d.ts

@@ -0,0 +1,28 @@
+import type { Agent, Message, Conversation, Turn, Thread } from "../types.js";
+import type { Storage, InboxQuery, ThreadQuery } from "./interface.js";
+export declare class InMemoryStorage implements Storage {
+    private agents;
+    private messages;
+    private conversations;
+    private turns;
+    private threads;
+    getAgent(agentId: string): Agent | undefined;
+    putAgent(agent: Agent): void;
+    listAgents(scope?: string): Agent[];
+    removeAgent(agentId: string): boolean;
+    getMessage(id: string): Message | undefined;
+    putMessage(message: Message): Message;
+    getInbox(agentId: string, opts?: InboxQuery): Message[];
+    getThread(query: ThreadQuery): Message[];
+    getSentMessages(agentId: string, limit?: number): Message[];
+    searchMessages(query: string, scope?: string): Message[];
+    getConversation(id: string): Conversation | undefined;
+    putConversation(conversation: Conversation): Conversation;
+    listConversations(scope?: string): Conversation[];
+    addTurn(turn: Turn): void;
+    getTurns(conversationId: string): Turn[];
+    getThread2(id: string): Thread | undefined;
+    putThread(thread: Thread): Thread;
+    getThreadsByConversation(conversationId: string): Thread[];
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/storage/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/storage/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,OAAO,EACP,YAAY,EACZ,IAAI,EACJ,MAAM,EACP,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEvE,qBAAa,eAAgB,YAAW,OAAO;IAC7C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,OAAO,CAA6B;IAI5C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAI5C,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAI5B,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE;IAMnC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAMrC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI3C,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAKrC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,EAAE;IAcvD,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,EAAE;IAUxC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE;IAU3D,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE;IAoBxD,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIrD,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,YAAY;IAKzD,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE;IAQjD,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAIzB,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,EAAE;IAQxC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI1C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAKjC,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE;CAK3D"}

package/dist/storage/memory.js

@@ -0,0 +1,118 @@
+export class InMemoryStorage {
+    agents = new Map();
+    messages = new Map();
+    conversations = new Map();
+    turns = [];
+    threads = new Map();
+    // --- Agents ---
+    getAgent(agentId) {
+        return this.agents.get(agentId);
+    }
+    putAgent(agent) {
+        this.agents.set(agent.agent_id, agent);
+    }
+    listAgents(scope) {
+        const all = Array.from(this.agents.values());
+        if (!scope)
+            return all;
+        return all.filter((a) => a.scope === scope);
+    }
+    removeAgent(agentId) {
+        return this.agents.delete(agentId);
+    }
+    // --- Messages ---
+    getMessage(id) {
+        return this.messages.get(id);
+    }
+    putMessage(message) {
+        this.messages.set(message.id, message);
+        return message;
+    }
+    getInbox(agentId, opts) {
+        const results = [];
+        for (const msg of this.messages.values()) {
+            const recipient = msg.recipients.find((r) => r.agent_id === agentId);
+            if (!recipient)
+                continue;
+            if (opts?.unreadOnly && recipient.read_at)
+                continue;
+            if (opts?.since && msg.created_at < opts.since)
+                continue;
+            results.push(msg);
+        }
+        results.sort((a, b) => a.created_at.localeCompare(b.created_at));
+        if (opts?.limit)
+            return results.slice(0, opts.limit);
+        return results;
+    }
+    getThread(query) {
+        const results = [];
+        for (const msg of this.messages.values()) {
+            if (msg.thread_tag === query.threadTag && msg.scope === query.scope) {
+                results.push(msg);
+            }
+        }
+        return results.sort((a, b) => a.created_at.localeCompare(b.created_at));
+    }
+    getSentMessages(agentId, limit) {
+        const results = [];
+        for (const msg of this.messages.values()) {
+            if (msg.sender_id === agentId)
+                results.push(msg);
+        }
+        results.sort((a, b) => a.created_at.localeCompare(b.created_at));
+        if (limit)
+            return results.slice(0, limit);
+        return results;
+    }
+    searchMessages(query, scope) {
+        const lower = query.toLowerCase();
+        const results = [];
+        for (const msg of this.messages.values()) {
+            if (scope && msg.scope !== scope)
+                continue;
+            const text = msg.content.type === "text" ? msg.content.text : "";
+            const subject = msg.subject ?? "";
+            if (text.toLowerCase().includes(lower) ||
+                subject.toLowerCase().includes(lower)) {
+                results.push(msg);
+            }
+        }
+        return results.sort((a, b) => a.created_at.localeCompare(b.created_at));
+    }
+    // --- Conversations ---
+    getConversation(id) {
+        return this.conversations.get(id);
+    }
+    putConversation(conversation) {
+        this.conversations.set(conversation.id, conversation);
+        return conversation;
+    }
+    listConversations(scope) {
+        const all = Array.from(this.conversations.values());
+        if (!scope)
+            return all;
+        return all.filter((c) => c.scope === scope);
+    }
+    // --- Turns ---
+    addTurn(turn) {
+        this.turns.push(turn);
+    }
+    getTurns(conversationId) {
+        return this.turns
+            .filter((t) => t.conversation_id === conversationId)
+            .sort((a, b) => a.created_at.localeCompare(b.created_at));
+    }
+    // --- Threads ---
+    getThread2(id) {
+        return this.threads.get(id);
+    }
+    putThread(thread) {
+        this.threads.set(thread.id, thread);
+        return thread;
+    }
+    getThreadsByConversation(conversationId) {
+        return Array.from(this.threads.values()).filter((t) => t.conversation_id === conversationId);
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/storage/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/storage/memory.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,eAAe;IAClB,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAC;IAClC,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IACtC,aAAa,GAAG,IAAI,GAAG,EAAwB,CAAC;IAChD,KAAK,GAAW,EAAE,CAAC;IACnB,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE5C,iBAAiB;IAEjB,QAAQ,CAAC,OAAe;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,QAAQ,CAAC,KAAY;QACnB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,UAAU,CAAC,KAAc;QACvB,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK;YAAE,OAAO,GAAG,CAAC;QACvB,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,WAAW,CAAC,OAAe;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,mBAAmB;IAEnB,UAAU,CAAC,EAAU;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,UAAU,CAAC,OAAgB;QACzB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACvC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,QAAQ,CAAC,OAAe,EAAE,IAAiB;QACzC,MAAM,OAAO,GAAc,EAAE,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;YACrE,IAAI,CAAC,SAAS;gBAAE,SAAS;YACzB,IAAI,IAAI,EAAE,UAAU,IAAI,SAAS,CAAC,OAAO;gBAAE,SAAS;YACpD,IAAI,IAAI,EAAE,KAAK,IAAI,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,KAAK;gBAAE,SAAS;YACzD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QACjE,IAAI,IAAI,EAAE,KAAK;YAAE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACrD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,SAAS,CAAC,KAAkB;QAC1B,MAAM,OAAO,GAAc,EAAE,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,IAAI,GAAG,CAAC,UAAU,KAAK,KAAK,CAAC,SAAS,IAAI,GAAG,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC;gBACpE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,eAAe,CAAC,OAAe,EAAE,KAAc;QAC7C,MAAM,OAAO,GAAc,EAAE,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,IAAI,GAAG,CAAC,SAAS,KAAK,OAAO;gBAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QACjE,IAAI,KAAK;YAAE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC1C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,cAAc,CAAC,KAAa,EAAE,KAAc;QAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,OAAO,GAAc,EAAE,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,IAAI,KAAK,IAAI,GAAG,CAAC,KAAK,KAAK,KAAK;gBAAE,SAAS;YAC3C,MAAM,IAAI,GACR,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAE,GAAG,CAAC,OAA4B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5E,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;YAClC,IACE,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAClC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,EACrC,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,wBAAwB;IAExB,eAAe,CAAC,EAAU;QACxB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,eAAe,CAAC,YAA0B;QACxC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QACtD,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,iBAAiB,CAAC,KAAc;QAC9B,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK;YAAE,OAAO,GAAG,CAAC;QACvB,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,gBAAgB;IAEhB,OAAO,CAAC,IAAU;QAChB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,QAAQ,CAAC,cAAsB;QAC7B,OAAO,IAAI,CAAC,KAAK;aACd,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,KAAK,cAAc,CAAC;aACnD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,kBAAkB;IAElB,UAAU,CAAC,EAAU;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,SAAS,CAAC,MAAc;QACtB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACpC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,wBAAwB,CAAC,cAAsB;QAC7C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAC7C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,KAAK,cAAc,CAC5C,CAAC;IACJ,CAAC;CACF"}

package/dist/storage/sqlite.d.ts

@@ -0,0 +1,35 @@
+import type { Agent, Message, Conversation, Turn, Thread } from "../types.js";
+import type { Storage, InboxQuery, ThreadQuery } from "./interface.js";
+export interface SqliteStorageOptions {
+    path: string;
+}
+export declare class SqliteStorage implements Storage {
+    private db;
+    constructor(opts: SqliteStorageOptions);
+    private migrate;
+    getAgent(agentId: string): Agent | undefined;
+    putAgent(agent: Agent): void;
+    listAgents(scope?: string): Agent[];
+    removeAgent(agentId: string): boolean;
+    getMessage(id: string): Message | undefined;
+    putMessage(message: Message): Message;
+    getInbox(agentId: string, opts?: InboxQuery): Message[];
+    getThread(query: ThreadQuery): Message[];
+    getSentMessages(agentId: string, limit?: number): Message[];
+    searchMessages(query: string, scope?: string): Message[];
+    private searchMessagesLike;
+    getConversation(id: string): Conversation | undefined;
+    putConversation(conversation: Conversation): Conversation;
+    listConversations(scope?: string): Conversation[];
+    addTurn(turn: Turn): void;
+    getTurns(conversationId: string): Turn[];
+    getThread2(id: string): Thread | undefined;
+    putThread(thread: Thread): Thread;
+    getThreadsByConversation(conversationId: string): Thread[];
+    private getRecipients;
+    private getParticipants;
+    private rowToMessage;
+    private rowToConversation;
+    close(): void;
+}
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/storage/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/storage/sqlite.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,KAAK,EACL,OAAO,EACP,YAAY,EACZ,IAAI,EACJ,MAAM,EAIP,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEvE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,aAAc,YAAW,OAAO;IAC3C,OAAO,CAAC,EAAE,CAAoB;gBAElB,IAAI,EAAE,oBAAoB;IAOtC,OAAO,CAAC,OAAO;IAsIf,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAO5C,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAoB5B,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE;IASnC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IASrC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAQ3C,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IA6CrC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,EAAE;IAyBvD,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,EAAE;IASxC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE;IAW3D,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE;IA+BxD,OAAO,CAAC,kBAAkB;IAkB1B,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAQrD,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,YAAY;IA+BzD,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE;IAgBjD,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAoBzB,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,EAAE;IAWxC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAO1C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAkBjC,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE;IAS1D,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,iBAAiB;IAazB,KAAK,IAAI,IAAI;CAGd"}