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

package/dist/cjs/ai/index.d.ts

@@ -16,6 +16,7 @@
  */
 export { createExecutableSolanaTools, agentRpcMethods, solanaToolNames, type AgentRpcMethod, type SolanaTool, type SolanaToolMap, type SolanaToolkit, type CreateSolanaToolsOpts, } from './tools';
 export { createJupiterTools, createRaydiumTools, createMetaplexTools, createJupiterOnchainTools, createRaydiumOnchainTools, createSolanaProgramsTools, createProtocolTools, jupiterMethods, jupiterMethodNames, raydiumMethods, raydiumMethodNames, metaplexMethods, metaplexMethodNames, jupiterOnchainMethods, jupiterOnchainMethodNames, raydiumOnchainMethods, raydiumOnchainMethodNames, solanaProgramsMethods, solanaProgramsMethodNames, ProtocolHttpClient, ProtocolApiError, buildProtocolTools, createMethodRegistry, JUPITER_API_URL, RAYDIUM_API_URL, JUPITER_PROGRAM_IDS, RAYDIUM_PROGRAM_IDS, type ProtocolMethod, type ProtocolToolkit, type ProtocolTool, type ProtocolClientConfig, type CreateProtocolToolsOpts, type JupiterToolsConfig, type RaydiumToolsConfig, type MetaplexToolsConfig, type JupiterOnchainToolsConfig, type RaydiumOnchainToolsConfig, type SolanaProgramsToolsConfig, type CreateProtocolToolsConfig, type AllProtocolToolkits, } from './tools';
-export { AgentGateway, createAgentGateway, AgentSession, SessionError, BudgetExhaustedError, RateLimitExceededError, SessionExpiredError, CallLimitExceededError, PricingEngine, DEFAULT_TIERS, ResponseValidator, ToolMarketplace, GatewayError, SessionNotFoundError, MaxSessionsError, IntentVerificationError, type AgentId, type AgentIdentity, type AgentCredential, type PaymentToken, type PricingTier, type PaymentIntent, type PaymentReceipt, type SessionState, type SessionStatus, type ResponseAttestation, type AttestedResult, type ToolListing, type ToolBundle, type GatewayEventType, type GatewayEvent, type GatewayEventHandler, type GatewayConfig, type DynamicPricingConfig, type MarketplaceQuery, type MarketplaceStats, createAgentId, X402Paywall, X402Client, FacilitatorClient, createFacilitator, createX402Client, encodePaymentHeader, decodePaymentHeader, defaultRequirementsSelector, SOLANA_MAINNET, SOLANA_DEVNET, USDC_MAINNET, USDC_DEVNET, X402_HEADER_PAYMENT_REQUIRED, X402_HEADER_PAYMENT_SIGNATURE, X402_HEADER_PAYMENT_RESPONSE, X402_STATUS_CODE, X402_VERSION, FacilitatorError, VerifyError, SettleError, X402ClientError, NoAcceptablePaymentError, PaymentSigningError, PaymentRetryError, type X402Network, type X402ResourceInfo, type X402PaymentRequirements, type X402PaymentRequired, type X402PaymentPayload, type ExactSvmPayload, type X402VerifyResponse, type X402SettleResponse, type X402SettlementResponse, type X402CreateAuthHeaders, type X402FacilitatorConfig, type X402SupportedKind, type X402SupportedResponse, type X402RouteConfig, type X402Config, type X402PayloadSigner, type X402RequirementsSelector, type X402BudgetCheck, type X402ClientConfig, type X402PaymentOutcome, type PaywallResult, type SettleResult, } from './gateway';
+export { AgentGateway, createAgentGateway, AgentSession, SessionError, BudgetExhaustedError, RateLimitExceededError, SessionExpiredError, CallLimitExceededError, PricingEngine, DEFAULT_TIERS, ResponseValidator, ToolMarketplace, AgentRegistry, MemoryAdapter, type PersistenceAdapter, type AgentRegistryConfig, GatewayError, SessionNotFoundError, MaxSessionsError, IntentVerificationError, type AgentId, type AgentIdentity, type AgentCredential, type PaymentToken, type PricingTier, type PaymentIntent, type PaymentReceipt, type SessionState, type SessionStatus, type ResponseAttestation, type AttestedResult, type ToolListing, type ToolBundle, type GatewayEventType, type GatewayEvent, type GatewayEventHandler, type GatewayConfig, type DynamicPricingConfig, type MarketplaceQuery, type MarketplaceStats, createAgentId, type RetryConfig, type SnapshotDepth, type GatewaySnapshot, type X402PipelineStep, X402Paywall, X402Client, FacilitatorClient, createFacilitator, createX402Client, encodePaymentHeader, decodePaymentHeader, defaultRequirementsSelector, SOLANA_MAINNET, SOLANA_DEVNET, USDC_MAINNET, USDC_DEVNET, X402_HEADER_PAYMENT_REQUIRED, X402_HEADER_PAYMENT_SIGNATURE, X402_HEADER_PAYMENT_RESPONSE, X402_STATUS_CODE, X402_VERSION, FacilitatorError, VerifyError, SettleError, X402ClientError, NoAcceptablePaymentError, PaymentSigningError, PaymentRetryError, FacilitatorDiscovery, type FacilitatorHealthResult, type FindBestOptions, type X402Network, type X402ResourceInfo, type X402PaymentRequirements, type X402PaymentRequired, type X402PaymentPayload, type ExactSvmPayload, type X402VerifyResponse, type X402SettleResponse, type X402SettlementResponse, type X402CreateAuthHeaders, type X402FacilitatorConfig, type X402SupportedKind, type X402SupportedResponse, type X402RouteConfig, type X402Config, type X402PayloadSigner, type X402RequirementsSelector, type X402BudgetCheck, type X402ClientConfig, type X402PaymentOutcome, type PaywallResult, type SettleResult, } from './gateway';
+export { MemoryStore, RedisPersistence, PostgresPersistence, PersistenceError, serialize as serializeForStore, deserialize as deserializeFromStore, buildKey as buildStoreKey, buildSchema as buildPostgresSchema, SCHEMA_VERSION as PERSISTENCE_SCHEMA_VERSION, type PersistenceStore, type RedisLike, type PgLike, type SessionRecord, type ReceiptRecord, type MetricPoint, type SetOptions, type ListOptions, type MetricQueryOpts, type StoreConfig, type RedisStoreConfig, type PostgresStoreConfig, type MemoryStoreConfig, } from './persistence';
 export { getJupiterTools, getRaydiumTools, } from './lazy';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/ai/index.d.ts.map

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

