@oobe-protocol-labs/synapse-client-sdk 1.2.0 → 1.2.2

package/dist/cjs/ai/persistence/memory.js

@@ -0,0 +1,192 @@
+"use strict";
+/**
+ * @module ai/persistence/memory
+ * @description In-memory persistence store for Synapse AI gateway data.
+ *
+ * Ideal for testing, local development, and single-process deployments
+ * where external database infrastructure is unnecessary.
+ *
+ * Features:
+ * - TTL support on generic key-value entries
+ * - Optional max-entries eviction (FIFO)
+ * - Full {@link PersistenceStore} API
+ * - Drop-in `PersistenceAdapter` for {@link AgentRegistry}
+ *
+ * @since 1.2.2
+ *
+ * @example
+ * ```ts
+ * import { MemoryStore } from '@oobe-protocol-labs/synapse-client-sdk/ai';
+ *
+ * const store = new MemoryStore();
+ * await store.connect();
+ *
+ * await store.saveAgent(gateway.snapshot());
+ * const snap = await store.loadAgent('agent-1');
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryStore = void 0;
+const helpers_1 = require("./helpers");
+/**
+ * @description In-memory implementation of {@link PersistenceStore}.
+ *
+ * Data is stored in `Map` instances and does **not** survive process restarts.
+ * TTL is checked lazily on read (no background timers).
+ *
+ * @since 1.2.2
+ */
+class MemoryStore {
+    name = 'memory';
+    maxEntries;
+    /* ── Storage maps ──────────────────────────────────────── */
+    kv = new Map();
+    agents = new Map();
+    sessions = new Map(); // key = agentId:sessionId
+    receipts = new Map(); // key = agentId
+    metrics = new Map(); // key = agentId:metricKey
+    constructor(config = {}) {
+        this.maxEntries = config.maxEntries ?? 0;
+    }
+    /* ── Lifecycle ─────────────────────────────────────────── */
+    async connect() { }
+    async disconnect() { }
+    async ping() { return true; }
+    /* ── Generic KV ────────────────────────────────────────── */
+    async get(key) {
+        const entry = this.kv.get(key);
+        if (!entry)
+            return null;
+        if (entry.expiresAt && Date.now() > entry.expiresAt) {
+            this.kv.delete(key);
+            return null;
+        }
+        return (0, helpers_1.deserialize)(entry.json);
+    }
+    async set(key, value, opts) {
+        this.enforceEviction();
+        const entry = { json: (0, helpers_1.serialize)(value) };
+        if (opts?.ttl && opts.ttl > 0) {
+            entry.expiresAt = Date.now() + opts.ttl * 1000;
+        }
+        this.kv.set(key, entry);
+    }
+    async del(key) {
+        return this.kv.delete(key);
+    }
+    async has(key) {
+        const entry = this.kv.get(key);
+        if (!entry)
+            return false;
+        if (entry.expiresAt && Date.now() > entry.expiresAt) {
+            this.kv.delete(key);
+            return false;
+        }
+        return true;
+    }
+    /* ── Agents ────────────────────────────────────────────── */
+    async saveAgent(snapshot) {
+        this.agents.set(snapshot.agentId, snapshot);
+    }
+    async loadAgent(agentId) {
+        return this.agents.get(agentId) ?? null;
+    }
+    async deleteAgent(agentId) {
+        return this.agents.delete(agentId);
+    }
+    async listAgents() {
+        return [...this.agents.keys()];
+    }
+    /* ── Sessions ──────────────────────────────────────────── */
+    async saveSession(record) {
+        this.sessions.set(`${record.agentId}:${record.id}`, record);
+    }
+    async loadSession(agentId, sessionId) {
+        return this.sessions.get(`${agentId}:${sessionId}`) ?? null;
+    }
+    async deleteSessions(agentId) {
+        const prefix = `${agentId}:`;
+        let count = 0;
+        for (const key of this.sessions.keys()) {
+            if (key.startsWith(prefix)) {
+                this.sessions.delete(key);
+                count++;
+            }
+        }
+        return count;
+    }
+    async listSessions(agentId, opts = {}) {
+        const prefix = `${agentId}:`;
+        let results = [];
+        for (const [key, rec] of this.sessions) {
+            if (key.startsWith(prefix)) {
+                if (opts.status && rec.status !== opts.status)
+                    continue;
+                results.push(rec);
+            }
+        }
+        // Sort by createdAt descending
+        results.sort((a, b) => b.createdAt - a.createdAt);
+        const offset = opts.offset ?? 0;
+        const limit = opts.limit ?? results.length;
+        return results.slice(offset, offset + limit);
+    }
+    /* ── Receipts ──────────────────────────────────────────── */
+    async saveReceipt(record) {
+        const list = this.receipts.get(record.agentId) ?? [];
+        list.push(record);
+        this.receipts.set(record.agentId, list);
+    }
+    async listReceipts(agentId, opts = {}) {
+        const list = this.receipts.get(agentId) ?? [];
+        // Sort by settledAt descending (most recent first)
+        const sorted = [...list].sort((a, b) => b.settledAt - a.settledAt);
+        const offset = opts.offset ?? 0;
+        const limit = opts.limit ?? sorted.length;
+        return sorted.slice(offset, offset + limit);
+    }
+    /* ── Metrics ───────────────────────────────────────────── */
+    async recordMetric(agentId, key, value, labels) {
+        const mk = `${agentId}:${key}`;
+        const list = this.metrics.get(mk) ?? [];
+        list.push({ timestamp: Date.now(), value, labels });
+        this.metrics.set(mk, list);
+    }
+    async queryMetrics(agentId, key, opts = {}) {
+        const mk = `${agentId}:${key}`;
+        let points = this.metrics.get(mk) ?? [];
+        if (opts.from != null)
+            points = points.filter(p => p.timestamp >= opts.from);
+        if (opts.to != null)
+            points = points.filter(p => p.timestamp <= opts.to);
+        // Most recent first
+        points = [...points].sort((a, b) => b.timestamp - a.timestamp);
+        if (opts.limit != null)
+            points = points.slice(0, opts.limit);
+        return points;
+    }
+    /* ── PersistenceAdapter compat ─────────────────────────── */
+    async save(agentId, snapshot) {
+        return this.saveAgent(snapshot);
+    }
+    async load(agentId) {
+        return this.loadAgent(agentId);
+    }
+    async delete(agentId) {
+        this.agents.delete(agentId);
+    }
+    async keys() {
+        return this.listAgents();
+    }
+    /* ── Internals ─────────────────────────────────────────── */
+    enforceEviction() {
+        if (this.maxEntries > 0 && this.kv.size >= this.maxEntries) {
+            // FIFO: remove the oldest key
+            const firstKey = this.kv.keys().next().value;
+            if (firstKey)
+                this.kv.delete(firstKey);
+        }
+    }
+}
+exports.MemoryStore = MemoryStore;
+//# sourceMappingURL=memory.js.map

