@holon-run/agentinbox 0.1.0

package/dist/src/store.js

@@ -0,0 +1,1271 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentInboxStore = void 0;
+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 SCHEMA_VERSION = 11;
+function parseJson(value) {
+    if (!value) {
+        return {};
+    }
+    return JSON.parse(value);
+}
+class AgentInboxStore {
+    dbPath;
+    db;
+    static sqlPromise = null;
+    constructor(dbPath, db) {
+        this.dbPath = dbPath;
+        this.db = db;
+    }
+    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)
+            ? new SQL.Database(node_fs_1.default.readFileSync(dbPath))
+            : new SQL.Database();
+        const store = new AgentInboxStore(dbPath, db);
+        store.migrate();
+        store.persist();
+        return store;
+    }
+    static async loadSqlJs() {
+        if (!this.sqlPromise) {
+            this.sqlPromise = (0, sql_js_1.default)({
+                locateFile: (file) => require.resolve(`sql.js/dist/${file}`),
+            });
+        }
+        return this.sqlPromise;
+    }
+    close() {
+        this.db.close();
+    }
+    save() {
+        this.persist();
+    }
+    migrate() {
+        const userVersion = this.userVersion();
+        if (userVersion === 0) {
+            this.dropKnownTables();
+            this.createCurrentSchema();
+            this.setUserVersion(SCHEMA_VERSION);
+            return;
+        }
+        if (userVersion !== SCHEMA_VERSION) {
+            throw new Error(`unsupported database schema version ${userVersion}; delete ${this.dbPath} to recreate`);
+        }
+        this.createCurrentSchema();
+    }
+    dropKnownTables() {
+        const tables = [
+            "consumer_commits",
+            "consumers",
+            "stream_events",
+            "streams",
+            "deliveries",
+            "activations",
+            "inbox_items",
+            "activation_dispatch_states",
+            "activation_targets",
+            "subscriptions",
+            "inboxes",
+            "agents",
+            "sources",
+            "terminal_dispatch_states",
+            "terminal_targets",
+            "interests",
+        ];
+        this.inTransaction(() => {
+            for (const table of tables) {
+                if (this.tableExists(table)) {
+                    this.db.exec(`drop table ${table};`);
+                }
+            }
+        });
+    }
+    createCurrentSchema() {
+        this.db.exec(`
+      create table if not exists sources (
+        source_id text primary key,
+        source_type text not null,
+        source_key text not null,
+        config_ref text,
+        config_json text not null,
+        status text not null,
+        checkpoint text,
+        created_at text not null,
+        updated_at text not null,
+        unique(source_type, source_key)
+      );
+
+      create table if not exists agents (
+        agent_id text primary key,
+        status text not null,
+        offline_since text,
+        runtime_kind text not null,
+        runtime_session_id text,
+        created_at text not null,
+        updated_at text not null,
+        last_seen_at text not null
+      );
+
+      create table if not exists inboxes (
+        inbox_id text primary key,
+        owner_agent_id text not null unique,
+        created_at text not null
+      );
+
+      create table if not exists subscriptions (
+        subscription_id text primary key,
+        agent_id text not null,
+        source_id text not null,
+        filter_json text not null,
+        lifecycle_mode text not null,
+        expires_at text,
+        start_policy text not null,
+        start_offset integer,
+        start_time text,
+        created_at text not null
+      );
+
+      create table if not exists activation_targets (
+        target_id text primary key,
+        agent_id text not null,
+        kind text not null,
+        status text not null,
+        offline_since text,
+        consecutive_failures integer not null,
+        last_delivered_at text,
+        last_error text,
+        mode text not null,
+        notify_lease_ms integer not null,
+        url text,
+        runtime_kind text,
+        runtime_session_id text,
+        backend text,
+        tmux_pane_id text,
+        tty text,
+        term_program text,
+        iterm_session_id text,
+        created_at text not null,
+        updated_at text not null,
+        last_seen_at text not null
+      );
+
+      create table if not exists activation_dispatch_states (
+        agent_id text not null,
+        target_id text not null,
+        status text not null,
+        lease_expires_at text,
+        pending_new_item_count integer not null,
+        pending_summary text,
+        pending_subscription_ids_json text not null,
+        pending_source_ids_json text not null,
+        updated_at text not null,
+        primary key (agent_id, target_id)
+      );
+
+      create table if not exists inbox_items (
+        item_id text primary key,
+        source_id text not null,
+        source_native_id text not null,
+        event_variant text not null,
+        inbox_id text not null,
+        occurred_at text not null,
+        metadata_json text not null,
+        raw_payload_json text not null,
+        delivery_handle_json text,
+        acked_at text,
+        unique(source_id, source_native_id, event_variant, inbox_id)
+      );
+
+      create table if not exists activations (
+        activation_id text primary key,
+        kind text not null,
+        agent_id text not null,
+        inbox_id text not null,
+        target_id text not null,
+        target_kind text not null,
+        subscription_ids_json text not null,
+        source_ids_json text not null,
+        new_item_count integer not null,
+        summary text not null,
+        items_json text,
+        created_at text not null,
+        delivered_at text
+      );
+
+      create table if not exists deliveries (
+        delivery_id text primary key,
+        provider text not null,
+        surface text not null,
+        target_ref text not null,
+        thread_ref text,
+        reply_mode text,
+        kind text not null,
+        payload_json text not null,
+        status text not null,
+        created_at text not null
+      );
+
+      create table if not exists streams (
+        stream_id text primary key,
+        source_id text not null unique,
+        stream_key text not null unique,
+        backend text not null,
+        created_at text not null
+      );
+
+      create table if not exists stream_events (
+        offset integer primary key autoincrement,
+        stream_event_id text not null unique,
+        stream_id text not null,
+        source_id text not null,
+        source_native_id text not null,
+        event_variant text not null,
+        occurred_at text not null,
+        metadata_json text not null,
+        raw_payload_json text not null,
+        delivery_handle_json text,
+        created_at text not null,
+        unique(stream_id, source_native_id, event_variant)
+      );
+
+      create table if not exists consumers (
+        consumer_id text primary key,
+        stream_id text not null,
+        subscription_id text not null unique,
+        consumer_key text not null unique,
+        start_policy text not null,
+        start_offset integer,
+        start_time text,
+        next_offset integer not null,
+        created_at text not null,
+        updated_at text not null
+      );
+
+      create table if not exists consumer_commits (
+        commit_id text primary key,
+        consumer_id text not null,
+        stream_id text not null,
+        committed_offset integer not null,
+        committed_at text not null
+      );
+
+      create unique index if not exists idx_activation_targets_terminal_tmux
+        on activation_targets(tmux_pane_id)
+        where kind = 'terminal' and tmux_pane_id is not null;
+
+      create unique index if not exists idx_activation_targets_terminal_iterm
+        on activation_targets(iterm_session_id)
+        where kind = 'terminal' and iterm_session_id is not null;
+
+      create unique index if not exists idx_activation_targets_runtime_session
+        on activation_targets(runtime_kind, runtime_session_id)
+        where kind = 'terminal' and runtime_session_id is not null;
+
+      create index if not exists idx_activation_dispatch_states_target
+        on activation_dispatch_states(target_id, lease_expires_at);
+
+      create index if not exists idx_inbox_items_acked_at
+        on inbox_items(acked_at);
+
+      create index if not exists idx_inbox_items_inbox_acked_at
+        on inbox_items(inbox_id, acked_at);
+
+      create index if not exists idx_agents_status_offline
+        on agents(status, offline_since);
+
+      create index if not exists idx_activation_targets_agent_status
+        on activation_targets(agent_id, status);
+
+      create index if not exists idx_stream_events_stream_offset
+        on stream_events(stream_id, offset);
+
+      create index if not exists idx_stream_events_stream_occurred_at
+        on stream_events(stream_id, occurred_at);
+
+      create index if not exists idx_consumers_stream
+        on consumers(stream_id);
+
+      create index if not exists idx_consumer_commits_consumer
+        on consumer_commits(consumer_id, committed_offset);
+    `);
+    }
+    persist() {
+        const data = this.db.export();
+        node_fs_1.default.writeFileSync(this.dbPath, Buffer.from(data));
+    }
+    inTransaction(fn) {
+        this.db.exec("begin");
+        try {
+            fn();
+            this.db.exec("commit");
+        }
+        catch (error) {
+            this.db.exec("rollback");
+            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};`);
+    }
+    tableExists(name) {
+        const row = this.getOne("select name from sqlite_master where type = 'table' and name = ?", [name]);
+        return Boolean(row);
+    }
+    getSourceByKey(sourceType, sourceKey) {
+        const row = sourceType === "local_event"
+            ? this.getOne("select * from sources where source_type in (?, ?) and source_key = ? order by case when source_type = ? then 0 else 1 end limit 1", ["local_event", "custom", sourceKey, "local_event"])
+            : this.getOne("select * from sources where source_type = ? and source_key = ?", [sourceType, sourceKey]);
+        return row ? this.mapSource(row) : null;
+    }
+    getSource(sourceId) {
+        const row = this.getOne("select * from sources where source_id = ?", [sourceId]);
+        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.persist();
+    }
+    listSources() {
+        const rows = this.getAll("select * from sources order by created_at asc");
+        return rows.map((row) => this.mapSource(row));
+    }
+    updateSourceRuntime(sourceId, input) {
+        const current = this.getSource(sourceId);
+        if (!current) {
+            throw new Error(`unknown source: ${sourceId}`);
+        }
+        this.db.run(`
+      update sources
+      set status = ?, checkpoint = ?, updated_at = ?
+      where source_id = ?
+    `, [
+            input.status ?? current.status,
+            input.checkpoint ?? current.checkpoint ?? null,
+            (0, util_1.nowIso)(),
+            sourceId,
+        ]);
+        this.persist();
+    }
+    getAgent(agentId) {
+        const row = this.getOne("select * from agents where agent_id = ?", [agentId]);
+        return row ? this.mapAgent(row) : null;
+    }
+    insertAgent(agent) {
+        this.db.run(`
+      insert into agents (
+        agent_id, status, offline_since, runtime_kind, runtime_session_id, created_at, updated_at, last_seen_at
+      ) values (?, ?, ?, ?, ?, ?, ?, ?)
+    `, [
+            agent.agentId,
+            agent.status,
+            agent.offlineSince ?? null,
+            agent.runtimeKind,
+            agent.runtimeSessionId ?? null,
+            agent.createdAt,
+            agent.updatedAt,
+            agent.lastSeenAt,
+        ]);
+        this.persist();
+    }
+    updateAgent(agentId, input) {
+        const current = this.getAgent(agentId);
+        if (!current) {
+            throw new Error(`unknown agent: ${agentId}`);
+        }
+        this.db.run(`
+      update agents
+      set status = ?, offline_since = ?, runtime_kind = ?, runtime_session_id = ?, updated_at = ?, last_seen_at = ?
+      where agent_id = ?
+    `, [
+            input.status ?? current.status,
+            input.offlineSince !== undefined ? input.offlineSince : current.offlineSince ?? null,
+            input.runtimeKind,
+            input.runtimeSessionId ?? null,
+            input.updatedAt,
+            input.lastSeenAt,
+            agentId,
+        ]);
+        this.persist();
+        return this.getAgent(agentId);
+    }
+    listAgents() {
+        const rows = this.getAll("select * from agents order by created_at asc");
+        return rows.map((row) => this.mapAgent(row));
+    }
+    getInbox(inboxId) {
+        const row = this.getOne("select * from inboxes where inbox_id = ?", [inboxId]);
+        return row ? this.mapInbox(row) : null;
+    }
+    getInboxByAgentId(agentId) {
+        const row = this.getOne("select * from inboxes where owner_agent_id = ?", [agentId]);
+        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.persist();
+    }
+    listInboxes() {
+        const rows = this.getAll("select * from inboxes order by created_at asc");
+        return rows.map((row) => this.mapInbox(row));
+    }
+    getSubscription(subscriptionId) {
+        const row = this.getOne("select * from subscriptions where subscription_id = ?", [subscriptionId]);
+        return row ? this.mapSubscription(row) : null;
+    }
+    insertSubscription(subscription) {
+        this.db.run(`
+      insert into subscriptions (
+        subscription_id, agent_id, source_id, filter_json, lifecycle_mode, expires_at, start_policy, start_offset, start_time, created_at
+      ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `, [
+            subscription.subscriptionId,
+            subscription.agentId,
+            subscription.sourceId,
+            JSON.stringify(subscription.filter),
+            subscription.lifecycleMode,
+            subscription.expiresAt ?? null,
+            subscription.startPolicy,
+            subscription.startOffset ?? null,
+            subscription.startTime ?? null,
+            subscription.createdAt,
+        ]);
+        this.persist();
+    }
+    listSubscriptions() {
+        const rows = this.getAll("select * from subscriptions order by created_at asc");
+        return rows.map((row) => this.mapSubscription(row));
+    }
+    listSubscriptionsForSource(sourceId) {
+        const rows = this.getAll("select * from subscriptions where source_id = ? order by created_at asc", [sourceId]);
+        return rows.map((row) => this.mapSubscription(row));
+    }
+    listSubscriptionsForAgent(agentId) {
+        const rows = this.getAll("select * from subscriptions where agent_id = ? order by created_at asc", [agentId]);
+        return rows.map((row) => this.mapSubscription(row));
+    }
+    deleteSubscription(subscriptionId) {
+        const subscription = this.getSubscription(subscriptionId);
+        if (!subscription) {
+            return null;
+        }
+        this.db.run("delete from subscriptions where subscription_id = ?", [subscriptionId]);
+        this.persist();
+        return subscription;
+    }
+    getActivationTarget(targetId) {
+        const row = this.getOne("select * from activation_targets where target_id = ?", [targetId]);
+        return row ? this.mapActivationTarget(row) : null;
+    }
+    getTerminalActivationTargetByTmuxPaneId(tmuxPaneId) {
+        const row = this.getOne("select * from activation_targets where kind = 'terminal' and tmux_pane_id = ?", [tmuxPaneId]);
+        const target = row ? this.mapActivationTarget(row) : null;
+        return target?.kind === "terminal" ? target : null;
+    }
+    getTerminalActivationTargetByItermSessionId(itermSessionId) {
+        const row = this.getOne("select * from activation_targets where kind = 'terminal' and iterm_session_id = ?", [itermSessionId]);
+        const target = row ? this.mapActivationTarget(row) : null;
+        return target?.kind === "terminal" ? target : null;
+    }
+    getTerminalActivationTargetByTty(tty) {
+        const row = this.getOne("select * from activation_targets where kind = 'terminal' and tty = ?", [tty]);
+        const target = row ? this.mapActivationTarget(row) : null;
+        return target?.kind === "terminal" ? target : null;
+    }
+    getTerminalActivationTargetByRuntimeSession(runtimeKind, runtimeSessionId) {
+        const row = this.getOne("select * from activation_targets where kind = 'terminal' and runtime_kind = ? and runtime_session_id = ?", [runtimeKind, runtimeSessionId]);
+        const target = row ? this.mapActivationTarget(row) : null;
+        return target?.kind === "terminal" ? target : null;
+    }
+    insertActivationTarget(target) {
+        if (target.kind === "webhook") {
+            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 (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `, [
+                target.targetId,
+                target.agentId,
+                target.kind,
+                target.status,
+                target.offlineSince ?? null,
+                target.consecutiveFailures,
+                target.lastDeliveredAt ?? null,
+                target.lastError ?? null,
+                target.mode,
+                target.notifyLeaseMs,
+                target.url,
+                target.createdAt,
+                target.updatedAt,
+                target.lastSeenAt,
+            ]);
+        }
+        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,
+          runtime_kind, runtime_session_id, backend, tmux_pane_id, tty, term_program, iterm_session_id,
+          created_at, updated_at, last_seen_at
+        ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `, [
+                target.targetId,
+                target.agentId,
+                target.kind,
+                target.status,
+                target.offlineSince ?? null,
+                target.consecutiveFailures,
+                target.lastDeliveredAt ?? null,
+                target.lastError ?? null,
+                target.mode,
+                target.notifyLeaseMs,
+                target.runtimeKind,
+                target.runtimeSessionId ?? null,
+                target.backend,
+                target.tmuxPaneId ?? null,
+                target.tty ?? null,
+                target.termProgram ?? null,
+                target.itermSessionId ?? null,
+                target.createdAt,
+                target.updatedAt,
+                target.lastSeenAt,
+            ]);
+        }
+        this.persist();
+    }
+    updateTerminalActivationTargetHeartbeat(targetId, input) {
+        this.db.run(`
+      update activation_targets
+      set status = 'active', offline_since = null, last_error = null, consecutive_failures = 0,
+          runtime_kind = ?, runtime_session_id = ?, tmux_pane_id = ?, tty = ?, term_program = ?, iterm_session_id = ?, updated_at = ?, last_seen_at = ?
+      where target_id = ? and kind = 'terminal'
+    `, [
+            input.runtimeKind,
+            input.runtimeSessionId ?? null,
+            input.tmuxPaneId ?? null,
+            input.tty ?? null,
+            input.termProgram ?? null,
+            input.itermSessionId ?? null,
+            input.updatedAt,
+            input.lastSeenAt,
+            targetId,
+        ]);
+        this.persist();
+        const target = this.getActivationTarget(targetId);
+        if (!target || target.kind !== "terminal") {
+            throw new Error(`unknown terminal activation target: ${targetId}`);
+        }
+        return target;
+    }
+    updateActivationTargetRuntime(targetId, input) {
+        const current = this.getActivationTarget(targetId);
+        if (!current) {
+            throw new Error(`unknown activation target: ${targetId}`);
+        }
+        this.db.run(`
+      update activation_targets
+      set status = ?, offline_since = ?, consecutive_failures = ?, last_delivered_at = ?, last_error = ?, updated_at = ?, last_seen_at = ?
+      where target_id = ?
+    `, [
+            input.status ?? current.status,
+            input.offlineSince !== undefined ? input.offlineSince : current.offlineSince ?? null,
+            input.consecutiveFailures ?? current.consecutiveFailures,
+            input.lastDeliveredAt !== undefined ? input.lastDeliveredAt : current.lastDeliveredAt ?? null,
+            input.lastError !== undefined ? input.lastError : current.lastError ?? null,
+            input.updatedAt,
+            input.lastSeenAt ?? current.lastSeenAt,
+            targetId,
+        ]);
+        this.persist();
+        return this.getActivationTarget(targetId);
+    }
+    listActivationTargets() {
+        const rows = this.getAll("select * from activation_targets order by created_at asc");
+        return rows.map((row) => this.mapActivationTarget(row));
+    }
+    listActivationTargetsForAgent(agentId) {
+        const rows = this.getAll("select * from activation_targets where agent_id = ? order by created_at asc", [agentId]);
+        return rows.map((row) => this.mapActivationTarget(row));
+    }
+    deleteActivationTarget(agentId, targetId) {
+        this.inTransaction(() => {
+            this.db.run("delete from activation_dispatch_states where agent_id = ? and target_id = ?", [agentId, targetId]);
+            this.db.run("delete from activation_targets where agent_id = ? and target_id = ?", [agentId, targetId]);
+        });
+        this.persist();
+    }
+    deleteAgent(agentId, options) {
+        const inbox = this.getInboxByAgentId(agentId);
+        const subscriptions = this.listSubscriptionsForAgent(agentId);
+        this.inTransaction(() => {
+            for (const subscription of subscriptions) {
+                this.db.run("delete from consumer_commits where consumer_id in (select consumer_id from consumers where subscription_id = ?)", [
+                    subscription.subscriptionId,
+                ]);
+                this.db.run("delete from consumers where subscription_id = ?", [subscription.subscriptionId]);
+            }
+            this.db.run("delete from subscriptions where agent_id = ?", [agentId]);
+            this.db.run("delete from activation_dispatch_states where agent_id = ?", [agentId]);
+            this.db.run("delete from activation_targets where agent_id = ?", [agentId]);
+            if (inbox) {
+                this.db.run("delete from inbox_items where inbox_id = ?", [inbox.inboxId]);
+                this.db.run("delete from activations where agent_id = ? or inbox_id = ?", [agentId, inbox.inboxId]);
+                this.db.run("delete from inboxes where inbox_id = ?", [inbox.inboxId]);
+            }
+            else {
+                this.db.run("delete from activations where agent_id = ?", [agentId]);
+            }
+            this.db.run("delete from agents where agent_id = ?", [agentId]);
+        });
+        if (options?.persist !== false) {
+            this.persist();
+        }
+    }
+    countActiveActivationTargetsForAgent(agentId) {
+        const row = this.getOne("select count(*) as count from activation_targets where agent_id = ? and status = 'active'", [agentId]);
+        return Number(row?.count ?? 0);
+    }
+    listOfflineAgentsOlderThan(cutoffIso) {
+        const rows = this.getAll("select * from agents where status = 'offline' and offline_since is not null and offline_since <= ? order by offline_since asc", [cutoffIso]);
+        return rows.map((row) => this.mapAgent(row));
+    }
+    getActivationDispatchState(agentId, targetId) {
+        const row = this.getOne("select * from activation_dispatch_states where agent_id = ? and target_id = ?", [agentId, targetId]);
+        return row ? this.mapActivationDispatchState(row) : null;
+    }
+    listActivationDispatchStates() {
+        const rows = this.getAll("select * from activation_dispatch_states order by updated_at asc");
+        return rows.map((row) => this.mapActivationDispatchState(row));
+    }
+    listActivationDispatchStatesForAgent(agentId) {
+        const rows = this.getAll("select * from activation_dispatch_states where agent_id = ? order by updated_at asc", [agentId]);
+        return rows.map((row) => this.mapActivationDispatchState(row));
+    }
+    upsertActivationDispatchState(state) {
+        this.db.run(`
+      insert into activation_dispatch_states (
+        agent_id, target_id, status, lease_expires_at, pending_new_item_count, pending_summary,
+        pending_subscription_ids_json, pending_source_ids_json, updated_at
+      ) values (?, ?, ?, ?, ?, ?, ?, ?, ?)
+      on conflict(agent_id, target_id) do update set
+        status = excluded.status,
+        lease_expires_at = excluded.lease_expires_at,
+        pending_new_item_count = excluded.pending_new_item_count,
+        pending_summary = excluded.pending_summary,
+        pending_subscription_ids_json = excluded.pending_subscription_ids_json,
+        pending_source_ids_json = excluded.pending_source_ids_json,
+        updated_at = excluded.updated_at
+    `, [
+            state.agentId,
+            state.targetId,
+            state.status,
+            state.leaseExpiresAt ?? null,
+            state.pendingNewItemCount,
+            state.pendingSummary ?? null,
+            JSON.stringify(state.pendingSubscriptionIds),
+            JSON.stringify(state.pendingSourceIds),
+            state.updatedAt,
+        ]);
+        this.persist();
+    }
+    deleteActivationDispatchState(agentId, targetId) {
+        this.db.run("delete from activation_dispatch_states where agent_id = ? and target_id = ?", [agentId, targetId]);
+        this.persist();
+    }
+    insertInboxItem(item) {
+        const before = this.changes();
+        this.db.run(`
+      insert or ignore into inbox_items (
+        item_id, source_id, source_native_id, event_variant, inbox_id, occurred_at,
+        metadata_json, raw_payload_json, delivery_handle_json, acked_at
+      ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `, [
+            item.itemId,
+            item.sourceId,
+            item.sourceNativeId,
+            item.eventVariant,
+            item.inboxId,
+            item.occurredAt,
+            JSON.stringify(item.metadata),
+            JSON.stringify(item.rawPayload),
+            item.deliveryHandle ? JSON.stringify(item.deliveryHandle) : null,
+            item.ackedAt ?? null,
+        ]);
+        const inserted = this.changes() > before;
+        if (inserted) {
+            this.persist();
+        }
+        return inserted;
+    }
+    listInboxItems(inboxId, options) {
+        const includeAcked = options?.includeAcked ?? false;
+        const filters = ["inbox_id = ?"];
+        const params = [inboxId];
+        if (!includeAcked) {
+            filters.push("acked_at is null");
+        }
+        if (options?.afterItemId) {
+            const anchor = this.getOne("select occurred_at, item_id from inbox_items where inbox_id = ? and item_id = ?", [inboxId, options.afterItemId]);
+            if (!anchor) {
+                throw new Error(`unknown inbox item: ${options.afterItemId}`);
+            }
+            filters.push("((occurred_at > ?) or (occurred_at = ? and item_id > ?))");
+            params.push(String(anchor.occurred_at), String(anchor.occurred_at), String(anchor.item_id));
+        }
+        const rows = this.getAll(`select * from inbox_items where ${filters.join(" and ")} order by occurred_at asc, item_id asc`, params);
+        return rows.map((row) => this.mapInboxItem(row));
+    }
+    ackItems(inboxId, itemIds, ackedAt) {
+        let changes = 0;
+        for (const itemId of itemIds) {
+            this.db.run(`
+        update inbox_items
+        set acked_at = ?
+        where inbox_id = ? and item_id = ? and acked_at is null
+      `, [ackedAt, inboxId, itemId]);
+            changes += this.changes();
+        }
+        if (changes > 0) {
+            this.persist();
+        }
+        return changes;
+    }
+    ackItemsThrough(inboxId, itemId, ackedAt) {
+        const anchor = this.getOne("select occurred_at, item_id from inbox_items where inbox_id = ? and item_id = ?", [inboxId, itemId]);
+        if (!anchor) {
+            throw new Error(`unknown inbox item: ${itemId}`);
+        }
+        this.db.run(`
+      update inbox_items
+      set acked_at = ?
+      where inbox_id = ?
+        and acked_at is null
+        and ((occurred_at < ?) or (occurred_at = ? and item_id <= ?))
+    `, [ackedAt, inboxId, String(anchor.occurred_at), String(anchor.occurred_at), String(anchor.item_id)]);
+        const changes = this.changes();
+        if (changes > 0) {
+            this.persist();
+        }
+        return changes;
+    }
+    deleteAckedInboxItems(inboxId, olderThan) {
+        this.db.run(`
+      delete 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();
+        }
+        return changes;
+    }
+    deleteAckedInboxItemsGlobal(olderThan) {
+        this.db.run(`
+      delete from inbox_items
+      where acked_at is not null
+        and acked_at < ?
+    `, [olderThan]);
+        const changes = this.changes();
+        if (changes > 0) {
+            this.persist();
+        }
+        return changes;
+    }
+    countInboxItems(inboxId, includeAcked) {
+        const row = this.getOne(`
+      select count(*) as count
+      from inbox_items
+      where inbox_id = ?
+      ${includeAcked ? "" : "and acked_at is null"}
+    `, [inboxId]);
+        return Number(row?.count ?? 0);
+    }
+    insertActivation(activation) {
+        this.db.run(`
+      insert into activations (
+        activation_id, kind, agent_id, inbox_id, target_id, target_kind,
+        subscription_ids_json, source_ids_json, new_item_count, summary, items_json, created_at, delivered_at
+      ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `, [
+            activation.activationId,
+            activation.kind,
+            activation.agentId,
+            activation.inboxId,
+            activation.targetId,
+            activation.targetKind,
+            JSON.stringify(activation.subscriptionIds),
+            JSON.stringify(activation.sourceIds),
+            activation.newItemCount,
+            activation.summary,
+            activation.items ? JSON.stringify(activation.items) : null,
+            activation.createdAt,
+            activation.deliveredAt ?? null,
+        ]);
+        this.persist();
+    }
+    listActivations() {
+        const rows = this.getAll("select * from activations order by created_at desc");
+        return rows.map((row) => this.mapActivation(row));
+    }
+    insertDelivery(delivery) {
+        this.db.run(`
+      insert into deliveries (
+        delivery_id, provider, surface, target_ref, thread_ref, reply_mode,
+        kind, payload_json, status, created_at
+      ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `, [
+            delivery.deliveryId,
+            delivery.provider,
+            delivery.surface,
+            delivery.targetRef,
+            delivery.threadRef ?? null,
+            delivery.replyMode ?? null,
+            delivery.kind,
+            JSON.stringify(delivery.payload),
+            delivery.status,
+            delivery.createdAt,
+        ]);
+        this.persist();
+    }
+    listDeliveries() {
+        const rows = this.getAll("select * from deliveries order by created_at desc");
+        return rows.map((row) => this.mapDelivery(row));
+    }
+    insertStream(stream) {
+        this.db.run("insert into streams (stream_id, source_id, stream_key, backend, created_at) values (?, ?, ?, ?, ?)", [stream.streamId, stream.sourceId, stream.streamKey, stream.backend, stream.createdAt]);
+        this.persist();
+    }
+    getStream(streamId) {
+        const row = this.getOne("select * from streams where stream_id = ?", [streamId]);
+        return row ? this.mapStream(row) : null;
+    }
+    listStreams() {
+        const rows = this.getAll("select * from streams order by created_at asc");
+        return rows.map((row) => this.mapStream(row));
+    }
+    getStreamBySourceId(sourceId) {
+        const row = this.getOne("select * from streams where source_id = ?", [sourceId]);
+        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(),
+            };
+        }
+        return { appended: 0, deduped: 1, lastOffset: null };
+    }
+    readStreamEvents(streamId, nextOffset, limit) {
+        const rows = this.getAll(`
+      select * from stream_events
+      where stream_id = ? and offset >= ?
+      order by offset asc
+      limit ?
+    `, [streamId, nextOffset, limit]);
+        return rows.map((row) => this.mapStreamEvent(row));
+    }
+    getStreamStats(streamId) {
+        const row = this.getOne(`
+      select count(*) as event_count, max(offset) as high_watermark_offset
+      from stream_events
+      where stream_id = ?
+    `, [streamId]);
+        return {
+            streamId,
+            eventCount: Number(row?.event_count ?? 0),
+            highWatermarkOffset: row?.high_watermark_offset != null ? Number(row.high_watermark_offset) : null,
+        };
+    }
+    findOffsetAtOrAfter(streamId, occurredAt) {
+        const row = this.getOne(`
+      select offset
+      from stream_events
+      where stream_id = ? and occurred_at >= ?
+      order by occurred_at asc, offset asc
+      limit 1
+    `, [streamId, occurredAt]);
+        return row?.offset != null ? Number(row.offset) : null;
+    }
+    countPendingEvents(streamId, nextOffset) {
+        const row = this.getOne("select count(*) as count from stream_events where stream_id = ? and offset >= ?", [streamId, nextOffset]);
+        return Number(row?.count ?? 0);
+    }
+    insertConsumer(consumer) {
+        this.db.run(`
+      insert into consumers (
+        consumer_id, stream_id, subscription_id, consumer_key, start_policy,
+        start_offset, start_time, next_offset, created_at, updated_at
+      ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `, [
+            consumer.consumerId,
+            consumer.streamId,
+            consumer.subscriptionId,
+            consumer.consumerKey,
+            consumer.startPolicy,
+            consumer.startOffset ?? null,
+            consumer.startTime ?? null,
+            consumer.nextOffset,
+            consumer.createdAt,
+            consumer.updatedAt,
+        ]);
+        this.persist();
+    }
+    getConsumer(consumerId) {
+        const row = this.getOne("select * from consumers where consumer_id = ?", [consumerId]);
+        return row ? this.mapConsumer(row) : null;
+    }
+    getConsumerBySubscriptionId(subscriptionId) {
+        const row = this.getOne("select * from consumers where subscription_id = ?", [subscriptionId]);
+        return row ? this.mapConsumer(row) : null;
+    }
+    listConsumers() {
+        const rows = this.getAll("select * from consumers order by created_at asc");
+        return rows.map((row) => this.mapConsumer(row));
+    }
+    deleteConsumer(consumerId) {
+        this.inTransaction(() => {
+            this.db.run("delete from consumer_commits where consumer_id = ?", [consumerId]);
+            this.db.run("delete from consumers where consumer_id = ?", [consumerId]);
+        });
+        this.persist();
+    }
+    updateConsumerOffset(consumerId, nextOffset, committedOffset) {
+        const consumer = this.getConsumer(consumerId);
+        if (!consumer) {
+            throw new Error(`unknown consumer: ${consumerId}`);
+        }
+        const updatedAt = (0, util_1.nowIso)();
+        this.inTransaction(() => {
+            this.db.run("update consumers set next_offset = ?, updated_at = ? where consumer_id = ?", [nextOffset, updatedAt, consumerId]);
+            this.db.run(`
+        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]);
+        });
+        this.persist();
+        return this.getConsumer(consumerId);
+    }
+    resetConsumer(consumerId, input) {
+        this.db.run(`
+      update consumers
+      set start_policy = ?, start_offset = ?, start_time = ?, next_offset = ?, updated_at = ?
+      where consumer_id = ?
+    `, [
+            input.startPolicy,
+            input.startOffset ?? null,
+            input.startTime ?? null,
+            input.nextOffset,
+            (0, util_1.nowIso)(),
+            consumerId,
+        ]);
+        this.persist();
+        return this.getConsumer(consumerId);
+    }
+    getCounts() {
+        return {
+            sources: this.count("sources"),
+            agents: this.count("agents"),
+            offlineAgents: this.count("agents where status = 'offline'"),
+            subscriptions: this.count("subscriptions"),
+            inboxes: this.count("inboxes"),
+            activationTargets: this.count("activation_targets"),
+            offlineActivationTargets: this.count("activation_targets where status = 'offline'"),
+            activationDispatchStates: this.count("activation_dispatch_states"),
+            streamEvents: this.count("stream_events"),
+            consumers: this.count("consumers"),
+            inboxItems: this.count("inbox_items"),
+            pendingInboxItems: this.count("inbox_items where acked_at is null"),
+            activations: this.count("activations"),
+            deliveries: this.count("deliveries"),
+        };
+    }
+    count(tableOrClause) {
+        const row = this.getOne(`select count(*) as count from ${tableOrClause}`);
+        return row ? Number(row.count) : 0;
+    }
+    changes() {
+        const row = this.getOne("select changes() as count");
+        return row ? Number(row.count) : 0;
+    }
+    lastInsertRowId() {
+        const row = this.getOne("select last_insert_rowid() as rowid");
+        return Number(row?.rowid ?? 0);
+    }
+    getOne(sql, params = []) {
+        const statement = this.db.prepare(sql);
+        try {
+            statement.bind(params);
+            if (!statement.step()) {
+                return undefined;
+            }
+            return statement.getAsObject();
+        }
+        finally {
+            statement.free();
+        }
+    }
+    getAll(sql, params = []) {
+        const statement = this.db.prepare(sql);
+        try {
+            statement.bind(params);
+            const rows = [];
+            while (statement.step()) {
+                rows.push(statement.getAsObject());
+            }
+            return rows;
+        }
+        finally {
+            statement.free();
+        }
+    }
+    mapSource(row) {
+        const sourceType = String(row.source_type) === "custom"
+            ? "local_event"
+            : row.source_type;
+        return {
+            sourceId: String(row.source_id),
+            sourceType,
+            sourceKey: String(row.source_key),
+            configRef: row.config_ref ? String(row.config_ref) : null,
+            config: parseJson(row.config_json),
+            status: row.status,
+            checkpoint: row.checkpoint ? String(row.checkpoint) : null,
+            createdAt: String(row.created_at),
+            updatedAt: String(row.updated_at),
+        };
+    }
+    mapAgent(row) {
+        return {
+            agentId: String(row.agent_id),
+            status: row.status,
+            offlineSince: row.offline_since ? String(row.offline_since) : null,
+            runtimeKind: row.runtime_kind,
+            runtimeSessionId: row.runtime_session_id ? String(row.runtime_session_id) : null,
+            createdAt: String(row.created_at),
+            updatedAt: String(row.updated_at),
+            lastSeenAt: String(row.last_seen_at),
+        };
+    }
+    mapInbox(row) {
+        return {
+            inboxId: String(row.inbox_id),
+            ownerAgentId: String(row.owner_agent_id),
+            createdAt: String(row.created_at),
+        };
+    }
+    mapSubscription(row) {
+        return {
+            subscriptionId: String(row.subscription_id),
+            agentId: String(row.agent_id),
+            sourceId: String(row.source_id),
+            filter: parseJson(row.filter_json),
+            lifecycleMode: row.lifecycle_mode,
+            expiresAt: row.expires_at ? String(row.expires_at) : null,
+            startPolicy: row.start_policy,
+            startOffset: row.start_offset != null ? Number(row.start_offset) : null,
+            startTime: row.start_time ? String(row.start_time) : null,
+            createdAt: String(row.created_at),
+        };
+    }
+    mapActivationTarget(row) {
+        if (String(row.kind) === "webhook") {
+            const url = typeof row.url === "string" && row.url.trim().length > 0 ? row.url.trim() : null;
+            if (!url) {
+                throw new Error(`invalid webhook activation target: ${String(row.target_id)}`);
+            }
+            return {
+                targetId: String(row.target_id),
+                agentId: String(row.agent_id),
+                kind: "webhook",
+                status: row.status,
+                offlineSince: row.offline_since ? String(row.offline_since) : null,
+                consecutiveFailures: Number(row.consecutive_failures ?? 0),
+                lastDeliveredAt: row.last_delivered_at ? String(row.last_delivered_at) : null,
+                lastError: row.last_error ? String(row.last_error) : null,
+                mode: row.mode,
+                url,
+                notifyLeaseMs: Number(row.notify_lease_ms),
+                createdAt: String(row.created_at),
+                updatedAt: String(row.updated_at),
+                lastSeenAt: String(row.last_seen_at),
+            };
+        }
+        return {
+            targetId: String(row.target_id),
+            agentId: String(row.agent_id),
+            kind: "terminal",
+            status: row.status,
+            offlineSince: row.offline_since ? String(row.offline_since) : null,
+            consecutiveFailures: Number(row.consecutive_failures ?? 0),
+            lastDeliveredAt: row.last_delivered_at ? String(row.last_delivered_at) : null,
+            lastError: row.last_error ? String(row.last_error) : null,
+            mode: row.mode,
+            notifyLeaseMs: Number(row.notify_lease_ms),
+            runtimeKind: (row.runtime_kind ? String(row.runtime_kind) : "unknown"),
+            runtimeSessionId: row.runtime_session_id ? String(row.runtime_session_id) : null,
+            backend: row.backend,
+            tmuxPaneId: row.tmux_pane_id ? String(row.tmux_pane_id) : null,
+            tty: row.tty ? String(row.tty) : null,
+            termProgram: row.term_program ? String(row.term_program) : null,
+            itermSessionId: row.iterm_session_id ? String(row.iterm_session_id) : null,
+            createdAt: String(row.created_at),
+            updatedAt: String(row.updated_at),
+            lastSeenAt: String(row.last_seen_at),
+        };
+    }
+    mapActivationDispatchState(row) {
+        return {
+            agentId: String(row.agent_id),
+            targetId: String(row.target_id),
+            status: row.status,
+            leaseExpiresAt: row.lease_expires_at ? String(row.lease_expires_at) : null,
+            pendingNewItemCount: Number(row.pending_new_item_count),
+            pendingSummary: row.pending_summary ? String(row.pending_summary) : null,
+            pendingSubscriptionIds: parseJson(row.pending_subscription_ids_json),
+            pendingSourceIds: parseJson(row.pending_source_ids_json),
+            updatedAt: String(row.updated_at),
+        };
+    }
+    mapInboxItem(row) {
+        return {
+            itemId: String(row.item_id),
+            sourceId: String(row.source_id),
+            sourceNativeId: String(row.source_native_id),
+            eventVariant: String(row.event_variant),
+            inboxId: String(row.inbox_id),
+            occurredAt: String(row.occurred_at),
+            metadata: parseJson(row.metadata_json),
+            rawPayload: parseJson(row.raw_payload_json),
+            deliveryHandle: row.delivery_handle_json
+                ? parseJson(row.delivery_handle_json)
+                : null,
+            ackedAt: row.acked_at ? String(row.acked_at) : null,
+        };
+    }
+    mapActivation(row) {
+        return {
+            kind: "agentinbox.activation",
+            activationId: String(row.activation_id),
+            agentId: String(row.agent_id),
+            inboxId: String(row.inbox_id),
+            targetId: String(row.target_id),
+            targetKind: row.target_kind,
+            subscriptionIds: parseJson(row.subscription_ids_json),
+            sourceIds: parseJson(row.source_ids_json),
+            newItemCount: Number(row.new_item_count),
+            summary: String(row.summary),
+            items: row.items_json ? parseJson(row.items_json) : undefined,
+            createdAt: String(row.created_at),
+            deliveredAt: row.delivered_at ? String(row.delivered_at) : null,
+        };
+    }
+    mapDelivery(row) {
+        return {
+            deliveryId: String(row.delivery_id),
+            provider: String(row.provider),
+            surface: String(row.surface),
+            targetRef: String(row.target_ref),
+            threadRef: row.thread_ref ? String(row.thread_ref) : null,
+            replyMode: row.reply_mode ? String(row.reply_mode) : null,
+            kind: String(row.kind),
+            payload: parseJson(row.payload_json),
+            status: row.status,
+            createdAt: String(row.created_at),
+        };
+    }
+    mapStream(row) {
+        return {
+            streamId: String(row.stream_id),
+            sourceId: String(row.source_id),
+            streamKey: String(row.stream_key),
+            backend: String(row.backend),
+            createdAt: String(row.created_at),
+        };
+    }
+    mapStreamEvent(row) {
+        return {
+            offset: Number(row.offset),
+            streamEventId: String(row.stream_event_id),
+            streamId: String(row.stream_id),
+            sourceId: String(row.source_id),
+            sourceNativeId: String(row.source_native_id),
+            eventVariant: String(row.event_variant),
+            occurredAt: String(row.occurred_at),
+            metadata: parseJson(row.metadata_json),
+            rawPayload: parseJson(row.raw_payload_json),
+            deliveryHandle: row.delivery_handle_json
+                ? parseJson(row.delivery_handle_json)
+                : null,
+            createdAt: String(row.created_at),
+        };
+    }
+    mapConsumer(row) {
+        return {
+            consumerId: String(row.consumer_id),
+            streamId: String(row.stream_id),
+            subscriptionId: String(row.subscription_id),
+            consumerKey: String(row.consumer_key),
+            nextOffset: Number(row.next_offset),
+            startPolicy: row.start_policy,
+            startOffset: row.start_offset != null ? Number(row.start_offset) : null,
+            startTime: row.start_time ? String(row.start_time) : null,
+            createdAt: String(row.created_at),
+            updatedAt: String(row.updated_at),
+        };
+    }
+}
+exports.AgentInboxStore = AgentInboxStore;