@knowzai/local-store 0.1.0

package/dist/sqlite-store.js

@@ -0,0 +1,416 @@
+import { mkdirSync, chmodSync } from 'node:fs';
+import { dirname } from 'node:path';
+import Database from 'better-sqlite3';
+import * as sqliteVec from 'sqlite-vec';
+import { SCHEMA_VERSION, DEFAULT_DIM, } from './types.js';
+// sqlite-vec accepts a JSON array as float-vector input; this avoids a
+// BLOB-binding path that misparses under better-sqlite3 (spurious rowid error).
+function vecParam(v) {
+    return JSON.stringify(Array.from(v));
+}
+export class SqliteStore {
+    driver = 'sqlite';
+    db;
+    dim;
+    constructor(dbPath, dim = DEFAULT_DIM) {
+        this.dim = dim;
+        if (dbPath !== ':memory:')
+            mkdirSync(dirname(dbPath), { recursive: true, mode: 0o700 });
+        this.db = new Database(dbPath);
+        if (dbPath !== ':memory:')
+            chmodSync(dbPath, 0o600);
+        sqliteVec.load(this.db);
+        this.db.pragma('journal_mode = WAL');
+    }
+    async init() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS meta (key TEXT PRIMARY KEY, value TEXT);
+      CREATE TABLE IF NOT EXISTS items (
+        id TEXT PRIMARY KEY, vault_id TEXT, title TEXT NOT NULL, type TEXT NOT NULL,
+        content_hash TEXT NOT NULL, content TEXT, tags TEXT NOT NULL DEFAULT '[]',
+        updated_at TEXT NOT NULL, sync_state TEXT NOT NULL, remote_version INTEGER
+      );
+      CREATE INDEX IF NOT EXISTS idx_items_vault ON items(vault_id);
+      CREATE INDEX IF NOT EXISTS idx_items_sync ON items(sync_state);
+      CREATE TABLE IF NOT EXISTS chunks (
+        rowid INTEGER PRIMARY KEY AUTOINCREMENT, id TEXT UNIQUE NOT NULL, item_id TEXT NOT NULL,
+        ordinal INTEGER NOT NULL, text TEXT NOT NULL, start_byte INTEGER, end_byte INTEGER, lang TEXT
+      );
+      CREATE INDEX IF NOT EXISTS idx_chunks_item ON chunks(item_id);
+      CREATE TABLE IF NOT EXISTS file_state (
+        path TEXT PRIMARY KEY, hash TEXT NOT NULL, mtime_ms REAL NOT NULL, size INTEGER NOT NULL,
+        item_id TEXT, last_indexed_at TEXT
+      );
+      CREATE TABLE IF NOT EXISTS sync_log (
+        ts TEXT NOT NULL, direction TEXT NOT NULL, item_id TEXT, action TEXT, detail TEXT
+      );
+      CREATE TABLE IF NOT EXISTS observations (
+        id TEXT PRIMARY KEY, session_id TEXT NOT NULL, ts TEXT NOT NULL,
+        kind TEXT NOT NULL, tool_name TEXT, summary TEXT NOT NULL,
+        redacted INTEGER NOT NULL DEFAULT 0, vault_id TEXT, sealed_into_item_id TEXT
+      );
+      CREATE INDEX IF NOT EXISTS idx_obs_session ON observations(session_id);
+      CREATE INDEX IF NOT EXISTS idx_obs_sealed ON observations(sealed_into_item_id);
+      CREATE TABLE IF NOT EXISTS capture_outbox (
+        idempotency_key TEXT PRIMARY KEY, item_id TEXT NOT NULL, session_id TEXT NOT NULL,
+        created_at TEXT NOT NULL, attempts INTEGER NOT NULL DEFAULT 0, last_attempt_at TEXT,
+        state TEXT NOT NULL DEFAULT 'pending', last_error TEXT, lease_until TEXT
+      );
+      CREATE INDEX IF NOT EXISTS idx_outbox_state ON capture_outbox(state);
+    `);
+        this.db.exec(`CREATE VIRTUAL TABLE IF NOT EXISTS embeddings USING vec0(embedding float[${this.dim}]);`);
+        const existingDim = this.getMeta('dim');
+        if (existingDim && Number(existingDim) !== this.dim) {
+            throw new Error(`Local store dim mismatch: store=${existingDim}, requested=${this.dim}`);
+        }
+        this.setMeta('schemaVersion', String(SCHEMA_VERSION));
+        this.setMeta('dim', String(this.dim));
+    }
+    getMeta(key) {
+        const r = this.db.prepare('SELECT value FROM meta WHERE key = ?').get(key);
+        return r?.value;
+    }
+    setMeta(key, value) {
+        this.db
+            .prepare('INSERT INTO meta(key,value) VALUES(?,?) ON CONFLICT(key) DO UPDATE SET value=excluded.value')
+            .run(key, value);
+    }
+    rowToItem(r) {
+        return {
+            id: r.id,
+            vaultId: r.vault_id ?? undefined,
+            title: r.title,
+            type: r.type,
+            contentHash: r.content_hash,
+            content: r.content ?? undefined,
+            tags: JSON.parse(r.tags),
+            updatedAt: r.updated_at,
+            syncState: r.sync_state,
+            remoteVersion: r.remote_version ?? undefined,
+        };
+    }
+    async upsertItem(i) {
+        this.db
+            .prepare(`INSERT INTO items(id,vault_id,title,type,content_hash,content,tags,updated_at,sync_state,remote_version)
+         VALUES(@id,@vault_id,@title,@type,@content_hash,@content,@tags,@updated_at,@sync_state,@remote_version)
+         ON CONFLICT(id) DO UPDATE SET vault_id=excluded.vault_id, title=excluded.title, type=excluded.type,
+           content_hash=excluded.content_hash, content=excluded.content, tags=excluded.tags,
+           updated_at=excluded.updated_at, sync_state=excluded.sync_state, remote_version=excluded.remote_version`)
+            .run({
+            id: i.id,
+            vault_id: i.vaultId ?? null,
+            title: i.title,
+            type: i.type,
+            content_hash: i.contentHash,
+            content: i.content ?? null,
+            tags: JSON.stringify(i.tags ?? []),
+            updated_at: i.updatedAt,
+            sync_state: i.syncState,
+            remote_version: i.remoteVersion ?? null,
+        });
+    }
+    async getItem(id) {
+        const r = this.db.prepare('SELECT * FROM items WHERE id = ?').get(id);
+        return r ? this.rowToItem(r) : undefined;
+    }
+    async listItems(filter = {}) {
+        const where = [];
+        const params = [];
+        if (filter.vaultId) {
+            where.push('vault_id = ?');
+            params.push(filter.vaultId);
+        }
+        if (filter.syncState) {
+            where.push('sync_state = ?');
+            params.push(filter.syncState);
+        }
+        const sql = `SELECT * FROM items ${where.length ? `WHERE ${where.join(' AND ')}` : ''} ORDER BY updated_at DESC`;
+        return this.db.prepare(sql).all(...params).map((r) => this.rowToItem(r));
+    }
+    async reassignItemId(oldId, newId) {
+        const tx = this.db.transaction(() => {
+            this.db.prepare('UPDATE items SET id = ? WHERE id = ?').run(newId, oldId);
+            this.db.prepare('UPDATE chunks SET item_id = ? WHERE item_id = ?').run(newId, oldId);
+            this.db.prepare('UPDATE file_state SET item_id = ? WHERE item_id = ?').run(newId, oldId);
+        });
+        tx();
+    }
+    async deleteItem(id) {
+        const tx = this.db.transaction((itemId) => {
+            const rows = this.db.prepare('SELECT rowid FROM chunks WHERE item_id = ?').all(itemId);
+            const del = this.db.prepare('DELETE FROM embeddings WHERE rowid = ?');
+            for (const { rowid } of rows)
+                del.run(rowid);
+            this.db.prepare('DELETE FROM chunks WHERE item_id = ?').run(itemId);
+            this.db.prepare('DELETE FROM items WHERE id = ?').run(itemId);
+        });
+        tx(id);
+    }
+    async putChunks(itemId, chunks, vectors) {
+        const tx = this.db.transaction(() => {
+            const old = this.db.prepare('SELECT rowid FROM chunks WHERE item_id = ?').all(itemId);
+            const delEmb = this.db.prepare('DELETE FROM embeddings WHERE rowid = ?');
+            for (const { rowid } of old)
+                delEmb.run(rowid);
+            this.db.prepare('DELETE FROM chunks WHERE item_id = ?').run(itemId);
+            const insChunk = this.db.prepare(`INSERT INTO chunks(id,item_id,ordinal,text,start_byte,end_byte,lang)
+         VALUES(?,?,?,?,?,?,?)`);
+            const insEmb = this.db.prepare('INSERT INTO embeddings(rowid, embedding) VALUES(?, ?)');
+            chunks.forEach((c, idx) => {
+                const info = insChunk.run(c.id, c.itemId, c.ordinal, c.text, c.startByte ?? null, c.endByte ?? null, c.lang ?? null);
+                const vec = vectors?.[idx];
+                if (vec) {
+                    if (vec.length !== this.dim)
+                        throw new Error(`vector dim ${vec.length} != store dim ${this.dim}`);
+                    // vec0 requires the rowid bound as SQLITE_INTEGER — better-sqlite3
+                    // only does that for a BigInt, not a plain JS number.
+                    insEmb.run(BigInt(info.lastInsertRowid), vecParam(vec));
+                }
+            });
+        });
+        tx();
+    }
+    async knnSearch(queryVec, k, filter) {
+        if (queryVec.length !== this.dim)
+            throw new Error(`query dim ${queryVec.length} != store dim ${this.dim}`);
+        const overfetch = filter?.vaultId ? k * 4 : k;
+        const rows = this.db
+            .prepare(`SELECT e.rowid AS rowid, e.distance AS distance,
+                c.id, c.item_id, c.ordinal, c.text, c.start_byte, c.end_byte, c.lang
+         FROM embeddings e JOIN chunks c ON c.rowid = e.rowid
+         WHERE e.embedding MATCH ? AND k = ?
+         ORDER BY e.distance`)
+            .all(vecParam(queryVec), overfetch);
+        let hits = rows.map((r) => ({
+            distance: r.distance,
+            chunk: {
+                id: r.id,
+                itemId: r.item_id,
+                ordinal: r.ordinal,
+                text: r.text,
+                startByte: r.start_byte ?? undefined,
+                endByte: r.end_byte ?? undefined,
+                lang: r.lang ?? undefined,
+            },
+        }));
+        if (filter?.vaultId) {
+            const inVault = new Set(this.db.prepare('SELECT id FROM items WHERE vault_id = ?').all(filter.vaultId).map((x) => x.id));
+            hits = hits.filter((h) => inVault.has(h.chunk.itemId)).slice(0, k);
+        }
+        return hits;
+    }
+    async setFileState(s) {
+        this.db
+            .prepare(`INSERT INTO file_state(path,hash,mtime_ms,size,item_id,last_indexed_at)
+         VALUES(@path,@hash,@mtime_ms,@size,@item_id,@last_indexed_at)
+         ON CONFLICT(path) DO UPDATE SET hash=excluded.hash, mtime_ms=excluded.mtime_ms,
+           size=excluded.size, item_id=excluded.item_id, last_indexed_at=excluded.last_indexed_at`)
+            .run({
+            path: s.path,
+            hash: s.hash,
+            mtime_ms: s.mtimeMs,
+            size: s.size,
+            item_id: s.itemId ?? null,
+            last_indexed_at: s.lastIndexedAt ?? null,
+        });
+    }
+    async getFileState(path) {
+        const r = this.db.prepare('SELECT * FROM file_state WHERE path = ?').get(path);
+        if (!r)
+            return undefined;
+        return {
+            path: r.path,
+            hash: r.hash,
+            mtimeMs: r.mtime_ms,
+            size: r.size,
+            itemId: r.item_id ?? undefined,
+            lastIndexedAt: r.last_indexed_at ?? undefined,
+        };
+    }
+    async listFileStates() {
+        const rows = this.db.prepare('SELECT * FROM file_state').all();
+        return rows.map((r) => ({
+            path: r.path,
+            hash: r.hash,
+            mtimeMs: r.mtime_ms,
+            size: r.size,
+            itemId: r.item_id ?? undefined,
+            lastIndexedAt: r.last_indexed_at ?? undefined,
+        }));
+    }
+    async meta() {
+        const itemCount = this.db.prepare('SELECT COUNT(*) AS n FROM items').get().n;
+        const chunkCount = this.db.prepare('SELECT COUNT(*) AS n FROM chunks').get().n;
+        return {
+            schemaVersion: Number(this.getMeta('schemaVersion') ?? SCHEMA_VERSION),
+            dim: Number(this.getMeta('dim') ?? this.dim),
+            itemCount,
+            chunkCount,
+        };
+    }
+    // ── Agent-memory capture / outbox (FEAT_AgentMemoryLocalOutbox) ─────────────
+    rowToObservation(r) {
+        return {
+            id: r.id,
+            sessionId: r.session_id,
+            ts: r.ts,
+            kind: r.kind,
+            toolName: r.tool_name ?? undefined,
+            summary: r.summary,
+            redacted: r.redacted === 1,
+            vaultId: r.vault_id ?? undefined,
+            sealedIntoItemId: r.sealed_into_item_id ?? undefined,
+        };
+    }
+    rowToOutbox(r) {
+        return {
+            idempotencyKey: r.idempotency_key,
+            itemId: r.item_id,
+            sessionId: r.session_id,
+            createdAt: r.created_at,
+            attempts: r.attempts,
+            lastAttemptAt: r.last_attempt_at ?? undefined,
+            state: r.state,
+            lastError: r.last_error ?? undefined,
+            leaseUntil: r.lease_until ?? undefined,
+        };
+    }
+    async recordObservation(o) {
+        this.db
+            .prepare(`INSERT INTO observations(id,session_id,ts,kind,tool_name,summary,redacted,vault_id,sealed_into_item_id)
+         VALUES(@id,@session_id,@ts,@kind,@tool_name,@summary,@redacted,@vault_id,@sealed_into_item_id)
+         ON CONFLICT(id) DO UPDATE SET session_id=excluded.session_id, ts=excluded.ts, kind=excluded.kind,
+           tool_name=excluded.tool_name, summary=excluded.summary, redacted=excluded.redacted,
+           vault_id=excluded.vault_id, sealed_into_item_id=excluded.sealed_into_item_id`)
+            .run({
+            id: o.id,
+            session_id: o.sessionId,
+            ts: o.ts,
+            kind: o.kind,
+            tool_name: o.toolName ?? null,
+            summary: o.summary,
+            redacted: o.redacted ? 1 : 0,
+            vault_id: o.vaultId ?? null,
+            sealed_into_item_id: o.sealedIntoItemId ?? null,
+        });
+    }
+    async listObservations(filter = {}) {
+        const where = [];
+        const params = [];
+        if (filter.sessionId) {
+            where.push('session_id = ?');
+            params.push(filter.sessionId);
+        }
+        if (filter.sealed === true)
+            where.push('sealed_into_item_id IS NOT NULL');
+        if (filter.sealed === false)
+            where.push('sealed_into_item_id IS NULL');
+        const sql = `SELECT * FROM observations ${where.length ? `WHERE ${where.join(' AND ')}` : ''} ORDER BY ts ASC`;
+        return this.db.prepare(sql).all(...params).map((r) => this.rowToObservation(r));
+    }
+    async markObservationsSealed(ids, itemId) {
+        if (ids.length === 0)
+            return;
+        const upd = this.db.prepare('UPDATE observations SET sealed_into_item_id = ? WHERE id = ?');
+        const tx = this.db.transaction((list) => {
+            for (const id of list)
+                upd.run(itemId, id);
+        });
+        tx(ids);
+    }
+    async enqueueOutbox(e) {
+        this.db
+            .prepare(`INSERT INTO capture_outbox(idempotency_key,item_id,session_id,created_at,attempts,last_attempt_at,state,last_error,lease_until)
+         VALUES(@idempotency_key,@item_id,@session_id,@created_at,@attempts,@last_attempt_at,@state,@last_error,@lease_until)
+         ON CONFLICT(idempotency_key) DO NOTHING`)
+            .run({
+            idempotency_key: e.idempotencyKey,
+            item_id: e.itemId,
+            session_id: e.sessionId,
+            created_at: e.createdAt,
+            attempts: e.attempts ?? 0,
+            last_attempt_at: e.lastAttemptAt ?? null,
+            state: e.state ?? 'pending',
+            last_error: e.lastError ?? null,
+            lease_until: e.leaseUntil ?? null,
+        });
+    }
+    async claimOutbox(opts) {
+        const claim = this.db.transaction((now, leaseUntil, limit) => {
+            // pending whose backoff has elapsed, OR inflight whose lease expired (crash recovery).
+            const candidates = this.db
+                .prepare(`SELECT idempotency_key FROM capture_outbox
+           WHERE (state = 'pending' AND (lease_until IS NULL OR lease_until <= @now))
+              OR (state = 'inflight' AND lease_until IS NOT NULL AND lease_until <= @now)
+           ORDER BY created_at ASC LIMIT @limit`)
+                .all({ now, limit });
+            const mark = this.db.prepare(`UPDATE capture_outbox SET state='inflight', lease_until=@lease, last_attempt_at=@now
+         WHERE idempotency_key=@key`);
+            for (const c of candidates)
+                mark.run({ lease: leaseUntil, now, key: c.idempotency_key });
+            return candidates.map((c) => c.idempotency_key);
+        });
+        const keys = claim(opts.now, opts.leaseUntil, opts.limit);
+        return keys
+            .map((k) => this.db.prepare('SELECT * FROM capture_outbox WHERE idempotency_key = ?').get(k))
+            .filter((r) => !!r)
+            .map((r) => this.rowToOutbox(r));
+    }
+    async updateOutbox(key, patch) {
+        const colMap = {
+            itemId: 'item_id',
+            sessionId: 'session_id',
+            createdAt: 'created_at',
+            attempts: 'attempts',
+            lastAttemptAt: 'last_attempt_at',
+            state: 'state',
+            lastError: 'last_error',
+            leaseUntil: 'lease_until',
+        };
+        const sets = [];
+        const params = { key };
+        for (const [k, v] of Object.entries(patch)) {
+            const col = colMap[k];
+            if (!col)
+                continue;
+            sets.push(`${col} = @${col}`);
+            params[col] = v ?? null;
+        }
+        if (sets.length === 0)
+            return;
+        this.db
+            .prepare(`UPDATE capture_outbox SET ${sets.join(', ')} WHERE idempotency_key = @key`)
+            .run(params);
+    }
+    async getOutbox(key) {
+        const r = this.db.prepare('SELECT * FROM capture_outbox WHERE idempotency_key = ?').get(key);
+        return r ? this.rowToOutbox(r) : undefined;
+    }
+    async listOutbox(filter = {}) {
+        const sql = `SELECT * FROM capture_outbox ${filter.state ? 'WHERE state = ?' : ''} ORDER BY created_at ASC`;
+        const rows = (filter.state
+            ? this.db.prepare(sql).all(filter.state)
+            : this.db.prepare(sql).all());
+        return rows.map((r) => this.rowToOutbox(r));
+    }
+    async outboxStats() {
+        const rows = this.db
+            .prepare('SELECT state, COUNT(*) AS n FROM capture_outbox GROUP BY state')
+            .all();
+        const stats = { pending: 0, inflight: 0, done: 0, dead: 0, conflict: 0 };
+        for (const r of rows) {
+            if (r.state === 'pending' ||
+                r.state === 'inflight' ||
+                r.state === 'done' ||
+                r.state === 'dead' ||
+                r.state === 'conflict') {
+                stats[r.state] = r.n;
+            }
+        }
+        return stats;
+    }
+    async close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=sqlite-store.js.map

package/dist/sqlite-store.js.map

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

package/dist/sync-engine.d.ts

@@ -0,0 +1,118 @@
+import type { KnowzApiClient } from '@knowzai/api-client';
+import type { LocalStore, LocalItem } from './types.js';
+export interface SyncReport {
+    pulled: number;
+    pushed: number;
+    conflicts: string[];
+    skipped: number;
+}
+export interface SyncStatus {
+    total: number;
+    new: number;
+    dirty: number;
+    synced: number;
+    conflict: number;
+    deleted: number;
+}
+/** Result of one `flushOutbox()` drain pass. */
+export interface FlushReport {
+    /** Entries claimed and attempted this pass. */
+    claimed: number;
+    /** Successfully delivered to the cloud (outbox → done). */
+    sent: number;
+    /** Transient failures deferred for retry (outbox → pending w/ backoff). */
+    failed: number;
+    /** Permanently failed / max-attempts exceeded (outbox → dead). */
+    dead: number;
+    conflicts: string[];
+}
+export interface FlushOptions {
+    /** Max entries to process this pass. Default 100. */
+    limit?: number;
+    /** Lease window (ms) a claimed entry holds before it can be reclaimed. Default 60s. */
+    leaseMs?: number;
+    /** Attempts after which a transient failure dead-letters. Default 5. */
+    maxAttempts?: number;
+    /** Base retry backoff (ms); doubles per attempt, capped at maxBackoffMs. Default 1s. */
+    baseBackoffMs?: number;
+    /** Backoff ceiling (ms). Default 5min. */
+    maxBackoffMs?: number;
+    /** Injectable clock (epoch ms) for deterministic tests. Default Date.now. */
+    now?: () => number;
+    /** Provenance stamped into each created item's metadata (e.g. the profile). */
+    source?: string;
+}
+/**
+ * Optional content encryptor (Model-3 CMEK). When present, push encrypts item
+ * content before it leaves the machine and pull decrypts after fetch, so the
+ * cloud only ever stores ciphertext.
+ */
+export interface ContentEncryptor {
+    encrypt(plaintext: string): string;
+    decrypt(ciphertext: string): string;
+    isEncrypted(s: string): boolean;
+}
+export declare class SyncEngine {
+    private readonly store;
+    private readonly client;
+    private readonly encryptor?;
+    constructor(store: LocalStore, client: KnowzApiClient, opts?: {
+        encryptor?: ContentEncryptor;
+    });
+    /**
+     * Iterate EVERY page of `knowledge.list` for a vault, invoking `onSummary`
+     * per remote item. Stops when the cumulative count reaches `total` OR a page
+     * returns fewer than `pageSize` items (defensive against a 0/undefined total),
+     * so the full remote set is always covered without an infinite loop.
+     */
+    private forEachRemote;
+    /** Cloud → local. Upserts remote items; flags conflicts; skips unchanged. */
+    pull(opts?: {
+        vaultId?: string;
+        pageSize?: number;
+    }): Promise<SyncReport>;
+    /** Local dirty/new → cloud. Clears dirty + records remoteVersion. */
+    push(opts?: {
+        vaultId?: string;
+    }): Promise<SyncReport>;
+    run(opts?: {
+        vaultId?: string;
+    }): Promise<SyncReport>;
+    status(): Promise<SyncStatus>;
+    /** Items currently in conflict (local + remote both changed). */
+    listConflicts(): Promise<LocalItem[]>;
+    /** Resolve one conflicted item by keeping the remote copy or the local copy. */
+    resolveConflict(id: string, strategy: 'remote' | 'local'): Promise<'updated-from-remote' | 'kept-local' | 'not-found'>;
+    /**
+     * Recovery: re-pull authoritative cloud state to repair the local store
+     * (overwrites non-dirty items, preserves dirty-vs-advanced as conflicts) and
+     * report any local `synced` items no longer present remotely (orphans).
+     */
+    recover(opts?: {
+        vaultId?: string;
+        pageSize?: number;
+    }): Promise<{
+        repaired: number;
+        conflicts: string[];
+        orphanedLocal: string[];
+    }>;
+    /**
+     * Drain the capture outbox to the cloud (FEAT_AgentMemoryLocalOutbox).
+     *
+     * Each claimed entry's sealed content lives in `items`; we create it via the
+     * existing `knowledge.create` path (the batch endpoint is not yet shipped),
+     * stamping the idempotency key into item metadata for best-effort server-side
+     * dedup. Idempotency is enforced LOCALLY: a `done` entry is never reclaimed,
+     * and re-enqueue is a no-op on the idempotency-key PK. The only double-create
+     * window is "create succeeded but its ack was lost before we marked done" —
+     * acceptable until the content-hash-dedup batch endpoint lands.
+     *
+     * Resilience: claims `pending` (whose backoff elapsed) plus `inflight` whose
+     * lease expired (crash recovery). Transient failures back off exponentially;
+     * after `maxAttempts` an entry dead-letters (visible via `outboxStats`). This
+     * is what makes the orphaned-pending-captures leak structurally impossible —
+     * a capture is a committed row drained by an idempotent, retrying consumer.
+     */
+    flushOutbox(opts?: FlushOptions): Promise<FlushReport>;
+}
+//# sourceMappingURL=sync-engine.d.ts.map

package/dist/sync-engine.d.ts.map

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