agent-inbox 0.0.1 → 0.1.1

package/dist/storage/sqlite.js

@@ -0,0 +1,445 @@
+import Database from "better-sqlite3";
+export class SqliteStorage {
+    db;
+    constructor(opts) {
+        this.db = new Database(opts.path);
+        this.db.pragma("journal_mode = WAL");
+        this.db.pragma("foreign_keys = ON");
+        this.migrate();
+    }
+    migrate() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS agents (
+        agent_id TEXT PRIMARY KEY,
+        display_name TEXT,
+        program TEXT,
+        model TEXT,
+        scope TEXT NOT NULL DEFAULT 'default',
+        status TEXT NOT NULL DEFAULT 'active',
+        metadata TEXT NOT NULL DEFAULT '{}',
+        registered_at TEXT NOT NULL,
+        last_active_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS messages (
+        id TEXT PRIMARY KEY,
+        scope TEXT NOT NULL DEFAULT 'default',
+        sender_id TEXT NOT NULL,
+        subject TEXT,
+        content TEXT NOT NULL,
+        thread_tag TEXT,
+        in_reply_to TEXT,
+        conversation_id TEXT,
+        importance TEXT NOT NULL DEFAULT 'normal',
+        metadata TEXT NOT NULL DEFAULT '{}',
+        created_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS recipients (
+        message_id TEXT NOT NULL,
+        agent_id TEXT NOT NULL,
+        kind TEXT NOT NULL DEFAULT 'to',
+        delivered_at TEXT,
+        read_at TEXT,
+        ack_at TEXT,
+        PRIMARY KEY (message_id, agent_id),
+        FOREIGN KEY (message_id) REFERENCES messages(id)
+      );
+
+      CREATE TABLE IF NOT EXISTS conversations (
+        id TEXT PRIMARY KEY,
+        scope TEXT NOT NULL DEFAULT 'default',
+        subject TEXT,
+        status TEXT NOT NULL DEFAULT 'active',
+        metadata TEXT NOT NULL DEFAULT '{}',
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS participants (
+        conversation_id TEXT NOT NULL,
+        agent_id TEXT NOT NULL,
+        role TEXT,
+        joined_at TEXT NOT NULL,
+        PRIMARY KEY (conversation_id, agent_id),
+        FOREIGN KEY (conversation_id) REFERENCES conversations(id)
+      );
+
+      CREATE TABLE IF NOT EXISTS turns (
+        id TEXT PRIMARY KEY,
+        conversation_id TEXT NOT NULL,
+        participant_id TEXT NOT NULL,
+        source_message_id TEXT,
+        content_type TEXT NOT NULL,
+        content TEXT NOT NULL,
+        thread_id TEXT,
+        in_reply_to TEXT,
+        created_at TEXT NOT NULL,
+        FOREIGN KEY (conversation_id) REFERENCES conversations(id)
+      );
+
+      CREATE TABLE IF NOT EXISTS threads (
+        id TEXT PRIMARY KEY,
+        conversation_id TEXT NOT NULL,
+        root_turn_id TEXT NOT NULL,
+        parent_thread_id TEXT,
+        subject TEXT,
+        created_at TEXT NOT NULL,
+        FOREIGN KEY (conversation_id) REFERENCES conversations(id)
+      );
+
+      -- Indexes for common queries
+      CREATE INDEX IF NOT EXISTS idx_messages_scope ON messages(scope);
+      CREATE INDEX IF NOT EXISTS idx_messages_sender ON messages(sender_id);
+      CREATE INDEX IF NOT EXISTS idx_messages_thread_tag ON messages(thread_tag, scope);
+      CREATE INDEX IF NOT EXISTS idx_messages_conversation ON messages(conversation_id);
+      CREATE INDEX IF NOT EXISTS idx_messages_created ON messages(created_at);
+      CREATE INDEX IF NOT EXISTS idx_recipients_agent ON recipients(agent_id);
+      CREATE INDEX IF NOT EXISTS idx_turns_conversation ON turns(conversation_id);
+      CREATE INDEX IF NOT EXISTS idx_agents_scope ON agents(scope);
+
+      -- FTS5 virtual table for full-text search
+      CREATE VIRTUAL TABLE IF NOT EXISTS messages_fts USING fts5(
+        id UNINDEXED,
+        subject,
+        text_content,
+        content='messages',
+        content_rowid='rowid'
+      );
+
+      -- Triggers to keep FTS in sync
+      CREATE TRIGGER IF NOT EXISTS messages_ai AFTER INSERT ON messages BEGIN
+        INSERT INTO messages_fts(rowid, id, subject, text_content)
+        VALUES (NEW.rowid, NEW.id, NEW.subject,
+          CASE WHEN json_extract(NEW.content, '$.type') = 'text'
+               THEN json_extract(NEW.content, '$.text')
+               ELSE '' END);
+      END;
+
+      CREATE TRIGGER IF NOT EXISTS messages_ad AFTER DELETE ON messages BEGIN
+        INSERT INTO messages_fts(messages_fts, rowid, id, subject, text_content)
+        VALUES ('delete', OLD.rowid, OLD.id, OLD.subject,
+          CASE WHEN json_extract(OLD.content, '$.type') = 'text'
+               THEN json_extract(OLD.content, '$.text')
+               ELSE '' END);
+      END;
+
+      CREATE TRIGGER IF NOT EXISTS messages_au AFTER UPDATE ON messages BEGIN
+        INSERT INTO messages_fts(messages_fts, rowid, id, subject, text_content)
+        VALUES ('delete', OLD.rowid, OLD.id, OLD.subject,
+          CASE WHEN json_extract(OLD.content, '$.type') = 'text'
+               THEN json_extract(OLD.content, '$.text')
+               ELSE '' END);
+        INSERT INTO messages_fts(rowid, id, subject, text_content)
+        VALUES (NEW.rowid, NEW.id, NEW.subject,
+          CASE WHEN json_extract(NEW.content, '$.type') = 'text'
+               THEN json_extract(NEW.content, '$.text')
+               ELSE '' END);
+      END;
+    `);
+    }
+    // --- Agents ---
+    getAgent(agentId) {
+        const row = this.db
+            .prepare("SELECT * FROM agents WHERE agent_id = ?")
+            .get(agentId);
+        return row ? rowToAgent(row) : undefined;
+    }
+    putAgent(agent) {
+        this.db
+            .prepare(`INSERT OR REPLACE INTO agents
+         (agent_id, display_name, program, model, scope, status, metadata, registered_at, last_active_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(agent.agent_id, agent.display_name ?? null, agent.program ?? null, agent.model ?? null, agent.scope, agent.status, JSON.stringify(agent.metadata), agent.registered_at, agent.last_active_at);
+    }
+    listAgents(scope) {
+        if (scope) {
+            return this.db.prepare("SELECT * FROM agents WHERE scope = ?").all(scope).map(rowToAgent);
+        }
+        return this.db.prepare("SELECT * FROM agents").all().map(rowToAgent);
+    }
+    removeAgent(agentId) {
+        const result = this.db
+            .prepare("DELETE FROM agents WHERE agent_id = ?")
+            .run(agentId);
+        return result.changes > 0;
+    }
+    // --- Messages ---
+    getMessage(id) {
+        const row = this.db
+            .prepare("SELECT * FROM messages WHERE id = ?")
+            .get(id);
+        if (!row)
+            return undefined;
+        return this.rowToMessage(row);
+    }
+    putMessage(message) {
+        const upsertMsg = this.db.prepare(`INSERT OR REPLACE INTO messages
+       (id, scope, sender_id, subject, content, thread_tag, in_reply_to, conversation_id, importance, metadata, created_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+        const upsertRecipient = this.db.prepare(`INSERT OR REPLACE INTO recipients
+       (message_id, agent_id, kind, delivered_at, read_at, ack_at)
+       VALUES (?, ?, ?, ?, ?, ?)`);
+        this.db.transaction(() => {
+            upsertMsg.run(message.id, message.scope, message.sender_id, message.subject ?? null, JSON.stringify(message.content), message.thread_tag ?? null, message.in_reply_to ?? null, message.conversation_id ?? null, message.importance, JSON.stringify(message.metadata), message.created_at);
+            // Delete old recipients and re-insert
+            this.db
+                .prepare("DELETE FROM recipients WHERE message_id = ?")
+                .run(message.id);
+            for (const r of message.recipients) {
+                upsertRecipient.run(message.id, r.agent_id, r.kind, r.delivered_at ?? null, r.read_at ?? null, r.ack_at ?? null);
+            }
+        })();
+        return message;
+    }
+    getInbox(agentId, opts) {
+        let sql = `
+      SELECT m.* FROM messages m
+      JOIN recipients r ON r.message_id = m.id
+      WHERE r.agent_id = ?
+    `;
+        const params = [agentId];
+        if (opts?.unreadOnly) {
+            sql += " AND r.read_at IS NULL";
+        }
+        if (opts?.since) {
+            sql += " AND m.created_at >= ?";
+            params.push(opts.since);
+        }
+        sql += " ORDER BY m.created_at ASC";
+        if (opts?.limit) {
+            sql += " LIMIT ?";
+            params.push(opts.limit);
+        }
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map((row) => this.rowToMessage(row));
+    }
+    getThread(query) {
+        const rows = this.db
+            .prepare("SELECT * FROM messages WHERE thread_tag = ? AND scope = ? ORDER BY created_at ASC")
+            .all(query.threadTag, query.scope);
+        return rows.map((row) => this.rowToMessage(row));
+    }
+    getSentMessages(agentId, limit) {
+        let sql = "SELECT * FROM messages WHERE sender_id = ? ORDER BY created_at ASC";
+        const params = [agentId];
+        if (limit) {
+            sql += " LIMIT ?";
+            params.push(limit);
+        }
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map((row) => this.rowToMessage(row));
+    }
+    searchMessages(query, scope) {
+        let sql;
+        let params;
+        if (scope) {
+            sql = `
+        SELECT m.* FROM messages m
+        JOIN messages_fts fts ON fts.id = m.id
+        WHERE messages_fts MATCH ? AND m.scope = ?
+        ORDER BY m.created_at ASC
+      `;
+            params = [query, scope];
+        }
+        else {
+            sql = `
+        SELECT m.* FROM messages m
+        JOIN messages_fts fts ON fts.id = m.id
+        WHERE messages_fts MATCH ?
+        ORDER BY m.created_at ASC
+      `;
+            params = [query];
+        }
+        try {
+            const rows = this.db.prepare(sql).all(...params);
+            return rows.map((row) => this.rowToMessage(row));
+        }
+        catch {
+            // FTS query syntax error — fall back to LIKE
+            return this.searchMessagesLike(query, scope);
+        }
+    }
+    searchMessagesLike(query, scope) {
+        const pattern = `%${query}%`;
+        let sql = `
+      SELECT * FROM messages
+      WHERE (subject LIKE ? OR content LIKE ?)
+    `;
+        const params = [pattern, pattern];
+        if (scope) {
+            sql += " AND scope = ?";
+            params.push(scope);
+        }
+        sql += " ORDER BY created_at ASC";
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map((row) => this.rowToMessage(row));
+    }
+    // --- Conversations ---
+    getConversation(id) {
+        const row = this.db
+            .prepare("SELECT * FROM conversations WHERE id = ?")
+            .get(id);
+        if (!row)
+            return undefined;
+        return this.rowToConversation(row);
+    }
+    putConversation(conversation) {
+        this.db.transaction(() => {
+            this.db
+                .prepare(`INSERT OR REPLACE INTO conversations
+           (id, scope, subject, status, metadata, created_at, updated_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?)`)
+                .run(conversation.id, conversation.scope, conversation.subject ?? null, conversation.status, JSON.stringify(conversation.metadata), conversation.created_at, conversation.updated_at);
+            // Re-sync participants
+            this.db
+                .prepare("DELETE FROM participants WHERE conversation_id = ?")
+                .run(conversation.id);
+            const insertP = this.db.prepare(`INSERT INTO participants (conversation_id, agent_id, role, joined_at) VALUES (?, ?, ?, ?)`);
+            for (const p of conversation.participants) {
+                insertP.run(conversation.id, p.agent_id, p.role ?? null, p.joined_at);
+            }
+        })();
+        return conversation;
+    }
+    listConversations(scope) {
+        let rows;
+        if (scope) {
+            rows = this.db
+                .prepare("SELECT * FROM conversations WHERE scope = ? ORDER BY updated_at DESC")
+                .all(scope);
+        }
+        else {
+            rows = this.db
+                .prepare("SELECT * FROM conversations ORDER BY updated_at DESC")
+                .all();
+        }
+        return rows.map((row) => this.rowToConversation(row));
+    }
+    // --- Turns ---
+    addTurn(turn) {
+        this.db
+            .prepare(`INSERT INTO turns
+         (id, conversation_id, participant_id, source_message_id, content_type, content, thread_id, in_reply_to, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(turn.id, turn.conversation_id, turn.participant_id, turn.source_message_id ?? null, turn.content_type, JSON.stringify(turn.content), turn.thread_id ?? null, turn.in_reply_to ?? null, turn.created_at);
+    }
+    getTurns(conversationId) {
+        const rows = this.db
+            .prepare("SELECT * FROM turns WHERE conversation_id = ? ORDER BY created_at ASC")
+            .all(conversationId);
+        return rows.map(rowToTurn);
+    }
+    // --- Threads ---
+    getThread2(id) {
+        const row = this.db
+            .prepare("SELECT * FROM threads WHERE id = ?")
+            .get(id);
+        return row ? rowToThread(row) : undefined;
+    }
+    putThread(thread) {
+        this.db
+            .prepare(`INSERT OR REPLACE INTO threads
+         (id, conversation_id, root_turn_id, parent_thread_id, subject, created_at)
+         VALUES (?, ?, ?, ?, ?, ?)`)
+            .run(thread.id, thread.conversation_id, thread.root_turn_id, thread.parent_thread_id ?? null, thread.subject ?? null, thread.created_at);
+        return thread;
+    }
+    getThreadsByConversation(conversationId) {
+        const rows = this.db
+            .prepare("SELECT * FROM threads WHERE conversation_id = ?")
+            .all(conversationId);
+        return rows.map(rowToThread);
+    }
+    // --- Helpers ---
+    getRecipients(messageId) {
+        const rows = this.db
+            .prepare("SELECT * FROM recipients WHERE message_id = ?")
+            .all(messageId);
+        return rows.map((r) => ({
+            agent_id: r.agent_id,
+            kind: r.kind,
+            delivered_at: r.delivered_at ?? undefined,
+            read_at: r.read_at ?? undefined,
+            ack_at: r.ack_at ?? undefined,
+        }));
+    }
+    getParticipants(conversationId) {
+        const rows = this.db
+            .prepare("SELECT * FROM participants WHERE conversation_id = ?")
+            .all(conversationId);
+        return rows.map((r) => ({
+            agent_id: r.agent_id,
+            role: r.role ?? undefined,
+            joined_at: r.joined_at,
+        }));
+    }
+    rowToMessage(row) {
+        return {
+            id: row.id,
+            scope: row.scope,
+            sender_id: row.sender_id,
+            recipients: this.getRecipients(row.id),
+            subject: row.subject ?? undefined,
+            content: JSON.parse(row.content),
+            thread_tag: row.thread_tag ?? undefined,
+            in_reply_to: row.in_reply_to ?? undefined,
+            conversation_id: row.conversation_id ?? undefined,
+            importance: row.importance,
+            metadata: JSON.parse(row.metadata),
+            created_at: row.created_at,
+        };
+    }
+    rowToConversation(row) {
+        return {
+            id: row.id,
+            scope: row.scope,
+            subject: row.subject ?? undefined,
+            status: row.status,
+            participants: this.getParticipants(row.id),
+            metadata: JSON.parse(row.metadata),
+            created_at: row.created_at,
+            updated_at: row.updated_at,
+        };
+    }
+    close() {
+        this.db.close();
+    }
+}
+function rowToAgent(row) {
+    return {
+        agent_id: row.agent_id,
+        display_name: row.display_name ?? undefined,
+        program: row.program ?? undefined,
+        model: row.model ?? undefined,
+        scope: row.scope,
+        status: row.status,
+        metadata: JSON.parse(row.metadata),
+        registered_at: row.registered_at,
+        last_active_at: row.last_active_at,
+    };
+}
+function rowToTurn(row) {
+    return {
+        id: row.id,
+        conversation_id: row.conversation_id,
+        participant_id: row.participant_id,
+        source_message_id: row.source_message_id ?? undefined,
+        content_type: row.content_type,
+        content: JSON.parse(row.content),
+        thread_id: row.thread_id ?? undefined,
+        in_reply_to: row.in_reply_to ?? undefined,
+        created_at: row.created_at,
+    };
+}
+function rowToThread(row) {
+    return {
+        id: row.id,
+        conversation_id: row.conversation_id,
+        root_turn_id: row.root_turn_id,
+        parent_thread_id: row.parent_thread_id ?? undefined,
+        subject: row.subject ?? undefined,
+        created_at: row.created_at,
+    };
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/storage/sqlite.js.map

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

package/dist/traceability/traceability.d.ts

@@ -0,0 +1,29 @@
+import { EventEmitter } from "node:events";
+import type { Storage } from "../storage/interface.js";
+/**
+ * Auto-creates Conversations, Turns, and Threads from messaging events.
+ *
+ * Rules:
+ * 1. Message with conversationId → add Turn to that Conversation
+ * 2. Message with thread_tag, no conversationId → find/create Conversation for thread_tag+scope
+ * 3. Message with neither → add Turn to catch-all Conversation for scope
+ * 4. Reply (in_reply_to) → create Thread if not exists, link Turn
+ */
+export declare class TraceabilityLayer {
+    private storage;
+    /** Maps "thread_tag:scope" → conversation ID */
+    private tagToConversation;
+    /** Maps scope → catch-all conversation ID */
+    private scopeCatchAll;
+    /** Maps original message ID → thread ID (for reply chains) */
+    private replyChainToThread;
+    constructor(storage: Storage, events: EventEmitter);
+    private onMessage;
+    private resolveConversation;
+    private createConversation;
+    private ensureParticipant;
+    private resolveThread;
+    private findRootMessage;
+    private findTurnForMessage;
+}
+//# sourceMappingURL=traceability.d.ts.map

package/dist/traceability/traceability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceability.d.ts","sourceRoot":"","sources":["../../src/traceability/traceability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAS1B,OAAO,CAAC,OAAO;IARjB,gDAAgD;IAChD,OAAO,CAAC,iBAAiB,CAA6B;IACtD,6CAA6C;IAC7C,OAAO,CAAC,aAAa,CAA6B;IAClD,8DAA8D;IAC9D,OAAO,CAAC,kBAAkB,CAA6B;gBAG7C,OAAO,EAAE,OAAO,EACxB,MAAM,EAAE,YAAY;IAKtB,OAAO,CAAC,SAAS;IA6CjB,OAAO,CAAC,mBAAmB;IAoC3B,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,aAAa;IA0BrB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,kBAAkB;CAS3B"}

package/dist/traceability/traceability.js

@@ -0,0 +1,150 @@
+import { ulid } from "ulid";
+/**
+ * Auto-creates Conversations, Turns, and Threads from messaging events.
+ *
+ * Rules:
+ * 1. Message with conversationId → add Turn to that Conversation
+ * 2. Message with thread_tag, no conversationId → find/create Conversation for thread_tag+scope
+ * 3. Message with neither → add Turn to catch-all Conversation for scope
+ * 4. Reply (in_reply_to) → create Thread if not exists, link Turn
+ */
+export class TraceabilityLayer {
+    storage;
+    /** Maps "thread_tag:scope" → conversation ID */
+    tagToConversation = new Map();
+    /** Maps scope → catch-all conversation ID */
+    scopeCatchAll = new Map();
+    /** Maps original message ID → thread ID (for reply chains) */
+    replyChainToThread = new Map();
+    constructor(storage, events) {
+        this.storage = storage;
+        events.on("message.created", (msg) => this.onMessage(msg));
+    }
+    onMessage(message) {
+        const conversationId = this.resolveConversation(message);
+        // Update message's conversation_id if not already set
+        if (!message.conversation_id) {
+            message.conversation_id = conversationId;
+            this.storage.putMessage(message);
+        }
+        // Ensure sender is a participant
+        this.ensureParticipant(conversationId, message.sender_id);
+        // Ensure recipients are participants
+        for (const r of message.recipients) {
+            this.ensureParticipant(conversationId, r.agent_id);
+        }
+        // Create Turn
+        const turn = {
+            id: `turn-${ulid()}`,
+            conversation_id: conversationId,
+            participant_id: message.sender_id,
+            source_message_id: message.id,
+            content_type: message.content.type,
+            content: message.content,
+            created_at: message.created_at,
+        };
+        // Handle reply threading
+        if (message.in_reply_to) {
+            const threadId = this.resolveThread(message, conversationId, turn.id);
+            turn.thread_id = threadId;
+            turn.in_reply_to = this.findTurnForMessage(message.in_reply_to);
+        }
+        this.storage.addTurn(turn);
+        // Update conversation updated_at
+        const conv = this.storage.getConversation(conversationId);
+        if (conv) {
+            conv.updated_at = message.created_at;
+            this.storage.putConversation(conv);
+        }
+    }
+    resolveConversation(message) {
+        // 1. Explicit conversation ID
+        if (message.conversation_id) {
+            const existing = this.storage.getConversation(message.conversation_id);
+            if (existing)
+                return existing.id;
+            // Create it if it doesn't exist
+            return this.createConversation(message.scope, message.subject, message.conversation_id);
+        }
+        // 2. thread_tag → conversation
+        if (message.thread_tag) {
+            const key = `${message.thread_tag}:${message.scope}`;
+            const existing = this.tagToConversation.get(key);
+            if (existing)
+                return existing;
+            const convId = this.createConversation(message.scope, message.thread_tag);
+            this.tagToConversation.set(key, convId);
+            return convId;
+        }
+        // 3. Catch-all for scope
+        const existing = this.scopeCatchAll.get(message.scope);
+        if (existing)
+            return existing;
+        const convId = this.createConversation(message.scope, "General");
+        this.scopeCatchAll.set(message.scope, convId);
+        return convId;
+    }
+    createConversation(scope, subject, explicitId) {
+        const now = new Date().toISOString();
+        const conv = {
+            id: explicitId ?? `conv-${ulid()}`,
+            scope,
+            subject,
+            status: "active",
+            participants: [],
+            metadata: {},
+            created_at: now,
+            updated_at: now,
+        };
+        this.storage.putConversation(conv);
+        return conv.id;
+    }
+    ensureParticipant(conversationId, agentId) {
+        const conv = this.storage.getConversation(conversationId);
+        if (!conv)
+            return;
+        if (conv.participants.some((p) => p.agent_id === agentId))
+            return;
+        conv.participants.push({
+            agent_id: agentId,
+            joined_at: new Date().toISOString(),
+        });
+        this.storage.putConversation(conv);
+    }
+    resolveThread(message, conversationId, turnId) {
+        // Find the root of the reply chain
+        const rootMessageId = this.findRootMessage(message.in_reply_to);
+        const existingThreadId = this.replyChainToThread.get(rootMessageId);
+        if (existingThreadId)
+            return existingThreadId;
+        // Create new thread
+        const rootTurnId = this.findTurnForMessage(rootMessageId) ?? turnId;
+        const thread = {
+            id: `thread-${ulid()}`,
+            conversation_id: conversationId,
+            root_turn_id: rootTurnId,
+            subject: message.subject,
+            created_at: new Date().toISOString(),
+        };
+        this.storage.putThread(thread);
+        this.replyChainToThread.set(rootMessageId, thread.id);
+        return thread.id;
+    }
+    findRootMessage(messageId) {
+        const msg = this.storage.getMessage(messageId);
+        if (!msg || !msg.in_reply_to)
+            return messageId;
+        return this.findRootMessage(msg.in_reply_to);
+    }
+    findTurnForMessage(messageId) {
+        // Look through all conversations for a turn with this source_message_id
+        for (const conv of this.storage.listConversations()) {
+            const turns = this.storage.getTurns(conv.id);
+            const turn = turns.find((t) => t.source_message_id === messageId);
+            if (turn)
+                return turn.id;
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=traceability.js.map

package/dist/traceability/traceability.js.map

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