@holon-run/agentinbox 0.6.0 → 1.0.0-beta.0

package/dist/src/store.js

@@ -8,8 +8,8 @@ const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const sql_js_1 = __importDefault(require("sql.js"));
 const util_1 = require("./util");
-const LEGACY_SCHEMA_VERSION = 12;
 const DRIZZLE_MIGRATIONS_TABLE = "__drizzle_migrations";
+const V1_BASELINE_TAG = "0000_v1_initial";
 function parseJson(value) {
     if (!value) {
         return {};
@@ -38,10 +38,16 @@ class AgentInboxStore {
     static async open(dbPath) {
         node_fs_1.default.mkdirSync(node_path_1.default.dirname(dbPath), { recursive: true });
         const SQL = await this.loadSqlJs();
-        const db = node_fs_1.default.existsSync(dbPath)
+        let db = node_fs_1.default.existsSync(dbPath)
             ? new SQL.Database(node_fs_1.default.readFileSync(dbPath))
             : new SQL.Database();
-        const store = new AgentInboxStore(dbPath, db);
+        let store = new AgentInboxStore(dbPath, db);
+        if (node_fs_1.default.existsSync(dbPath) && store.shouldArchivePreV1Database()) {
+            const archivedPath = store.archivePreV1Database();
+            console.warn(`[agentinbox] archived pre-v1 local database to ${archivedPath}; starting with a fresh v1 database (no data imported).`);
+            db = new SQL.Database();
+            store = new AgentInboxStore(dbPath, db);
+        }
         store.migrate();
         store.persist();
         return store;
@@ -62,26 +68,13 @@ class AgentInboxStore {
     }
     migrate() {
         const migrations = this.loadSqlMigrations();
-        const hasMigrationTable = this.tableExists(DRIZZLE_MIGRATIONS_TABLE);
         this.ensureDrizzleMigrationsTable();
         const applied = this.listAppliedMigrationTags();
-        const userVersion = this.userVersion();
-        if (applied.size === 0 && !hasMigrationTable && this.tableExists("sources")) {
-            if (userVersion !== 0 && userVersion !== LEGACY_SCHEMA_VERSION) {
-                throw new Error(`unsupported legacy database schema version ${userVersion} at ${this.dbPath}`);
-            }
-            this.recordAppliedMigration(migrations[0].tag);
-            applied.add(migrations[0].tag);
-        }
         const pending = migrations.filter((migration) => !applied.has(migration.tag));
-        if (pending.length > 0) {
-            if (this.shouldBackupBeforeMigration()) {
-                this.backupDatabase();
-            }
-            for (const migration of pending) {
-                this.applyMigration(migration);
-            }
+        for (const migration of pending) {
+            this.applyMigration(migration);
         }
+        this.ensureInboxEntryBackfill();
         this.setUserVersion(migrations.length);
     }
     loadSqlMigrations() {
@@ -133,16 +126,52 @@ class AgentInboxStore {
     recordAppliedMigration(tag) {
         this.db.run(`insert or ignore into ${DRIZZLE_MIGRATIONS_TABLE} (tag, applied_at) values (?, ?)`, [tag, (0, util_1.nowIso)()]);
     }
-    shouldBackupBeforeMigration() {
-        if (!node_fs_1.default.existsSync(this.dbPath)) {
+    shouldArchivePreV1Database() {
+        if (this.isV1Database()) {
             return false;
         }
-        return this.tableExists("sources");
+        return this.hasRecognizablePreV1Schema();
     }
-    backupDatabase() {
+    isV1Database() {
+        if (!this.tableExists(DRIZZLE_MIGRATIONS_TABLE)) {
+            return false;
+        }
+        const applied = this.listAppliedMigrationTags();
+        if (!applied.has(V1_BASELINE_TAG)) {
+            return false;
+        }
+        return this.tableExists("source_hosts")
+            && this.tableExists("inbox_entries")
+            && this.tableExists("digest_threads")
+            && this.columnExists("activation_dispatch_states", "pending_fingerprint")
+            && this.columnType("inbox_entries", "entry_id") === "text"
+            && this.columnType("digest_threads", "thread_id") === "text";
+    }
+    hasRecognizablePreV1Schema() {
+        return this.tableExists("sources")
+            || this.tableExists("agents")
+            || this.tableExists("subscriptions")
+            || this.tableExists("activation_targets")
+            || this.tableExists("inbox_items")
+            || this.tableExists(DRIZZLE_MIGRATIONS_TABLE);
+    }
+    archivePreV1Database() {
+        this.close();
+        const archivedPath = this.nextArchivedDatabasePath();
+        node_fs_1.default.renameSync(this.dbPath, archivedPath);
+        return archivedPath;
+    }
+    nextArchivedDatabasePath() {
         const safeStamp = (0, util_1.nowIso)().replace(/[:.]/g, "-");
-        const backupPath = `${this.dbPath}.backup-${safeStamp}`;
-        node_fs_1.default.copyFileSync(this.dbPath, backupPath);
+        const base = `${this.dbPath}.pre-v1.${safeStamp}.bak`;
+        if (!node_fs_1.default.existsSync(base)) {
+            return base;
+        }
+        let suffix = 1;
+        while (node_fs_1.default.existsSync(`${base}.${suffix}`)) {
+            suffix += 1;
+        }
+        return `${base}.${suffix}`;
     }
     persist() {
         const data = this.db.export();
@@ -159,13 +188,6 @@ class AgentInboxStore {
             throw error;
         }
     }
-    userVersion() {
-        const row = this.getOne("pragma user_version;");
-        if (!row) {
-            return 0;
-        }
-        return Number(row.user_version ?? 0);
-    }
     setUserVersion(version) {
         this.db.exec(`pragma user_version = ${version};`);
     }
@@ -173,6 +195,137 @@ class AgentInboxStore {
         const row = this.getOne("select name from sqlite_master where type = 'table' and name = ?", [name]);
         return Boolean(row);
     }
+    columnExists(tableName, columnName) {
+        if (!this.tableExists(tableName)) {
+            return false;
+        }
+        const rows = this.getAll(`pragma table_info(${tableName});`);
+        return rows.some((row) => String(row.name) === columnName);
+    }
+    columnType(tableName, columnName) {
+        if (!this.tableExists(tableName)) {
+            return null;
+        }
+        const rows = this.getAll(`pragma table_info(${tableName});`);
+        const row = rows.find((entry) => String(entry.name) === columnName);
+        return row ? String(row.type).toLowerCase() : null;
+    }
+    ensureInboxEntryBackfill() {
+        if (!this.tableExists("inbox_entries") || !this.tableExists("inbox_items")) {
+            return;
+        }
+        const existing = this.getOne("select count(*) as count from inbox_entries");
+        if (existing && Number(existing.count ?? 0) > 0) {
+            return;
+        }
+        const rows = this.getAll(`
+      select *
+      from inbox_items
+      order by inbox_id asc, coalesce(inbox_sequence, rowid) asc
+    `);
+        if (rows.length === 0) {
+            return;
+        }
+        this.inTransaction(() => {
+            for (const row of rows) {
+                const item = this.mapInboxItem(row);
+                const entryId = this.insertInboxEntryRecord({
+                    inboxId: item.inboxId,
+                    kind: "item",
+                    threadId: null,
+                    revision: null,
+                    groupKey: null,
+                    resourceRef: null,
+                    eventFamily: null,
+                    itemJson: JSON.stringify({
+                        itemId: item.itemId,
+                        sourceId: item.sourceId,
+                        sourceNativeId: item.sourceNativeId,
+                        eventVariant: item.eventVariant,
+                        inboxId: item.inboxId,
+                        occurredAt: item.occurredAt,
+                        metadata: item.metadata,
+                        rawPayload: item.rawPayload,
+                        deliveryHandle: item.deliveryHandle ?? null,
+                    }),
+                    count: 1,
+                    summary: summarizeBackfilledItemEntry(item),
+                    firstItemAt: item.occurredAt,
+                    lastItemAt: item.occurredAt,
+                    sourceIdsJson: JSON.stringify([item.sourceId]),
+                    subscriptionIdsJson: JSON.stringify([]),
+                    deliveryHandleJson: item.deliveryHandle ? JSON.stringify(item.deliveryHandle) : null,
+                    ackedAt: item.ackedAt ?? null,
+                    supersededAt: null,
+                    createdAt: item.occurredAt,
+                });
+                this.db.run("insert or ignore into inbox_entry_items (entry_id, item_id) values (?, ?)", [entryId, item.itemId]);
+            }
+        });
+    }
+    getSourceHostByKey(hostType, hostKey) {
+        const row = this.getOne("select * from source_hosts where host_type = ? and host_key = ?", [hostType, hostKey]);
+        return row ? this.mapSourceHost(row) : null;
+    }
+    getSourceHost(hostId) {
+        const row = this.getOne("select * from source_hosts where host_id = ?", [hostId]);
+        return row ? this.mapSourceHost(row) : null;
+    }
+    insertSourceHost(host) {
+        this.db.run(`
+      insert into source_hosts (
+        host_id, host_type, host_key, config_ref, config_json, status, created_at, updated_at
+      ) values (?, ?, ?, ?, ?, ?, ?, ?)
+    `, [
+            host.hostId,
+            host.hostType,
+            host.hostKey,
+            host.configRef ?? null,
+            JSON.stringify(host.config ?? {}),
+            host.status,
+            host.createdAt,
+            host.updatedAt,
+        ]);
+        this.persist();
+    }
+    listSourceHosts() {
+        const rows = this.getAll("select * from source_hosts order by created_at asc");
+        return rows.map((row) => this.mapSourceHost(row));
+    }
+    updateSourceHostDefinition(hostId, input) {
+        const current = this.getSourceHost(hostId);
+        if (!current) {
+            throw new Error(`unknown source host: ${hostId}`);
+        }
+        this.db.run(`
+      update source_hosts
+      set config_ref = ?, config_json = ?, updated_at = ?
+      where host_id = ?
+    `, [
+            Object.prototype.hasOwnProperty.call(input, "configRef") ? input.configRef ?? null : current.configRef ?? null,
+            JSON.stringify(Object.prototype.hasOwnProperty.call(input, "config") ? input.config ?? {} : current.config ?? {}),
+            (0, util_1.nowIso)(),
+            hostId,
+        ]);
+        this.persist();
+        return this.getSourceHost(hostId);
+    }
+    updateSourceHostRuntime(hostId, input) {
+        const current = this.getSourceHost(hostId);
+        if (!current) {
+            throw new Error(`unknown source host: ${hostId}`);
+        }
+        this.db.run(`
+      update source_hosts
+      set status = ?, updated_at = ?
+      where host_id = ?
+    `, [
+            Object.prototype.hasOwnProperty.call(input, "status") ? input.status ?? current.status : current.status,
+            (0, util_1.nowIso)(),
+            hostId,
+        ]);
+        this.persist();
+    }
     getSourceByKey(sourceType, sourceKey) {
         const row = this.getOne("select * from sources where source_type = ? and source_key = ?", [sourceType, sourceKey]);
         return row ? this.mapSource(row) : null;
@@ -182,22 +335,31 @@ class AgentInboxStore {
         return row ? this.mapSource(row) : null;
     }
     insertSource(source) {
-        this.db.run(`
-      insert into sources (
-        source_id, source_type, source_key, config_ref, config_json,
-        status, checkpoint, created_at, updated_at
-      ) values (?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `, [
-            source.sourceId,
-            source.sourceType,
-            source.sourceKey,
-            source.configRef ?? null,
-            JSON.stringify(source.config ?? {}),
-            source.status,
-            source.checkpoint ?? null,
-            source.createdAt,
-            source.updatedAt,
-        ]);
+        this.inTransaction(() => {
+            if (!source.hostId || !source.streamKind || !source.streamKey) {
+                throw new Error("source insert requires hostId, streamKind, and streamKey");
+            }
+            this.db.run(`
+        insert into sources (
+          source_id, host_id, stream_kind, stream_key,
+          source_type, source_key, config_ref, config_json,
+          status, checkpoint, created_at, updated_at
+        ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `, [
+                source.sourceId,
+                source.hostId,
+                source.streamKind,
+                source.streamKey,
+                source.sourceType,
+                source.sourceKey,
+                source.configRef ?? null,
+                JSON.stringify(source.config ?? {}),
+                source.status,
+                source.checkpoint ?? null,
+                source.createdAt,
+                source.updatedAt,
+            ]);
+        });
         this.persist();
     }
     listSources() {
@@ -290,6 +452,13 @@ class AgentInboxStore {
             }
             this.db.run("delete from source_idle_states where source_id = ?", [sourceId]);
             this.db.run("delete from sources where source_id = ?", [sourceId]);
+            const hostId = source.hostId ?? null;
+            const siblings = hostId
+                ? this.getOne("select count(*) as count from sources where host_id = ?", [hostId])
+                : null;
+            if (hostId && Number(siblings?.count ?? 0) === 0) {
+                this.db.run("delete from source_hosts where host_id = ?", [hostId]);
+            }
         });
         this.persist();
         return source;
@@ -349,8 +518,43 @@ class AgentInboxStore {
         return row ? this.mapInbox(row) : null;
     }
     insertInbox(inbox) {
-        this.db.run("insert into inboxes (inbox_id, owner_agent_id, created_at) values (?, ?, ?)", [inbox.inboxId, inbox.ownerAgentId, inbox.createdAt]);
+        this.db.run(`
+      insert into inboxes (
+        inbox_id, owner_agent_id, aggregation_enabled, aggregation_window_ms,
+        aggregation_max_items, aggregation_max_thread_age_ms, created_at
+      ) values (?, ?, ?, ?, ?, ?, ?)
+      `, [
+            inbox.inboxId,
+            inbox.ownerAgentId,
+            inbox.aggregationEnabled ? 1 : 0,
+            inbox.aggregationWindowMs ?? null,
+            inbox.aggregationMaxItems ?? null,
+            inbox.aggregationMaxThreadAgeMs ?? null,
+            inbox.createdAt,
+        ]);
+        this.persist();
+    }
+    updateInboxAggregationPolicy(inboxId, policy) {
+        const current = this.getInbox(inboxId);
+        if (!current) {
+            throw new Error(`unknown inbox: ${inboxId}`);
+        }
+        this.db.run(`
+      update inboxes
+      set aggregation_enabled = ?,
+          aggregation_window_ms = ?,
+          aggregation_max_items = ?,
+          aggregation_max_thread_age_ms = ?
+      where inbox_id = ?
+      `, [
+            policy.enabled === undefined ? (current.aggregationEnabled ? 1 : 0) : (policy.enabled ? 1 : 0),
+            Object.prototype.hasOwnProperty.call(policy, "windowMs") ? policy.windowMs ?? null : current.aggregationWindowMs ?? null,
+            Object.prototype.hasOwnProperty.call(policy, "maxItems") ? policy.maxItems ?? null : current.aggregationMaxItems ?? null,
+            Object.prototype.hasOwnProperty.call(policy, "maxThreadAgeMs") ? policy.maxThreadAgeMs ?? null : current.aggregationMaxThreadAgeMs ?? null,
+            inboxId,
+        ]);
         this.persist();
+        return this.getInbox(inboxId);
     }
     listInboxes() {
         const rows = this.getAll("select * from inboxes order by created_at asc");
@@ -482,8 +686,8 @@ class AgentInboxStore {
             this.db.run(`
         insert into activation_targets (
           target_id, agent_id, kind, status, offline_since, consecutive_failures, last_delivered_at, last_error,
-          mode, notify_lease_ms, url, created_at, updated_at, last_seen_at
-        ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+          mode, notify_lease_ms, min_unacked_items, url, created_at, updated_at, last_seen_at
+        ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
       `, [
                 target.targetId,
                 target.agentId,
@@ -495,6 +699,7 @@ class AgentInboxStore {
                 target.lastError ?? null,
                 target.mode,
                 target.notifyLeaseMs,
+                target.minUnackedItems ?? null,
                 target.url,
                 target.createdAt,
                 target.updatedAt,
@@ -504,10 +709,10 @@ class AgentInboxStore {
         else {
             this.db.run(`
         insert into activation_targets (
-          target_id, agent_id, kind, status, offline_since, consecutive_failures, last_delivered_at, last_error, mode, notify_lease_ms,
+          target_id, agent_id, kind, status, offline_since, consecutive_failures, last_delivered_at, last_error, mode, notify_lease_ms, min_unacked_items,
           runtime_kind, runtime_session_id, runtime_pid, backend, tmux_pane_id, tty, term_program, iterm_session_id,
           created_at, updated_at, last_seen_at
-        ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
       `, [
                 target.targetId,
                 target.agentId,
@@ -519,6 +724,7 @@ class AgentInboxStore {
                 target.lastError ?? null,
                 target.mode,
                 target.notifyLeaseMs,
+                target.minUnackedItems ?? null,
                 target.runtimeKind,
                 target.runtimeSessionId ?? null,
                 target.runtimePid ?? null,
@@ -538,7 +744,7 @@ class AgentInboxStore {
         this.db.run(`
       update activation_targets
       set status = 'active', offline_since = null, last_error = null, consecutive_failures = 0,
-          runtime_kind = ?, runtime_session_id = ?, runtime_pid = ?, tmux_pane_id = ?, tty = ?, term_program = ?, iterm_session_id = ?, updated_at = ?, last_seen_at = ?
+          runtime_kind = ?, runtime_session_id = ?, runtime_pid = ?, tmux_pane_id = ?, tty = ?, term_program = ?, iterm_session_id = ?, notify_lease_ms = ?, min_unacked_items = ?, updated_at = ?, last_seen_at = ?
       where target_id = ? and kind = 'terminal'
     `, [
             input.runtimeKind,
@@ -548,6 +754,8 @@ class AgentInboxStore {
             input.tty ?? null,
             input.termProgram ?? null,
             input.itermSessionId ?? null,
+            input.notifyLeaseMs,
+            input.minUnackedItems,
             input.updatedAt,
             input.lastSeenAt,
             targetId,
@@ -729,13 +937,19 @@ class AgentInboxStore {
     upsertActivationDispatchState(state) {
         this.db.run(`
       insert into activation_dispatch_states (
-        agent_id, target_id, status, lease_expires_at, last_notified_fingerprint, pending_new_item_count, pending_summary,
+        agent_id, target_id, status, lease_expires_at, last_notified_fingerprint, defer_reason, defer_attempts,
+        first_deferred_at, last_deferred_at, pending_fingerprint, pending_new_item_count, pending_summary,
         pending_subscription_ids_json, pending_source_ids_json, updated_at
-      ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
       on conflict(agent_id, target_id) do update set
         status = excluded.status,
         lease_expires_at = excluded.lease_expires_at,
         last_notified_fingerprint = excluded.last_notified_fingerprint,
+        defer_reason = excluded.defer_reason,
+        defer_attempts = excluded.defer_attempts,
+        first_deferred_at = excluded.first_deferred_at,
+        last_deferred_at = excluded.last_deferred_at,
+        pending_fingerprint = excluded.pending_fingerprint,
         pending_new_item_count = excluded.pending_new_item_count,
         pending_summary = excluded.pending_summary,
         pending_subscription_ids_json = excluded.pending_subscription_ids_json,
@@ -747,6 +961,11 @@ class AgentInboxStore {
             state.status,
             state.leaseExpiresAt ?? null,
             state.lastNotifiedFingerprint ?? null,
+            state.deferReason ?? null,
+            state.deferAttempts,
+            state.firstDeferredAt ?? null,
+            state.lastDeferredAt ?? null,
+            state.pendingFingerprint ?? null,
             state.pendingNewItemCount,
             state.pendingSummary ?? null,
             JSON.stringify(state.pendingSubscriptionIds),
@@ -790,20 +1009,237 @@ class AgentInboxStore {
         }
         return inserted;
     }
-    listInboxItems(inboxId, options) {
+    createInboxItemEntry(inboxId, item, input) {
+        const entryId = this.insertInboxEntryRecord({
+            inboxId,
+            kind: "item",
+            threadId: null,
+            revision: null,
+            groupKey: null,
+            resourceRef: null,
+            eventFamily: null,
+            itemJson: JSON.stringify({
+                itemId: item.itemId,
+                sourceId: item.sourceId,
+                sourceNativeId: item.sourceNativeId,
+                eventVariant: item.eventVariant,
+                inboxId: item.inboxId,
+                occurredAt: item.occurredAt,
+                metadata: item.metadata,
+                rawPayload: item.rawPayload,
+                deliveryHandle: item.deliveryHandle ?? null,
+            }),
+            count: 1,
+            summary: input.summary,
+            firstItemAt: item.occurredAt,
+            lastItemAt: item.occurredAt,
+            sourceIdsJson: JSON.stringify([item.sourceId]),
+            subscriptionIdsJson: JSON.stringify(uniqueSorted(input.subscriptionIds)),
+            deliveryHandleJson: item.deliveryHandle ? JSON.stringify(item.deliveryHandle) : null,
+            ackedAt: item.ackedAt ?? null,
+            supersededAt: null,
+            createdAt: (0, util_1.nowIso)(),
+        });
+        this.db.run("insert or ignore into inbox_entry_items (entry_id, item_id) values (?, ?)", [entryId, item.itemId]);
+        this.persist();
+        return this.getInboxEntry(entryId);
+    }
+    listInboxEntries(inboxId, options) {
         const includeAcked = options?.includeAcked ?? false;
         const filters = ["inbox_id = ?"];
         const params = [inboxId];
         if (!includeAcked) {
             filters.push("acked_at is null");
+            filters.push("superseded_at is null");
         }
-        if (options?.afterItemId) {
-            const anchor = this.getOne("select coalesce(inbox_sequence, rowid) as inbox_sequence from inbox_items where inbox_id = ? and item_id = ?", [inboxId, options.afterItemId]);
+        if (options?.afterEntryId) {
+            const anchor = this.getOne("select sequence from inbox_entries where inbox_id = ? and entry_id = ?", [inboxId, (0, util_1.parseEntryRef)(options.afterEntryId)]);
             if (!anchor) {
-                throw new Error(`unknown inbox item: ${options.afterItemId}`);
+                throw new Error(`unknown inbox entry: ${options.afterEntryId}`);
             }
-            filters.push("coalesce(inbox_sequence, rowid) > ?");
-            params.push(Number(anchor.inbox_sequence));
+            filters.push("sequence > ?");
+            params.push(Number(anchor.sequence));
+        }
+        const rows = this.getAll(`select * from inbox_entries where ${filters.join(" and ")} order by sequence asc`, params);
+        return this.mapInboxEntries(rows);
+    }
+    getInboxEntry(entryId) {
+        const rows = this.getAll("select * from inbox_entries where entry_id = ?", [(0, util_1.parseEntryRef)(entryId)]);
+        return this.mapInboxEntries(rows)[0] ?? null;
+    }
+    ackInboxEntries(inboxId, entryIds, ackedAt) {
+        const resolvedIds = uniqueSorted(entryIds).map((entryId) => this.resolveInboxEntryId(inboxId, entryId));
+        const itemIds = this.getRawItemIdsForEntryIds(resolvedIds);
+        const ackedItems = itemIds.length > 0 ? this.ackItems(inboxId, itemIds, ackedAt) : 0;
+        if (ackedItems > 0) {
+            this.syncInboxEntryAckState(inboxId, ackedAt);
+        }
+        const ackedEntries = this.countAckedEntries(resolvedIds, ackedAt);
+        return { ackedEntries, ackedItems };
+    }
+    ackInboxEntriesThrough(inboxId, entryId, ackedAt) {
+        const anchor = this.getOne("select sequence from inbox_entries where inbox_id = ? and entry_id = ?", [inboxId, this.resolveInboxEntryId(inboxId, entryId)]);
+        if (!anchor) {
+            throw new Error(`unknown inbox entry: ${entryId}`);
+        }
+        const rows = this.getAll(`
+      select entry_id
+      from inbox_entries
+      where inbox_id = ?
+        and acked_at is null
+        and superseded_at is null
+        and sequence <= ?
+      order by sequence asc
+      `, [inboxId, Number(anchor.sequence)]);
+        return this.ackInboxEntries(inboxId, rows.map((row) => (0, util_1.formatEntryRef)(String(row.entry_id))), ackedAt);
+    }
+    getOpenDigestThread(inboxId, groupKey) {
+        const row = this.getOne(`
+      select * from digest_threads
+      where inbox_id = ? and group_key = ? and status = 'open'
+      order by created_at desc, rowid desc
+      limit 1
+      `, [inboxId, groupKey]);
+        return row ? this.mapDigestThread(row) : null;
+    }
+    createDigestThread(input) {
+        const threadId = (0, util_1.generateCanonicalId)("thr");
+        this.db.run(`
+      insert into digest_threads (
+        thread_id, inbox_id, source_id, group_key, resource_ref, event_family, latest_revision,
+        latest_entry_id, status, summary, first_item_at, last_item_at, flush_after_at,
+        created_at, updated_at
+      ) values (?, ?, ?, ?, ?, ?, 0, null, 'open', ?, ?, ?, ?, ?, ?)
+      `, [
+            threadId,
+            input.inboxId,
+            input.sourceId,
+            input.groupKey,
+            input.resourceRef ?? null,
+            input.eventFamily ?? null,
+            input.summary,
+            input.firstItemAt,
+            input.firstItemAt,
+            input.flushAfterAt ?? null,
+            input.createdAt,
+            input.createdAt,
+        ]);
+        this.persist();
+        return this.getDigestThread(threadId);
+    }
+    getDigestThread(threadId) {
+        const row = this.getOne("select * from digest_threads where thread_id = ?", [threadId]);
+        return row ? this.mapDigestThread(row) : null;
+    }
+    addItemToDigestThread(threadId, itemId, occurredAt, summary, flushAfterAt) {
+        this.inTransaction(() => {
+            this.db.run("insert or ignore into digest_thread_items (thread_id, item_id) values (?, ?)", [threadId, itemId]);
+            this.db.run(`
+        update digest_threads
+        set summary = ?, last_item_at = ?, flush_after_at = ?, updated_at = ?
+        where thread_id = ?
+        `, [summary, occurredAt, flushAfterAt, (0, util_1.nowIso)(), threadId]);
+        });
+        this.persist();
+        return this.getDigestThread(threadId);
+    }
+    listDueDigestThreads(now) {
+        const rows = this.getAll(`
+      select *
+      from digest_threads
+      where status = 'open'
+        and flush_after_at is not null
+        and flush_after_at <= ?
+      order by flush_after_at asc, created_at asc, thread_id asc
+      `, [now]);
+        return rows.map((row) => this.mapDigestThread(row));
+    }
+    listUnackedInboxItemsForDigestThread(threadId) {
+        const rows = this.getAll(`
+      select i.*
+      from digest_thread_items t
+      join inbox_items i on i.item_id = t.item_id
+      where t.thread_id = ?
+        and i.acked_at is null
+      order by coalesce(i.inbox_sequence, i.rowid) asc
+      `, [threadId]);
+        return rows.map((row) => this.mapInboxItem(row));
+    }
+    listOpenDigestThreadsForInbox(inboxId) {
+        const rows = this.getAll("select * from digest_threads where inbox_id = ? and status = 'open' order by created_at asc, thread_id asc", [inboxId]);
+        return rows.map((row) => this.mapDigestThread(row));
+    }
+    listOpenDigestThreads() {
+        const rows = this.getAll("select * from digest_threads where status = 'open' order by created_at asc, thread_id asc");
+        return rows.map((row) => this.mapDigestThread(row));
+    }
+    materializeDigestSnapshot(input) {
+        const thread = this.getDigestThread(input.threadId);
+        if (!thread) {
+            throw new Error(`unknown digest thread: ${input.threadId}`);
+        }
+        this.inTransaction(() => {
+            if (thread.latestEntryId != null) {
+                this.db.run("update inbox_entries set superseded_at = ? where entry_id = ? and superseded_at is null", [input.createdAt, thread.latestEntryId]);
+            }
+            const nextRevision = thread.latestRevision + 1;
+            const entryId = this.insertInboxEntryRecord({
+                inboxId: input.inboxId,
+                kind: "digest_snapshot",
+                threadId: input.threadId,
+                revision: nextRevision,
+                groupKey: input.groupKey,
+                resourceRef: input.resourceRef ?? null,
+                eventFamily: input.eventFamily ?? null,
+                itemJson: null,
+                count: input.itemIds.length,
+                summary: input.summary,
+                firstItemAt: input.firstItemAt,
+                lastItemAt: input.lastItemAt,
+                sourceIdsJson: JSON.stringify(uniqueSorted(input.sourceIds)),
+                subscriptionIdsJson: JSON.stringify(uniqueSorted(input.subscriptionIds)),
+                deliveryHandleJson: input.deliveryHandleJson ?? null,
+                ackedAt: null,
+                supersededAt: null,
+                createdAt: input.createdAt,
+            });
+            for (const itemId of input.itemIds) {
+                this.db.run("insert or ignore into inbox_entry_items (entry_id, item_id) values (?, ?)", [entryId, itemId]);
+            }
+            this.db.run(`
+        update digest_threads
+        set latest_revision = ?, latest_entry_id = ?, summary = ?, first_item_at = ?, last_item_at = ?,
+            flush_after_at = null, updated_at = ?
+        where thread_id = ?
+        `, [nextRevision, entryId, input.summary, input.firstItemAt, input.lastItemAt, input.createdAt, input.threadId]);
+        });
+        this.persist();
+        return this.getInboxEntry(this.getDigestThread(input.threadId).latestEntryId);
+    }
+    closeDigestThread(threadId, updatedAt) {
+        this.db.run("update digest_threads set status = 'closed', flush_after_at = null, updated_at = ? where thread_id = ?", [updatedAt, threadId]);
+        this.persist();
+    }
+    listDigestThreadsForRawItems(itemIds) {
+        if (itemIds.length === 0) {
+            return [];
+        }
+        const placeholders = itemIds.map(() => "?").join(", ");
+        const rows = this.getAll(`
+      select distinct t.*
+      from digest_threads t
+      join digest_thread_items i on i.thread_id = t.thread_id
+      where i.item_id in (${placeholders})
+      order by t.created_at asc, t.thread_id asc
+      `, itemIds);
+        return rows.map((row) => this.mapDigestThread(row));
+    }
+    listInboxItems(inboxId, options) {
+        const includeAcked = options?.includeAcked ?? false;
+        const filters = ["inbox_id = ?"];
+        const params = [inboxId];
+        if (!includeAcked) {
+            filters.push("acked_at is null");
         }
         const rows = this.getAll(`select * from inbox_items where ${filters.join(" and ")} order by coalesce(inbox_sequence, rowid) asc`, params);
         return rows.map((row) => this.mapInboxItem(row));
@@ -842,29 +1278,31 @@ class AgentInboxStore {
         return changes;
     }
     deleteAckedInboxItems(inboxId, olderThan) {
-        this.db.run(`
-      delete from inbox_items
+        const itemIds = this.getAll(`
+      select item_id
+      from inbox_items
       where inbox_id = ?
         and acked_at is not null
         and acked_at < ?
-    `, [inboxId, olderThan]);
-        const changes = this.changes();
-        if (changes > 0) {
-            this.persist();
+      `, [inboxId, olderThan]).map((row) => String(row.item_id));
+        if (itemIds.length === 0) {
+            return 0;
         }
-        return changes;
+        this.deleteInboxItemsAndEntryArtifacts(itemIds);
+        return itemIds.length;
     }
     deleteAckedInboxItemsGlobal(olderThan) {
-        this.db.run(`
-      delete from inbox_items
+        const itemIds = this.getAll(`
+      select item_id
+      from inbox_items
       where acked_at is not null
         and acked_at < ?
-    `, [olderThan]);
-        const changes = this.changes();
-        if (changes > 0) {
-            this.persist();
+      `, [olderThan]).map((row) => String(row.item_id));
+        if (itemIds.length === 0) {
+            return 0;
         }
-        return changes;
+        this.deleteInboxItemsAndEntryArtifacts(itemIds);
+        return itemIds.length;
     }
     countInboxItems(inboxId, includeAcked) {
         const row = this.getOne(`
@@ -892,7 +1330,7 @@ class AgentInboxStore {
             JSON.stringify(activation.sourceIds),
             activation.newItemCount,
             activation.summary,
-            activation.items ? JSON.stringify(activation.items) : null,
+            activation.entries ? JSON.stringify(activation.entries) : (activation.items ? JSON.stringify(activation.items) : null),
             activation.createdAt,
             activation.deliveredAt ?? null,
         ]);
@@ -943,34 +1381,50 @@ class AgentInboxStore {
         return row ? this.mapStream(row) : null;
     }
     insertStreamEvent(streamId, event) {
-        const before = this.changes();
-        this.db.run(`
-      insert or ignore into stream_events (
-        stream_event_id, stream_id, source_id, source_native_id, event_variant,
-        occurred_at, metadata_json, raw_payload_json, delivery_handle_json, created_at
-      ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `, [
-            (0, util_1.generateId)("strevt"),
-            streamId,
-            event.sourceId,
-            event.sourceNativeId,
-            event.eventVariant,
-            event.occurredAt ?? (0, util_1.nowIso)(),
-            JSON.stringify(event.metadata ?? {}),
-            JSON.stringify(event.rawPayload ?? {}),
-            event.deliveryHandle ? JSON.stringify(event.deliveryHandle) : null,
-            (0, util_1.nowIso)(),
-        ]);
-        const inserted = this.changes() > before;
-        if (inserted) {
-            this.persist();
-            return {
-                appended: 1,
-                deduped: 0,
-                lastOffset: this.lastInsertRowId(),
-            };
+        const occurredAt = event.occurredAt ?? (0, util_1.nowIso)();
+        const metadataJson = JSON.stringify(event.metadata ?? {});
+        const rawPayloadJson = JSON.stringify(event.rawPayload ?? {});
+        const deliveryHandleJson = event.deliveryHandle ? JSON.stringify(event.deliveryHandle) : null;
+        for (let attempt = 0; attempt < 5; attempt += 1) {
+            const before = this.changes();
+            this.db.run(`
+        insert or ignore into stream_events (
+          stream_event_id, stream_id, source_id, source_native_id, event_variant,
+          occurred_at, metadata_json, raw_payload_json, delivery_handle_json, created_at
+        ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `, [
+                (0, util_1.generateCanonicalId)("evt"),
+                streamId,
+                event.sourceId,
+                event.sourceNativeId,
+                event.eventVariant,
+                occurredAt,
+                metadataJson,
+                rawPayloadJson,
+                deliveryHandleJson,
+                (0, util_1.nowIso)(),
+            ]);
+            if (this.changes() > before) {
+                this.persist();
+                return {
+                    appended: 1,
+                    deduped: 0,
+                    lastOffset: this.lastInsertRowId(),
+                };
+            }
+            const existing = this.getOne(`
+        select offset
+        from stream_events
+        where stream_id = ?
+          and source_native_id = ?
+          and event_variant = ?
+        limit 1
+        `, [streamId, event.sourceNativeId, event.eventVariant]);
+            if (existing) {
+                return { appended: 0, deduped: 1, lastOffset: null };
+            }
         }
-        return { appended: 0, deduped: 1, lastOffset: null };
+        throw new Error(`unable to allocate a unique stream_event_id for ${event.sourceNativeId}`);
     }
     readStreamEvents(streamId, nextOffset, limit) {
         const rows = this.getAll(`
@@ -1058,7 +1512,7 @@ class AgentInboxStore {
         insert into consumer_commits (
           commit_id, consumer_id, stream_id, committed_offset, committed_at
         ) values (?, ?, ?, ?, ?)
-      `, [(0, util_1.generateId)("commit"), consumerId, consumer.streamId, committedOffset, updatedAt]);
+      `, [(0, util_1.generateCanonicalId)("cmt"), consumerId, consumer.streamId, committedOffset, updatedAt]);
         });
         this.persist();
         return this.getConsumer(consumerId);
@@ -1139,8 +1593,15 @@ class AgentInboxStore {
         }
     }
     mapSource(row) {
+        const hostId = requiredText(row, "host_id");
+        const streamKind = requiredText(row, "stream_kind");
+        const streamKey = requiredText(row, "stream_key");
         return {
             sourceId: String(row.source_id),
+            streamId: String(row.source_id),
+            hostId,
+            streamKind,
+            streamKey,
             sourceType: row.source_type,
             sourceKey: String(row.source_key),
             configRef: row.config_ref ? String(row.config_ref) : null,
@@ -1151,6 +1612,18 @@ class AgentInboxStore {
             updatedAt: String(row.updated_at),
         };
     }
+    mapSourceHost(row) {
+        return {
+            hostId: String(row.host_id),
+            hostType: String(row.host_type),
+            hostKey: String(row.host_key),
+            configRef: row.config_ref ? String(row.config_ref) : null,
+            config: parseJson(row.config_json),
+            status: String(row.status),
+            createdAt: String(row.created_at),
+            updatedAt: String(row.updated_at),
+        };
+    }
     mapSourceIdleState(row) {
         return {
             sourceId: String(row.source_id),
@@ -1176,6 +1649,10 @@ class AgentInboxStore {
         return {
             inboxId: String(row.inbox_id),
             ownerAgentId: String(row.owner_agent_id),
+            aggregationEnabled: Number(row.aggregation_enabled ?? 0) > 0,
+            aggregationWindowMs: row.aggregation_window_ms == null ? null : Number(row.aggregation_window_ms),
+            aggregationMaxItems: row.aggregation_max_items == null ? null : Number(row.aggregation_max_items),
+            aggregationMaxThreadAgeMs: row.aggregation_max_thread_age_ms == null ? null : Number(row.aggregation_max_thread_age_ms),
             createdAt: String(row.created_at),
         };
     }
@@ -1224,6 +1701,11 @@ class AgentInboxStore {
                 mode: row.mode,
                 url,
                 notifyLeaseMs: Number(row.notify_lease_ms),
+                minUnackedItems: row.min_unacked_items == null ? null : Number(row.min_unacked_items),
+                notificationPolicy: {
+                    notifyLeaseMs: Number(row.notify_lease_ms),
+                    minUnackedItems: row.min_unacked_items == null ? null : Number(row.min_unacked_items),
+                },
                 createdAt: String(row.created_at),
                 updatedAt: String(row.updated_at),
                 lastSeenAt: String(row.last_seen_at),
@@ -1240,6 +1722,11 @@ class AgentInboxStore {
             lastError: row.last_error ? String(row.last_error) : null,
             mode: row.mode,
             notifyLeaseMs: Number(row.notify_lease_ms),
+            minUnackedItems: row.min_unacked_items == null ? null : Number(row.min_unacked_items),
+            notificationPolicy: {
+                notifyLeaseMs: Number(row.notify_lease_ms),
+                minUnackedItems: row.min_unacked_items == null ? null : Number(row.min_unacked_items),
+            },
             runtimeKind: (row.runtime_kind ? String(row.runtime_kind) : "unknown"),
             runtimeSessionId: row.runtime_session_id ? String(row.runtime_session_id) : null,
             runtimePid: row.runtime_pid == null ? null : Number(row.runtime_pid),
@@ -1260,6 +1747,11 @@ class AgentInboxStore {
             status: row.status,
             leaseExpiresAt: row.lease_expires_at ? String(row.lease_expires_at) : null,
             lastNotifiedFingerprint: row.last_notified_fingerprint ? String(row.last_notified_fingerprint) : null,
+            deferReason: row.defer_reason ? row.defer_reason : null,
+            deferAttempts: Number(row.defer_attempts ?? 0),
+            firstDeferredAt: row.first_deferred_at ? String(row.first_deferred_at) : null,
+            lastDeferredAt: row.last_deferred_at ? String(row.last_deferred_at) : null,
+            pendingFingerprint: row.pending_fingerprint ? String(row.pending_fingerprint) : null,
             pendingNewItemCount: Number(row.pending_new_item_count),
             pendingSummary: row.pending_summary ? String(row.pending_summary) : null,
             pendingSubscriptionIds: parseJson(row.pending_subscription_ids_json),
@@ -1301,6 +1793,70 @@ class AgentInboxStore {
             ackedAt: row.acked_at ? String(row.acked_at) : null,
         };
     }
+    mapInboxEntry(row, itemIds) {
+        const base = {
+            entryId: (0, util_1.formatEntryRef)(requiredText(row, "entry_id")),
+            inboxId: String(row.inbox_id),
+            sequence: Number(row.sequence),
+            itemId: "",
+            summary: String(row.summary),
+            count: Number(row.count),
+            itemIds,
+            sourceIds: parseJson(row.source_ids_json),
+            subscriptionIds: parseJson(row.subscription_ids_json),
+            firstItemAt: String(row.first_item_at),
+            lastItemAt: String(row.last_item_at),
+            deliveryHandle: row.delivery_handle_json
+                ? parseJson(row.delivery_handle_json)
+                : null,
+            ackedAt: row.acked_at ? String(row.acked_at) : null,
+            supersededAt: row.superseded_at ? String(row.superseded_at) : null,
+        };
+        if (String(row.kind) === "item") {
+            const item = parseJson(row.item_json);
+            return {
+                ...base,
+                kind: "item",
+                itemId: item.itemId,
+                sourceId: item.sourceId,
+                sourceNativeId: item.sourceNativeId,
+                eventVariant: item.eventVariant,
+                occurredAt: item.occurredAt,
+                metadata: item.metadata,
+                rawPayload: item.rawPayload,
+                item,
+            };
+        }
+        return {
+            ...base,
+            kind: "digest_snapshot",
+            itemId: base.itemIds[0] ?? (0, util_1.formatEntryRef)(requiredText(row, "entry_id")),
+            threadId: (0, util_1.formatThreadRef)(requiredText(row, "thread_id")),
+            revision: Number(row.revision),
+            groupKey: String(row.group_key),
+            resourceRef: row.resource_ref ? String(row.resource_ref) : null,
+            eventFamily: row.event_family ? String(row.event_family) : null,
+        };
+    }
+    mapDigestThread(row) {
+        return {
+            threadId: requiredText(row, "thread_id"),
+            inboxId: String(row.inbox_id),
+            sourceId: String(row.source_id),
+            groupKey: String(row.group_key),
+            resourceRef: row.resource_ref ? String(row.resource_ref) : null,
+            eventFamily: row.event_family ? String(row.event_family) : null,
+            latestRevision: Number(row.latest_revision),
+            latestEntryId: row.latest_entry_id == null ? null : String(row.latest_entry_id),
+            status: String(row.status),
+            summary: String(row.summary),
+            firstItemAt: String(row.first_item_at),
+            lastItemAt: String(row.last_item_at),
+            flushAfterAt: row.flush_after_at ? String(row.flush_after_at) : null,
+            createdAt: String(row.created_at),
+            updatedAt: String(row.updated_at),
+        };
+    }
     mapActivation(row) {
         return {
             kind: "agentinbox.activation",
@@ -1311,9 +1867,10 @@ class AgentInboxStore {
             targetKind: row.target_kind,
             subscriptionIds: parseJson(row.subscription_ids_json),
             sourceIds: parseJson(row.source_ids_json),
+            newEntryCount: row.items_json ? parseJson(row.items_json)?.length ?? 0 : Number(row.new_item_count),
             newItemCount: Number(row.new_item_count),
             summary: String(row.summary),
-            items: row.items_json ? parseJson(row.items_json) : undefined,
+            entries: row.items_json ? parseJson(row.items_json) : undefined,
             createdAt: String(row.created_at),
             deliveredAt: row.delivered_at ? String(row.delivered_at) : null,
         };
@@ -1332,6 +1889,191 @@ class AgentInboxStore {
             createdAt: String(row.created_at),
         };
     }
+    resolveInboxEntryId(inboxId, refOrItemId) {
+        try {
+            return (0, util_1.parseEntryRef)(refOrItemId);
+        }
+        catch {
+            const row = this.getOne(`
+        select e.entry_id
+        from inbox_entries e
+        join inbox_entry_items i on i.entry_id = e.entry_id
+        where e.inbox_id = ?
+          and i.item_id = ?
+        order by e.sequence desc
+        limit 1
+        `, [inboxId, refOrItemId]);
+            if (!row) {
+                throw new Error(`unknown inbox entry: ${refOrItemId}`);
+            }
+            return String(row.entry_id);
+        }
+    }
+    insertInboxEntryRecord(input) {
+        const entryId = (0, util_1.generateCanonicalId)("ent");
+        this.db.run(`
+      insert into inbox_entries (
+        entry_id, inbox_id, kind, sequence, thread_id, revision, group_key, resource_ref, event_family,
+        item_json, count, summary, first_item_at, last_item_at, source_ids_json,
+        subscription_ids_json, delivery_handle_json, acked_at, superseded_at, created_at
+      ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `, [
+            entryId,
+            input.inboxId,
+            input.kind,
+            this.nextInboxEntrySequence(),
+            input.threadId,
+            input.revision,
+            input.groupKey,
+            input.resourceRef,
+            input.eventFamily,
+            input.itemJson,
+            input.count,
+            input.summary,
+            input.firstItemAt,
+            input.lastItemAt,
+            input.sourceIdsJson,
+            input.subscriptionIdsJson,
+            input.deliveryHandleJson,
+            input.ackedAt,
+            input.supersededAt,
+            input.createdAt,
+        ]);
+        return entryId;
+    }
+    nextInboxEntrySequence() {
+        const row = this.getOne("select coalesce(max(sequence), 0) + 1 as next_sequence from inbox_entries");
+        return Number(row?.next_sequence ?? 1);
+    }
+    listEntryItemIds(entryId) {
+        const rows = this.getAll(`
+      select iei.item_id
+      from inbox_entry_items iei
+      left join inbox_items ii on ii.item_id = iei.item_id
+      where iei.entry_id = ?
+      order by coalesce(ii.inbox_sequence, ii.rowid, iei.rowid) asc
+      `, [entryId]);
+        return rows.map((row) => String(row.item_id));
+    }
+    listEntryItemIdsBulk(entryIds) {
+        const result = new Map();
+        if (entryIds.length === 0) {
+            return result;
+        }
+        const placeholders = entryIds.map(() => "?").join(", ");
+        const rows = this.getAll(`
+      select iei.entry_id, iei.item_id
+      from inbox_entry_items iei
+      left join inbox_items ii on ii.item_id = iei.item_id
+      where iei.entry_id in (${placeholders})
+      order by iei.entry_id asc, coalesce(ii.inbox_sequence, ii.rowid, iei.rowid) asc
+      `, entryIds);
+        for (const row of rows) {
+            const entryId = String(row.entry_id);
+            const itemIds = result.get(entryId) ?? [];
+            itemIds.push(String(row.item_id));
+            result.set(entryId, itemIds);
+        }
+        return result;
+    }
+    getRawItemIdsForEntryIds(entryIds) {
+        const itemIds = new Set();
+        for (const entryId of entryIds) {
+            for (const itemId of this.listEntryItemIds(entryId)) {
+                itemIds.add(itemId);
+            }
+        }
+        return [...itemIds];
+    }
+    mapInboxEntries(rows) {
+        const itemIdsByEntry = this.listEntryItemIdsBulk(rows.map((row) => String(row.entry_id)));
+        return rows.map((row) => this.mapInboxEntry(row, itemIdsByEntry.get(String(row.entry_id)) ?? []));
+    }
+    syncInboxEntryAckState(inboxId, ackedAt) {
+        this.db.run(`
+      update inbox_entries
+      set acked_at = ?
+      where inbox_id = ?
+        and acked_at is null
+        and not exists (
+          select 1
+          from inbox_entry_items e
+          join inbox_items i on i.item_id = e.item_id
+          where e.entry_id = inbox_entries.entry_id
+            and i.acked_at is null
+        )
+      `, [ackedAt, inboxId]);
+        this.persist();
+    }
+    countAckedEntries(entryIds, ackedAt) {
+        if (entryIds.length === 0) {
+            return 0;
+        }
+        const placeholders = entryIds.map(() => "?").join(", ");
+        const row = this.getOne(`select count(*) as count from inbox_entries where entry_id in (${placeholders}) and acked_at = ?`, [...entryIds, ackedAt]);
+        return Number(row?.count ?? 0);
+    }
+    deleteInboxItemsAndEntryArtifacts(itemIds) {
+        const placeholders = itemIds.map(() => "?").join(", ");
+        this.inTransaction(() => {
+            this.db.run(`delete from digest_thread_items where item_id in (${placeholders})`, itemIds);
+            this.db.run(`delete from inbox_items where item_id in (${placeholders})`, itemIds);
+            this.db.run(`
+        delete from inbox_entries
+        where entry_id in (
+          select e.entry_id
+          from inbox_entries e
+          where not exists (
+            select 1
+            from inbox_entry_items ee
+            where ee.entry_id = e.entry_id
+              and exists (
+                select 1
+                from inbox_items ii
+                where ii.item_id = ee.item_id
+              )
+          )
+        )
+        `);
+            this.db.run(`
+        delete from inbox_entry_items
+        where not exists (
+          select 1
+          from inbox_items ii
+          where ii.item_id = inbox_entry_items.item_id
+        )
+        `);
+            this.db.run(`
+        update digest_threads
+        set latest_entry_id = (
+              select e.entry_id
+              from inbox_entries e
+              where e.thread_id = digest_threads.thread_id
+              order by coalesce(e.revision, 0) desc, e.entry_id desc
+              limit 1
+            ),
+            latest_revision = coalesce((
+              select max(coalesce(e.revision, 0))
+              from inbox_entries e
+              where e.thread_id = digest_threads.thread_id
+            ), 0)
+        `);
+            this.db.run(`
+        delete from digest_threads
+        where not exists (
+          select 1
+          from digest_thread_items dti
+          where dti.thread_id = digest_threads.thread_id
+        )
+          and not exists (
+            select 1
+            from inbox_entries e
+            where e.thread_id = digest_threads.thread_id
+          )
+        `);
+        });
+        this.persist();
+    }
     mapStream(row) {
         return {
             streamId: String(row.stream_id),
@@ -1374,3 +2116,16 @@ class AgentInboxStore {
     }
 }
 exports.AgentInboxStore = AgentInboxStore;
+function requiredText(row, key) {
+    const value = row[key];
+    if (value == null) {
+        throw new Error(`missing required column: ${key}`);
+    }
+    return String(value);
+}
+function uniqueSorted(values) {
+    return [...new Set(values.filter((value) => typeof value === "string" && value.length > 0))].sort();
+}
+function summarizeBackfilledItemEntry(item) {
+    return `${item.eventVariant} from ${item.sourceId}`;
+}