@action-llama/action-llama 0.15.0 → 0.16.0

package/dist/shared/persistence/adapters/stats-store.js

@@ -0,0 +1,213 @@
+/**
+ * StatsStore adapter for backward compatibility.
+ *
+ * Implements the old StatsStore interface using event sourcing on the new persistence layer.
+ * Converts method calls to events and builds projections for queries.
+ */
+import { EventTypes, EventStreamWrapper } from "../event-store.js";
+export class StatsStoreAdapter {
+    persistence;
+    statsStream;
+    callIdCounter = 0;
+    constructor(persistence) {
+        this.persistence = persistence;
+        this.statsStream = new EventStreamWrapper(persistence.events.stream("stats"));
+    }
+    recordRun(run) {
+        // Record as events asynchronously
+        this.recordRunAsync(run).catch(error => {
+            console.error("Failed to record run event:", error);
+        });
+    }
+    async recordRunAsync(run) {
+        // Create run started event
+        await this.statsStream.appendTyped(EventTypes.RUN_STARTED, {
+            instanceId: run.instanceId,
+            agentName: run.agentName,
+            triggerType: run.triggerType,
+            triggerSource: run.triggerSource,
+        }, {
+            source: "stats-adapter",
+            correlationId: run.instanceId,
+            actor: run.agentName,
+        });
+        // Create run completed/failed event
+        const eventType = run.result === "error" ? EventTypes.RUN_FAILED : EventTypes.RUN_COMPLETED;
+        await this.statsStream.appendTyped(eventType, {
+            instanceId: run.instanceId,
+            agentName: run.agentName,
+            result: run.result,
+            exitCode: run.exitCode,
+            durationMs: run.durationMs,
+            inputTokens: run.inputTokens || 0,
+            outputTokens: run.outputTokens || 0,
+            cacheReadTokens: run.cacheReadTokens || 0,
+            cacheWriteTokens: run.cacheWriteTokens || 0,
+            totalTokens: run.totalTokens || 0,
+            costUsd: run.costUsd || 0,
+            turnCount: run.turnCount || 0,
+            errorMessage: run.errorMessage,
+            preHookMs: run.preHookMs,
+            postHookMs: run.postHookMs,
+        }, {
+            source: "stats-adapter",
+            correlationId: run.instanceId,
+            actor: run.agentName,
+        });
+    }
+    recordCallEdge(edge) {
+        const callId = ++this.callIdCounter;
+        // Record as events asynchronously
+        this.recordCallEdgeAsync(edge, callId).catch(error => {
+            console.error("Failed to record call edge event:", error);
+        });
+        return callId;
+    }
+    async recordCallEdgeAsync(edge, callId) {
+        // Create call initiated event
+        await this.statsStream.appendTyped(EventTypes.CALL_INITIATED, {
+            callId,
+            callerAgent: edge.callerAgent,
+            callerInstance: edge.callerInstance,
+            targetAgent: edge.targetAgent,
+            targetInstance: edge.targetInstance,
+            depth: edge.depth,
+        }, {
+            source: "stats-adapter",
+            correlationId: edge.callerInstance,
+            actor: edge.callerAgent,
+        });
+        // If the call already has completion data, record that too
+        if (edge.durationMs !== undefined) {
+            const eventType = edge.status === "error" ? EventTypes.CALL_FAILED : EventTypes.CALL_COMPLETED;
+            await this.statsStream.appendTyped(eventType, {
+                callId,
+                callerAgent: edge.callerAgent,
+                callerInstance: edge.callerInstance,
+                targetAgent: edge.targetAgent,
+                targetInstance: edge.targetInstance,
+                depth: edge.depth,
+                durationMs: edge.durationMs,
+                status: edge.status,
+            }, {
+                source: "stats-adapter",
+                correlationId: edge.callerInstance,
+                actor: edge.callerAgent,
+            });
+        }
+    }
+    updateCallEdge(id, updates) {
+        // This is tricky since we need to find the original call and update it
+        // For now, we'll just record a completion event with the call ID
+        this.updateCallEdgeAsync(id, updates).catch(error => {
+            console.error("Failed to update call edge event:", error);
+        });
+    }
+    async updateCallEdgeAsync(id, updates) {
+        if (updates.durationMs !== undefined) {
+            const eventType = updates.status === "error" ? EventTypes.CALL_FAILED : EventTypes.CALL_COMPLETED;
+            await this.statsStream.appendTyped(eventType, {
+                callId: id,
+                durationMs: updates.durationMs,
+                status: updates.status,
+                targetInstance: updates.targetInstance,
+            }, {
+                source: "stats-adapter",
+                tags: ["call-update"],
+            });
+        }
+    }
+    async queryRunsByAgentPaginated(agent, limit, offset) {
+        // Use SQL fallback for complex queries during migration
+        return this.persistence.query.sql(`SELECT * FROM runs WHERE agent_name = ? ORDER BY started_at DESC LIMIT ? OFFSET ?`, [agent, limit, offset]);
+    }
+    async countRunsByAgent(agent) {
+        const result = await this.persistence.query.sql(`SELECT COUNT(*) as count FROM runs WHERE agent_name = ?`, [agent]);
+        return result[0]?.count || 0;
+    }
+    async queryRunByInstanceId(instanceId) {
+        const result = await this.persistence.query.sql(`SELECT * FROM runs WHERE instance_id = ? LIMIT 1`, [instanceId]);
+        return result[0];
+    }
+    async queryRuns(query = {}) {
+        const since = query.since || 0;
+        const limit = query.limit || 100;
+        if (query.agent) {
+            return this.persistence.query.sql(`SELECT * FROM runs WHERE agent_name = ? AND started_at >= ? ORDER BY started_at DESC LIMIT ?`, [query.agent, since, limit]);
+        }
+        return this.persistence.query.sql(`SELECT * FROM runs WHERE started_at >= ? ORDER BY started_at DESC LIMIT ?`, [since, limit]);
+    }
+    async queryAgentSummary(query = {}) {
+        const since = query.since || 0;
+        if (query.agent) {
+            return this.persistence.query.sql(`SELECT
+          agent_name as agentName,
+          COUNT(*) as totalRuns,
+          SUM(CASE WHEN result IN ('completed', 'rerun') THEN 1 ELSE 0 END) as okRuns,
+          SUM(CASE WHEN result = 'error' THEN 1 ELSE 0 END) as errorRuns,
+          AVG(duration_ms) as avgDurationMs,
+          SUM(total_tokens) as totalTokens,
+          SUM(cost_usd) as totalCost,
+          AVG(pre_hook_ms) as avgPreHookMs,
+          AVG(post_hook_ms) as avgPostHookMs
+        FROM runs
+        WHERE agent_name = ? AND started_at >= ?
+        GROUP BY agent_name`, [query.agent, since]);
+        }
+        return this.persistence.query.sql(`SELECT
+        agent_name as agentName,
+        COUNT(*) as totalRuns,
+        SUM(CASE WHEN result IN ('completed', 'rerun') THEN 1 ELSE 0 END) as okRuns,
+        SUM(CASE WHEN result = 'error' THEN 1 ELSE 0 END) as errorRuns,
+        AVG(duration_ms) as avgDurationMs,
+        SUM(total_tokens) as totalTokens,
+        SUM(cost_usd) as totalCost,
+        AVG(pre_hook_ms) as avgPreHookMs,
+        AVG(post_hook_ms) as avgPostHookMs
+      FROM runs
+      WHERE started_at >= ?
+      GROUP BY agent_name
+      ORDER BY totalRuns DESC`, [since]);
+    }
+    async queryGlobalSummary(since = 0) {
+        const result = await this.persistence.query.sql(`SELECT
+        COUNT(*) as totalRuns,
+        SUM(CASE WHEN result IN ('completed', 'rerun') THEN 1 ELSE 0 END) as okRuns,
+        SUM(CASE WHEN result = 'error' THEN 1 ELSE 0 END) as errorRuns,
+        SUM(total_tokens) as totalTokens,
+        SUM(cost_usd) as totalCost
+      FROM runs
+      WHERE started_at >= ?`, [since]);
+        return result[0] || { totalRuns: 0, okRuns: 0, errorRuns: 0, totalTokens: 0, totalCost: 0 };
+    }
+    async queryCallGraph(query = {}) {
+        const since = query.since || 0;
+        return this.persistence.query.sql(`SELECT
+        caller_agent as callerAgent,
+        target_agent as targetAgent,
+        COUNT(*) as count,
+        AVG(depth) as avgDepth,
+        AVG(duration_ms) as avgDurationMs
+      FROM call_edges
+      WHERE started_at >= ?
+      GROUP BY caller_agent, target_agent
+      ORDER BY count DESC`, [since]);
+    }
+    prune(olderThanDays) {
+        const threshold = Date.now() - olderThanDays * 24 * 60 * 60 * 1000;
+        // This is a synchronous method in the original, so we'll make it async internally
+        this.pruneAsync(threshold).catch(error => {
+            console.error("Failed to prune stats:", error);
+        });
+        return { runs: 0, callEdges: 0 }; // Return dummy values for compatibility
+    }
+    async pruneAsync(threshold) {
+        await this.persistence.query.sql("DELETE FROM runs WHERE started_at < ?", [threshold]);
+        await this.persistence.query.sql("DELETE FROM call_edges WHERE started_at < ?", [threshold]);
+    }
+    close() {
+        // Don't close the underlying store since it might be shared
+        // The actual store will be closed by the main application
+    }
+}
+//# sourceMappingURL=stats-store.js.map

