@oobe-protocol-labs/synapse-client-sdk 1.2.1 → 2.0.0

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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"}

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

@@ -0,0 +1,84 @@
+/**
+ * @module ai/persistence/redis
+ * @description Redis persistence adapter for Synapse AI gateway data.
+ *
+ * Stores agent snapshots, sessions, receipts, metrics, and arbitrary
+ * key-value data in Redis using JSON serialization and configurable
+ * key prefixing.
+ *
+ * Bring your own Redis client — the adapter works with any library
+ * that satisfies the {@link RedisLike} interface:
+ * - **ioredis** (`new Redis()`)
+ * - **node-redis v4** (`createClient()`)
+ * - **@upstash/redis** (REST-based, partial)
+ *
+ * @since 1.2.2
+ *
+ * @example
+ * ```ts
+ * import Redis from 'ioredis';
+ * import { RedisPersistence } from '@oobe-protocol-labs/synapse-client-sdk/ai';
+ *
+ * const redis = new Redis(process.env.REDIS_URL);
+ * const store = new RedisPersistence({ client: redis });
+ * await store.connect();
+ *
+ * await store.saveAgent(gateway.snapshot());
+ * await store.saveSession(sessionRecord);
+ *
+ * // Drop-in for AgentRegistry:
+ * const registry = new AgentRegistry({ persistence: store });
+ * ```
+ */
+import type { PersistenceStore, RedisStoreConfig, SetOptions, ListOptions, MetricQueryOpts, SessionRecord, ReceiptRecord, MetricPoint } from './types';
+import type { GatewaySnapshot } from '../gateway/types';
+/**
+ * @description Redis implementation of {@link PersistenceStore}.
+ *
+ * Key layout (default prefix `synapse`):
+ * ```
+ * synapse:kv:{key}                       → generic KV
+ * synapse:agent:{agentId}                → agent snapshot JSON
+ * synapse:session:{agentId}:{sessionId}  → session record JSON
+ * synapse:receipts:{agentId}             → JSON array of receipts
+ * synapse:metrics:{agentId}:{metricKey}  → JSON array of MetricPoint
+ * ```
+ *
+ * @since 1.2.2
+ */
+export declare class RedisPersistence implements PersistenceStore {
+    readonly name = "redis";
+    private readonly client;
+    private readonly prefix;
+    private readonly defaultTtl;
+    constructor(config: RedisStoreConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    ping(): Promise<boolean>;
+    private kvKey;
+    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>;
+    private agentKey;
+    saveAgent(snapshot: GatewaySnapshot): Promise<void>;
+    loadAgent(agentId: string): Promise<GatewaySnapshot | null>;
+    deleteAgent(agentId: string): Promise<boolean>;
+    listAgents(): Promise<string[]>;
+    private sessionKey;
+    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[]>;
+    private receiptsKey;
+    saveReceipt(record: ReceiptRecord): Promise<void>;
+    listReceipts(agentId: string, opts?: ListOptions): Promise<ReceiptRecord[]>;
+    private metricsKey;
+    recordMetric(agentId: string, key: string, value: number, labels?: Record<string, string>): Promise<void>;
+    queryMetrics(agentId: string, key: string, opts?: MetricQueryOpts): Promise<MetricPoint[]>;
+    save(agentId: string, snapshot: GatewaySnapshot): Promise<void>;
+    load(agentId: string): Promise<GatewaySnapshot | null>;
+    delete(agentId: string): Promise<void>;
+    keys(): Promise<string[]>;
+}
+//# sourceMappingURL=redis.d.ts.map

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

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

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

@@ -0,0 +1,241 @@
+"use strict";
+/**
+ * @module ai/persistence/redis
+ * @description Redis persistence adapter for Synapse AI gateway data.
+ *
+ * Stores agent snapshots, sessions, receipts, metrics, and arbitrary
+ * key-value data in Redis using JSON serialization and configurable
+ * key prefixing.
+ *
+ * Bring your own Redis client — the adapter works with any library
+ * that satisfies the {@link RedisLike} interface:
+ * - **ioredis** (`new Redis()`)
+ * - **node-redis v4** (`createClient()`)
+ * - **@upstash/redis** (REST-based, partial)
+ *
+ * @since 1.2.2
+ *
+ * @example
+ * ```ts
+ * import Redis from 'ioredis';
+ * import { RedisPersistence } from '@oobe-protocol-labs/synapse-client-sdk/ai';
+ *
+ * const redis = new Redis(process.env.REDIS_URL);
+ * const store = new RedisPersistence({ client: redis });
+ * await store.connect();
+ *
+ * await store.saveAgent(gateway.snapshot());
+ * await store.saveSession(sessionRecord);
+ *
+ * // Drop-in for AgentRegistry:
+ * const registry = new AgentRegistry({ persistence: store });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisPersistence = void 0;
+const types_1 = require("./types");
+const helpers_1 = require("./helpers");
+/**
+ * @description Redis implementation of {@link PersistenceStore}.
+ *
+ * Key layout (default prefix `synapse`):
+ * ```
+ * synapse:kv:{key}                       → generic KV
+ * synapse:agent:{agentId}                → agent snapshot JSON
+ * synapse:session:{agentId}:{sessionId}  → session record JSON
+ * synapse:receipts:{agentId}             → JSON array of receipts
+ * synapse:metrics:{agentId}:{metricKey}  → JSON array of MetricPoint
+ * ```
+ *
+ * @since 1.2.2
+ */
+class RedisPersistence {
+    name = 'redis';
+    client;
+    prefix;
+    defaultTtl;
+    constructor(config) {
+        this.client = config.client;
+        this.prefix = config.keyPrefix ?? 'synapse';
+        this.defaultTtl = config.defaultTtl ?? 0;
+    }
+    /* ── Lifecycle ─────────────────────────────────────────── */
+    async connect() {
+        try {
+            await this.client.ping();
+        }
+        catch (err) {
+            throw new types_1.PersistenceError('Failed to connect to Redis', 'CONN_FAILED', err);
+        }
+    }
+    async disconnect() {
+        try {
+            await this.client.quit();
+        }
+        catch {
+            // Swallow — already disconnected
+        }
+    }
+    async ping() {
+        try {
+            const res = await this.client.ping();
+            return res === 'PONG' || res === 'pong';
+        }
+        catch {
+            return false;
+        }
+    }
+    /* ── Generic KV ────────────────────────────────────────── */
+    kvKey(key) {
+        return (0, helpers_1.buildKey)(this.prefix, 'kv', key);
+    }
+    async get(key) {
+        const raw = await this.client.get(this.kvKey(key));
+        return raw ? (0, helpers_1.deserialize)(raw) : null;
+    }
+    async set(key, value, opts) {
+        const k = this.kvKey(key);
+        await this.client.set(k, (0, helpers_1.serialize)(value));
+        const ttl = opts?.ttl ?? this.defaultTtl;
+        if (ttl > 0)
+            await this.client.expire(k, ttl);
+    }
+    async del(key) {
+        const n = await this.client.del(this.kvKey(key));
+        return n > 0;
+    }
+    async has(key) {
+        const n = await this.client.exists(this.kvKey(key));
+        return n > 0;
+    }
+    /* ── Agents ────────────────────────────────────────────── */
+    agentKey(agentId) {
+        return (0, helpers_1.buildKey)(this.prefix, 'agent', agentId);
+    }
+    async saveAgent(snapshot) {
+        const k = this.agentKey(snapshot.agentId);
+        await this.client.set(k, (0, helpers_1.serialize)(snapshot));
+        if (this.defaultTtl > 0)
+            await this.client.expire(k, this.defaultTtl);
+    }
+    async loadAgent(agentId) {
+        const raw = await this.client.get(this.agentKey(agentId));
+        return raw ? (0, helpers_1.deserialize)(raw) : null;
+    }
+    async deleteAgent(agentId) {
+        const n = await this.client.del(this.agentKey(agentId));
+        return n > 0;
+    }
+    async listAgents() {
+        const pattern = (0, helpers_1.buildKey)(this.prefix, 'agent', '*');
+        const keys = await this.client.keys(pattern);
+        const prefixLen = (0, helpers_1.buildKey)(this.prefix, 'agent', '').length;
+        return keys.map(k => k.slice(prefixLen));
+    }
+    /* ── Sessions ──────────────────────────────────────────── */
+    sessionKey(agentId, sessionId) {
+        return (0, helpers_1.buildKey)(this.prefix, 'session', agentId, sessionId);
+    }
+    async saveSession(record) {
+        const k = this.sessionKey(record.agentId, record.id);
+        await this.client.set(k, (0, helpers_1.serialize)(record));
+        // Auto-expire sessions based on their TTL
+        if (record.ttl > 0)
+            await this.client.expire(k, record.ttl);
+    }
+    async loadSession(agentId, sessionId) {
+        const raw = await this.client.get(this.sessionKey(agentId, sessionId));
+        return raw ? (0, helpers_1.deserialize)(raw) : null;
+    }
+    async deleteSessions(agentId) {
+        const pattern = (0, helpers_1.buildKey)(this.prefix, 'session', agentId, '*');
+        const keys = await this.client.keys(pattern);
+        let count = 0;
+        for (const k of keys) {
+            count += await this.client.del(k);
+        }
+        return count;
+    }
+    async listSessions(agentId, opts = {}) {
+        const pattern = (0, helpers_1.buildKey)(this.prefix, 'session', agentId, '*');
+        const keys = await this.client.keys(pattern);
+        let records = [];
+        for (const k of keys) {
+            const raw = await this.client.get(k);
+            if (raw) {
+                const rec = (0, helpers_1.deserialize)(raw);
+                if (opts.status && rec.status !== opts.status)
+                    continue;
+                records.push(rec);
+            }
+        }
+        records.sort((a, b) => b.createdAt - a.createdAt);
+        const offset = opts.offset ?? 0;
+        const limit = opts.limit ?? records.length;
+        return records.slice(offset, offset + limit);
+    }
+    /* ── Receipts ──────────────────────────────────────────── */
+    receiptsKey(agentId) {
+        return (0, helpers_1.buildKey)(this.prefix, 'receipts', agentId);
+    }
+    async saveReceipt(record) {
+        const k = this.receiptsKey(record.agentId);
+        const raw = await this.client.get(k);
+        const list = raw ? (0, helpers_1.deserialize)(raw) : [];
+        list.push(record);
+        await this.client.set(k, (0, helpers_1.serialize)(list));
+    }
+    async listReceipts(agentId, opts = {}) {
+        const raw = await this.client.get(this.receiptsKey(agentId));
+        if (!raw)
+            return [];
+        const list = (0, helpers_1.deserialize)(raw);
+        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 ───────────────────────────────────────────── */
+    metricsKey(agentId, key) {
+        return (0, helpers_1.buildKey)(this.prefix, 'metrics', agentId, key);
+    }
+    async recordMetric(agentId, key, value, labels) {
+        const k = this.metricsKey(agentId, key);
+        const raw = await this.client.get(k);
+        const list = raw ? (0, helpers_1.deserialize)(raw) : [];
+        list.push({ timestamp: Date.now(), value, labels });
+        // Keep last 10 000 points per metric key (prevent unbounded growth)
+        if (list.length > 10_000)
+            list.splice(0, list.length - 10_000);
+        await this.client.set(k, (0, helpers_1.serialize)(list));
+    }
+    async queryMetrics(agentId, key, opts = {}) {
+        const raw = await this.client.get(this.metricsKey(agentId, key));
+        if (!raw)
+            return [];
+        let points = (0, helpers_1.deserialize)(raw);
+        if (opts.from != null)
+            points = points.filter(p => p.timestamp >= opts.from);
+        if (opts.to != null)
+            points = points.filter(p => p.timestamp <= opts.to);
+        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) {
+        await this.deleteAgent(agentId);
+    }
+    async keys() {
+        return this.listAgents();
+    }
+}
+exports.RedisPersistence = RedisPersistence;
+//# sourceMappingURL=redis.js.map