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

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

@@ -0,0 +1,237 @@
+/**
+ * @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 { PersistenceError } from './types.js';
+import { serialize, deserialize, buildKey } from './helpers.js';
+/**
+ * @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 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 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 buildKey(this.prefix, 'kv', key);
+    }
+    async get(key) {
+        const raw = await this.client.get(this.kvKey(key));
+        return raw ? deserialize(raw) : null;
+    }
+    async set(key, value, opts) {
+        const k = this.kvKey(key);
+        await this.client.set(k, 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 buildKey(this.prefix, 'agent', agentId);
+    }
+    async saveAgent(snapshot) {
+        const k = this.agentKey(snapshot.agentId);
+        await this.client.set(k, 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 ? deserialize(raw) : null;
+    }
+    async deleteAgent(agentId) {
+        const n = await this.client.del(this.agentKey(agentId));
+        return n > 0;
+    }
+    async listAgents() {
+        const pattern = buildKey(this.prefix, 'agent', '*');
+        const keys = await this.client.keys(pattern);
+        const prefixLen = buildKey(this.prefix, 'agent', '').length;
+        return keys.map(k => k.slice(prefixLen));
+    }
+    /* ── Sessions ──────────────────────────────────────────── */
+    sessionKey(agentId, sessionId) {
+        return buildKey(this.prefix, 'session', agentId, sessionId);
+    }
+    async saveSession(record) {
+        const k = this.sessionKey(record.agentId, record.id);
+        await this.client.set(k, 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 ? deserialize(raw) : null;
+    }
+    async deleteSessions(agentId) {
+        const pattern = 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 = 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 = 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 buildKey(this.prefix, 'receipts', agentId);
+    }
+    async saveReceipt(record) {
+        const k = this.receiptsKey(record.agentId);
+        const raw = await this.client.get(k);
+        const list = raw ? deserialize(raw) : [];
+        list.push(record);
+        await this.client.set(k, serialize(list));
+    }
+    async listReceipts(agentId, opts = {}) {
+        const raw = await this.client.get(this.receiptsKey(agentId));
+        if (!raw)
+            return [];
+        const list = 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 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 ? 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, serialize(list));
+    }
+    async queryMetrics(agentId, key, opts = {}) {
+        const raw = await this.client.get(this.metricsKey(agentId, key));
+        if (!raw)
+            return [];
+        let points = 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();
+    }
+}
+//# sourceMappingURL=redis.js.map

package/dist/esm/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/esm/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/esm/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/esm/ai/persistence/types.js

@@ -0,0 +1,36 @@
+/**
+ * @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
+ */
+/* ═══════════════════════════════════════════════════════════════
+ *  Error
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * @description Error thrown by any persistence store operation.
+ * @since 1.2.2
+ */
+export 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';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/esm/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,MAAM,OAAO,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"}

package/dist/esm/ai/tools/protocols/metaplex/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../../../src/ai/tools/protocols/metaplex/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC7B,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAuIjE;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,uBAAuB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,iBAAiB,EACzB,IAAI,GAAE,mBAAwB,GAC7B,eAAe,CAOjB;AAED,2CAA2C;AAC3C,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../../../src/ai/tools/protocols/metaplex/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC7B,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AA+HjE;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,uBAAuB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,iBAAiB,EACzB,IAAI,GAAE,mBAAwB,GAC7B,eAAe,CAOjB;AAED,2CAA2C;AAC3C,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}

package/dist/esm/ai/tools/protocols/metaplex/tools.js

@@ -47,19 +47,13 @@ function createMetaplexExecutor(transport) {
         if (!rpcMethod) {
             throw new Error(`Unknown Metaplex DAS method: ${method.name}`);
         }
-        // Strip the commitment field — DAS methods embed it in the params object
+        // Strip the commitment field — DAS methods embed it in the named params
         const { commitment, ...params } = input;
-        // DAS methods expect a single params array element
+        // DAS API uses JSON-RPC 2.0 named parameters (object), NOT positional (array).
+        // This matches the Metaplex Read API / DAS specification.
         const rpcParams = commitment
-            ? [{ ...params, commitment }]
-            : [params];
-        // For single-ID methods, unwrap to match the DAS API signature
-        if (method.name === 'getAsset' || method.name === 'getAssetProof') {
-            return transport.request(rpcMethod, [{ id: params.id, ...(commitment ? { commitment } : {}) }]);
-        }
-        if (method.name === 'getAssets' || method.name === 'getAssetProofs') {
-            return transport.request(rpcMethod, [{ ids: params.ids, ...(commitment ? { commitment } : {}) }]);
-        }
+            ? { ...params, commitment }
+            : { ...params };
         return transport.request(rpcMethod, rpcParams);
     };
 }
@@ -76,14 +70,14 @@ async function executeResolveCollection(transport, input) {
     const commitmentParam = commitment ? { commitment } : {};
     // Fetch collection asset + sample items in parallel
     const [collection, page] = await Promise.all([
-        transport.request('getAsset', [{ id: collectionAddress, ...commitmentParam }]),
-        transport.request('getAssetsByGroup', [{
-                groupKey: 'collection',
-                groupValue: collectionAddress,
-                limit: sampleSize,
-                page: 1,
-                ...commitmentParam,
-            }]),
+        transport.request('getAsset', { id: collectionAddress, ...commitmentParam }),
+        transport.request('getAssetsByGroup', {
+            groupKey: 'collection',
+            groupValue: collectionAddress,
+            limit: sampleSize,
+            page: 1,
+            ...commitmentParam,
+        }),
     ]);
     // Compute stats from the sample
     const items = page?.items ?? [];

package/dist/esm/ai/tools/protocols/metaplex/tools.js.map

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