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

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

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

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

@@ -0,0 +1,267 @@
+/**
+ * @module ai/persistence/types
+ * @description Core type definitions for the Synapse AI persistence layer.
+ *
+ * Defines the universal {@link PersistenceStore} interface and all associated
+ * data records, configuration objects, and client abstractions.
+ *
+ * The generic client interfaces ({@link RedisLike}, {@link PgLike}) use
+ * dependency-injection: you create the client with your preferred library
+ * (ioredis, node-redis, pg, @vercel/postgres, @neondatabase/serverless, …)
+ * and pass the instance to the adapter constructor.
+ *
+ * @since 1.2.2
+ */
+import type { GatewaySnapshot } from '../gateway/types';
+/**
+ * @description Error thrown by any persistence store operation.
+ * @since 1.2.2
+ */
+export declare class PersistenceError extends Error {
+    /** Machine-readable error code (e.g. `'CONN_FAILED'`, `'QUERY_ERROR'`). */
+    readonly code: string;
+    /** The underlying error from the database driver, if any. */
+    readonly cause?: unknown | undefined;
+    constructor(message: string, 
+    /** Machine-readable error code (e.g. `'CONN_FAILED'`, `'QUERY_ERROR'`). */
+    code: string, 
+    /** The underlying error from the database driver, if any. */
+    cause?: unknown | undefined);
+}
+/**
+ * @description Minimal interface a Redis-compatible client must satisfy.
+ *
+ * Compatible with:
+ * - **ioredis** (`new Redis()`)
+ * - **node-redis v4** (`createClient()`)
+ * - **@upstash/redis** (REST-based)
+ * - Any client exposing the same method signatures
+ *
+ * @since 1.2.2
+ */
+export interface RedisLike {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, ...args: unknown[]): Promise<unknown>;
+    del(key: string): Promise<number>;
+    exists(key: string): Promise<number>;
+    keys(pattern: string): Promise<string[]>;
+    expire(key: string, seconds: number): Promise<number | boolean>;
+    ping(): Promise<string>;
+    quit(): Promise<unknown>;
+}
+/**
+ * @description Minimal interface a PostgreSQL-compatible client must satisfy.
+ *
+ * Compatible with:
+ * - **pg** (`new Pool()` or `new Client()`)
+ * - **@vercel/postgres** (`sql` tagged template or pool)
+ * - **@neondatabase/serverless** (`neon()`)
+ * - Any client exposing a `.query()` method
+ *
+ * @since 1.2.2
+ */
+export interface PgLike {
+    query<T extends Record<string, unknown> = Record<string, unknown>>(text: string, values?: unknown[]): Promise<{
+        rows: T[];
+        rowCount: number | null;
+    }>;
+    /** Optional — some pool implementations don't expose `end()`. */
+    end?(): Promise<void>;
+}
+/**
+ * @description JSON-safe session record for persistence.
+ * All `BigInt` fields are stored as decimal strings.
+ * @since 1.2.2
+ */
+export interface SessionRecord {
+    /** Session unique ID. */
+    id: string;
+    /** Owning agent ID. */
+    agentId: string;
+    /** Lifecycle status (`active`, `settled`, `expired`, …). */
+    status: string;
+    /** Buyer agent ID. */
+    buyer: string;
+    /** Seller agent ID. */
+    seller: string;
+    /** Pricing tier ID. */
+    tierId: string;
+    /** Payment-intent nonce. */
+    intentNonce: string;
+    /** Remaining budget (smallest token unit, as string). */
+    budgetRemaining: string;
+    /** Total budget allocated at session start (as string). */
+    budgetTotal: string;
+    /** Number of calls made. */
+    callsMade: number;
+    /** Calls remaining (−1 = unlimited). */
+    callsRemaining: number;
+    /** Per-method call counts. */
+    methodCounts: Record<string, number>;
+    /** Arbitrary session metadata. */
+    metadata: Record<string, unknown>;
+    /** Unix timestamp of creation (ms). */
+    createdAt: number;
+    /** Unix timestamp of last activity (ms). */
+    lastActivityAt: number;
+    /** Session TTL in seconds. */
+    ttl: number;
+}
+/**
+ * @description JSON-safe payment receipt for persistence.
+ * @since 1.2.2
+ */
+export interface ReceiptRecord {
+    /** Receipt unique ID. */
+    id: string;
+    /** Agent that issued the receipt. */
+    agentId: string;
+    /** Session this receipt belongs to. */
+    sessionId?: string;
+    /** Payment-intent nonce. */
+    intentNonce: string;
+    /** Amount actually charged (smallest unit, as string). */
+    amountCharged: string;
+    /** Total calls billed in this receipt. */
+    callCount: number;
+    /** On-chain tx signature, or `null` for off-chain. */
+    txSignature: string | null;
+    /** Settlement method (`onchain`, `offchain-escrow`, `streaming`). */
+    settlement: string;
+    /** Unix timestamp of settlement (ms). */
+    settledAt: number;
+}
+/**
+ * @description A single metric data point.
+ * @since 1.2.2
+ */
+export interface MetricPoint {
+    /** Unix timestamp (ms). */
+    timestamp: number;
+    /** Numeric value. */
+    value: number;
+    /** Optional labels for grouping/filtering. */
+    labels?: Record<string, string>;
+}
+/** Options for {@link PersistenceStore.set}. */
+export interface SetOptions {
+    /** TTL in seconds (0 or `undefined` = no expiry). */
+    ttl?: number;
+}
+/** Options for list queries (sessions, receipts). */
+export interface ListOptions {
+    /** Max results to return. */
+    limit?: number;
+    /** Offset for pagination. */
+    offset?: number;
+    /** Filter by status (sessions only). */
+    status?: string;
+}
+/** Options for metric queries. */
+export interface MetricQueryOpts {
+    /** Start timestamp (inclusive, ms). */
+    from?: number;
+    /** End timestamp (inclusive, ms). */
+    to?: number;
+    /** Max points to return (most recent first). */
+    limit?: number;
+}
+/** Base configuration shared by all stores. */
+export interface StoreConfig {
+    /**
+     * Key/table prefix. Default: `'synapse'`.
+     * - Redis keys: `{prefix}:agent:{id}`, `{prefix}:session:{agentId}:{id}`, …
+     * - PostgreSQL tables: `{prefix}_agents`, `{prefix}_sessions`, …
+     */
+    keyPrefix?: string;
+}
+/** Configuration for {@link RedisPersistence}. */
+export interface RedisStoreConfig extends StoreConfig {
+    /** Pre-configured Redis-compatible client instance. */
+    client: RedisLike;
+    /** Default TTL in seconds for stored values (0 = no expiry). Default: `0`. */
+    defaultTtl?: number;
+}
+/** Configuration for {@link PostgresPersistence}. */
+export interface PostgresStoreConfig extends StoreConfig {
+    /** Pre-configured PostgreSQL-compatible client/pool instance. */
+    client: PgLike;
+    /** Run schema migrations automatically on `connect()`. Default: `true`. */
+    autoMigrate?: boolean;
+}
+/** Configuration for {@link MemoryStore}. */
+export interface MemoryStoreConfig extends StoreConfig {
+    /** Maximum entries before oldest are evicted (0 = unlimited). Default: `0`. */
+    maxEntries?: number;
+}
+/**
+ * @description Universal persistence store for Synapse AI gateway data.
+ *
+ * Three built-in implementations:
+ * | Store | Best for |
+ * |---|---|
+ * | {@link MemoryStore} | Testing, dev, single-process |
+ * | {@link RedisPersistence} | Sessions, caching, pub/sub, replicas |
+ * | {@link PostgresPersistence} | Long-term analytics, receipts, audit |
+ *
+ * All implementations also satisfy the `PersistenceAdapter` interface
+ * from {@link AgentRegistry}, so they can be used as drop-in replacements:
+ *
+ * ```ts
+ * const store = new RedisPersistence({ client: redis });
+ * const registry = new AgentRegistry({ persistence: store });
+ * ```
+ *
+ * @since 1.2.2
+ */
+export interface PersistenceStore {
+    /** Store identifier (e.g. `'memory'`, `'redis'`, `'postgresql'`). */
+    readonly name: string;
+    /** Establish connection / run migrations. Idempotent. */
+    connect(): Promise<void>;
+    /** Gracefully disconnect from the backing store. */
+    disconnect(): Promise<void>;
+    /** Health check — returns `true` if the store is reachable. */
+    ping(): Promise<boolean>;
+    /** Retrieve a value by key. Returns `null` if not found or expired. */
+    get<T = unknown>(key: string): Promise<T | null>;
+    /** Store a value by key with optional TTL. */
+    set(key: string, value: unknown, opts?: SetOptions): Promise<void>;
+    /** Delete a key. Returns `true` if the key existed. */
+    del(key: string): Promise<boolean>;
+    /** Check if a key exists (and is not expired). */
+    has(key: string): Promise<boolean>;
+    /** Persist an agent's {@link GatewaySnapshot}. */
+    saveAgent(snapshot: GatewaySnapshot): Promise<void>;
+    /** Load an agent snapshot by ID. */
+    loadAgent(agentId: string): Promise<GatewaySnapshot | null>;
+    /** Delete an agent snapshot. Returns `true` if it existed. */
+    deleteAgent(agentId: string): Promise<boolean>;
+    /** List all persisted agent IDs. */
+    listAgents(): Promise<string[]>;
+    /** Persist a session record. */
+    saveSession(record: SessionRecord): Promise<void>;
+    /** Load a session by agent ID + session ID. */
+    loadSession(agentId: string, sessionId: string): Promise<SessionRecord | null>;
+    /** Delete all sessions for an agent. Returns the count deleted. */
+    deleteSessions(agentId: string): Promise<number>;
+    /** List sessions for an agent with optional filtering. */
+    listSessions(agentId: string, opts?: ListOptions): Promise<SessionRecord[]>;
+    /** Persist a payment receipt. */
+    saveReceipt(record: ReceiptRecord): Promise<void>;
+    /** List receipts for an agent with pagination. */
+    listReceipts(agentId: string, opts?: ListOptions): Promise<ReceiptRecord[]>;
+    /** Record a numeric metric data point. */
+    recordMetric(agentId: string, key: string, value: number, labels?: Record<string, string>): Promise<void>;
+    /** Query metric points with optional time range and limit. */
+    queryMetrics(agentId: string, key: string, opts?: MetricQueryOpts): Promise<MetricPoint[]>;
+    /** Alias for `saveAgent()`. Satisfies `PersistenceAdapter.save()`. */
+    save(agentId: string, snapshot: GatewaySnapshot): Promise<void>;
+    /** Alias for `loadAgent()`. Satisfies `PersistenceAdapter.load()`. */
+    load(agentId: string): Promise<GatewaySnapshot | null>;
+    /** Alias for `deleteAgent()`. Satisfies `PersistenceAdapter.delete()`. */
+    delete(agentId: string): Promise<void>;
+    /** Alias for `listAgents()`. Satisfies `PersistenceAdapter.keys()`. */
+    keys(): Promise<string[]>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * @module ai/persistence/types
+ * @description Core type definitions for the Synapse AI persistence layer.
+ *
+ * Defines the universal {@link PersistenceStore} interface and all associated
+ * data records, configuration objects, and client abstractions.
+ *
+ * The generic client interfaces ({@link RedisLike}, {@link PgLike}) use
+ * dependency-injection: you create the client with your preferred library
+ * (ioredis, node-redis, pg, @vercel/postgres, @neondatabase/serverless, …)
+ * and pass the instance to the adapter constructor.
+ *
+ * @since 1.2.2
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PersistenceError = void 0;
+/* ═══════════════════════════════════════════════════════════════
+ *  Error
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * @description Error thrown by any persistence store operation.
+ * @since 1.2.2
+ */
+class PersistenceError extends Error {
+    code;
+    cause;
+    constructor(message, 
+    /** Machine-readable error code (e.g. `'CONN_FAILED'`, `'QUERY_ERROR'`). */
+    code, 
+    /** The underlying error from the database driver, if any. */
+    cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = 'PersistenceError';
+    }
+}
+exports.PersistenceError = PersistenceError;
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/ai/persistence/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAIH;;qEAEqE;AAErE;;;GAGG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IAIvB;IAEA;IALlB,YACE,OAAe;IACf,2EAA2E;IAC3D,IAAY;IAC5B,6DAA6D;IAC7C,KAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAQ;QAEZ,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAXD,4CAWC"}

package/dist/cjs/core/client.d.ts

@@ -93,6 +93,22 @@ export declare class SynapseClient implements SynapseClientLike {
     private _kitRpc?;
     private _kitSubs?;
     constructor(config: SynapseClientConfig);
+    /**
+     * Returns the underlying HTTP transport.
+     *
+     * Use this when a function requires a bare `HttpTransport` (e.g.
+     * `createExecutableSolanaTools`, protocol tool factories) instead of
+     * casting with `(client as any)._transport`.
+     *
+     * @returns The {@link HttpTransport} instance used by this client.
+     * @since 1.2.2
+     *
+     * @example
+     * ```ts
+     * const tools = createExecutableSolanaTools(client.getTransport());
+     * ```
+     */
+    getTransport(): HttpTransport;
     /**
      * Create a SynapseClient from a network + region specification.
      * Resolves the endpoint from the built-in registry and configures

package/dist/cjs/core/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/core/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAIpF,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAGlG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG9D;;;;;GAKG;AACH,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;CACnC;AAED,qBAAa,aAAc,YAAW,iBAAiB;IACrD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAsB;IAG1C,OAAO,CAAC,IAAI,CAAC,CAAY;IACzB,OAAO,CAAC,IAAI,CAAC,CAAY;IACzB,OAAO,CAAC,GAAG,CAAC,CAAW;IACvB,OAAO,CAAC,KAAK,CAAC,CAAgB;IAC9B,OAAO,CAAC,SAAS,CAAC,CAAiB;IAGnC,OAAO,CAAC,OAAO,CAAC,CAAoB;IACpC,OAAO,CAAC,QAAQ,CAAC,CAA8C;gBAEnD,MAAM,EAAE,mBAAmB;IAUvC;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,qBAAqB,GAAG,aAAa;IAajE;;;;;;;;;OASG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,CAAC;IAI7F;;;;;;;;OAQG;IACH,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,EAAE,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAM5G;;;;OAIG;IACH,IAAI,GAAG,IAAI,SAAS,CAMnB;IAED;;;;OAIG;IACH,IAAI,GAAG,IAAI,SAAS,CAMnB;IAED;;;;OAIG;IACH,IAAI,EAAE,IAAI,QAAQ,CAMjB;IAED;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,aAAa,CAaxB;IAID;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,IAAI,QAAQ,IAAI,cAAc,CAM7B;IAED;;;OAGG;IACH,OAAO,IAAI,IAAI;IAMf;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,MAAM,IAAI,GAAG,CAAC,YAAY,CAAC,CAc9B;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,IAAI,gBAAgB,IAAI,gBAAgB,CAAC,yBAAyB,CAAC,CAkBlE;CACF"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/core/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAIpF,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAGlG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG9D;;;;;GAKG;AACH,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;CACnC;AAED,qBAAa,aAAc,YAAW,iBAAiB;IACrD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAsB;IAG1C,OAAO,CAAC,IAAI,CAAC,CAAY;IACzB,OAAO,CAAC,IAAI,CAAC,CAAY;IACzB,OAAO,CAAC,GAAG,CAAC,CAAW;IACvB,OAAO,CAAC,KAAK,CAAC,CAAgB;IAC9B,OAAO,CAAC,SAAS,CAAC,CAAiB;IAGnC,OAAO,CAAC,OAAO,CAAC,CAAoB;IACpC,OAAO,CAAC,QAAQ,CAAC,CAA8C;gBAEnD,MAAM,EAAE,mBAAmB;IAMvC;;;;;;;;;;;;;;OAcG;IACH,YAAY,IAAI,aAAa;IAQ7B;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,qBAAqB,GAAG,aAAa;IAajE;;;;;;;;;OASG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,CAAC;IAI7F;;;;;;;;OAQG;IACH,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,EAAE,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAM5G;;;;OAIG;IACH,IAAI,GAAG,IAAI,SAAS,CAMnB;IAED;;;;OAIG;IACH,IAAI,GAAG,IAAI,SAAS,CAMnB;IAED;;;;OAIG;IACH,IAAI,EAAE,IAAI,QAAQ,CAMjB;IAED;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,aAAa,CAaxB;IAID;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,IAAI,QAAQ,IAAI,cAAc,CAM7B;IAED;;;OAGG;IACH,OAAO,IAAI,IAAI;IAMf;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,MAAM,IAAI,GAAG,CAAC,YAAY,CAAC,CAc9B;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,IAAI,gBAAgB,IAAI,gBAAgB,CAAC,yBAAyB,CAAC,CAkBlE;CACF"}

package/dist/cjs/core/client.js

@@ -56,6 +56,24 @@ class SynapseClient {
         if (config.debug)
             console.log('[Synapse SDK] initialized:', config.endpoint, `(${(0, env_1.isBrowser)() ? 'browser' : 'server'})`);
     }
+    /**
+     * Returns the underlying HTTP transport.
+     *
+     * Use this when a function requires a bare `HttpTransport` (e.g.
+     * `createExecutableSolanaTools`, protocol tool factories) instead of
+     * casting with `(client as any)._transport`.
+     *
+     * @returns The {@link HttpTransport} instance used by this client.
+     * @since 1.2.2
+     *
+     * @example
+     * ```ts
+     * const tools = createExecutableSolanaTools(client.getTransport());
+     * ```
+     */
+    getTransport() {
+        return this.transport;
+    }
     /* ═══════════════════════════════════════════════════════════════
      *  Static factories
      * ═══════════════════════════════════════════════════════════════ */

package/dist/cjs/core/client.js.map

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

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

@@ -0,0 +1,141 @@
+/**
+ * @module next
+ * @description Synapse Client SDK — Next.js integration helpers.
+ *
+ * Drop-in utilities for using the Synapse SDK in Next.js 13+ (App Router)
+ * with zero boilerplate for the most common patterns:
+ *
+ * - **`synapseResponse()`** — wraps `NextResponse.json()` with BigInt serialization
+ * - **`withSynapseError()`** — API Route error boundary / handler wrapper
+ * - **`createSynapseProvider()`** — HMR-safe SynapseClient singleton factory
+ * - **`createGatewayProvider()`** — HMR-safe AgentGateway singleton factory
+ *
+ * All exports are framework-independent at the type level: they work with
+ * any object that has `json()` and `status` — so they can be tested outside
+ * of a Next.js environment.
+ *
+ * @example API Route (App Router)
+ * ```ts
+ * // app/api/balance/route.ts
+ * import { synapseResponse, withSynapseError, createSynapseProvider } from '@oobe-protocol-labs/synapse-client-sdk/next';
+ * import { Pubkey } from '@oobe-protocol-labs/synapse-client-sdk';
+ *
+ * const getClient = createSynapseProvider({ endpoint: process.env.SYNAPSE_RPC! });
+ *
+ * export const GET = withSynapseError(async (req) => {
+ *   const address = new URL(req.url).searchParams.get('address')!;
+ *   const balance = await getClient().rpc.getBalance(Pubkey(address));
+ *   return synapseResponse({ balance });
+ * });
+ * ```
+ *
+ * @since 1.2.2
+ */
+import { type SingletonOptions } from '../utils/helpers';
+import { SynapseClient, type SynapseClientConfig } from '../core/client';
+/**
+ * @description Options for {@link synapseResponse}.
+ * @since 1.2.2
+ */
+export interface SynapseResponseInit {
+    /** HTTP status code (default: 200). */
+    status?: number;
+    /** Extra headers to include. */
+    headers?: Record<string, string>;
+}
+/**
+ * @description Create a JSON `Response` with automatic BigInt serialization.
+ *
+ * Works with Next.js App Router, edge functions, or any Web-standard
+ * `Response` environment.
+ *
+ * @param data - Any value (may contain `BigInt`).
+ * @param init - Optional status code and headers.
+ * @returns A `Response` with `Content-Type: application/json`.
+ * @since 1.2.2
+ *
+ * @example
+ * ```ts
+ * return synapseResponse({ budget: 100_000n, status: 'ok' });
+ * // → Response { body: '{"budget":"100000","status":"ok"}', status: 200 }
+ * ```
+ */
+export declare function synapseResponse(data: unknown, init?: SynapseResponseInit): Response;
+/**
+ * @description Wrap a Next.js API Route handler with error handling.
+ *
+ * Catches thrown errors and returns a structured JSON error response
+ * with the appropriate status code. SDK errors include the error code.
+ *
+ * @param handler - Async handler function `(req) => Response`
+ * @returns Wrapped handler with the same signature
+ * @since 1.2.2
+ *
+ * @example
+ * ```ts
+ * export const GET = withSynapseError(async (req) => {
+ *   // If this throws, caller gets { error: '...', code: '...' } with 500
+ *   const data = await client.rpc.getBalance(Pubkey('...'));
+ *   return synapseResponse({ data });
+ * });
+ * ```
+ */
+export declare function withSynapseError<T extends Request = Request>(handler: (req: T, ...args: unknown[]) => Promise<Response>): (req: T, ...args: unknown[]) => Promise<Response>;
+/**
+ * @description Create an HMR-safe SynapseClient singleton for Next.js.
+ *
+ * Uses {@link createSingleton} under the hood to store the instance
+ * on `globalThis`, surviving hot-module reloads in development.
+ *
+ * @param config - SynapseClient configuration
+ * @param opts   - Optional singleton options (version for cache busting)
+ * @returns A zero-arg getter that returns the singleton client
+ * @since 1.2.2
+ *
+ * @example
+ * ```ts
+ * // lib/synapse.ts
+ * import { createSynapseProvider } from '@oobe-protocol-labs/synapse-client-sdk/next';
+ *
+ * export const getSynapseClient = createSynapseProvider({
+ *   endpoint: process.env.SYNAPSE_RPC!,
+ *   apiKey: process.env.SYNAPSE_API_KEY,
+ * });
+ *
+ * // Then in any route/server component:
+ * const client = getSynapseClient();
+ * ```
+ */
+export declare function createSynapseProvider(config: SynapseClientConfig, opts?: SingletonOptions): () => SynapseClient;
+/**
+ * @description Create an HMR-safe AgentGateway singleton for Next.js.
+ *
+ * Lazily imports `AgentGateway` to avoid pulling the full AI module
+ * into routes that don't need it.
+ *
+ * @param clientProvider - A getter that returns the SynapseClient (from {@link createSynapseProvider})
+ * @param configFactory  - Function returning the GatewayConfig (evaluated once)
+ * @param opts           - Optional singleton options
+ * @returns A zero-arg getter that returns the singleton gateway
+ * @since 1.2.2
+ *
+ * @example
+ * ```ts
+ * import { createSynapseProvider, createGatewayProvider } from '@oobe-protocol-labs/synapse-client-sdk/next';
+ * import { AgentId, DEFAULT_TIERS } from '@oobe-protocol-labs/synapse-client-sdk/ai';
+ *
+ * const getClient = createSynapseProvider({ endpoint: process.env.SYNAPSE_RPC! });
+ *
+ * export const getGateway = createGatewayProvider(getClient, () => ({
+ *   identity: {
+ *     id: AgentId('did:synapse:agent:my-agent'),
+ *     name: 'My Agent',
+ *     walletPubkey: process.env.AGENT_WALLET!,
+ *     createdAt: Date.now(),
+ *   },
+ *   defaultTiers: DEFAULT_TIERS,
+ * }));
+ * ```
+ */
+export declare function createGatewayProvider(clientProvider: () => SynapseClient, configFactory: () => import('../ai/gateway/types').GatewayConfig, opts?: SingletonOptions): () => import('../ai/gateway/index').AgentGateway;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/next/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAMzE;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,EACb,IAAI,GAAE,mBAAwB,GAC7B,QAAQ,CAUV;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAC1D,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,GACzD,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAenD;AAMD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,mBAAmB,EAC3B,IAAI,CAAC,EAAE,gBAAgB,GACtB,MAAM,aAAa,CAMrB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,MAAM,aAAa,EACnC,aAAa,EAAE,MAAM,OAAO,qBAAqB,EAAE,aAAa,EAChE,IAAI,CAAC,EAAE,gBAAgB,GACtB,MAAM,OAAO,qBAAqB,EAAE,YAAY,CAUlD"}