@oobe-protocol-labs/synapse-sap-sdk 0.1.0

package/dist/esm/registries/discovery.js

@@ -0,0 +1,358 @@
+/**
+ * @module registries/discovery
+ * @description High-level agent and tool discovery registry.
+ *
+ * Abstracts the raw PDA-level indexing + fetching into a single
+ * developer-friendly interface for finding agents, tools, and
+ * services across the SAP network.
+ *
+ * Use cases:
+ *   - "Find all agents that support Jupiter swaps"
+ *   - "Find all Swap tools across all agents"
+ *   - "Get the full profile of agent X (identity + stats + tools)"
+ *   - "Get network-wide statistics"
+ *
+ * @category Registries
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * const discovery = client.discovery;
+ *
+ * // Find agents that support Jupiter protocol
+ * const agents = await discovery.findAgentsByProtocol("jupiter");
+ *
+ * // Get full agent profile (identity + stats + attestations)
+ * const profile = await discovery.getAgentProfile(agentWallet);
+ *
+ * // Find all Swap tools across the network
+ * const tools = await discovery.findToolsByCategory("swap");
+ *
+ * // Network overview
+ * const stats = await discovery.getNetworkOverview();
+ * ```
+ */
+import { deriveAgent, deriveAgentStats, deriveCapabilityIndex, deriveProtocolIndex, deriveToolCategoryIndex, deriveGlobalRegistry, } from "../pda";
+import { sha256 } from "../utils";
+import { TOOL_CATEGORY_VALUES } from "../constants";
+// ═══════════════════════════════════════════════════════════════════
+//  Discovery Registry
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name DiscoveryRegistry
+ * @description High-level agent and tool discovery registry for the SAP network.
+ *
+ * Provides a developer-friendly API for finding agents by capability,
+ * protocol, or tool category, fetching full agent profiles, and
+ * retrieving network-wide statistics.
+ *
+ * @category Registries
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * const discovery = client.discovery;
+ *
+ * // Find agents by capability
+ * const swapAgents = await discovery.findAgentsByCapability("jupiter:swap");
+ *
+ * // Get agent profile
+ * const profile = await discovery.getAgentProfile(agentWallet);
+ *
+ * // Network statistics
+ * const overview = await discovery.getNetworkOverview();
+ * ```
+ */
+export class DiscoveryRegistry {
+    program;
+    constructor(program) {
+        this.program = program;
+    }
+    // ── Agent Discovery ──────────────────────────────────
+    /**
+     * @name findAgentsByCapability
+     * @description Find all agent PDAs registered for a specific capability.
+     * Hashes the capability ID with SHA-256 and looks up the capability index PDA.
+     *
+     * @param capabilityId - The capability identifier string (e.g. `"jupiter:swap"`).
+     * @param opts - Optional settings.
+     * @param opts.hydrate - If `false`, returns only PDAs without fetching identity/stats. Defaults to `true`.
+     * @returns An array of {@link DiscoveredAgent} matching the capability.
+     * @since v0.1.0
+     *
+     * @example
+     * ```ts
+     * const agents = await discovery.findAgentsByCapability("jupiter:swap");
+     * ```
+     */
+    async findAgentsByCapability(capabilityId, opts) {
+        const capHash = sha256(capabilityId);
+        const [pda] = deriveCapabilityIndex(capHash);
+        const index = await this.fetchNullable("capabilityIndex", pda);
+        if (!index)
+            return [];
+        if (opts?.hydrate === false) {
+            return index.agents.map((agentPda) => ({
+                pda: agentPda,
+                identity: null,
+                stats: null,
+            }));
+        }
+        return this.hydrateAgents(index.agents);
+    }
+    /**
+     * @name findAgentsByProtocol
+     * @description Find all agent PDAs registered for a specific protocol.
+     * Hashes the protocol ID with SHA-256 and looks up the protocol index PDA.
+     *
+     * @param protocolId - The protocol identifier string (e.g. `"jupiter"`).
+     * @param opts - Optional settings.
+     * @param opts.hydrate - If `false`, returns only PDAs without fetching identity/stats. Defaults to `true`.
+     * @returns An array of {@link DiscoveredAgent} matching the protocol.
+     * @since v0.1.0
+     *
+     * @example
+     * ```ts
+     * const agents = await discovery.findAgentsByProtocol("jupiter");
+     * ```
+     */
+    async findAgentsByProtocol(protocolId, opts) {
+        const protoHash = sha256(protocolId);
+        const [pda] = deriveProtocolIndex(protoHash);
+        const index = await this.fetchNullable("protocolIndex", pda);
+        if (!index)
+            return [];
+        if (opts?.hydrate === false) {
+            return index.agents.map((agentPda) => ({
+                pda: agentPda,
+                identity: null,
+                stats: null,
+            }));
+        }
+        return this.hydrateAgents(index.agents);
+    }
+    /**
+     * @name findToolsByCategory
+     * @description Find all tool PDAs registered in a specific category.
+     * Accepts either a category name string or a numeric category value.
+     *
+     * @param category - Tool category name (e.g. `"swap"`) or numeric category value.
+     * @param opts - Optional settings.
+     * @param opts.hydrate - If `false`, returns only PDAs without fetching descriptors. Defaults to `true`.
+     * @returns An array of {@link DiscoveredTool} matching the category.
+     * @since v0.1.0
+     *
+     * @example
+     * ```ts
+     * const tools = await discovery.findToolsByCategory("swap");
+     * const tools = await discovery.findToolsByCategory(0); // numeric
+     * ```
+     */
+    async findToolsByCategory(category, opts) {
+        const categoryNum = typeof category === "number"
+            ? category
+            : TOOL_CATEGORY_VALUES[category] ?? 9;
+        const [pda] = deriveToolCategoryIndex(categoryNum);
+        const index = await this.fetchNullable("toolCategoryIndex", pda);
+        if (!index)
+            return [];
+        if (opts?.hydrate === false) {
+            return index.tools.map((toolPda) => ({
+                pda: toolPda,
+                descriptor: null,
+            }));
+        }
+        return this.hydrateTools(index.tools);
+    }
+    // ── Agent Profile ────────────────────────────────────
+    /**
+     * @name getAgentProfile
+     * @description Get the full profile of an agent by wallet address.
+     * Combines identity + stats into a single response with computed fields
+     * for easy display (active status, total calls, reputation, etc.).
+     *
+     * @param wallet - The agent owner's wallet public key.
+     * @returns The full {@link AgentProfile}, or `null` if the agent does not exist.
+     * @since v0.1.0
+     *
+     * @example
+     * ```ts
+     * const profile = await discovery.getAgentProfile(agentWallet);
+     * console.log(profile.identity.name);
+     * console.log(profile.computed.isActive);
+     * console.log(profile.computed.totalCalls);
+     * ```
+     */
+    async getAgentProfile(wallet) {
+        const [agentPda] = deriveAgent(wallet);
+        const [statsPda] = deriveAgentStats(agentPda);
+        const [identity, stats] = await Promise.all([
+            this.fetchNullable("agentAccount", agentPda),
+            this.fetchNullable("agentStats", statsPda),
+        ]);
+        if (!identity)
+            return null;
+        const totalCallsBN = stats?.totalCallsServed ?? identity.totalCallsServed;
+        return {
+            pda: agentPda,
+            identity,
+            stats,
+            computed: {
+                isActive: identity.isActive,
+                totalCalls: totalCallsBN.toString(),
+                reputationScore: identity.reputationScore,
+                hasX402: !!identity.x402Endpoint,
+                capabilityCount: identity.capabilities.length,
+                pricingTierCount: identity.pricing.length,
+                protocols: [...identity.protocols],
+            },
+        };
+    }
+    /**
+     * @name isAgentActive
+     * @description Check if an agent exists and is currently active.
+     * Reads the agent stats account to determine active status.
+     *
+     * @param wallet - The agent owner's wallet public key.
+     * @returns `true` if the agent exists and is active, `false` otherwise.
+     * @since v0.1.0
+     */
+    async isAgentActive(wallet) {
+        const [agentPda] = deriveAgent(wallet);
+        const [statsPda] = deriveAgentStats(agentPda);
+        const stats = await this.fetchNullable("agentStats", statsPda);
+        return stats?.isActive ?? false;
+    }
+    // ── Network Overview ─────────────────────────────────
+    /**
+     * @name getNetworkOverview
+     * @description Get network-wide statistics from the GlobalRegistry account.
+     * Returns aggregated counts and metadata for the entire SAP network.
+     *
+     * @returns A {@link NetworkOverview} with all network-level statistics.
+     * @since v0.1.0
+     */
+    async getNetworkOverview() {
+        const [pda] = deriveGlobalRegistry();
+        const reg = await this.fetch("globalRegistry", pda);
+        return {
+            totalAgents: reg.totalAgents.toString(),
+            activeAgents: reg.activeAgents.toString(),
+            totalFeedbacks: reg.totalFeedbacks.toString(),
+            totalTools: reg.totalTools,
+            totalVaults: reg.totalVaults,
+            totalAttestations: reg.totalAttestations,
+            totalCapabilities: reg.totalCapabilities,
+            totalProtocols: reg.totalProtocols,
+            authority: reg.authority,
+        };
+    }
+    // ── Multi-category Search ────────────────────────────
+    /**
+     * @name findAgentsByCapabilities
+     * @description Search across multiple capability IDs at once.
+     * Returns deduplicated agent PDAs aggregated from all matching capability indexes.
+     *
+     * @param capabilityIds - Array of capability identifier strings to search.
+     * @param opts - Optional settings.
+     * @param opts.hydrate - If `false`, returns only PDAs without fetching identity/stats. Defaults to `true`.
+     * @returns A deduplicated array of {@link DiscoveredAgent} matching any of the capabilities.
+     * @since v0.1.0
+     */
+    async findAgentsByCapabilities(capabilityIds, opts) {
+        const seen = new Set();
+        const results = [];
+        for (const capId of capabilityIds) {
+            const agents = await this.findAgentsByCapability(capId, opts);
+            for (const agent of agents) {
+                const key = agent.pda.toBase58();
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    results.push(agent);
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * @name getToolCategorySummary
+     * @description Search across all 10 tool categories and return a summary.
+     * Lists each category with its name, numeric value, and tool count.
+     *
+     * @returns An array of category summary objects with `category`, `categoryNum`, and `toolCount`.
+     * @since v0.1.0
+     */
+    async getToolCategorySummary() {
+        const categories = Object.entries(TOOL_CATEGORY_VALUES);
+        const results = [];
+        for (const [name, num] of categories) {
+            const [pda] = deriveToolCategoryIndex(num);
+            const index = await this.fetchNullable("toolCategoryIndex", pda);
+            results.push({
+                category: name,
+                categoryNum: num,
+                toolCount: index?.tools.length ?? 0,
+            });
+        }
+        return results;
+    }
+    // ── Internals ────────────────────────────────────────
+    /**
+     * @name hydrateAgents
+     * @description Hydrate an array of agent PDAs by fetching identity and stats data.
+     * @param agentPdas - Array of agent PDA public keys.
+     * @returns An array of {@link DiscoveredAgent} with populated identity and stats fields.
+     * @private
+     */
+    async hydrateAgents(agentPdas) {
+        return Promise.all(agentPdas.map(async (agentPda) => {
+            const [statsPda] = deriveAgentStats(agentPda);
+            const [identity, stats] = await Promise.all([
+                this.fetchNullable("agentAccount", agentPda),
+                this.fetchNullable("agentStats", statsPda),
+            ]);
+            return { pda: agentPda, identity, stats };
+        }));
+    }
+    /**
+     * @name hydrateTools
+     * @description Hydrate an array of tool PDAs by fetching descriptor data.
+     * @param toolPdas - Array of tool PDA public keys.
+     * @returns An array of {@link DiscoveredTool} with populated descriptor fields.
+     * @private
+     */
+    async hydrateTools(toolPdas) {
+        return Promise.all(toolPdas.map(async (toolPda) => {
+            const descriptor = await this.fetchNullable("toolDescriptor", toolPda);
+            return { pda: toolPda, descriptor };
+        }));
+    }
+    /**
+     * @name fetch
+     * @description Fetch an on-chain account by name and PDA. Throws if not found.
+     * @param name - Anchor account discriminator name.
+     * @param pda - Account public key to fetch.
+     * @returns The deserialized account data.
+     * @throws If the account does not exist.
+     * @private
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async fetch(name, pda) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-explicit-any
+        return this.program.account[name].fetch(pda);
+    }
+    /**
+     * @name fetchNullable
+     * @description Fetch an on-chain account by name and PDA. Returns `null` if not found.
+     * @param name - Anchor account discriminator name.
+     * @param pda - Account public key to fetch.
+     * @returns The deserialized account data, or `null` if the account does not exist.
+     * @private
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async fetchNullable(name, pda) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-explicit-any
+        return this.program.account[name].fetchNullable(pda);
+    }
+}
+//# sourceMappingURL=discovery.js.map

package/dist/esm/registries/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../src/registries/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAKH,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AA+HpD,sEAAsE;AACtE,sBAAsB;AACtB,sEAAsE;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,OAAmB;QAAnB,YAAO,GAAP,OAAO,CAAY;IAAG,CAAC;IAEpD,wDAAwD;IAExD;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,sBAAsB,CAC1B,YAAoB,EACpB,IAA4B;QAE5B,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAE7C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,CACpC,iBAAiB,EACjB,GAAG,CACJ,CAAC;QACF,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QAEtB,IAAI,IAAI,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;YAC5B,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBACrC,GAAG,EAAE,QAAQ;gBACb,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE,IAAI;aACZ,CAAC,CAAC,CAAC;QACN,CAAC;QAED,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,oBAAoB,CACxB,UAAkB,EAClB,IAA4B;QAE5B,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAE7C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,CACpC,eAAe,EACf,GAAG,CACJ,CAAC;QACF,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QAEtB,IAAI,IAAI,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;YAC5B,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBACrC,GAAG,EAAE,QAAQ;gBACb,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE,IAAI;aACZ,CAAC,CAAC,CAAC;QACN,CAAC;QAED,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,mBAAmB,CACvB,QAAmC,EACnC,IAA4B;QAE5B,MAAM,WAAW,GACf,OAAO,QAAQ,KAAK,QAAQ;YAC1B,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAE1C,MAAM,CAAC,GAAG,CAAC,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,CACpC,mBAAmB,EACnB,GAAG,CACJ,CAAC;QACF,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QAEtB,IAAI,IAAI,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;YAC5B,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBACnC,GAAG,EAAE,OAAO;gBACZ,UAAU,EAAE,IAAI;aACjB,CAAC,CAAC,CAAC;QACN,CAAC;QAED,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,wDAAwD;IAExD;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,eAAe,CAAC,MAAiB;QACrC,MAAM,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,CAAC,QAAQ,CAAC,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAE9C,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC1C,IAAI,CAAC,aAAa,CAAmB,cAAc,EAAE,QAAQ,CAAC;YAC9D,IAAI,CAAC,aAAa,CAAiB,YAAY,EAAE,QAAQ,CAAC;SAC3D,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAE3B,MAAM,YAAY,GAAO,KAAK,EAAE,gBAAgB,IAAI,QAAQ,CAAC,gBAAgB,CAAC;QAE9E,OAAO;YACL,GAAG,EAAE,QAAQ;YACb,QAAQ;YACR,KAAK;YACL,QAAQ,EAAE;gBACR,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,UAAU,EAAE,YAAY,CAAC,QAAQ,EAAE;gBACnC,eAAe,EAAE,QAAQ,CAAC,eAAe;gBACzC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,YAAY;gBAChC,eAAe,EAAE,QAAQ,CAAC,YAAY,CAAC,MAAM;gBAC7C,gBAAgB,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM;gBACzC,SAAS,EAAE,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC;aACnC;SACF,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,aAAa,CAAC,MAAiB;QACnC,MAAM,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,CAAC,QAAQ,CAAC,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAE9C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,CACpC,YAAY,EACZ,QAAQ,CACT,CAAC;QACF,OAAO,KAAK,EAAE,QAAQ,IAAI,KAAK,CAAC;IAClC,CAAC;IAED,wDAAwD;IAExD;;;;;;;OAOG;IACH,KAAK,CAAC,kBAAkB;QACtB,MAAM,CAAC,GAAG,CAAC,GAAG,oBAAoB,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAqB,gBAAgB,EAAE,GAAG,CAAC,CAAC;QAExE,OAAO;YACL,WAAW,EAAE,GAAG,CAAC,WAAW,CAAC,QAAQ,EAAE;YACvC,YAAY,EAAE,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE;YACzC,cAAc,EAAE,GAAG,CAAC,cAAc,CAAC,QAAQ,EAAE;YAC7C,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;YACxC,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;YACxC,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CAAC;IACJ,CAAC;IAED,wDAAwD;IAExD;;;;;;;;;;OAUG;IACH,KAAK,CAAC,wBAAwB,CAC5B,aAAuB,EACvB,IAA4B;QAE5B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,MAAM,OAAO,GAAsB,EAAE,CAAC;QAEtC,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC9D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;gBACjC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACd,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,sBAAsB;QAG1B,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAErD,CAAC;QAEF,MAAM,OAAO,GAIR,EAAE,CAAC;QAER,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,UAAU,EAAE,CAAC;YACrC,MAAM,CAAC,GAAG,CAAC,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;YAC3C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,CACpC,mBAAmB,EACnB,GAAG,CACJ,CAAC;YACF,OAAO,CAAC,IAAI,CAAC;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,GAAG;gBAChB,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC;aACpC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,wDAAwD;IAExD;;;;;;OAMG;IACK,KAAK,CAAC,aAAa,CACzB,SAAsB;QAEtB,OAAO,OAAO,CAAC,GAAG,CAChB,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;YAC/B,MAAM,CAAC,QAAQ,CAAC,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAC9C,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC1C,IAAI,CAAC,aAAa,CAAmB,cAAc,EAAE,QAAQ,CAAC;gBAC9D,IAAI,CAAC,aAAa,CAAiB,YAAY,EAAE,QAAQ,CAAC;aAC3D,CAAC,CAAC;YACH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC5C,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,YAAY,CACxB,QAAqB;QAErB,OAAO,OAAO,CAAC,GAAG,CAChB,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAC7B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CACzC,gBAAgB,EAChB,OAAO,CACR,CAAC;YACF,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;QACtC,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,8DAA8D;IACtD,KAAK,CAAC,KAAK,CAAI,IAAY,EAAE,GAAc;QACjD,0GAA0G;QAC1G,OAAQ,IAAI,CAAC,OAAO,CAAC,OAAe,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;IACtE,CAAC;IAED;;;;;;;OAOG;IACH,8DAA8D;IACtD,KAAK,CAAC,aAAa,CAAI,IAAY,EAAE,GAAc;QACzD,0GAA0G;QAC1G,OAAQ,IAAI,CAAC,OAAO,CAAC,OAAe,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,GAAG,CAAsB,CAAC;IACrF,CAAC;CACF"}

package/dist/esm/registries/index.js

@@ -0,0 +1,44 @@
+/**
+ * @module registries
+ * @description High-level registry barrel export.
+ *
+ * Registries are developer-facing abstractions that combine
+ * multiple raw SDK modules into cohesive, workflow-oriented APIs:
+ *
+ *   - **DiscoveryRegistry** — Find agents, tools, and services across
+ *     the SAP network by capability, protocol, or tool category.
+ *
+ *   - **X402Registry** — Full x402 micropayment lifecycle: pricing
+ *     estimation, escrow management, HTTP header generation,
+ *     settlement, and balance monitoring.
+ *
+ *   - **SessionManager** — Unified memory session lifecycle: create
+ *     vault, open session, write data, read ring buffer, seal
+ *     archives, and close sessions in a single API.
+ *
+ *   - **AgentBuilder** — Fluent builder for agent registration with
+ *     capabilities, pricing tiers, tools, and x402 endpoint config.
+ *
+ * All registries are accessible as lazy singletons on `SapClient`:
+ *
+ * ```ts
+ * const client = SapClient.from(provider);
+ *
+ * client.discovery    // → DiscoveryRegistry
+ * client.x402         // → X402Registry
+ * client.session      // → SessionManager
+ * client.builder      // → AgentBuilder (fresh instance each access)
+ * ```
+ *
+ * @category Registries
+ * @since v0.1.0
+ * @see {@link DiscoveryRegistry}
+ * @see {@link X402Registry}
+ * @see {@link SessionManager}
+ * @see {@link AgentBuilder}
+ */
+export { DiscoveryRegistry } from "./discovery";
+export { X402Registry } from "./x402";
+export { SessionManager } from "./session";
+export { AgentBuilder } from "./builder";
+//# sourceMappingURL=index.js.map

package/dist/esm/registries/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/registries/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAShD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAWtC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAS3C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}