package/dist/cjs/ai/index.js

@@ -16,8 +16,8 @@
  * @since 1.0.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FacilitatorClient = exports.X402Client = exports.X402Paywall = exports.createAgentId = exports.IntentVerificationError = exports.MaxSessionsError = exports.SessionNotFoundError = exports.GatewayError = exports.ToolMarketplace = exports.ResponseValidator = exports.DEFAULT_TIERS = exports.PricingEngine = exports.CallLimitExceededError = exports.SessionExpiredError = exports.RateLimitExceededError = exports.BudgetExhaustedError = exports.SessionError = exports.AgentSession = exports.createAgentGateway = exports.AgentGateway = exports.RAYDIUM_PROGRAM_IDS = exports.JUPITER_PROGRAM_IDS = exports.RAYDIUM_API_URL = exports.JUPITER_API_URL = exports.createMethodRegistry = exports.buildProtocolTools = exports.ProtocolApiError = exports.ProtocolHttpClient = exports.solanaProgramsMethodNames = exports.solanaProgramsMethods = exports.raydiumOnchainMethodNames = exports.raydiumOnchainMethods = exports.jupiterOnchainMethodNames = exports.jupiterOnchainMethods = exports.metaplexMethodNames = exports.metaplexMethods = exports.raydiumMethodNames = exports.raydiumMethods = exports.jupiterMethodNames = exports.jupiterMethods = exports.createProtocolTools = exports.createSolanaProgramsTools = exports.createRaydiumOnchainTools = exports.createJupiterOnchainTools = exports.createMetaplexTools = exports.createRaydiumTools = exports.createJupiterTools = exports.solanaToolNames = exports.agentRpcMethods = exports.createExecutableSolanaTools = void 0;
-exports.getRaydiumTools = exports.getJupiterTools = exports.PaymentRetryError = exports.PaymentSigningError = exports.NoAcceptablePaymentError = exports.X402ClientError = exports.SettleError = exports.VerifyError = exports.FacilitatorError = exports.X402_VERSION = exports.X402_STATUS_CODE = exports.X402_HEADER_PAYMENT_RESPONSE = exports.X402_HEADER_PAYMENT_SIGNATURE = exports.X402_HEADER_PAYMENT_REQUIRED = exports.USDC_DEVNET = exports.USDC_MAINNET = exports.SOLANA_DEVNET = exports.SOLANA_MAINNET = exports.defaultRequirementsSelector = exports.decodePaymentHeader = exports.encodePaymentHeader = exports.createX402Client = exports.createFacilitator = void 0;
+exports.X402Paywall = exports.createAgentId = exports.IntentVerificationError = exports.MaxSessionsError = exports.SessionNotFoundError = exports.GatewayError = exports.MemoryAdapter = exports.AgentRegistry = exports.ToolMarketplace = exports.ResponseValidator = exports.DEFAULT_TIERS = exports.PricingEngine = exports.CallLimitExceededError = exports.SessionExpiredError = exports.RateLimitExceededError = exports.BudgetExhaustedError = exports.SessionError = exports.AgentSession = exports.createAgentGateway = exports.AgentGateway = exports.RAYDIUM_PROGRAM_IDS = exports.JUPITER_PROGRAM_IDS = exports.RAYDIUM_API_URL = exports.JUPITER_API_URL = exports.createMethodRegistry = exports.buildProtocolTools = exports.ProtocolApiError = exports.ProtocolHttpClient = exports.solanaProgramsMethodNames = exports.solanaProgramsMethods = exports.raydiumOnchainMethodNames = exports.raydiumOnchainMethods = exports.jupiterOnchainMethodNames = exports.jupiterOnchainMethods = exports.metaplexMethodNames = exports.metaplexMethods = exports.raydiumMethodNames = exports.raydiumMethods = exports.jupiterMethodNames = exports.jupiterMethods = exports.createProtocolTools = exports.createSolanaProgramsTools = exports.createRaydiumOnchainTools = exports.createJupiterOnchainTools = exports.createMetaplexTools = exports.createRaydiumTools = exports.createJupiterTools = exports.solanaToolNames = exports.agentRpcMethods = exports.createExecutableSolanaTools = void 0;
+exports.getRaydiumTools = exports.getJupiterTools = exports.PERSISTENCE_SCHEMA_VERSION = exports.buildPostgresSchema = exports.buildStoreKey = exports.deserializeFromStore = exports.serializeForStore = exports.PersistenceError = exports.PostgresPersistence = exports.RedisPersistence = exports.MemoryStore = exports.FacilitatorDiscovery = exports.PaymentRetryError = exports.PaymentSigningError = exports.NoAcceptablePaymentError = exports.X402ClientError = exports.SettleError = exports.VerifyError = exports.FacilitatorError = exports.X402_VERSION = exports.X402_STATUS_CODE = exports.X402_HEADER_PAYMENT_RESPONSE = exports.X402_HEADER_PAYMENT_SIGNATURE = exports.X402_HEADER_PAYMENT_REQUIRED = exports.USDC_DEVNET = exports.USDC_MAINNET = exports.SOLANA_DEVNET = exports.SOLANA_MAINNET = exports.defaultRequirementsSelector = exports.decodePaymentHeader = exports.encodePaymentHeader = exports.createX402Client = exports.createFacilitator = exports.FacilitatorClient = exports.X402Client = void 0;
 // ── Tools (LangChain) ─────────────────────────────────────────
 var tools_1 = require("./tools");
 Object.defineProperty(exports, "createExecutableSolanaTools", { enumerable: true, get: function () { return tools_1.createExecutableSolanaTools; } });