package/dist/cjs/ai/persistence/memory.js.map

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

package/dist/cjs/ai/persistence/postgresql.d.ts

@@ -0,0 +1,119 @@
+/**
+ * @module ai/persistence/postgresql
+ * @description PostgreSQL persistence adapter for Synapse AI gateway data.
+ *
+ * Stores agent snapshots, sessions, receipts, and metric time-series in
+ * PostgreSQL using JSONB columns, with automatic schema migration on
+ * first `connect()`.
+ *
+ * Bring your own client — the adapter works with any library that satisfies
+ * the {@link PgLike} interface:
+ * - **pg** (`new Pool()` or `new Client()`)
+ * - **@vercel/postgres** (`createPool()`)
+ * - **@neondatabase/serverless** (`neon()`)
+ *
+ * @since 1.2.2
+ *
+ * @example
+ * ```ts
+ * import { Pool } from 'pg';
+ * import { PostgresPersistence } from '@oobe-protocol-labs/synapse-client-sdk/ai';
+ *
+ * const pool = new Pool({ connectionString: process.env.DATABASE_URL });
+ * const store = new PostgresPersistence({ client: pool });
+ * await store.connect(); // runs migrations
+ *
+ * await store.saveAgent(gateway.snapshot());
+ * const receipts = await store.listReceipts('agent-1', { limit: 50 });
+ *
+ * // Drop-in for AgentRegistry:
+ * const registry = new AgentRegistry({ persistence: store });
+ * ```
+ */
+import type { PersistenceStore, PostgresStoreConfig, SetOptions, ListOptions, MetricQueryOpts, SessionRecord, ReceiptRecord, MetricPoint } from './types';
+import type { GatewaySnapshot } from '../gateway/types';
+/**
+ * @description PostgreSQL implementation of {@link PersistenceStore}.
+ *
+ * Table layout (default prefix `synapse`):
+ * ```
+ * synapse_agents          (agent_id PK, snapshot JSONB)
+ * synapse_sessions        (agent_id + id PK, state JSONB, status)
+ * synapse_receipts        (id PK, agent_id, receipt JSONB)
+ * synapse_metrics         (id BIGSERIAL, agent_id, metric_key, value, labels, recorded_at)
+ * synapse_kv              (key PK, value JSONB, expires_at)
+ * synapse_schema_version  (version PK, applied_at)
+ * ```
+ *
+ * @since 1.2.2
+ */
+export declare class PostgresPersistence implements PersistenceStore {
+    readonly name = "postgresql";
+    private readonly client;
+    private readonly prefix;
+    private readonly autoMigrate;
+    private migrated;
+    constructor(config: PostgresStoreConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    ping(): Promise<boolean>;
+    /**
+     * @description Run schema migrations.
+     *
+     * Called automatically on `connect()` if `autoMigrate` is `true` (default).
+     * Safe to call multiple times — all DDL uses `IF NOT EXISTS`.
+     *
+     * @since 1.2.2
+     */
+    migrate(): Promise<void>;
+    private t;
+    get<T = unknown>(key: string): Promise<T | null>;
+    set(key: string, value: unknown, opts?: SetOptions): Promise<void>;
+    del(key: string): Promise<boolean>;
+    has(key: string): Promise<boolean>;
+    saveAgent(snapshot: GatewaySnapshot): Promise<void>;
+    loadAgent(agentId: string): Promise<GatewaySnapshot | null>;
+    deleteAgent(agentId: string): Promise<boolean>;
+    listAgents(): Promise<string[]>;
+    saveSession(record: SessionRecord): Promise<void>;
+    loadSession(agentId: string, sessionId: string): Promise<SessionRecord | null>;
+    deleteSessions(agentId: string): Promise<number>;
+    listSessions(agentId: string, opts?: ListOptions): Promise<SessionRecord[]>;
+    saveReceipt(record: ReceiptRecord): Promise<void>;
+    listReceipts(agentId: string, opts?: ListOptions): Promise<ReceiptRecord[]>;
+    recordMetric(agentId: string, key: string, value: number, labels?: Record<string, string>): Promise<void>;
+    queryMetrics(agentId: string, key: string, opts?: MetricQueryOpts): Promise<MetricPoint[]>;
+    /**
+     * @description Delete expired KV entries and old metric data.
+     *
+     * Call periodically (e.g. via a cron job) to reclaim storage.
+     *
+     * @param {object} [opts] - Cleanup options
+     * @param {number} [opts.metricsOlderThanDays=90] - Delete metrics older than N days
+     * @returns {Promise<{ kvDeleted: number; metricsDeleted: number }>}
+     * @since 1.2.2
+     */
+    cleanup(opts?: {
+        metricsOlderThanDays?: number;
+    }): Promise<{
+        kvDeleted: number;
+        metricsDeleted: number;
+    }>;
+    /**
+     * @description Get the currently applied schema version.
+     * @returns {Promise<number>} Schema version, or `0` if not yet migrated.
+     * @since 1.2.2
+     */
+    getSchemaVersion(): Promise<number>;
+    /**
+     * @description Get row counts for all tables (useful for monitoring).
+     * @returns {Promise<Record<string, number>>} Table name → row count
+     * @since 1.2.2
+     */
+    getTableStats(): Promise<Record<string, number>>;
+    save(agentId: string, snapshot: GatewaySnapshot): Promise<void>;
+    load(agentId: string): Promise<GatewaySnapshot | null>;
+    delete(agentId: string): Promise<void>;
+    keys(): Promise<string[]>;
+}
+//# sourceMappingURL=postgresql.d.ts.map

package/dist/cjs/ai/persistence/postgresql.d.ts.map

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

package/dist/cjs/ai/persistence/postgresql.js

@@ -0,0 +1,310 @@
+"use strict";
+/**
+ * @module ai/persistence/postgresql
+ * @description PostgreSQL persistence adapter for Synapse AI gateway data.
+ *
+ * Stores agent snapshots, sessions, receipts, and metric time-series in
+ * PostgreSQL using JSONB columns, with automatic schema migration on
+ * first `connect()`.
+ *
+ * Bring your own client — the adapter works with any library that satisfies
+ * the {@link PgLike} interface:
+ * - **pg** (`new Pool()` or `new Client()`)
+ * - **@vercel/postgres** (`createPool()`)
+ * - **@neondatabase/serverless** (`neon()`)
+ *
+ * @since 1.2.2
+ *
+ * @example
+ * ```ts
+ * import { Pool } from 'pg';
+ * import { PostgresPersistence } from '@oobe-protocol-labs/synapse-client-sdk/ai';
+ *
+ * const pool = new Pool({ connectionString: process.env.DATABASE_URL });
+ * const store = new PostgresPersistence({ client: pool });
+ * await store.connect(); // runs migrations
+ *
+ * await store.saveAgent(gateway.snapshot());
+ * const receipts = await store.listReceipts('agent-1', { limit: 50 });
+ *
+ * // Drop-in for AgentRegistry:
+ * const registry = new AgentRegistry({ persistence: store });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresPersistence = void 0;
+const types_1 = require("./types");
+const helpers_1 = require("./helpers");
+/**
+ * @description PostgreSQL implementation of {@link PersistenceStore}.
+ *
+ * Table layout (default prefix `synapse`):
+ * ```
+ * synapse_agents          (agent_id PK, snapshot JSONB)
+ * synapse_sessions        (agent_id + id PK, state JSONB, status)
+ * synapse_receipts        (id PK, agent_id, receipt JSONB)
+ * synapse_metrics         (id BIGSERIAL, agent_id, metric_key, value, labels, recorded_at)
+ * synapse_kv              (key PK, value JSONB, expires_at)
+ * synapse_schema_version  (version PK, applied_at)
+ * ```
+ *
+ * @since 1.2.2
+ */
+class PostgresPersistence {
+    name = 'postgresql';
+    client;
+    prefix;
+    autoMigrate;
+    migrated = false;
+    constructor(config) {
+        this.client = config.client;
+        this.prefix = config.keyPrefix ?? 'synapse';
+        this.autoMigrate = config.autoMigrate ?? true;
+    }
+    /* ── Lifecycle ─────────────────────────────────────────── */
+    async connect() {
+        try {
+            // Verify connection
+            await this.client.query('SELECT 1');
+            // Auto-migrate if enabled and not yet done
+            if (this.autoMigrate && !this.migrated) {
+                await this.migrate();
+            }
+        }
+        catch (err) {
+            throw new types_1.PersistenceError('Failed to connect to PostgreSQL', 'CONN_FAILED', err);
+        }
+    }
+    async disconnect() {
+        try {
+            if (this.client.end)
+                await this.client.end();
+        }
+        catch {
+            // Swallow — already disconnected
+        }
+    }
+    async ping() {
+        try {
+            await this.client.query('SELECT 1');
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * @description Run schema migrations.
+     *
+     * Called automatically on `connect()` if `autoMigrate` is `true` (default).
+     * Safe to call multiple times — all DDL uses `IF NOT EXISTS`.
+     *
+     * @since 1.2.2
+     */
+    async migrate() {
+        try {
+            const ddl = (0, helpers_1.buildSchema)(this.prefix);
+            await this.client.query(ddl);
+            this.migrated = true;
+        }
+        catch (err) {
+            throw new types_1.PersistenceError('Schema migration failed', 'MIGRATION_FAILED', err);
+        }
+    }
+    /* ── Generic KV ────────────────────────────────────────── */
+    t(name) {
+        return `${this.prefix}_${name}`;
+    }
+    async get(key) {
+        const { rows } = await this.client.query(`SELECT value FROM ${this.t('kv')}
+       WHERE key = $1 AND (expires_at IS NULL OR expires_at > NOW())`, [key]);
+        if (rows.length === 0)
+            return null;
+        return rows[0].value;
+    }
+    async set(key, value, opts) {
+        const parsed = JSON.parse((0, helpers_1.serialize)(value));
+        const expiresAt = opts?.ttl && opts.ttl > 0
+            ? new Date(Date.now() + opts.ttl * 1000).toISOString()
+            : null;
+        await this.client.query(`INSERT INTO ${this.t('kv')} (key, value, expires_at)
+       VALUES ($1, $2, $3)
+       ON CONFLICT (key)
+       DO UPDATE SET value = EXCLUDED.value, expires_at = EXCLUDED.expires_at`, [key, parsed, expiresAt]);
+    }
+    async del(key) {
+        const { rowCount } = await this.client.query(`DELETE FROM ${this.t('kv')} WHERE key = $1`, [key]);
+        return (rowCount ?? 0) > 0;
+    }
+    async has(key) {
+        const { rows } = await this.client.query(`SELECT COUNT(*)::text AS n FROM ${this.t('kv')}
+       WHERE key = $1 AND (expires_at IS NULL OR expires_at > NOW())`, [key]);
+        return parseInt(rows[0]?.n ?? '0', 10) > 0;
+    }
+    /* ── Agents ────────────────────────────────────────────── */
+    async saveAgent(snapshot) {
+        const parsed = JSON.parse((0, helpers_1.serialize)(snapshot));
+        await this.client.query(`INSERT INTO ${this.t('agents')} (agent_id, snapshot, updated_at)
+       VALUES ($1, $2, NOW())
+       ON CONFLICT (agent_id)
+       DO UPDATE SET snapshot = EXCLUDED.snapshot, updated_at = NOW()`, [snapshot.agentId, parsed]);
+    }
+    async loadAgent(agentId) {
+        const { rows } = await this.client.query(`SELECT snapshot FROM ${this.t('agents')} WHERE agent_id = $1`, [agentId]);
+        return rows[0]?.snapshot ?? null;
+    }
+    async deleteAgent(agentId) {
+        const { rowCount } = await this.client.query(`DELETE FROM ${this.t('agents')} WHERE agent_id = $1`, [agentId]);
+        return (rowCount ?? 0) > 0;
+    }
+    async listAgents() {
+        const { rows } = await this.client.query(`SELECT agent_id FROM ${this.t('agents')} ORDER BY created_at`);
+        return rows.map(r => r.agent_id);
+    }
+    /* ── Sessions ──────────────────────────────────────────── */
+    async saveSession(record) {
+        const parsed = JSON.parse((0, helpers_1.serialize)(record));
+        await this.client.query(`INSERT INTO ${this.t('sessions')} (id, agent_id, state, status, updated_at)
+       VALUES ($1, $2, $3, $4, NOW())
+       ON CONFLICT (agent_id, id)
+       DO UPDATE SET state = EXCLUDED.state, status = EXCLUDED.status, updated_at = NOW()`, [record.id, record.agentId, parsed, record.status]);
+    }
+    async loadSession(agentId, sessionId) {
+        const { rows } = await this.client.query(`SELECT state FROM ${this.t('sessions')} WHERE agent_id = $1 AND id = $2`, [agentId, sessionId]);
+        return rows[0]?.state ?? null;
+    }
+    async deleteSessions(agentId) {
+        const { rowCount } = await this.client.query(`DELETE FROM ${this.t('sessions')} WHERE agent_id = $1`, [agentId]);
+        return rowCount ?? 0;
+    }
+    async listSessions(agentId, opts = {}) {
+        const conditions = ['agent_id = $1'];
+        const params = [agentId];
+        let paramIdx = 2;
+        if (opts.status) {
+            conditions.push(`status = $${paramIdx++}`);
+            params.push(opts.status);
+        }
+        const limit = opts.limit ?? 100;
+        const offset = opts.offset ?? 0;
+        const { rows } = await this.client.query(`SELECT state FROM ${this.t('sessions')}
+       WHERE ${conditions.join(' AND ')}
+       ORDER BY created_at DESC
+       LIMIT $${paramIdx++} OFFSET $${paramIdx}`, [...params, limit, offset]);
+        return rows.map(r => r.state);
+    }
+    /* ── Receipts ──────────────────────────────────────────── */
+    async saveReceipt(record) {
+        const parsed = JSON.parse((0, helpers_1.serialize)(record));
+        await this.client.query(`INSERT INTO ${this.t('receipts')} (id, agent_id, session_id, receipt, amount_charged, settled_at)
+       VALUES ($1, $2, $3, $4, $5, to_timestamp($6 / 1000.0))
+       ON CONFLICT (id) DO NOTHING`, [record.id, record.agentId, record.sessionId ?? null, parsed, record.amountCharged, record.settledAt]);
+    }
+    async listReceipts(agentId, opts = {}) {
+        const limit = opts.limit ?? 100;
+        const offset = opts.offset ?? 0;
+        const { rows } = await this.client.query(`SELECT receipt FROM ${this.t('receipts')}
+       WHERE agent_id = $1
+       ORDER BY settled_at DESC
+       LIMIT $2 OFFSET $3`, [agentId, limit, offset]);
+        return rows.map(r => r.receipt);
+    }
+    /* ── Metrics ───────────────────────────────────────────── */
+    async recordMetric(agentId, key, value, labels) {
+        await this.client.query(`INSERT INTO ${this.t('metrics')} (agent_id, metric_key, value, labels)
+       VALUES ($1, $2, $3, $4)`, [agentId, key, value, labels ? JSON.parse(JSON.stringify(labels)) : {}]);
+    }
+    async queryMetrics(agentId, key, opts = {}) {
+        const conditions = ['agent_id = $1', 'metric_key = $2'];
+        const params = [agentId, key];
+        let paramIdx = 3;
+        if (opts.from != null) {
+            conditions.push(`recorded_at >= to_timestamp($${paramIdx++} / 1000.0)`);
+            params.push(opts.from);
+        }
+        if (opts.to != null) {
+            conditions.push(`recorded_at <= to_timestamp($${paramIdx++} / 1000.0)`);
+            params.push(opts.to);
+        }
+        const limit = opts.limit ?? 1000;
+        const { rows } = await this.client.query(`SELECT value, labels, recorded_at
+       FROM ${this.t('metrics')}
+       WHERE ${conditions.join(' AND ')}
+       ORDER BY recorded_at DESC
+       LIMIT $${paramIdx}`, [...params, limit]);
+        return rows.map(r => ({
+            timestamp: new Date(r.recorded_at).getTime(),
+            value: Number(r.value),
+            labels: r.labels && Object.keys(r.labels).length > 0 ? r.labels : undefined,
+        }));
+    }
+    /* ── Maintenance ───────────────────────────────────────── */
+    /**
+     * @description Delete expired KV entries and old metric data.
+     *
+     * Call periodically (e.g. via a cron job) to reclaim storage.
+     *
+     * @param {object} [opts] - Cleanup options
+     * @param {number} [opts.metricsOlderThanDays=90] - Delete metrics older than N days
+     * @returns {Promise<{ kvDeleted: number; metricsDeleted: number }>}
+     * @since 1.2.2
+     */
+    async cleanup(opts = {}) {
+        const kvResult = await this.client.query((0, helpers_1.buildKvCleanupSql)(this.prefix));
+        const days = opts.metricsOlderThanDays ?? 90;
+        const metricsResult = await this.client.query(`DELETE FROM ${this.t('metrics')}
+       WHERE recorded_at < NOW() - INTERVAL '${days} days'`);
+        return {
+            kvDeleted: kvResult.rowCount ?? 0,
+            metricsDeleted: metricsResult.rowCount ?? 0,
+        };
+    }
+    /**
+     * @description Get the currently applied schema version.
+     * @returns {Promise<number>} Schema version, or `0` if not yet migrated.
+     * @since 1.2.2
+     */
+    async getSchemaVersion() {
+        try {
+            const { rows } = await this.client.query(`SELECT MAX(version) AS version FROM ${this.t('schema_version')}`);
+            return rows[0]?.version ?? 0;
+        }
+        catch {
+            return 0; // Table doesn't exist yet
+        }
+    }
+    /**
+     * @description Get row counts for all tables (useful for monitoring).
+     * @returns {Promise<Record<string, number>>} Table name → row count
+     * @since 1.2.2
+     */
+    async getTableStats() {
+        const tables = ['agents', 'sessions', 'receipts', 'metrics', 'kv'];
+        const stats = {};
+        for (const table of tables) {
+            try {
+                const { rows } = await this.client.query(`SELECT COUNT(*)::text AS n FROM ${this.t(table)}`);
+                stats[table] = parseInt(rows[0]?.n ?? '0', 10);
+            }
+            catch {
+                stats[table] = -1; // Table doesn't exist
+            }
+        }
+        return stats;
+    }
+    /* ── PersistenceAdapter compat ─────────────────────────── */
+    async save(agentId, snapshot) {
+        return this.saveAgent(snapshot);
+    }
+    async load(agentId) {
+        return this.loadAgent(agentId);
+    }
+    async delete(agentId) {
+        await this.deleteAgent(agentId);
+    }
+    async keys() {
+        return this.listAgents();
+    }
+}
+exports.PostgresPersistence = PostgresPersistence;
+//# sourceMappingURL=postgresql.js.map

package/dist/cjs/ai/persistence/postgresql.js.map

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