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

package/dist/esm/ai/sap/adapter.d.ts

@@ -1,140 +0,0 @@
-/**
- * @module ai/sap/adapter
- * @description SAP — On-chain persistence adapter for {@link AgentRegistry}.
- *
- * Implements the {@link PersistenceAdapter} interface using SAP on-chain
- * data, enabling the `AgentRegistry` to persist and discover agents
- * directly on the Solana blockchain.
- *
- * @example
- * ```ts
- * import { AgentRegistry, OnChainPersistenceAdapter } from '@oobe-protocol-labs/synapse-client-sdk/ai';
- *
- * const adapter = new OnChainPersistenceAdapter(client, { programId: 'SAPAgnt1...' });
- * const registry = new AgentRegistry({ adapter });
- *
- * // Agents registered via the registry are now backed by on-chain data
- * ```
- *
- * @since 1.3.0
- */
-import type { SAPConfig } from './types';
-import { SAPDiscovery } from './discovery';
-/**
- * @description Persistence adapter interface (matches gateway/registry).
- * @since 1.3.0
- */
-interface PersistenceAdapterLike {
-    save(id: string, data: unknown): Promise<void>;
-    load(id: string): Promise<unknown | null>;
-    loadAll(): Promise<Array<{
-        id: string;
-        data: unknown;
-    }>>;
-    remove(id: string): Promise<void>;
-}
-/**
- * @description Minimal RPC client interface.
- * @since 1.3.0
- */
-interface RpcClient {
-    transport: {
-        request<T = unknown>(method: string, params: unknown[]): Promise<T>;
-    };
-}
-/**
- * @description Persistence adapter backed by SAP on-chain data.
- *
- * **Read operations** (`load`, `loadAll`) query the blockchain via
- * {@link SAPDiscovery}. **Write operations** (`save`, `remove`) are
- * cached locally — the actual on-chain write must be done by the user
- * via {@link SAPInstructionBuilder} + transaction signing.
- *
- * This design separates read (automatic) from write (user-driven)
- * because on-chain writes require a signature from the agent's wallet.
- *
- * @implements {PersistenceAdapterLike}
- * @since 1.3.0
- */
-export declare class OnChainPersistenceAdapter implements PersistenceAdapterLike {
-    private readonly discovery;
-    private readonly pendingWrites;
-    private readonly removed;
-    /**
-     * @param {RpcClient} client - Client providing RPC transport
-     * @param {Partial<SAPConfig>} [config] - SAP configuration
-     */
-    constructor(client: RpcClient, config?: Partial<SAPConfig>);
-    /**
-     * @description Get the underlying discovery instance for direct queries.
-     * @returns {SAPDiscovery} Discovery engine
-     * @since 1.3.0
-     */
-    getDiscovery(): SAPDiscovery;
-    /**
-     * @description Stage agent data for persistence.
-     *
-     * This caches the data locally. To actually write on-chain, build and
-     * send a transaction using {@link SAPInstructionBuilder}.
-     *
-     * @param {string} id - Agent wallet pubkey or DID
-     * @param {unknown} data - Agent data to persist
-     * @returns {Promise<void>}
-     * @since 1.3.0
-     */
-    save(id: string, data: unknown): Promise<void>;
-    /**
-     * @description Load agent data from on-chain PDA.
-     *
-     * First checks pending writes (local cache), then queries the blockchain.
-     *
-     * @param {string} id - Agent wallet pubkey
-     * @returns {Promise<AgentPDAAccount | unknown | null>} Agent data or null
-     * @since 1.3.0
-     */
-    load(id: string): Promise<unknown | null>;
-    /**
-     * @description Load all agents from the blockchain.
-     *
-     * Merges on-chain data with pending local writes, excluding removed entries.
-     *
-     * @returns {Promise<Array<{ id: string; data: unknown }>>} All agent records
-     * @since 1.3.0
-     */
-    loadAll(): Promise<Array<{
-        id: string;
-        data: unknown;
-    }>>;
-    /**
-     * @description Mark an agent for removal (locally cached).
-     *
-     * On-chain removal requires sending a `deactivate` instruction
-     * via {@link SAPInstructionBuilder}.
-     *
-     * @param {string} id - Agent wallet pubkey
-     * @returns {Promise<void>}
-     * @since 1.3.0
-     */
-    remove(id: string): Promise<void>;
-    /**
-     * @description Get pending writes that need to be committed on-chain.
-     * @returns {Map<string, unknown>} Map of agent ID → staged data
-     * @since 1.3.0
-     */
-    getPendingWrites(): ReadonlyMap<string, unknown>;
-    /**
-     * @description Get IDs of agents marked for removal.
-     * @returns {ReadonlySet<string>} Set of removed agent IDs
-     * @since 1.3.0
-     */
-    getRemovedIds(): ReadonlySet<string>;
-    /**
-     * @description Clear all pending local writes and removals.
-     * Call after successfully committing transactions on-chain.
-     * @returns {void}
-     * @since 1.3.0
-     */
-    clearPending(): void;
-}
-export {};
-//# sourceMappingURL=adapter.d.ts.map