@@ -75,6 +75,9 @@ Object.defineProperty(exports, "DEFAULT_TIERS", { enumerable: true, get: functio
 Object.defineProperty(exports, "ResponseValidator", { enumerable: true, get: function () { return gateway_1.ResponseValidator; } });
 // Marketplace
 Object.defineProperty(exports, "ToolMarketplace", { enumerable: true, get: function () { return gateway_1.ToolMarketplace; } });
+// Agent Registry
+Object.defineProperty(exports, "AgentRegistry", { enumerable: true, get: function () { return gateway_1.AgentRegistry; } });
+Object.defineProperty(exports, "MemoryAdapter", { enumerable: true, get: function () { return gateway_1.MemoryAdapter; } });
 // Errors
 Object.defineProperty(exports, "GatewayError", { enumerable: true, get: function () { return gateway_1.GatewayError; } });
 Object.defineProperty(exports, "SessionNotFoundError", { enumerable: true, get: function () { return gateway_1.SessionNotFoundError; } });
@@ -107,6 +110,22 @@ Object.defineProperty(exports, "X402ClientError", { enumerable: true, get: funct
 Object.defineProperty(exports, "NoAcceptablePaymentError", { enumerable: true, get: function () { return gateway_1.NoAcceptablePaymentError; } });
 Object.defineProperty(exports, "PaymentSigningError", { enumerable: true, get: function () { return gateway_1.PaymentSigningError; } });
 Object.defineProperty(exports, "PaymentRetryError", { enumerable: true, get: function () { return gateway_1.PaymentRetryError; } });
+// x402 Discovery
+Object.defineProperty(exports, "FacilitatorDiscovery", { enumerable: true, get: function () { return gateway_1.FacilitatorDiscovery; } });
+// ── Persistence (Redis, PostgreSQL, Memory) ──────────────────
+var persistence_1 = require("./persistence");
+// Adapters
+Object.defineProperty(exports, "MemoryStore", { enumerable: true, get: function () { return persistence_1.MemoryStore; } });
+Object.defineProperty(exports, "RedisPersistence", { enumerable: true, get: function () { return persistence_1.RedisPersistence; } });
+Object.defineProperty(exports, "PostgresPersistence", { enumerable: true, get: function () { return persistence_1.PostgresPersistence; } });
+// Error
+Object.defineProperty(exports, "PersistenceError", { enumerable: true, get: function () { return persistence_1.PersistenceError; } });
+// Helpers
+Object.defineProperty(exports, "serializeForStore", { enumerable: true, get: function () { return persistence_1.serialize; } });
+Object.defineProperty(exports, "deserializeFromStore", { enumerable: true, get: function () { return persistence_1.deserialize; } });
+Object.defineProperty(exports, "buildStoreKey", { enumerable: true, get: function () { return persistence_1.buildKey; } });
+Object.defineProperty(exports, "buildPostgresSchema", { enumerable: true, get: function () { return persistence_1.buildSchema; } });
+Object.defineProperty(exports, "PERSISTENCE_SCHEMA_VERSION", { enumerable: true, get: function () { return persistence_1.SCHEMA_VERSION; } });
 // ── Lazy factories (Next.js / webpack compatibility) ──────────
 var lazy_1 = require("./lazy");
 Object.defineProperty(exports, "getJupiterTools", { enumerable: true, get: function () { return lazy_1.getJupiterTools; } });

package/dist/cjs/ai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;;AAEH,iEAAiE;AACjE,iCASiB;AARf,oHAAA,2BAA2B,OAAA;AAC3B,wGAAA,eAAe,OAAA;AACf,wGAAA,eAAe,OAAA;AAQjB,iEAAiE;AACjE,iCA8CiB;AA7Cf,YAAY;AACZ,2GAAA,kBAAkB,OAAA;AAClB,2GAAA,kBAAkB,OAAA;AAClB,4GAAA,mBAAmB,OAAA;AACnB,kHAAA,yBAAyB,OAAA;AACzB,kHAAA,yBAAyB,OAAA;AACzB,kHAAA,yBAAyB,OAAA;AACzB,4GAAA,mBAAmB,OAAA;AACnB,UAAU;AACV,uGAAA,cAAc,OAAA;AACd,2GAAA,kBAAkB,OAAA;AAClB,uGAAA,cAAc,OAAA;AACd,2GAAA,kBAAkB,OAAA;AAClB,wGAAA,eAAe,OAAA;AACf,4GAAA,mBAAmB,OAAA;AACnB,8GAAA,qBAAqB,OAAA;AACrB,kHAAA,yBAAyB,OAAA;AACzB,8GAAA,qBAAqB,OAAA;AACrB,kHAAA,yBAAyB,OAAA;AACzB,8GAAA,qBAAqB,OAAA;AACrB,kHAAA,yBAAyB,OAAA;AACzB,wBAAwB;AACxB,2GAAA,kBAAkB,OAAA;AAClB,yGAAA,gBAAgB,OAAA;AAChB,2GAAA,kBAAkB,OAAA;AAClB,6GAAA,oBAAoB,OAAA;AACpB,YAAY;AACZ,wGAAA,eAAe,OAAA;AACf,wGAAA,eAAe,OAAA;AACf,4GAAA,mBAAmB,OAAA;AACnB,4GAAA,mBAAmB,OAAA;AAiBrB,iEAAiE;AACjE,qCAuGmB;AAtGjB,oBAAoB;AACpB,uGAAA,YAAY,OAAA;AACZ,6GAAA,kBAAkB,OAAA;AAElB,UAAU;AACV,uGAAA,YAAY,OAAA;AACZ,uGAAA,YAAY,OAAA;AACZ,+GAAA,oBAAoB,OAAA;AACpB,iHAAA,sBAAsB,OAAA;AACtB,8GAAA,mBAAmB,OAAA;AACnB,iHAAA,sBAAsB,OAAA;AAEtB,UAAU;AACV,wGAAA,aAAa,OAAA;AACb,wGAAA,aAAa,OAAA;AAEb,cAAc;AACd,4GAAA,iBAAiB,OAAA;AAEjB,cAAc;AACd,0GAAA,eAAe,OAAA;AAEf,SAAS;AACT,uGAAA,YAAY,OAAA;AACZ,+GAAA,oBAAoB,OAAA;AACpB,2GAAA,gBAAgB,OAAA;AAChB,kHAAA,uBAAuB,OAAA;AAuBvB,wGAAA,aAAa,OAAA;AAEb,gBAAgB;AAChB,sGAAA,WAAW,OAAA;AACX,qGAAA,UAAU,OAAA;AACV,4GAAA,iBAAiB,OAAA;AACjB,4GAAA,iBAAiB,OAAA;AACjB,2GAAA,gBAAgB,OAAA;AAChB,8GAAA,mBAAmB,OAAA;AACnB,8GAAA,mBAAmB,OAAA;AACnB,sHAAA,2BAA2B,OAAA;AAC3B,yGAAA,cAAc,OAAA;AACd,wGAAA,aAAa,OAAA;AACb,uGAAA,YAAY,OAAA;AACZ,sGAAA,WAAW,OAAA;AACX,uHAAA,4BAA4B,OAAA;AAC5B,wHAAA,6BAA6B,OAAA;AAC7B,uHAAA,4BAA4B,OAAA;AAC5B,2GAAA,gBAAgB,OAAA;AAChB,uGAAA,YAAY,OAAA;AAEZ,cAAc;AACd,2GAAA,gBAAgB,OAAA;AAChB,sGAAA,WAAW,OAAA;AACX,sGAAA,WAAW,OAAA;AACX,0GAAA,eAAe,OAAA;AACf,mHAAA,wBAAwB,OAAA;AACxB,8GAAA,mBAAmB,OAAA;AACnB,4GAAA,iBAAiB,OAAA;AA2BnB,iEAAiE;AACjE,+BAGgB;AAFd,uGAAA,eAAe,OAAA;AACf,uGAAA,eAAe,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/index.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,83 @@
+/**
+ * @module ai/persistence/helpers
+ * @description Serialization utilities, key builders, and PostgreSQL schema
+ * for the Synapse AI persistence layer.
+ *
+ * @since 1.2.2
+ */
+/**
+ * Serialize a value to a JSON string, converting `BigInt` to strings.
+ *
+ * @param value - Any value (may contain `BigInt`, `Map`, nested objects).
+ * @returns JSON string safe for storage.
+ * @since 1.2.2
+ */
+export declare function serialize(value: unknown): string;
+/**
+ * Deserialize a JSON string back to a typed value.
+ *
+ * @typeParam T - Expected return type.
+ * @param json - JSON string from the store.
+ * @returns Parsed value.
+ * @since 1.2.2
+ */
+export declare function deserialize<T = unknown>(json: string): T;
+/**
+ * Build a namespaced Redis key from segments.
+ *
+ * @example
+ * ```ts
+ * buildKey('synapse', 'agent', 'did:agent:1');
+ * // → 'synapse:agent:did:agent:1'
+ * ```
+ *
+ * @param parts - Key segments joined by `:`.
+ * @returns Colon-delimited key string.
+ * @since 1.2.2
+ */
+export declare function buildKey(...parts: string[]): string;
+/**
+ * Strip a prefix from a Redis key and return the remaining segments.
+ *
+ * @param prefix - The prefix to strip (e.g. `'synapse'`).
+ * @param key    - Full key (e.g. `'synapse:agent:id1'`).
+ * @returns Remaining segments after the prefix (e.g. `['agent', 'id1']`).
+ * @since 1.2.2
+ */
+export declare function parseKey(prefix: string, key: string): string[];
+/**
+ * Extract the agent ID from a namespaced Redis key.
+ *
+ * @param prefix - Key prefix (e.g. `'synapse'`).
+ * @param key    - Full key (e.g. `'synapse:agent:my-agent'`).
+ * @returns The agent ID segment, or the full key if pattern doesn't match.
+ * @since 1.2.2
+ */
+export declare function extractAgentId(prefix: string, key: string): string;
+/** Current schema version. Bump when adding migrations. */
+export declare const SCHEMA_VERSION = 1;
+/**
+ * Generate the full PostgreSQL DDL for a given table prefix.
+ *
+ * Creates tables:
+ * - `{prefix}_agents`   — agent snapshots (JSONB)
+ * - `{prefix}_sessions` — session records (JSONB)
+ * - `{prefix}_receipts` — payment receipts (JSONB)
+ * - `{prefix}_metrics`  — time-series metric points
+ * - `{prefix}_kv`       — generic key-value store
+ * - `{prefix}_schema_version` — migration tracking
+ *
+ * @param prefix - Table name prefix (default: `'synapse'`).
+ * @returns SQL DDL string ready for `client.query()`.
+ * @since 1.2.2
+ */
+export declare function buildSchema(prefix?: string): string;
+/**
+ * SQL to clean up expired rows from the KV table.
+ *
+ * @param prefix - Table name prefix.
+ * @returns DELETE statement string.
+ * @since 1.2.2
+ */
+export declare function buildKvCleanupSql(prefix?: string): string;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/ai/persistence/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAExD;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAG9D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIlE;AAMD,2DAA2D;AAC3D,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,MAAM,GAAE,MAAkB,GAAG,MAAM,CA2E9D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,MAAkB,GAAG,MAAM,CAEpE"}

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

@@ -0,0 +1,193 @@
+"use strict";
+/**
+ * @module ai/persistence/helpers
+ * @description Serialization utilities, key builders, and PostgreSQL schema
+ * for the Synapse AI persistence layer.
+ *
+ * @since 1.2.2
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCHEMA_VERSION = void 0;
+exports.serialize = serialize;
+exports.deserialize = deserialize;
+exports.buildKey = buildKey;
+exports.parseKey = parseKey;
+exports.extractAgentId = extractAgentId;
+exports.buildSchema = buildSchema;
+exports.buildKvCleanupSql = buildKvCleanupSql;
+const helpers_1 = require("../../utils/helpers");
+/* ═══════════════════════════════════════════════════════════════
+ *  Serialization
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * Serialize a value to a JSON string, converting `BigInt` to strings.
+ *
+ * @param value - Any value (may contain `BigInt`, `Map`, nested objects).
+ * @returns JSON string safe for storage.
+ * @since 1.2.2
+ */
+function serialize(value) {
+    return JSON.stringify((0, helpers_1.toJsonSafe)(value));
+}
+/**
+ * Deserialize a JSON string back to a typed value.
+ *
+ * @typeParam T - Expected return type.
+ * @param json - JSON string from the store.
+ * @returns Parsed value.
+ * @since 1.2.2
+ */
+function deserialize(json) {
+    return JSON.parse(json);
+}
+/* ═══════════════════════════════════════════════════════════════
+ *  Redis key builders
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * Build a namespaced Redis key from segments.
+ *
+ * @example
+ * ```ts
+ * buildKey('synapse', 'agent', 'did:agent:1');
+ * // → 'synapse:agent:did:agent:1'
+ * ```
+ *
+ * @param parts - Key segments joined by `:`.
+ * @returns Colon-delimited key string.
+ * @since 1.2.2
+ */
+function buildKey(...parts) {
+    return parts.join(':');
+}
+/**
+ * Strip a prefix from a Redis key and return the remaining segments.
+ *
+ * @param prefix - The prefix to strip (e.g. `'synapse'`).
+ * @param key    - Full key (e.g. `'synapse:agent:id1'`).
+ * @returns Remaining segments after the prefix (e.g. `['agent', 'id1']`).
+ * @since 1.2.2
+ */
+function parseKey(prefix, key) {
+    const stripped = key.startsWith(prefix + ':') ? key.slice(prefix.length + 1) : key;
+    return stripped.split(':');
+}
+/**
+ * Extract the agent ID from a namespaced Redis key.
+ *
+ * @param prefix - Key prefix (e.g. `'synapse'`).
+ * @param key    - Full key (e.g. `'synapse:agent:my-agent'`).
+ * @returns The agent ID segment, or the full key if pattern doesn't match.
+ * @since 1.2.2
+ */
+function extractAgentId(prefix, key) {
+    const parts = parseKey(prefix, key);
+    // Keys are: agent:{id}, session:{agentId}:{sessionId}, etc.
+    return parts.length >= 2 ? parts[1] : key;
+}
+/* ═══════════════════════════════════════════════════════════════
+ *  PostgreSQL schema
+ * ═══════════════════════════════════════════════════════════════ */
+/** Current schema version. Bump when adding migrations. */
+exports.SCHEMA_VERSION = 1;
+/**
+ * Generate the full PostgreSQL DDL for a given table prefix.
+ *
+ * Creates tables:
+ * - `{prefix}_agents`   — agent snapshots (JSONB)
+ * - `{prefix}_sessions` — session records (JSONB)
+ * - `{prefix}_receipts` — payment receipts (JSONB)
+ * - `{prefix}_metrics`  — time-series metric points
+ * - `{prefix}_kv`       — generic key-value store
+ * - `{prefix}_schema_version` — migration tracking
+ *
+ * @param prefix - Table name prefix (default: `'synapse'`).
+ * @returns SQL DDL string ready for `client.query()`.
+ * @since 1.2.2
+ */
+function buildSchema(prefix = 'synapse') {
+    const p = prefix;
+    return `
+-- ═══════════════════════════════════════════════════════════════
+--  Synapse AI Persistence — Schema v${exports.SCHEMA_VERSION}
+--  Prefix: ${p}
+-- ═══════════════════════════════════════════════════════════════
+
+-- Agent snapshots
+CREATE TABLE IF NOT EXISTS ${p}_agents (
+  agent_id   TEXT PRIMARY KEY,
+  snapshot   JSONB NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+-- Session records
+CREATE TABLE IF NOT EXISTS ${p}_sessions (
+  id         TEXT NOT NULL,
+  agent_id   TEXT NOT NULL,
+  state      JSONB NOT NULL,
+  status     TEXT NOT NULL DEFAULT 'active',
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  PRIMARY KEY (agent_id, id)
+);
+CREATE INDEX IF NOT EXISTS idx_${p}_sessions_agent
+  ON ${p}_sessions (agent_id);
+CREATE INDEX IF NOT EXISTS idx_${p}_sessions_status
+  ON ${p}_sessions (status);
+
+-- Payment receipts
+CREATE TABLE IF NOT EXISTS ${p}_receipts (
+  id             TEXT PRIMARY KEY,
+  agent_id       TEXT NOT NULL,
+  session_id     TEXT,
+  receipt        JSONB NOT NULL,
+  amount_charged TEXT NOT NULL DEFAULT '0',
+  settled_at     TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+CREATE INDEX IF NOT EXISTS idx_${p}_receipts_agent
+  ON ${p}_receipts (agent_id);
+CREATE INDEX IF NOT EXISTS idx_${p}_receipts_settled
+  ON ${p}_receipts (settled_at DESC);
+
+-- Metric time-series
+CREATE TABLE IF NOT EXISTS ${p}_metrics (
+  id          BIGSERIAL PRIMARY KEY,
+  agent_id    TEXT NOT NULL,
+  metric_key  TEXT NOT NULL,
+  value       DOUBLE PRECISION NOT NULL,
+  labels      JSONB DEFAULT '{}',
+  recorded_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+CREATE INDEX IF NOT EXISTS idx_${p}_metrics_agent_key
+  ON ${p}_metrics (agent_id, metric_key);
+CREATE INDEX IF NOT EXISTS idx_${p}_metrics_time
+  ON ${p}_metrics (recorded_at DESC);
+
+-- Generic key-value store
+CREATE TABLE IF NOT EXISTS ${p}_kv (
+  key        TEXT PRIMARY KEY,
+  value      JSONB NOT NULL,
+  expires_at TIMESTAMPTZ,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+-- Schema version tracking
+CREATE TABLE IF NOT EXISTS ${p}_schema_version (
+  version    INTEGER PRIMARY KEY,
+  applied_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+INSERT INTO ${p}_schema_version (version) VALUES (${exports.SCHEMA_VERSION})
+  ON CONFLICT (version) DO NOTHING;
+`.trim();
+}
+/**
+ * SQL to clean up expired rows from the KV table.
+ *
+ * @param prefix - Table name prefix.
+ * @returns DELETE statement string.
+ * @since 1.2.2
+ */
+function buildKvCleanupSql(prefix = 'synapse') {
+    return `DELETE FROM ${prefix}_kv WHERE expires_at IS NOT NULL AND expires_at < NOW()`;
+}
+//# sourceMappingURL=helpers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../../src/ai/persistence/helpers.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAeH,8BAEC;AAUD,kCAEC;AAmBD,4BAEC;AAUD,4BAGC;AAUD,wCAIC;AAwBD,kCA2EC;AASD,8CAEC;AAzLD,iDAAiD;AAEjD;;qEAEqE;AAErE;;;;;;GAMG;AACH,SAAgB,SAAS,CAAC,KAAc;IACtC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAA,oBAAU,EAAC,KAAK,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,WAAW,CAAc,IAAY;IACnD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;AAC/B,CAAC;AAED;;qEAEqE;AAErE;;;;;;;;;;;;GAYG;AACH,SAAgB,QAAQ,CAAC,GAAG,KAAe;IACzC,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,QAAQ,CAAC,MAAc,EAAE,GAAW;IAClD,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACnF,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,cAAc,CAAC,MAAc,EAAE,GAAW;IACxD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,4DAA4D;IAC5D,OAAO,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AAC5C,CAAC;AAED;;qEAEqE;AAErE,2DAA2D;AAC9C,QAAA,cAAc,GAAG,CAAC,CAAC;AAEhC;;;;;;;;;;;;;;GAcG;AACH,SAAgB,WAAW,CAAC,SAAiB,SAAS;IACpD,MAAM,CAAC,GAAG,MAAM,CAAC;IACjB,OAAO;;uCAE8B,sBAAc;cACvC,CAAC;;;;6BAIc,CAAC;;;;;;;;6BAQD,CAAC;;;;;;;;;iCASG,CAAC;OAC3B,CAAC;iCACyB,CAAC;OAC3B,CAAC;;;6BAGqB,CAAC;;;;;;;;iCAQG,CAAC;OAC3B,CAAC;iCACyB,CAAC;OAC3B,CAAC;;;6BAGqB,CAAC;;;;;;;;iCAQG,CAAC;OAC3B,CAAC;iCACyB,CAAC;OAC3B,CAAC;;;6BAGqB,CAAC;;;;;;;;6BAQD,CAAC;;;;cAIhB,CAAC,qCAAqC,sBAAc;;CAEjE,CAAC,IAAI,EAAE,CAAC;AACT,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,SAAiB,SAAS;IAC1D,OAAO,eAAe,MAAM,yDAAyD,CAAC;AACxF,CAAC"}

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

@@ -0,0 +1,91 @@
+/**
+ * @module ai/persistence
+ * @description Synapse AI Persistence Layer — Redis, PostgreSQL, and in-memory
+ * adapters for long-term storage of agent snapshots, sessions, receipts,
+ * and metrics.
+ *
+ * ## Architecture
+ *
+ * All adapters implement the universal {@link PersistenceStore} interface
+ * **and** the `PersistenceAdapter` interface from {@link AgentRegistry},
+ * so they work everywhere:
+ *
+ * ```ts
+ * // As a standalone store
+ * const store = new RedisPersistence({ client: redis });
+ * await store.saveAgent(snapshot);
+ *
+ * // As AgentRegistry backend
+ * const registry = new AgentRegistry({ persistence: store });
+ * ```
+ *
+ * ## Adapters
+ *
+ * | Adapter | Backing store | Best for |
+ * |---|---|---|
+ * | {@link MemoryStore} | In-process `Map` | Testing, dev, CLI tools |
+ * | {@link RedisPersistence} | Redis / Valkey | Sessions, caching, pub/sub |
+ * | {@link PostgresPersistence} | PostgreSQL | Analytics, receipts, audit |
+ *
+ * ## Dependency injection
+ *
+ * Redis and PostgreSQL adapters accept a pre-configured client instance
+ * via their constructor config. No runtime dependencies are bundled —
+ * install `ioredis` or `pg` as needed.
+ *
+ * @example Redis quick start
+ * ```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, defaultTtl: 3600 });
+ * await store.connect();
+ *
+ * await store.saveAgent(gateway.snapshot());
+ * await store.saveSession(sessionRecord);
+ * await store.recordMetric('agent-1', 'calls', 42);
+ * ```
+ *
+ * @example PostgreSQL quick start
+ * ```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(); // auto-creates tables
+ *
+ * await store.saveAgent(gateway.snapshot());
+ * const receipts = await store.listReceipts('agent-1', { limit: 50 });
+ * const stats = await store.getTableStats();
+ * ```
+ *
+ * @example Dual-store pattern (Redis cache + PostgreSQL archive)
+ * ```ts
+ * import Redis from 'ioredis';
+ * import { Pool } from 'pg';
+ * import { RedisPersistence, PostgresPersistence } from '@oobe-protocol-labs/synapse-client-sdk/ai';
+ *
+ * const cache   = new RedisPersistence({ client: new Redis(), defaultTtl: 300 });
+ * const archive = new PostgresPersistence({ client: new Pool() });
+ * await Promise.all([cache.connect(), archive.connect()]);
+ *
+ * // Write to both, read from cache first
+ * async function saveAgent(snapshot) {
+ *   await Promise.all([cache.saveAgent(snapshot), archive.saveAgent(snapshot)]);
+ * }
+ *
+ * async function loadAgent(id) {
+ *   return (await cache.loadAgent(id)) ?? archive.loadAgent(id);
+ * }
+ * ```
+ *
+ * @since 1.2.2
+ */
+export { PersistenceError, type PersistenceStore, type RedisLike, type PgLike, type SessionRecord, type ReceiptRecord, type MetricPoint, type SetOptions, type ListOptions, type MetricQueryOpts, type StoreConfig, type RedisStoreConfig, type PostgresStoreConfig, type MemoryStoreConfig, } from './types';
+export { serialize, deserialize, buildKey, parseKey, extractAgentId, buildSchema, buildKvCleanupSql, SCHEMA_VERSION, } from './helpers';
+export { MemoryStore } from './memory';
+export { RedisPersistence } from './redis';
+export { PostgresPersistence } from './postgresql';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai/persistence/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AAGH,OAAO,EACL,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,SAAS,EACT,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,cAAc,GACf,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * @module ai/persistence
+ * @description Synapse AI Persistence Layer — Redis, PostgreSQL, and in-memory
+ * adapters for long-term storage of agent snapshots, sessions, receipts,
+ * and metrics.
+ *
+ * ## Architecture
+ *
+ * All adapters implement the universal {@link PersistenceStore} interface
+ * **and** the `PersistenceAdapter` interface from {@link AgentRegistry},
+ * so they work everywhere:
+ *
+ * ```ts
+ * // As a standalone store
+ * const store = new RedisPersistence({ client: redis });
+ * await store.saveAgent(snapshot);
+ *
+ * // As AgentRegistry backend
+ * const registry = new AgentRegistry({ persistence: store });
+ * ```
+ *
+ * ## Adapters
+ *
+ * | Adapter | Backing store | Best for |
+ * |---|---|---|
+ * | {@link MemoryStore} | In-process `Map` | Testing, dev, CLI tools |
+ * | {@link RedisPersistence} | Redis / Valkey | Sessions, caching, pub/sub |
+ * | {@link PostgresPersistence} | PostgreSQL | Analytics, receipts, audit |
+ *
+ * ## Dependency injection
+ *
+ * Redis and PostgreSQL adapters accept a pre-configured client instance
+ * via their constructor config. No runtime dependencies are bundled —
+ * install `ioredis` or `pg` as needed.
+ *
+ * @example Redis quick start
+ * ```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, defaultTtl: 3600 });
+ * await store.connect();
+ *
+ * await store.saveAgent(gateway.snapshot());
+ * await store.saveSession(sessionRecord);
+ * await store.recordMetric('agent-1', 'calls', 42);
+ * ```
+ *
+ * @example PostgreSQL quick start
+ * ```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(); // auto-creates tables
+ *
+ * await store.saveAgent(gateway.snapshot());
+ * const receipts = await store.listReceipts('agent-1', { limit: 50 });
+ * const stats = await store.getTableStats();
+ * ```
+ *
+ * @example Dual-store pattern (Redis cache + PostgreSQL archive)
+ * ```ts
+ * import Redis from 'ioredis';
+ * import { Pool } from 'pg';
+ * import { RedisPersistence, PostgresPersistence } from '@oobe-protocol-labs/synapse-client-sdk/ai';
+ *
+ * const cache   = new RedisPersistence({ client: new Redis(), defaultTtl: 300 });
+ * const archive = new PostgresPersistence({ client: new Pool() });
+ * await Promise.all([cache.connect(), archive.connect()]);
+ *
+ * // Write to both, read from cache first
+ * async function saveAgent(snapshot) {
+ *   await Promise.all([cache.saveAgent(snapshot), archive.saveAgent(snapshot)]);
+ * }
+ *
+ * async function loadAgent(id) {
+ *   return (await cache.loadAgent(id)) ?? archive.loadAgent(id);
+ * }
+ * ```
+ *
+ * @since 1.2.2
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresPersistence = exports.RedisPersistence = exports.MemoryStore = exports.SCHEMA_VERSION = exports.buildKvCleanupSql = exports.buildSchema = exports.extractAgentId = exports.parseKey = exports.buildKey = exports.deserialize = exports.serialize = exports.PersistenceError = void 0;
+/* ── Types ───────────────────────────────────────────────────── */
+var types_1 = require("./types");
+Object.defineProperty(exports, "PersistenceError", { enumerable: true, get: function () { return types_1.PersistenceError; } });
+/* ── Helpers ─────────────────────────────────────────────────── */
+var helpers_1 = require("./helpers");
+Object.defineProperty(exports, "serialize", { enumerable: true, get: function () { return helpers_1.serialize; } });
+Object.defineProperty(exports, "deserialize", { enumerable: true, get: function () { return helpers_1.deserialize; } });
+Object.defineProperty(exports, "buildKey", { enumerable: true, get: function () { return helpers_1.buildKey; } });
+Object.defineProperty(exports, "parseKey", { enumerable: true, get: function () { return helpers_1.parseKey; } });
+Object.defineProperty(exports, "extractAgentId", { enumerable: true, get: function () { return helpers_1.extractAgentId; } });
+Object.defineProperty(exports, "buildSchema", { enumerable: true, get: function () { return helpers_1.buildSchema; } });
+Object.defineProperty(exports, "buildKvCleanupSql", { enumerable: true, get: function () { return helpers_1.buildKvCleanupSql; } });
+Object.defineProperty(exports, "SCHEMA_VERSION", { enumerable: true, get: function () { return helpers_1.SCHEMA_VERSION; } });
+/* ── Adapters ────────────────────────────────────────────────── */
+var memory_1 = require("./memory");
+Object.defineProperty(exports, "MemoryStore", { enumerable: true, get: function () { return memory_1.MemoryStore; } });
+var redis_1 = require("./redis");
+Object.defineProperty(exports, "RedisPersistence", { enumerable: true, get: function () { return redis_1.RedisPersistence; } });
+var postgresql_1 = require("./postgresql");
+Object.defineProperty(exports, "PostgresPersistence", { enumerable: true, get: function () { return postgresql_1.PostgresPersistence; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ai/persistence/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;;;AAEH,oEAAoE;AACpE,iCAeiB;AAdf,yGAAA,gBAAgB,OAAA;AAgBlB,oEAAoE;AACpE,qCASmB;AARjB,oGAAA,SAAS,OAAA;AACT,sGAAA,WAAW,OAAA;AACX,mGAAA,QAAQ,OAAA;AACR,mGAAA,QAAQ,OAAA;AACR,yGAAA,cAAc,OAAA;AACd,sGAAA,WAAW,OAAA;AACX,4GAAA,iBAAiB,OAAA;AACjB,yGAAA,cAAc,OAAA;AAGhB,oEAAoE;AACpE,mCAAuC;AAA9B,qGAAA,WAAW,OAAA;AACpB,iCAA2C;AAAlC,yGAAA,gBAAgB,OAAA;AACzB,2CAAmD;AAA1C,iHAAA,mBAAmB,OAAA"}