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

package/dist/cjs/ai/gateway/registry.d.ts

@@ -0,0 +1,223 @@
+/**
+ * @module ai/gateway/registry
+ * @description AgentRegistry — Multi-agent lifecycle management.
+ *
+ * Provides a centralised registry for creating, discovering, and managing
+ * multiple {@link AgentGateway} instances.  Ideal for platforms that host
+ * many agents (e.g. marketplace back-ends, orchestrators, multi-tenant SaaS).
+ *
+ * Includes:
+ * - `create()` / `get()` / `remove()` / `clear()`  — CRUD
+ * - `list()` / `filter()`                           — discovery
+ * - `searchMarketplace()`                           — cross-agent tool search
+ * - `getAggregateMetrics()`                         — rolled-up stats
+ * - Pluggable persistence via `PersistenceAdapter`  (memory adapter built-in)
+ *
+ * @since 1.2.2
+ *
+ * @example
+ * ```ts
+ * import { AgentRegistry, AgentGateway } from '@oobe-protocol-labs/synapse-client-sdk/ai';
+ *
+ * const registry = new AgentRegistry();
+ *
+ * const gateway = registry.create(client, {
+ *   identity: { id: AgentId('agent-1'), name: 'Alice', walletPubkey: '...', createdAt: Date.now() },
+ *   defaultTiers: DEFAULT_TIERS,
+ * });
+ *
+ * const all = registry.list();
+ * const defi = registry.filter(g => g.identity.tags?.includes('defi'));
+ * ```
+ */
+import type { SynapseClientLike } from '../../core/client';
+import type { AgentId, GatewayConfig } from './types';
+import { AgentGateway } from './index';
+import type { GatewaySnapshot, SnapshotDepth } from './types';
+import type { MarketplaceQuery } from './marketplace';
+/**
+ * @description Pluggable persistence layer for the registry.
+ * Implement this interface to back the registry with Redis, SQLite, etc.
+ * @since 1.2.2
+ */
+export interface PersistenceAdapter {
+    /** Save a snapshot keyed by agent ID. */
+    save(agentId: string, snapshot: GatewaySnapshot): void | Promise<void>;
+    /** Load a snapshot by agent ID (returns `null` if not found). */
+    load(agentId: string): GatewaySnapshot | null | Promise<GatewaySnapshot | null>;
+    /** Delete a snapshot by agent ID. */
+    delete(agentId: string): void | Promise<void>;
+    /** List all stored agent IDs. */
+    keys(): string[] | Promise<string[]>;
+}
+/**
+ * @description Default in-memory persistence adapter.
+ * @since 1.2.2
+ */
+export declare class MemoryAdapter implements PersistenceAdapter {
+    private readonly store;
+    save(agentId: string, snapshot: GatewaySnapshot): void;
+    load(agentId: string): GatewaySnapshot | null;
+    delete(agentId: string): void;
+    keys(): string[];
+}
+/**
+ * @description Configuration for {@link AgentRegistry}.
+ * @since 1.2.2
+ */
+export interface AgentRegistryConfig {
+    /** Maximum number of agents allowed in the registry (default: unlimited). */
+    maxAgents?: number;
+    /** Optional persistence adapter (default: in-memory). */
+    persistence?: PersistenceAdapter;
+    /** Gateway config template — merged with per-agent overrides in `create()`. */
+    defaultConfig?: Partial<GatewayConfig>;
+}
+/**
+ * @description Multi-agent lifecycle manager.
+ *
+ * Manages a collection of {@link AgentGateway} instances with CRUD
+ * operations, discovery, aggregate metrics, and optional persistence.
+ *
+ * @since 1.2.2
+ */
+export declare class AgentRegistry {
+    private readonly agents;
+    private readonly config;
+    private readonly persistence;
+    /**
+     * @param {AgentRegistryConfig} [config] - Optional registry configuration.
+     */
+    constructor(config?: AgentRegistryConfig);
+    /**
+     * @description Create and register a new agent gateway.
+     *
+     * @param {SynapseClientLike} client - Synapse client (or client-like transport wrapper)
+     * @param {GatewayConfig} config - Gateway configuration (merged with `defaultConfig`)
+     * @returns {AgentGateway} The newly created and registered gateway
+     * @throws {Error} If an agent with the same ID already exists or the max limit is reached
+     * @since 1.2.2
+     */
+    create(client: SynapseClientLike, config: GatewayConfig): AgentGateway;
+    /**
+     * @description Register an existing gateway in the registry.
+     *
+     * @param {AgentGateway} gateway - An already-constructed gateway
+     * @throws {Error} If an agent with the same ID already exists
+     * @since 1.2.2
+     */
+    register(gateway: AgentGateway): void;
+    /**
+     * @description Get a gateway by agent ID.
+     * @param {AgentId | string} agentId - The agent ID
+     * @returns {AgentGateway | undefined} The gateway or undefined
+     * @since 1.2.2
+     */
+    get(agentId: AgentId | string): AgentGateway | undefined;
+    /**
+     * @description Remove an agent from the registry.
+     * @param {AgentId | string} agentId - The agent ID to remove
+     * @returns {boolean} `true` if the agent was found and removed
+     * @since 1.2.2
+     */
+    remove(agentId: AgentId | string): boolean;
+    /**
+     * @description Remove all agents from the registry.
+     * @since 1.2.2
+     */
+    clear(): void;
+    /**
+     * @description Check if an agent exists in the registry.
+     * @param {AgentId | string} agentId - The agent ID to check
+     * @returns {boolean} `true` if registered
+     * @since 1.2.2
+     */
+    has(agentId: AgentId | string): boolean;
+    /**
+     * @description Get the number of registered agents.
+     * @since 1.2.2
+     */
+    get size(): number;
+    /**
+     * @description List all registered gateways.
+     * @returns {AgentGateway[]} Array of all gateways
+     * @since 1.2.2
+     */
+    list(): AgentGateway[];
+    /**
+     * @description Filter gateways by a predicate.
+     *
+     * @param {(gateway: AgentGateway) => boolean} predicate - Filter function
+     * @returns {AgentGateway[]} Matching gateways
+     * @since 1.2.2
+     *
+     * @example
+     * ```ts
+     * const defiAgents = registry.filter(g => g.identity.tags?.includes('defi'));
+     * ```
+     */
+    filter(predicate: (gateway: AgentGateway) => boolean): AgentGateway[];
+    /**
+     * @description Search tool listings across all registered gateways.
+     *
+     * @param {MarketplaceQuery} query - Marketplace search query
+     * @returns {{ agent: AgentGateway; listings: import('./marketplace').ToolListing[] }[]}
+     * @since 1.2.2
+     */
+    searchMarketplace(query: MarketplaceQuery): {
+        agent: AgentGateway;
+        listings: ReturnType<AgentGateway['marketplace']['search']>;
+    }[];
+    /**
+     * @description Get aggregate metrics across all registered agents.
+     *
+     * @returns {object} Rolled-up metrics
+     * @since 1.2.2
+     */
+    getAggregateMetrics(): {
+        totalAgents: number;
+        totalCallsServed: number;
+        totalRevenue: string;
+        totalActiveSessions: number;
+        totalSessions: number;
+        avgLatencyMs: number;
+    };
+    /**
+     * @description Snapshot all agents in the registry.
+     *
+     * @param {{ depth?: SnapshotDepth }} [opts] - Snapshot options
+     * @returns {GatewaySnapshot[]} Array of JSON-safe snapshots
+     * @since 1.2.2
+     */
+    snapshot(opts?: {
+        depth?: SnapshotDepth;
+    }): GatewaySnapshot[];
+    /**
+     * Enables `JSON.stringify(registry)`.
+     * @since 1.2.2
+     */
+    toJSON(): GatewaySnapshot[];
+    /**
+     * @description Persist all current agent snapshots via the configured adapter.
+     * @since 1.2.2
+     */
+    persist(): Promise<void>;
+    /**
+     * @description Load a snapshot from the persistence layer.
+     * @param {string} agentId - The agent ID to load
+     * @returns {Promise<GatewaySnapshot | null>} The stored snapshot or null
+     * @since 1.2.2
+     */
+    loadSnapshot(agentId: string): Promise<GatewaySnapshot | null>;
+    /**
+     * @description Iterate over all registered gateways.
+     * @since 1.2.2
+     */
+    [Symbol.iterator](): IterableIterator<AgentGateway>;
+    /**
+     * @description Iterate over `[agentId, gateway]` pairs.
+     * @since 1.2.2
+     */
+    entries(): IterableIterator<[string, AgentGateway]>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/cjs/ai/gateway/registry.d.ts.map

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

package/dist/cjs/ai/gateway/registry.js

@@ -0,0 +1,290 @@
+"use strict";
+/**
+ * @module ai/gateway/registry
+ * @description AgentRegistry — Multi-agent lifecycle management.
+ *
+ * Provides a centralised registry for creating, discovering, and managing
+ * multiple {@link AgentGateway} instances.  Ideal for platforms that host
+ * many agents (e.g. marketplace back-ends, orchestrators, multi-tenant SaaS).
+ *
+ * Includes:
+ * - `create()` / `get()` / `remove()` / `clear()`  — CRUD
+ * - `list()` / `filter()`                           — discovery
+ * - `searchMarketplace()`                           — cross-agent tool search
+ * - `getAggregateMetrics()`                         — rolled-up stats
+ * - Pluggable persistence via `PersistenceAdapter`  (memory adapter built-in)
+ *
+ * @since 1.2.2
+ *
+ * @example
+ * ```ts
+ * import { AgentRegistry, AgentGateway } from '@oobe-protocol-labs/synapse-client-sdk/ai';
+ *
+ * const registry = new AgentRegistry();
+ *
+ * const gateway = registry.create(client, {
+ *   identity: { id: AgentId('agent-1'), name: 'Alice', walletPubkey: '...', createdAt: Date.now() },
+ *   defaultTiers: DEFAULT_TIERS,
+ * });
+ *
+ * const all = registry.list();
+ * const defi = registry.filter(g => g.identity.tags?.includes('defi'));
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentRegistry = exports.MemoryAdapter = void 0;
+const index_1 = require("./index");
+/**
+ * @description Default in-memory persistence adapter.
+ * @since 1.2.2
+ */
+class MemoryAdapter {
+    store = new Map();
+    save(agentId, snapshot) {
+        this.store.set(agentId, snapshot);
+    }
+    load(agentId) {
+        return this.store.get(agentId) ?? null;
+    }
+    delete(agentId) {
+        this.store.delete(agentId);
+    }
+    keys() {
+        return [...this.store.keys()];
+    }
+}
+exports.MemoryAdapter = MemoryAdapter;
+/* ═══════════════════════════════════════════════════════════════
+ *  AgentRegistry
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * @description Multi-agent lifecycle manager.
+ *
+ * Manages a collection of {@link AgentGateway} instances with CRUD
+ * operations, discovery, aggregate metrics, and optional persistence.
+ *
+ * @since 1.2.2
+ */
+class AgentRegistry {
+    agents = new Map();
+    config;
+    persistence;
+    /**
+     * @param {AgentRegistryConfig} [config] - Optional registry configuration.
+     */
+    constructor(config = {}) {
+        this.config = config;
+        this.persistence = config.persistence ?? new MemoryAdapter();
+    }
+    /* ── CRUD ──────────────────────────────────────────────── */
+    /**
+     * @description Create and register a new agent gateway.
+     *
+     * @param {SynapseClientLike} client - Synapse client (or client-like transport wrapper)
+     * @param {GatewayConfig} config - Gateway configuration (merged with `defaultConfig`)
+     * @returns {AgentGateway} The newly created and registered gateway
+     * @throws {Error} If an agent with the same ID already exists or the max limit is reached
+     * @since 1.2.2
+     */
+    create(client, config) {
+        const merged = { ...this.config.defaultConfig, ...config };
+        const gateway = new index_1.AgentGateway(client, merged);
+        const id = gateway.agentId;
+        if (this.agents.has(id)) {
+            throw new Error(`Agent '${id}' already exists in the registry`);
+        }
+        if (this.config.maxAgents != null && this.agents.size >= this.config.maxAgents) {
+            throw new Error(`Registry limit reached (max ${this.config.maxAgents} agents)`);
+        }
+        this.agents.set(id, gateway);
+        return gateway;
+    }
+    /**
+     * @description Register an existing gateway in the registry.
+     *
+     * @param {AgentGateway} gateway - An already-constructed gateway
+     * @throws {Error} If an agent with the same ID already exists
+     * @since 1.2.2
+     */
+    register(gateway) {
+        const id = gateway.agentId;
+        if (this.agents.has(id)) {
+            throw new Error(`Agent '${id}' already exists in the registry`);
+        }
+        if (this.config.maxAgents != null && this.agents.size >= this.config.maxAgents) {
+            throw new Error(`Registry limit reached (max ${this.config.maxAgents} agents)`);
+        }
+        this.agents.set(id, gateway);
+    }
+    /**
+     * @description Get a gateway by agent ID.
+     * @param {AgentId | string} agentId - The agent ID
+     * @returns {AgentGateway | undefined} The gateway or undefined
+     * @since 1.2.2
+     */
+    get(agentId) {
+        return this.agents.get(agentId);
+    }
+    /**
+     * @description Remove an agent from the registry.
+     * @param {AgentId | string} agentId - The agent ID to remove
+     * @returns {boolean} `true` if the agent was found and removed
+     * @since 1.2.2
+     */
+    remove(agentId) {
+        return this.agents.delete(agentId);
+    }
+    /**
+     * @description Remove all agents from the registry.
+     * @since 1.2.2
+     */
+    clear() {
+        this.agents.clear();
+    }
+    /**
+     * @description Check if an agent exists in the registry.
+     * @param {AgentId | string} agentId - The agent ID to check
+     * @returns {boolean} `true` if registered
+     * @since 1.2.2
+     */
+    has(agentId) {
+        return this.agents.has(agentId);
+    }
+    /**
+     * @description Get the number of registered agents.
+     * @since 1.2.2
+     */
+    get size() {
+        return this.agents.size;
+    }
+    /* ── Discovery ─────────────────────────────────────────── */
+    /**
+     * @description List all registered gateways.
+     * @returns {AgentGateway[]} Array of all gateways
+     * @since 1.2.2
+     */
+    list() {
+        return [...this.agents.values()];
+    }
+    /**
+     * @description Filter gateways by a predicate.
+     *
+     * @param {(gateway: AgentGateway) => boolean} predicate - Filter function
+     * @returns {AgentGateway[]} Matching gateways
+     * @since 1.2.2
+     *
+     * @example
+     * ```ts
+     * const defiAgents = registry.filter(g => g.identity.tags?.includes('defi'));
+     * ```
+     */
+    filter(predicate) {
+        return [...this.agents.values()].filter(predicate);
+    }
+    /**
+     * @description Search tool listings across all registered gateways.
+     *
+     * @param {MarketplaceQuery} query - Marketplace search query
+     * @returns {{ agent: AgentGateway; listings: import('./marketplace').ToolListing[] }[]}
+     * @since 1.2.2
+     */
+    searchMarketplace(query) {
+        const results = [];
+        for (const gateway of this.agents.values()) {
+            const listings = gateway.marketplace.search(query);
+            if (listings.length > 0) {
+                results.push({ agent: gateway, listings });
+            }
+        }
+        return results;
+    }
+    /* ── Metrics ───────────────────────────────────────────── */
+    /**
+     * @description Get aggregate metrics across all registered agents.
+     *
+     * @returns {object} Rolled-up metrics
+     * @since 1.2.2
+     */
+    getAggregateMetrics() {
+        let totalCalls = 0;
+        let totalRevenue = 0n;
+        let totalActiveSessions = 0;
+        let totalSessions = 0;
+        let latencySum = 0;
+        let latencyCount = 0;
+        for (const gateway of this.agents.values()) {
+            const m = gateway.getMetrics();
+            totalCalls += m.totalCallsServed;
+            totalRevenue += BigInt(m.totalRevenue);
+            totalActiveSessions += m.activeSessions;
+            totalSessions += m.totalSessions;
+            if (m.avgLatencyMs > 0) {
+                latencySum += m.avgLatencyMs;
+                latencyCount++;
+            }
+        }
+        return {
+            totalAgents: this.agents.size,
+            totalCallsServed: totalCalls,
+            totalRevenue: totalRevenue.toString(),
+            totalActiveSessions,
+            totalSessions,
+            avgLatencyMs: latencyCount > 0 ? Math.round(latencySum / latencyCount) : 0,
+        };
+    }
+    /* ── Snapshot & serialization ──────────────────────────── */
+    /**
+     * @description Snapshot all agents in the registry.
+     *
+     * @param {{ depth?: SnapshotDepth }} [opts] - Snapshot options
+     * @returns {GatewaySnapshot[]} Array of JSON-safe snapshots
+     * @since 1.2.2
+     */
+    snapshot(opts = {}) {
+        return [...this.agents.values()].map(g => g.snapshot(opts));
+    }
+    /**
+     * Enables `JSON.stringify(registry)`.
+     * @since 1.2.2
+     */
+    toJSON() {
+        return this.snapshot({ depth: 'standard' });
+    }
+    /* ── Persistence helpers ───────────────────────────────── */
+    /**
+     * @description Persist all current agent snapshots via the configured adapter.
+     * @since 1.2.2
+     */
+    async persist() {
+        for (const gateway of this.agents.values()) {
+            const snap = gateway.snapshot({ depth: 'full' });
+            await this.persistence.save(snap.agentId, snap);
+        }
+    }
+    /**
+     * @description Load a snapshot from the persistence layer.
+     * @param {string} agentId - The agent ID to load
+     * @returns {Promise<GatewaySnapshot | null>} The stored snapshot or null
+     * @since 1.2.2
+     */
+    async loadSnapshot(agentId) {
+        return this.persistence.load(agentId);
+    }
+    /* ── Iteration ─────────────────────────────────────────── */
+    /**
+     * @description Iterate over all registered gateways.
+     * @since 1.2.2
+     */
+    [Symbol.iterator]() {
+        return this.agents.values();
+    }
+    /**
+     * @description Iterate over `[agentId, gateway]` pairs.
+     * @since 1.2.2
+     */
+    entries() {
+        return this.agents.entries();
+    }
+}
+exports.AgentRegistry = AgentRegistry;
+//# sourceMappingURL=registry.js.map

package/dist/cjs/ai/gateway/registry.js.map

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

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

@@ -267,7 +267,7 @@ export interface ToolBundle {
  * @description Union type of all observable gateway event types.
  * @since 1.0.0
  */
-export type GatewayEventType = 'session:created' | 'session:activated' | 'session:paused' | 'session:exhausted' | 'session:settled' | 'session:expired' | 'call:before' | 'call:after' | 'call:error' | 'call:attested' | 'payment:intent' | 'payment:settled' | 'ratelimit:exceeded' | 'budget:warning' | 'budget:exhausted' | 'x402:payment-required' | 'x402:payment-verified' | 'x402:payment-settled' | 'x402:payment-sent';
+export type GatewayEventType = 'session:created' | 'session:activated' | 'session:paused' | 'session:exhausted' | 'session:settled' | 'session:expired' | 'call:before' | 'call:after' | 'call:error' | 'call:attested' | 'call:retry' | 'payment:intent' | 'payment:settled' | 'ratelimit:exceeded' | 'budget:warning' | 'budget:exhausted' | 'x402:payment-required' | 'x402:payment-verified' | 'x402:payment-settled' | 'x402:payment-sent' | 'x402:pipeline:paywall' | 'x402:pipeline:verify' | 'x402:pipeline:execute' | 'x402:pipeline:settle' | 'x402:pipeline:complete' | 'x402:pipeline:error';
 /**
  * @description Event object emitted by the gateway event bus.
  * @template T The type of the event data payload
@@ -287,6 +287,106 @@ export interface GatewayEvent<T = unknown> {
 export type GatewayEventHandler<T = unknown> = (event: GatewayEvent<T>) => void | Promise<void>;
 import type { X402Config } from './x402/types';
 import type { X402ClientConfig } from './x402/client';
+/**
+ * @description Retry configuration for `gateway.execute()`.
+ * @since 1.2.2
+ */
+export interface RetryConfig {
+    /** Maximum number of attempts (including the first call). Default: 1 (no retry). */
+    maxAttempts?: number;
+    /** Base delay in ms before retrying. Doubles each attempt (exponential backoff). Default: 500. */
+    backoffMs?: number;
+    /** Multiplier applied to backoffMs on each retry. Default: 2. */
+    backoffMultiplier?: number;
+    /**
+     * Error messages or substrings that are considered transient and retryable.
+     * Default: `['fetch failed', 'ECONNRESET', 'ETIMEDOUT', 'ENOTFOUND', 'socket hang up']`.
+     */
+    retryableErrors?: string[];
+    /**
+     * If `true`, falls back to a raw `client.call()` on the last retry attempt.
+     * Useful when the gateway transport is behind a proxy that may be down.
+     * Default: `false`.
+     */
+    fallbackToDirectRpc?: boolean;
+}
+/**
+ * @description Depth option for {@link AgentGateway.snapshot}.
+ * @since 1.2.2
+ */
+export type SnapshotDepth = 'minimal' | 'standard' | 'full';
+/**
+ * @description JSON-safe snapshot of an AgentGateway's state.
+ * All BigInt values are serialized as strings.
+ * @since 1.2.2
+ */
+export interface GatewaySnapshot {
+    agentId: string;
+    identity: {
+        name: string;
+        walletPubkey: string;
+        description?: string;
+        tags?: string[];
+        createdAt: number;
+    };
+    metrics: {
+        totalCallsServed: number;
+        totalRevenue: string;
+        activeSessions: number;
+        totalSessions: number;
+        avgLatencyMs: number;
+        totalAttestations: number;
+    };
+    sessions: {
+        id: string;
+        status: string;
+        buyer: string;
+        budgetRemaining?: string;
+        callsMade?: number;
+        createdAt?: number;
+    }[];
+    tiers: {
+        id: string;
+        label: string;
+        pricePerCall: string;
+        maxCallsPerSession: number;
+        rateLimit: number;
+        includesAttestation: boolean;
+    }[];
+    marketplace: {
+        totalListings: number;
+        totalBundles: number;
+    };
+    x402: {
+        paywallEnabled: boolean;
+        clientEnabled: boolean;
+        clientPayments: number;
+    };
+}
+/**
+ * @description Step data emitted during the x402 pipeline.
+ * @since 1.2.2
+ */
+export interface X402PipelineStep {
+    /** Sequential step number (1-based). */
+    id: number;
+    /** Total number of steps in the pipeline. */
+    totalSteps: number;
+    /** Which actor performed this step. */
+    actor: 'seller' | 'buyer' | 'facilitator';
+    /** Short action label. */
+    action: string;
+    /** Human-readable description. */
+    detail: string;
+    /** Arbitrary step-specific data. */
+    data: Record<string, unknown>;
+    /** How long this step took in milliseconds. */
+    durationMs: number;
+    /** Whether the step was a real execution or simulated. */
+    status: 'real' | 'simulated';
+    /** Error that occurred during the step, if any. */
+    error?: string;
+}
 /**
  * @description Full configuration for an AgentGateway instance.
  * @since 1.0.0
@@ -320,5 +420,11 @@ export interface GatewayConfig {
      * x402-enabled servers.
      */
     x402Client?: X402ClientConfig;
+    /**
+     * Retry configuration for `execute()` and `executeWithX402()`.
+     * When set, transient RPC errors are retried with exponential backoff.
+     * @since 1.2.2
+     */
+    retry?: RetryConfig;
 }
 //# sourceMappingURL=types.d.ts.map