package/dist/esm/ai/sap/adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/ai/sap/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,SAAS,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAS3C;;;GAGG;AACH,UAAU,sBAAsB;IAC9B,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC1C,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CAAC;IACzD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,UAAU,SAAS;IACjB,SAAS,EAAE;QACT,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;KACrE,CAAC;CACH;AAMD;;;;;;;;;;;;;GAaG;AACH,qBAAa,yBAA0B,YAAW,sBAAsB;IACtE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmC;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAElD;;;OAGG;gBACS,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC;IAQ1D;;;;OAIG;IACH,YAAY,IAAI,YAAY;IAI5B;;;;;;;;;;OAUG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD;;;;;;;;OAQG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAa/C;;;;;;;OAOG;IACG,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IA+B9D;;;;;;;;;OASG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvC;;;;OAIG;IACH,gBAAgB,IAAI,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC;IAIhD;;;;OAIG;IACH,aAAa,IAAI,WAAW,CAAC,MAAM,CAAC;IAIpC;;;;;OAKG;IACH,YAAY,IAAI,IAAI;CAIrB"}

package/dist/esm/ai/sap/adapter.js

@@ -1,177 +0,0 @@
-/**
- * @module ai/sap/adapter
- * @description SAP — On-chain persistence adapter for {@link AgentRegistry}.
- *
- * Implements the {@link PersistenceAdapter} interface using SAP on-chain
- * data, enabling the `AgentRegistry` to persist and discover agents
- * directly on the Solana blockchain.
- *
- * @example
- * ```ts
- * import { AgentRegistry, OnChainPersistenceAdapter } from '@oobe-protocol-labs/synapse-client-sdk/ai';
- *
- * const adapter = new OnChainPersistenceAdapter(client, { programId: 'SAPAgnt1...' });
- * const registry = new AgentRegistry({ adapter });
- *
- * // Agents registered via the registry are now backed by on-chain data
- * ```
- *
- * @since 1.3.0
- */
-import { SAP_DEFAULT_PROGRAM_ID, pdaToIdentity } from './types.js';
-import { SAPDiscovery } from './discovery.js';
-/* ═══════════════════════════════════════════════════════════════
- *  OnChainPersistenceAdapter
- * ═══════════════════════════════════════════════════════════════ */
-/**
- * @description Persistence adapter backed by SAP on-chain data.
- *
- * **Read operations** (`load`, `loadAll`) query the blockchain via
- * {@link SAPDiscovery}. **Write operations** (`save`, `remove`) are
- * cached locally — the actual on-chain write must be done by the user
- * via {@link SAPInstructionBuilder} + transaction signing.
- *
- * This design separates read (automatic) from write (user-driven)
- * because on-chain writes require a signature from the agent's wallet.
- *
- * @implements {PersistenceAdapterLike}
- * @since 1.3.0
- */
-export class OnChainPersistenceAdapter {
-    discovery;
-    pendingWrites = new Map();
-    removed = new Set();
-    /**
-     * @param {RpcClient} client - Client providing RPC transport
-     * @param {Partial<SAPConfig>} [config] - SAP configuration
-     */
-    constructor(client, config) {
-        this.discovery = new SAPDiscovery(client, {
-            programId: config?.programId ?? SAP_DEFAULT_PROGRAM_ID,
-            commitment: config?.commitment ?? 'confirmed',
-            maxAccounts: config?.maxAccounts ?? 100,
-        });
-    }
-    /**
-     * @description Get the underlying discovery instance for direct queries.
-     * @returns {SAPDiscovery} Discovery engine
-     * @since 1.3.0
-     */
-    getDiscovery() {
-        return this.discovery;
-    }
-    /**
-     * @description Stage agent data for persistence.
-     *
-     * This caches the data locally. To actually write on-chain, build and
-     * send a transaction using {@link SAPInstructionBuilder}.
-     *
-     * @param {string} id - Agent wallet pubkey or DID
-     * @param {unknown} data - Agent data to persist
-     * @returns {Promise<void>}
-     * @since 1.3.0
-     */
-    async save(id, data) {
-        this.removed.delete(id);
-        this.pendingWrites.set(id, data);
-    }
-    /**
-     * @description Load agent data from on-chain PDA.
-     *
-     * First checks pending writes (local cache), then queries the blockchain.
-     *
-     * @param {string} id - Agent wallet pubkey
-     * @returns {Promise<AgentPDAAccount | unknown | null>} Agent data or null
-     * @since 1.3.0
-     */
-    async load(id) {
-        if (this.removed.has(id))
-            return null;
-        if (this.pendingWrites.has(id))
-            return this.pendingWrites.get(id);
-        const agent = await this.discovery.findAgent(id);
-        if (!agent)
-            return null;
-        return {
-            identity: pdaToIdentity(agent),
-            pda: agent,
-        };
-    }
-    /**
-     * @description Load all agents from the blockchain.
-     *
-     * Merges on-chain data with pending local writes, excluding removed entries.
-     *
-     * @returns {Promise<Array<{ id: string; data: unknown }>>} All agent records
-     * @since 1.3.0
-     */
-    async loadAll() {
-        const onChain = await this.discovery.findActive();
-        const results = [];
-        const seen = new Set();
-        // On-chain agents
-        for (const agent of onChain) {
-            if (this.removed.has(agent.walletPubkey))
-                continue;
-            seen.add(agent.walletPubkey);
-            // Prefer pending write if available
-            if (this.pendingWrites.has(agent.walletPubkey)) {
-                results.push({ id: agent.walletPubkey, data: this.pendingWrites.get(agent.walletPubkey) });
-            }
-            else {
-                results.push({
-                    id: agent.walletPubkey,
-                    data: { identity: pdaToIdentity(agent), pda: agent },
-                });
-            }
-        }
-        // Pending writes not yet on-chain
-        for (const [id, data] of this.pendingWrites) {
-            if (!seen.has(id) && !this.removed.has(id)) {
-                results.push({ id, data });
-            }
-        }
-        return results;
-    }
-    /**
-     * @description Mark an agent for removal (locally cached).
-     *
-     * On-chain removal requires sending a `deactivate` instruction
-     * via {@link SAPInstructionBuilder}.
-     *
-     * @param {string} id - Agent wallet pubkey
-     * @returns {Promise<void>}
-     * @since 1.3.0
-     */
-    async remove(id) {
-        this.pendingWrites.delete(id);
-        this.removed.add(id);
-    }
-    /**
-     * @description Get pending writes that need to be committed on-chain.
-     * @returns {Map<string, unknown>} Map of agent ID → staged data
-     * @since 1.3.0
-     */
-    getPendingWrites() {
-        return this.pendingWrites;
-    }
-    /**
-     * @description Get IDs of agents marked for removal.
-     * @returns {ReadonlySet<string>} Set of removed agent IDs
-     * @since 1.3.0
-     */
-    getRemovedIds() {
-        return this.removed;
-    }
-    /**
-     * @description Clear all pending local writes and removals.
-     * Call after successfully committing transactions on-chain.
-     * @returns {void}
-     * @since 1.3.0
-     */
-    clearPending() {
-        this.pendingWrites.clear();
-        this.removed.clear();
-    }
-}
-//# sourceMappingURL=adapter.js.map