package/dist/shared/persistence/adapters/stats-store.js.map

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

package/dist/shared/persistence/backends/memory.d.ts

@@ -0,0 +1,39 @@
+/**
+ * In-memory backend for unified persistence layer.
+ *
+ * Used primarily for testing and development. Provides the same interface
+ * as SQLite backend but stores everything in memory with optional size limits.
+ */
+import type { PersistenceBackend, Event, EventQuery } from "../index.js";
+export declare class MemoryBackend implements PersistenceBackend {
+    private maxSize?;
+    private kvStore;
+    private events;
+    private snapshots;
+    private sweepTimer;
+    private transactionStack;
+    private transactionDepth;
+    constructor(maxSize?: number | undefined);
+    init(): Promise<void>;
+    kvGet<T>(namespace: string, key: string): Promise<T | null>;
+    kvSet<T>(namespace: string, key: string, value: T, ttlMs?: number): Promise<void>;
+    kvDelete(namespace: string, key: string): Promise<void>;
+    kvDeleteAll(namespace: string): Promise<void>;
+    kvList<T>(namespace: string): Promise<Array<{
+        key: string;
+        value: T;
+    }>>;
+    eventAppend(stream: string, event: Omit<Event, 'id' | 'timestamp'>): Promise<Event>;
+    eventReplay(stream: string, query?: EventQuery): AsyncIterable<Event>;
+    eventGetSnapshot<T>(stream: string, type: string): Promise<T | null>;
+    eventSaveSnapshot<T>(stream: string, type: string, data: T, eventId: string): Promise<void>;
+    eventListStreams(): Promise<string[]>;
+    querySql<T>(query: string, params?: any[]): Promise<T[]>;
+    transactionBegin(): Promise<void>;
+    transactionCommit(): Promise<void>;
+    transactionRollback(): Promise<void>;
+    transactionRun<T>(fn: () => Promise<T>): Promise<T>;
+    private sweep;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/shared/persistence/backends/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../src/shared/persistence/backends/memory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAoBzE,qBAAa,aAAc,YAAW,kBAAkB;IAQ1C,OAAO,CAAC,OAAO,CAAC;IAP5B,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,UAAU,CAA6C;IAC/D,OAAO,CAAC,gBAAgB,CAAsB;IAC9C,OAAO,CAAC,gBAAgB,CAAK;gBAET,OAAO,CAAC,EAAE,MAAM,YAAA;IAE9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,KAAK,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAe3D,KAAK,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBjF,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7C,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IAsBvE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;IA4BlF,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC;IA4BtE,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAMpE,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3F,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKrC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,GAAG,EAAO,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAK5D,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBjC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAOlC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAUpC,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAazD,OAAO,CAAC,KAAK;IAgBP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAU7B"}

package/dist/shared/persistence/backends/memory.js

@@ -0,0 +1,214 @@
+/**
+ * In-memory backend for unified persistence layer.
+ *
+ * Used primarily for testing and development. Provides the same interface
+ * as SQLite backend but stores everything in memory with optional size limits.
+ */
+import { randomUUID } from "crypto";
+export class MemoryBackend {
+    maxSize;
+    kvStore = new Map();
+    events = new Map(); // stream -> events
+    snapshots = new Map(); // stream:type -> snapshot
+    sweepTimer;
+    transactionStack = [];
+    transactionDepth = 0;
+    constructor(maxSize) {
+        this.maxSize = maxSize;
+    }
+    async init() {
+        // Start periodic cleanup of expired KV entries
+        this.sweepTimer = setInterval(() => this.sweep(), 60_000);
+        if (this.sweepTimer.unref)
+            this.sweepTimer.unref();
+    }
+    // Key-value operations
+    async kvGet(namespace, key) {
+        const storeKey = `${namespace}:${key}`;
+        const entry = this.kvStore.get(storeKey);
+        if (!entry)
+            return null;
+        // Check expiration
+        if (entry.expiresAt && Date.now() >= entry.expiresAt) {
+            this.kvStore.delete(storeKey);
+            return null;
+        }
+        return entry.value;
+    }
+    async kvSet(namespace, key, value, ttlMs) {
+        const storeKey = `${namespace}:${key}`;
+        const now = Date.now();
+        // Check size limits if specified
+        if (this.maxSize && this.kvStore.size >= this.maxSize && !this.kvStore.has(storeKey)) {
+            throw new Error(`Memory store size limit exceeded (${this.maxSize})`);
+        }
+        const entry = {
+            value,
+            expiresAt: ttlMs ? now + ttlMs : undefined,
+            createdAt: this.kvStore.has(storeKey) ? this.kvStore.get(storeKey).createdAt : now,
+            updatedAt: now,
+        };
+        this.kvStore.set(storeKey, entry);
+    }
+    async kvDelete(namespace, key) {
+        const storeKey = `${namespace}:${key}`;
+        this.kvStore.delete(storeKey);
+    }
+    async kvDeleteAll(namespace) {
+        const prefix = `${namespace}:`;
+        for (const key of this.kvStore.keys()) {
+            if (key.startsWith(prefix)) {
+                this.kvStore.delete(key);
+            }
+        }
+    }
+    async kvList(namespace) {
+        const prefix = `${namespace}:`;
+        const now = Date.now();
+        const results = [];
+        for (const [storeKey, entry] of this.kvStore.entries()) {
+            if (!storeKey.startsWith(prefix))
+                continue;
+            // Skip expired entries
+            if (entry.expiresAt && now >= entry.expiresAt) {
+                this.kvStore.delete(storeKey);
+                continue;
+            }
+            const key = storeKey.slice(prefix.length);
+            results.push({ key, value: entry.value });
+        }
+        return results.sort((a, b) => a.key.localeCompare(b.key));
+    }
+    // Event operations
+    async eventAppend(stream, event) {
+        const id = randomUUID();
+        const timestamp = Date.now();
+        const fullEvent = {
+            id,
+            timestamp,
+            type: event.type,
+            data: event.data,
+            metadata: event.metadata,
+            version: event.version,
+        };
+        if (!this.events.has(stream)) {
+            this.events.set(stream, []);
+        }
+        const streamEvents = this.events.get(stream);
+        const sequence = streamEvents.length + 1;
+        streamEvents.push({
+            event: fullEvent,
+            sequence,
+        });
+        return fullEvent;
+    }
+    async *eventReplay(stream, query) {
+        const streamEvents = this.events.get(stream) || [];
+        let filteredEvents = streamEvents.map(e => e.event);
+        // Apply filters
+        if (query?.type) {
+            filteredEvents = filteredEvents.filter(e => e.type === query.type);
+        }
+        if (query?.from) {
+            filteredEvents = filteredEvents.filter(e => e.timestamp >= query.from);
+        }
+        if (query?.to) {
+            filteredEvents = filteredEvents.filter(e => e.timestamp < query.to);
+        }
+        // Apply pagination
+        const offset = query?.offset || 0;
+        const limit = Math.min(query?.limit || 1000, 10000);
+        const paginatedEvents = filteredEvents.slice(offset, offset + limit);
+        for (const event of paginatedEvents) {
+            yield { ...event }; // Return a copy
+        }
+    }
+    async eventGetSnapshot(stream, type) {
+        const key = `${stream}:${type}`;
+        const snapshot = this.snapshots.get(key);
+        return snapshot ? snapshot.data : null;
+    }
+    async eventSaveSnapshot(stream, type, data, eventId) {
+        const key = `${stream}:${type}`;
+        const snapshot = {
+            data,
+            eventId,
+            createdAt: Date.now(),
+        };
+        this.snapshots.set(key, snapshot);
+    }
+    async eventListStreams() {
+        return Array.from(this.events.keys()).sort();
+    }
+    // Query operations (limited in memory backend)
+    async querySql(query, params = []) {
+        throw new Error("SQL queries are not supported in memory backend. Use KV and event operations instead.");
+    }
+    // Transaction operations (simplified for memory)
+    async transactionBegin() {
+        this.transactionDepth++;
+        if (this.transactionDepth === 1) {
+            // Take snapshots of current state
+            const kvSnapshot = new Map(this.kvStore);
+            const eventsSnapshot = new Map(Array.from(this.events.entries()).map(([k, v]) => [k, [...v]]));
+            const snapshotsSnapshot = new Map(this.snapshots);
+            this.transactionStack.push(() => {
+                this.kvStore = kvSnapshot;
+                this.events = eventsSnapshot;
+                this.snapshots = snapshotsSnapshot;
+            });
+        }
+    }
+    async transactionCommit() {
+        this.transactionDepth--;
+        if (this.transactionDepth === 0) {
+            this.transactionStack.pop(); // Discard rollback function
+        }
+    }
+    async transactionRollback() {
+        this.transactionDepth--;
+        if (this.transactionDepth === 0) {
+            const rollback = this.transactionStack.pop();
+            if (rollback) {
+                rollback();
+            }
+        }
+    }
+    async transactionRun(fn) {
+        await this.transactionBegin();
+        try {
+            const result = await fn();
+            await this.transactionCommit();
+            return result;
+        }
+        catch (error) {
+            await this.transactionRollback();
+            throw error;
+        }
+    }
+    // Cleanup and maintenance
+    sweep() {
+        const now = Date.now();
+        let cleaned = 0;
+        for (const [key, entry] of this.kvStore.entries()) {
+            if (entry.expiresAt && now >= entry.expiresAt) {
+                this.kvStore.delete(key);
+                cleaned++;
+            }
+        }
+        if (cleaned > 0) {
+            console.debug(`Cleaned up ${cleaned} expired KV entries`);
+        }
+    }
+    async close() {
+        if (this.sweepTimer) {
+            clearInterval(this.sweepTimer);
+            this.sweepTimer = undefined;
+        }
+        this.kvStore.clear();
+        this.events.clear();
+        this.snapshots.clear();
+        this.transactionStack.length = 0;
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/shared/persistence/backends/memory.js.map

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

package/dist/shared/persistence/backends/sqlite.d.ts

@@ -0,0 +1,38 @@
+/**
+ * SQLite backend for unified persistence layer.
+ *
+ * Implements the PersistenceBackend interface with SQLite storage,
+ * combining key-value operations, event sourcing, and query capabilities
+ * in a single database with optimized indexes and transaction support.
+ */
+import type { PersistenceBackend, Event, EventQuery } from "../index.js";
+export declare class SqliteBackend implements PersistenceBackend {
+    private dbPath;
+    private db;
+    private stmts;
+    private sweepTimer;
+    private transactionDepth;
+    constructor(dbPath: string);
+    init(): Promise<void>;
+    kvGet<T>(namespace: string, key: string): Promise<T | null>;
+    kvSet<T>(namespace: string, key: string, value: T, ttlMs?: number): Promise<void>;
+    kvDelete(namespace: string, key: string): Promise<void>;
+    kvDeleteAll(namespace: string): Promise<void>;
+    kvList<T>(namespace: string): Promise<Array<{
+        key: string;
+        value: T;
+    }>>;
+    eventAppend(stream: string, event: Omit<Event, 'id' | 'timestamp'>): Promise<Event>;
+    eventReplay(stream: string, query?: EventQuery): AsyncIterable<Event>;
+    eventGetSnapshot<T>(stream: string, type: string): Promise<T | null>;
+    eventSaveSnapshot<T>(stream: string, type: string, data: T, eventId: string): Promise<void>;
+    eventListStreams(): Promise<string[]>;
+    querySql<T>(query: string, params?: any[]): Promise<T[]>;
+    transactionBegin(): Promise<void>;
+    transactionCommit(): Promise<void>;
+    transactionRollback(): Promise<void>;
+    transactionRun<T>(fn: () => Promise<T>): Promise<T>;
+    private sweep;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/shared/persistence/backends/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../../../src/shared/persistence/backends/sqlite.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzE,qBAAa,aAAc,YAAW,kBAAkB;IAM1C,OAAO,CAAC,MAAM;IAL1B,OAAO,CAAC,EAAE,CAAgC;IAC1C,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,UAAU,CAA6C;IAC/D,OAAO,CAAC,gBAAgB,CAAK;gBAET,MAAM,EAAE,MAAM;IAW5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA8GrB,KAAK,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAK3D,KAAK,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjF,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IAMvE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;IAyBlF,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC;IA+BtE,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAKpE,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3F,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAMrC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,GAAG,EAAO,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAU5D,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAOlC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpC,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAazD,OAAO,CAAC,KAAK;IAQP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}