package/dist/esm/ai/sap/adapter.js.map

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

package/dist/esm/ai/sap/discovery.d.ts

@@ -1,165 +0,0 @@
-/**
- * @module ai/sap/discovery
- * @description SAP — On-chain agent discovery via `getProgramAccounts`.
- *
- * Queries the Solana blockchain for registered agents, applying filters
- * like capability, protocol, reputation, price range, and uptime.
- *
- * Uses the SDK's native {@link HttpTransport} — no external dependencies.
- *
- * @example
- * ```ts
- * import { SynapseClient } from '@oobe-protocol-labs/synapse-client-sdk';
- * import { SAPDiscovery } from '@oobe-protocol-labs/synapse-client-sdk/ai';
- *
- * const client = new SynapseClient({ endpoint: 'https://api.mainnet-beta.solana.com' });
- * const discovery = new SAPDiscovery(client, { programId: 'SAPAgnt1...' });
- *
- * // Find agents that support Jupiter swaps
- * const result = await discovery.find({ capability: 'jupiter:swap', minReputation: 700 });
- * for (const agent of result.agents) {
- *   console.log(agent.name, agent.reputation.score, agent.x402Endpoint);
- * }
- * ```
- *
- * @since 1.3.0
- */
-import type { SAPConfig, AgentPDAAccount, AgentDiscoveryFilter, DiscoveryResult, SAPAggregateMetrics } from './types';
-/**
- * @description Minimal transport interface for RPC calls.
- * @since 1.3.0
- */
-interface RpcTransport {
-    request<T = unknown>(method: string, params: unknown[]): Promise<T>;
-}
-/**
- * @description Minimal client interface providing transport access.
- * Satisfied by {@link SynapseClient} and any object with a `transport` property.
- * @since 1.3.0
- */
-interface RpcClient {
-    transport: RpcTransport;
-}
-/**
- * @description Error class for SAP discovery failures.
- * @since 1.3.0
- */
-export declare class SAPDiscoveryError extends Error {
-    readonly code: string;
-    constructor(message: string, code: string);
-}
-/**
- * @description On-chain agent discovery engine.
- *
- * Queries the Solana blockchain for SAP-registered agents using
- * `getProgramAccounts` with memcmp filters for efficient querying.
- *
- * @since 1.3.0
- */
-export declare class SAPDiscovery {
-    private readonly transport;
-    private readonly config;
-    /**
-     * @param {RpcClient} client - Client providing RPC transport
-     * @param {Partial<SAPConfig>} [config] - Discovery configuration
-     */
-    constructor(client: RpcClient, config?: Partial<SAPConfig>);
-    /**
-     * @description Find a single agent by wallet public key.
-     *
-     * Derives the PDA and fetches the account data directly.
-     *
-     * @param {string} walletPubkey - Agent's wallet (base58)
-     * @returns {Promise<AgentPDAAccount | null>} Agent account or null
-     *
-     * @example
-     * ```ts
-     * const agent = await discovery.findAgent('7xKXwJ...');
-     * if (agent) console.log(agent.name, agent.capabilities);
-     * ```
-     *
-     * @since 1.3.0
-     */
-    findAgent(walletPubkey: string): Promise<AgentPDAAccount | null>;
-    /**
-     * @description Find agents matching the given filters.
-     *
-     * Uses `getProgramAccounts` with a memcmp filter on the discriminator
-     * to fetch all SAP accounts, then applies client-side filters.
-     *
-     * @param {AgentDiscoveryFilter} [filter] - Query filters
-     * @returns {Promise<DiscoveryResult>} Discovery results with matching agents
-     *
-     * @example
-     * ```ts
-     * const result = await discovery.find({
-     *   capability: 'jupiter:swap',
-     *   minReputation: 600,
-     *   maxPricePerCall: 5000n,
-     *   sortBy: 'reputation',
-     *   limit: 20,
-     * });
-     * ```
-     *
-     * @since 1.3.0
-     */
-    find(filter?: AgentDiscoveryFilter): Promise<DiscoveryResult>;
-    /**
-     * @description Find all active agents (shortcut for `find({ activeOnly: true })`).
-     * @returns {Promise<AgentPDAAccount[]>} Active agent accounts
-     * @since 1.3.0
-     */
-    findActive(): Promise<AgentPDAAccount[]>;
-    /**
-     * @description Find agents by capability ID.
-     * @param {string} capabilityId - Capability to search for (e.g. `"jupiter:swap"`)
-     * @returns {Promise<AgentPDAAccount[]>} Agents with the given capability
-     * @since 1.3.0
-     */
-    findByCapability(capabilityId: string): Promise<AgentPDAAccount[]>;
-    /**
-     * @description Find agents by protocol name.
-     * @param {string} protocol - Protocol name (e.g. `"jupiter"`, `"raydium"`)
-     * @returns {Promise<AgentPDAAccount[]>} Agents offering tools for the given protocol
-     * @since 1.3.0
-     */
-    findByProtocol(protocol: string): Promise<AgentPDAAccount[]>;
-    /**
-     * @description Find the cheapest agent for a given capability.
-     * @param {string} capabilityId - Capability to search for
-     * @returns {Promise<AgentPDAAccount | null>} Cheapest agent or null
-     * @since 1.3.0
-     */
-    findCheapest(capabilityId: string): Promise<AgentPDAAccount | null>;
-    /**
-     * @description Find the most reputable agent for a given capability.
-     * @param {string} capabilityId - Capability to search for
-     * @returns {Promise<AgentPDAAccount | null>} Most reputable agent or null
-     * @since 1.3.0
-     */
-    findMostReputable(capabilityId: string): Promise<AgentPDAAccount | null>;
-    /**
-     * @description Compute aggregate metrics across all registered agents.
-     *
-     * @returns {Promise<SAPAggregateMetrics>} Network-wide agent statistics
-     *
-     * @example
-     * ```ts
-     * const metrics = await discovery.getAggregateMetrics();
-     * console.log(`${metrics.activeAgents} active agents`);
-     * console.log(`${metrics.totalCallsServed} total calls served`);
-     * console.log(`Protocols: ${metrics.protocols.join(', ')}`);
-     * ```
-     *
-     * @since 1.3.0
-     */
-    getAggregateMetrics(): Promise<SAPAggregateMetrics>;
-    /**
-     * @description Fetch all SAP accounts from the blockchain using getProgramAccounts.
-     * @returns {Promise<AgentPDAAccount[]>} All deserialized agent accounts
-     * @internal
-     */
-    private fetchAllAccounts;
-}
-export {};
-//# sourceMappingURL=discovery.d.ts.map

package/dist/esm/ai/sap/discovery.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../../src/ai/sap/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAQjB;;;GAGG;AACH,UAAU,YAAY;IACpB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACrE;AAED;;;;GAIG;AACH,UAAU,SAAS;IACjB,SAAS,EAAE,YAAY,CAAC;CACzB;AAMD;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;aACG,IAAI,EAAE,MAAM;gBAA7C,OAAO,EAAE,MAAM,EAAkB,IAAI,EAAE,MAAM;CAI1D;AAED;;;;;;;GAOG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAE7C;;;OAGG;gBACS,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC;IAS1D;;;;;;;;;;;;;;;OAeG;IACG,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAiBtE;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,IAAI,CAAC,MAAM,GAAE,oBAAyB,GAAG,OAAO,CAAC,eAAe,CAAC;IAqEvE;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAK9C;;;;;OAKG;IACG,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAKxE;;;;;OAKG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAKlE;;;;;OAKG;IACG,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAUzE;;;;;OAKG;IACG,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAU9E;;;;;;;;;;;;;;OAcG;IACG,mBAAmB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAmCzD;;;;OAIG;YACW,gBAAgB;CAgC/B"}