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

package/dist/cjs/ai/sap/client.js

@@ -0,0 +1,334 @@
+"use strict";
+/**
+ * @module ai/sap/client
+ * @description SynapseAnchorSap — One-line bridge from Synapse Client SDK to SAP.
+ *
+ * Creates a fully-initialized `SapClient` instance using Synapse's
+ * network resolution, ready for agent registration, memory writes,
+ * x402 escrow, discovery, and every other SAP operation.
+ *
+ * **Peer dependencies** (must be installed by the consumer):
+ *  - `@oobe-protocol-labs/synapse-sap-sdk`
+ *  - `@coral-xyz/anchor`
+ *  - `@solana/web3.js`
+ *
+ * @example Standalone
+ * ```ts
+ * import { SynapseAnchorSap } from '@oobe-protocol-labs/synapse-client-sdk/ai/sap';
+ *
+ * const sap = SynapseAnchorSap.create({ wallet });
+ * await sap.agent.register({ name: 'My Agent', ... });
+ * ```
+ *
+ * @example Re-use SynapseClient endpoint
+ * ```ts
+ * import { SynapseClient } from '@oobe-protocol-labs/synapse-client-sdk';
+ * import { SynapseAnchorSap } from '@oobe-protocol-labs/synapse-client-sdk/ai/sap';
+ *
+ * const synapse = new SynapseClient({ endpoint: process.env.SYNAPSE_RPC! });
+ * const sap = SynapseAnchorSap.fromSynapseClient(synapse, wallet);
+ * ```
+ *
+ * @since 2.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SynapseAnchorSap = void 0;
+const synapse_1 = require("../../utils/synapse");
+const types_1 = require("./types");
+let _deps = null;
+/** @internal Resolve all peer deps once, throw clear errors on missing packages. */
+function resolveDeps() {
+    if (_deps)
+        return _deps;
+    let Connection;
+    let AnchorProvider;
+    let SapClient;
+    let PublicKey;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const web3 = require('@solana/web3.js');
+        Connection = web3.Connection;
+        PublicKey = web3.PublicKey;
+    }
+    catch {
+        throw new types_1.SapDependencyError('@solana/web3.js');
+    }
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const anchor = require('@coral-xyz/anchor');
+        AnchorProvider = anchor.AnchorProvider;
+    }
+    catch {
+        throw new types_1.SapDependencyError('@coral-xyz/anchor');
+    }
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const sapSdk = require('@oobe-protocol-labs/synapse-sap-sdk');
+        SapClient = sapSdk.SapClient;
+    }
+    catch {
+        throw new types_1.SapDependencyError('@oobe-protocol-labs/synapse-sap-sdk');
+    }
+    _deps = { Connection, AnchorProvider, SapClient, PublicKey };
+    return _deps;
+}
+/* ═══════════════════════════════════════════════════════════════
+ *  SynapseAnchorSap
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * Bridge between Synapse Client SDK and the SAP SDK.
+ *
+ * Resolves Synapse network endpoints automatically, creates an
+ * Anchor provider, and initializes a `SapClient` — all in a single
+ * synchronous factory call.
+ *
+ * All `SapClient` module accessors (`agent`, `builder`, `session`,
+ * `escrow`, `tools`, `discovery`, `feedback`, `attestation`) are
+ * proxied as first-class getters for ergonomic access.
+ *
+ * @example Registration flow
+ * ```ts
+ * const sap = SynapseAnchorSap.create({ wallet });
+ *
+ * // Using the fluent builder
+ * await sap.builder
+ *   .agent('DeFi Bot')
+ *   .description('Jupiter + Raydium swap agent')
+ *   .addCapability('jupiter:swap', { protocol: 'jupiter', version: '6.0' })
+ *   .addPricingTier({
+ *     tierId: 'standard',
+ *     pricePerCall: 10_000,
+ *     rateLimit: 60,
+ *     tokenType: 'sol',
+ *     settlementMode: 'x402',
+ *   })
+ *   .register();
+ * ```
+ *
+ * @example Discovery
+ * ```ts
+ * const agents = await sap.discovery.findByCapability('jupiter:swap');
+ * ```
+ *
+ * @example Memory session
+ * ```ts
+ * const session = await sap.session.start('conv-001');
+ * await sap.session.write(session, 'User requested SOL→USDC swap');
+ * const entries = await sap.session.readLatest(session);
+ * await sap.session.seal(session);
+ * ```
+ */
+class SynapseAnchorSap {
+    /**
+     * The underlying `SapClient` from `@oobe-protocol-labs/synapse-sap-sdk`.
+     *
+     * Access any SapClient method directly when the proxy getters
+     * don't cover your use case.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    sapClient;
+    /** The resolved Synapse endpoint used for this connection. */
+    endpoint;
+    /** The SAP program ID in use. */
+    programId;
+    /** Wallet public key as base58 string. */
+    walletPubkey;
+    /** The Anchor provider instance (for advanced use). */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    provider;
+    /** The Solana Connection instance (for advanced use). */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    connection;
+    /* ── Private constructor ─────────────────────────────────── */
+    constructor(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    sapClient, endpoint, programId, walletPubkey, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    provider, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    connection) {
+        this.sapClient = sapClient;
+        this.endpoint = endpoint;
+        this.programId = programId;
+        this.walletPubkey = walletPubkey;
+        this.provider = provider;
+        this.connection = connection;
+    }
+    /* ── Factory: create ─────────────────────────────────────── */
+    /**
+     * Create a `SynapseAnchorSap` instance.
+     *
+     * Resolves the Synapse endpoint for the given network/region,
+     * creates an Anchor provider, and initializes a SapClient.
+     *
+     * @param config - Bridge configuration (wallet + optional overrides)
+     * @returns Fully-initialized SAP bridge
+     * @throws {@link SapDependencyError} if peer dependencies are missing
+     *
+     * @example
+     * ```ts
+     * import { SynapseAnchorSap } from '@oobe-protocol-labs/synapse-client-sdk/ai/sap';
+     * import { SynapseNetwork } from '@oobe-protocol-labs/synapse-client-sdk/utils';
+     *
+     * const sap = SynapseAnchorSap.create({
+     *   wallet,
+     *   network: SynapseNetwork.Mainnet,
+     *   commitment: 'confirmed',
+     * });
+     * ```
+     */
+    static create(config) {
+        const { wallet, network = synapse_1.SynapseNetwork.Mainnet, region = synapse_1.SynapseRegion.US, rpcEndpoint, programId = types_1.SAP_PROGRAM_ID, commitment = 'confirmed', skipPreflight = false, debug = false, } = config;
+        // ── Resolve peer dependencies ─────────────────────────
+        const deps = resolveDeps();
+        // ── Resolve Synapse endpoint ──────────────────────────
+        const endpoint = (0, synapse_1.resolveEndpoint)(network, region);
+        const rpc = rpcEndpoint ?? endpoint.rpc;
+        if (debug) {
+            console.log(`[SynapseAnchorSap] connecting to ${rpc} (${network}:${region})`);
+        }
+        // ── Create Solana Connection ──────────────────────────
+        const connection = new deps.Connection(rpc, { commitment });
+        // ── Create Anchor Provider ────────────────────────────
+        const provider = new deps.AnchorProvider(connection, wallet, {
+            commitment,
+            skipPreflight,
+        });
+        // ── Create SapClient ──────────────────────────────────
+        const sapClient = deps.SapClient.from(provider, programId);
+        const walletPubkey = wallet.publicKey.toBase58();
+        if (debug) {
+            console.log(`[SynapseAnchorSap] initialized — wallet: ${walletPubkey}, program: ${programId}`);
+        }
+        return new SynapseAnchorSap(sapClient, endpoint, programId, walletPubkey, provider, connection);
+    }
+    /* ── Factory: fromSynapseClient ──────────────────────────── */
+    /**
+     * Create from an existing {@link SynapseClient}.
+     *
+     * Extracts the RPC endpoint URL from the client's configuration
+     * so you don't have to specify it twice.
+     *
+     * @param synapseClient - An initialized SynapseClient instance
+     * @param wallet - Wallet with signing capability
+     * @param opts - Optional overrides for programId, commitment, etc.
+     * @returns Fully-initialized SAP bridge using the same RPC endpoint
+     *
+     * @example
+     * ```ts
+     * import { SynapseClient } from '@oobe-protocol-labs/synapse-client-sdk';
+     * import { SynapseAnchorSap } from '@oobe-protocol-labs/synapse-client-sdk/ai/sap';
+     *
+     * const synapse = new SynapseClient({ endpoint: process.env.SYNAPSE_RPC! });
+     * const sap = SynapseAnchorSap.fromSynapseClient(synapse, wallet);
+     *
+     * // Now both synapse and sap share the same RPC endpoint
+     * await sap.agent.register({ ... });
+     * ```
+     */
+    static fromSynapseClient(synapseClient, wallet, opts) {
+        // Extract endpoint from SynapseClient's internal config.
+        // cfg is private, so we use a known-safe internal access pattern.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const clientAny = synapseClient;
+        const rpcEndpoint = clientAny.cfg?.endpoint ??
+            clientAny.config?.endpoint ??
+            clientAny._config?.endpoint;
+        if (!rpcEndpoint) {
+            throw new Error('Could not extract RPC endpoint from SynapseClient. ' +
+                'Use SynapseAnchorSap.create({ wallet, rpcEndpoint: "..." }) instead.');
+        }
+        return SynapseAnchorSap.create({
+            wallet,
+            rpcEndpoint,
+            programId: opts?.programId,
+            commitment: opts?.commitment ?? 'confirmed',
+            skipPreflight: opts?.skipPreflight,
+            debug: opts?.debug,
+        });
+    }
+    /* ═══════════════════════════════════════════════════════════
+     *  SapClient module accessors
+     *
+     *  These proxy to the underlying SapClient's lazy getters.
+     *  Each module is instantiated on first access and cached
+     *  by SapClient internally.
+     * ═══════════════════════════════════════════════════════════ */
+    /**
+     * Agent lifecycle — register, update, deactivate, reactivate, close,
+     * reportCalls, updateReputation, fetch, fetchStats.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    get agent() {
+        return this.sapClient.agent;
+    }
+    /**
+     * Fluent agent builder — `.agent('Name').description('...').addCapability(...)
+     * .addPricingTier(...).register()`.
+     *
+     * Returns a **new** builder on every access (one-shot flow).
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    get builder() {
+        return this.sapClient.builder;
+    }
+    /**
+     * Memory sessions — start, write, readLatest, seal, close.
+     * Composes VaultModule + LedgerModule into a single API.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    get session() {
+        return this.sapClient.session;
+    }
+    /**
+     * Escrow management — create, deposit, settle, withdraw, close.
+     * Handles x402 micropayment flows.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    get escrow() {
+        return this.sapClient.escrow;
+    }
+    /**
+     * Tool schema registry — publish, inscribe, update, close.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    get tools() {
+        return this.sapClient.tools;
+    }
+    /**
+     * Discovery — find agents by capability, protocol, wallet.
+     * Composes Agent + Indexing modules.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    get discovery() {
+        return this.sapClient.discovery;
+    }
+    /**
+     * Feedback — give, update, revoke trustless on-chain reviews.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    get feedback() {
+        return this.sapClient.feedback;
+    }
+    /**
+     * Attestation — create and revoke web-of-trust attestations.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    get attestation() {
+        return this.sapClient.attestation;
+    }
+    /**
+     * Direct access to the underlying Anchor `Program` instance.
+     * For low-level RPC calls or custom instruction building.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    get program() {
+        return this.sapClient.program;
+    }
+    /** Whether the bridge is fully initialized. */
+    get isReady() {
+        return this.sapClient != null;
+    }
+}
+exports.SynapseAnchorSap = SynapseAnchorSap;
+//# sourceMappingURL=client.js.map

package/dist/cjs/ai/sap/client.js.map

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

package/dist/cjs/ai/sap/index.d.ts

@@ -1,61 +1,78 @@
 /**
  * @module ai/sap
- * @description Solana Agent Protocol (SAP) — On-chain agent identity, discovery & reputation.
+ * @description Solana Agent Protocol (SAP) — Integration bridge for `@oobe-protocol-labs/synapse-sap-sdk`.
  *
- * Sub-modules:
- *  - `types`     — PDA account schema, instruction params, filter types
- *  - `pda`       — PDA derivation, Borsh serialization/deserialization
- *  - `program`   — Transaction instruction builders (register, update, deactivate)
- *  - `discovery` — On-chain agent search via `getProgramAccounts`
- *  - `adapter`   — {@link OnChainPersistenceAdapter} for {@link AgentRegistry}
+ * This module provides a **thin integration layer** that connects the
+ * Synapse Client SDK's infrastructure (network resolution, endpoint
+ * registry, HMR-safe singletons) with the standalone SAP SDK for
+ * on-chain agent operations.
  *
- * @example
+ * ## What moved
+ *
+ * The full SAP protocol implementation (PDA derivation, Borsh
+ * serialization, instruction builders, discovery, validation,
+ * subnetworks, scoring) now lives in:
+ *
+ *  - **Protocol (Anchor/Rust)**: https://github.com/OOBE-PROTOCOL/synapse-sap
+ *  - **SAP SDK (TypeScript)**: https://github.com/OOBE-PROTOCOL/synapse-sap-sdk
+ *    → `@oobe-protocol-labs/synapse-sap-sdk`
+ *
+ * ## What this module provides
+ *
+ *  - {@link SynapseAnchorSap} — Bridge class: resolves Synapse endpoints,
+ *    creates an Anchor provider, and initializes a `SapClient` in one call.
+ *    Exposes all SapClient modules as getters (`agent`, `builder`, `session`,
+ *    `escrow`, `tools`, `discovery`, `feedback`, `attestation`).
+ *
+ *  - {@link createSapProvider} — HMR-safe singleton factory for Next.js
+ *    server-side routes (same pattern as `createSynapseProvider`).
+ *
+ *  - {@link createSapContextBlueprint} — React integration blueprint with
+ *    typed context value, state manager, and subscription support — all
+ *    without a React dependency.
+ *
+ * ## Quick start
+ *
+ * @example Standalone (Node.js / scripts)
+ * ```ts
+ * import { SynapseAnchorSap } from '@oobe-protocol-labs/synapse-client-sdk/ai/sap';
+ *
+ * const sap = SynapseAnchorSap.create({ wallet });
+ * await sap.builder
+ *   .agent('TradeBot')
+ *   .description('Jupiter swap agent')
+ *   .addCapability('jupiter:swap', { protocol: 'jupiter', version: '6.0' })
+ *   .register();
+ * ```
+ *
+ * @example From existing SynapseClient
  * ```ts
- * import {
- *   SAPInstructionBuilder,
- *   SAPDiscovery,
- *   OnChainPersistenceAdapter,
- *   deriveAgentPDA,
- * } from '@oobe-protocol-labs/synapse-client-sdk/ai';
- *
- * // 1. Derive PDA address
- * const pda = deriveAgentPDA(walletPubkey, programId);
- *
- * // 2. Build registration instruction
- * const builder = new SAPInstructionBuilder({ programId });
- * const ix = builder.register({
- *   walletPubkey,
- *   name: 'My DeFi Agent',
- *   description: 'Jupiter + Raydium tools',
- *   capabilities: [{ id: 'jupiter:swap' }, { id: 'raydium:pool_info' }],
- *   pricing: [{ tierId: 'standard', pricePerCall: 1000n, rateLimit: 10, maxCallsPerSession: 100, tokenType: 'USDC' }],
- *   x402Endpoint: 'https://myagent.xyz/.well-known/x402',
- * });
- *
- * // 3. Discover agents on-chain
- * const discovery = new SAPDiscovery(client, { programId });
- * const agents = await discovery.find({ capability: 'jupiter:swap', minReputation: 700 });
- *
- * // 4. Use as persistence adapter for AgentRegistry
- * const adapter = new OnChainPersistenceAdapter(client, { programId });
- * const registry = new AgentRegistry({ adapter });
+ * import { SynapseClient } from '@oobe-protocol-labs/synapse-client-sdk';
+ * import { SynapseAnchorSap } from '@oobe-protocol-labs/synapse-client-sdk/ai/sap';
+ *
+ * const client = new SynapseClient({ endpoint: process.env.SYNAPSE_RPC! });
+ * const sap = SynapseAnchorSap.fromSynapseClient(client, wallet);
+ * ```
+ *
+ * @example Next.js server-side (HMR-safe)
+ * ```ts
+ * import { createSapProvider } from '@oobe-protocol-labs/synapse-client-sdk/ai/sap';
+ * const getSap = createSapProvider(serverWallet, { network: SynapseNetwork.Mainnet });
+ * const sap = getSap();
+ * ```
+ *
+ * @example Next.js client-side (React context)
+ * ```tsx
+ * import { createSapContextBlueprint } from '@oobe-protocol-labs/synapse-client-sdk/ai/sap';
+ * const blueprint = createSapContextBlueprint({ network: SynapseNetwork.Mainnet });
+ * // Wire into your React provider — see provider.ts JSDoc for full example
  * ```
  *
- * @since 1.3.0
+ * @since 2.1.0
  */
-export type { SAPConfig, AgentCapability, AgentPricingOnChain, AgentReputationOnChain, AgentPDAAccount, RegisterAgentParams, UpdateAgentParams, UpdateReputationParams, AgentDiscoveryFilter, DiscoveryResult, SAPAggregateMetrics, SAPInstruction, SAPAccountMeta, VolumeCurveBreakpoint, } from './types';
-export { SAP_DEFAULT_PROGRAM_ID, SAP_SEED_PREFIX, SAP_ACCOUNT_DISCRIMINATOR, SAP_INSTRUCTION_DISCRIMINATORS, pdaToIdentity, pricingToTier, computeCallCost, estimateTotalCost, } from './types';
-export type { DerivedPDA } from './pda';
-export { deriveAgentPDA, deserializeAgentAccount, serializeRegisterData, serializeUpdateData, base58Decode, base58Encode, isOnCurve, BorshReader, BorshWriter, } from './pda';
-export { SAPInstructionBuilder, SAPProgramError, } from './program';
-export { SAPDiscovery, SAPDiscoveryError, } from './discovery';
-export { OnChainPersistenceAdapter, } from './adapter';
-export type { CapabilityCategory, CapabilityIOSchema, CapabilityDefinition, } from './registry';
-export { SAPCapabilityRegistry, } from './registry';
-export type { ValidationSeverity, ValidationIssue, ValidationReport, SAPValidatorConfig, } from './validator';
-export { SAPValidator, SAPValidationError, } from './validator';
-export type { SelectionStrategy, SubnetworkConfig, CapabilityAssignment, SubnetworkResult, SubnetworkHealth, } from './subnetwork';
-export { SubnetworkBuilder, } from './subnetwork';
-export type { HealthScoreBreakdown, AgentHealthScore, NetworkAnalytics, } from './scoring';
-export { computeAgentHealthScore, computeNetworkAnalytics, } from './scoring';
+export type { SapWallet, SapCommitment, SapBridgeConfig, SapProviderConfig, SapContextValue, } from './types';
+export { SAP_PROGRAM_ID, SapDependencyError, } from './types';
+export { SynapseAnchorSap } from './client';
+export type { SapContextBlueprint, SapStateManager, } from './provider';
+export { createSapProvider, createSapContextBlueprint, } from './provider';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/ai/sap/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai/sap/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAGH,YAAY,EACV,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,yBAAyB,EACzB,8BAA8B,EAC9B,aAAa,EACb,aAAa,EACb,eAAe,EACf,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAExC,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,WAAW,EACX,WAAW,GACZ,MAAM,OAAO,CAAC;AAGf,OAAO,EACL,qBAAqB,EACrB,eAAe,GAChB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,YAAY,EACZ,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,yBAAyB,GAC1B,MAAM,WAAW,CAAC;AAGnB,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,YAAY,EACZ,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai/sap/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEG;AAGH,YAAY,EACV,SAAS,EACT,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,eAAe,GAChB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,cAAc,EACd,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG5C,YAAY,EACV,mBAAmB,EACnB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,YAAY,CAAC"}

package/dist/cjs/ai/sap/index.js

@@ -1,89 +1,85 @@
 "use strict";
 /**
  * @module ai/sap
- * @description Solana Agent Protocol (SAP) — On-chain agent identity, discovery & reputation.
+ * @description Solana Agent Protocol (SAP) — Integration bridge for `@oobe-protocol-labs/synapse-sap-sdk`.
  *
- * Sub-modules:
- *  - `types`     — PDA account schema, instruction params, filter types
- *  - `pda`       — PDA derivation, Borsh serialization/deserialization
- *  - `program`   — Transaction instruction builders (register, update, deactivate)
- *  - `discovery` — On-chain agent search via `getProgramAccounts`
- *  - `adapter`   — {@link OnChainPersistenceAdapter} for {@link AgentRegistry}
+ * This module provides a **thin integration layer** that connects the
+ * Synapse Client SDK's infrastructure (network resolution, endpoint
+ * registry, HMR-safe singletons) with the standalone SAP SDK for
+ * on-chain agent operations.
  *
- * @example
+ * ## What moved
+ *
+ * The full SAP protocol implementation (PDA derivation, Borsh
+ * serialization, instruction builders, discovery, validation,
+ * subnetworks, scoring) now lives in:
+ *
+ *  - **Protocol (Anchor/Rust)**: https://github.com/OOBE-PROTOCOL/synapse-sap
+ *  - **SAP SDK (TypeScript)**: https://github.com/OOBE-PROTOCOL/synapse-sap-sdk
+ *    → `@oobe-protocol-labs/synapse-sap-sdk`
+ *
+ * ## What this module provides
+ *
+ *  - {@link SynapseAnchorSap} — Bridge class: resolves Synapse endpoints,
+ *    creates an Anchor provider, and initializes a `SapClient` in one call.
+ *    Exposes all SapClient modules as getters (`agent`, `builder`, `session`,
+ *    `escrow`, `tools`, `discovery`, `feedback`, `attestation`).
+ *
+ *  - {@link createSapProvider} — HMR-safe singleton factory for Next.js
+ *    server-side routes (same pattern as `createSynapseProvider`).
+ *
+ *  - {@link createSapContextBlueprint} — React integration blueprint with
+ *    typed context value, state manager, and subscription support — all
+ *    without a React dependency.
+ *
+ * ## Quick start
+ *
+ * @example Standalone (Node.js / scripts)
+ * ```ts
+ * import { SynapseAnchorSap } from '@oobe-protocol-labs/synapse-client-sdk/ai/sap';
+ *
+ * const sap = SynapseAnchorSap.create({ wallet });
+ * await sap.builder
+ *   .agent('TradeBot')
+ *   .description('Jupiter swap agent')
+ *   .addCapability('jupiter:swap', { protocol: 'jupiter', version: '6.0' })
+ *   .register();
+ * ```
+ *
+ * @example From existing SynapseClient
  * ```ts
- * import {
- *   SAPInstructionBuilder,
- *   SAPDiscovery,
- *   OnChainPersistenceAdapter,
- *   deriveAgentPDA,
- * } from '@oobe-protocol-labs/synapse-client-sdk/ai';
- *
- * // 1. Derive PDA address
- * const pda = deriveAgentPDA(walletPubkey, programId);
- *
- * // 2. Build registration instruction
- * const builder = new SAPInstructionBuilder({ programId });
- * const ix = builder.register({
- *   walletPubkey,
- *   name: 'My DeFi Agent',
- *   description: 'Jupiter + Raydium tools',
- *   capabilities: [{ id: 'jupiter:swap' }, { id: 'raydium:pool_info' }],
- *   pricing: [{ tierId: 'standard', pricePerCall: 1000n, rateLimit: 10, maxCallsPerSession: 100, tokenType: 'USDC' }],
- *   x402Endpoint: 'https://myagent.xyz/.well-known/x402',
- * });
- *
- * // 3. Discover agents on-chain
- * const discovery = new SAPDiscovery(client, { programId });
- * const agents = await discovery.find({ capability: 'jupiter:swap', minReputation: 700 });
- *
- * // 4. Use as persistence adapter for AgentRegistry
- * const adapter = new OnChainPersistenceAdapter(client, { programId });
- * const registry = new AgentRegistry({ adapter });
+ * import { SynapseClient } from '@oobe-protocol-labs/synapse-client-sdk';
+ * import { SynapseAnchorSap } from '@oobe-protocol-labs/synapse-client-sdk/ai/sap';
+ *
+ * const client = new SynapseClient({ endpoint: process.env.SYNAPSE_RPC! });
+ * const sap = SynapseAnchorSap.fromSynapseClient(client, wallet);
+ * ```
+ *
+ * @example Next.js server-side (HMR-safe)
+ * ```ts
+ * import { createSapProvider } from '@oobe-protocol-labs/synapse-client-sdk/ai/sap';
+ * const getSap = createSapProvider(serverWallet, { network: SynapseNetwork.Mainnet });
+ * const sap = getSap();
+ * ```
+ *
+ * @example Next.js client-side (React context)
+ * ```tsx
+ * import { createSapContextBlueprint } from '@oobe-protocol-labs/synapse-client-sdk/ai/sap';
+ * const blueprint = createSapContextBlueprint({ network: SynapseNetwork.Mainnet });
+ * // Wire into your React provider — see provider.ts JSDoc for full example
  * ```
  *
- * @since 1.3.0
+ * @since 2.1.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.computeNetworkAnalytics = exports.computeAgentHealthScore = exports.SubnetworkBuilder = exports.SAPValidationError = exports.SAPValidator = exports.SAPCapabilityRegistry = exports.OnChainPersistenceAdapter = exports.SAPDiscoveryError = exports.SAPDiscovery = exports.SAPProgramError = exports.SAPInstructionBuilder = exports.BorshWriter = exports.BorshReader = exports.isOnCurve = exports.base58Encode = exports.base58Decode = exports.serializeUpdateData = exports.serializeRegisterData = exports.deserializeAgentAccount = exports.deriveAgentPDA = exports.estimateTotalCost = exports.computeCallCost = exports.pricingToTier = exports.pdaToIdentity = exports.SAP_INSTRUCTION_DISCRIMINATORS = exports.SAP_ACCOUNT_DISCRIMINATOR = exports.SAP_SEED_PREFIX = exports.SAP_DEFAULT_PROGRAM_ID = void 0;
+exports.createSapContextBlueprint = exports.createSapProvider = exports.SynapseAnchorSap = exports.SapDependencyError = exports.SAP_PROGRAM_ID = void 0;
 var types_1 = require("./types");
-Object.defineProperty(exports, "SAP_DEFAULT_PROGRAM_ID", { enumerable: true, get: function () { return types_1.SAP_DEFAULT_PROGRAM_ID; } });
-Object.defineProperty(exports, "SAP_SEED_PREFIX", { enumerable: true, get: function () { return types_1.SAP_SEED_PREFIX; } });
-Object.defineProperty(exports, "SAP_ACCOUNT_DISCRIMINATOR", { enumerable: true, get: function () { return types_1.SAP_ACCOUNT_DISCRIMINATOR; } });
-Object.defineProperty(exports, "SAP_INSTRUCTION_DISCRIMINATORS", { enumerable: true, get: function () { return types_1.SAP_INSTRUCTION_DISCRIMINATORS; } });
-Object.defineProperty(exports, "pdaToIdentity", { enumerable: true, get: function () { return types_1.pdaToIdentity; } });
-Object.defineProperty(exports, "pricingToTier", { enumerable: true, get: function () { return types_1.pricingToTier; } });
-Object.defineProperty(exports, "computeCallCost", { enumerable: true, get: function () { return types_1.computeCallCost; } });
-Object.defineProperty(exports, "estimateTotalCost", { enumerable: true, get: function () { return types_1.estimateTotalCost; } });
-var pda_1 = require("./pda");
-Object.defineProperty(exports, "deriveAgentPDA", { enumerable: true, get: function () { return pda_1.deriveAgentPDA; } });
-Object.defineProperty(exports, "deserializeAgentAccount", { enumerable: true, get: function () { return pda_1.deserializeAgentAccount; } });
-Object.defineProperty(exports, "serializeRegisterData", { enumerable: true, get: function () { return pda_1.serializeRegisterData; } });
-Object.defineProperty(exports, "serializeUpdateData", { enumerable: true, get: function () { return pda_1.serializeUpdateData; } });
-Object.defineProperty(exports, "base58Decode", { enumerable: true, get: function () { return pda_1.base58Decode; } });
-Object.defineProperty(exports, "base58Encode", { enumerable: true, get: function () { return pda_1.base58Encode; } });
-Object.defineProperty(exports, "isOnCurve", { enumerable: true, get: function () { return pda_1.isOnCurve; } });
-Object.defineProperty(exports, "BorshReader", { enumerable: true, get: function () { return pda_1.BorshReader; } });
-Object.defineProperty(exports, "BorshWriter", { enumerable: true, get: function () { return pda_1.BorshWriter; } });
-/* ── Program ── */
-var program_1 = require("./program");
-Object.defineProperty(exports, "SAPInstructionBuilder", { enumerable: true, get: function () { return program_1.SAPInstructionBuilder; } });
-Object.defineProperty(exports, "SAPProgramError", { enumerable: true, get: function () { return program_1.SAPProgramError; } });
-/* ── Discovery ── */
-var discovery_1 = require("./discovery");
-Object.defineProperty(exports, "SAPDiscovery", { enumerable: true, get: function () { return discovery_1.SAPDiscovery; } });
-Object.defineProperty(exports, "SAPDiscoveryError", { enumerable: true, get: function () { return discovery_1.SAPDiscoveryError; } });
-/* ── Adapter ── */
-var adapter_1 = require("./adapter");
-Object.defineProperty(exports, "OnChainPersistenceAdapter", { enumerable: true, get: function () { return adapter_1.OnChainPersistenceAdapter; } });
-var registry_1 = require("./registry");
-Object.defineProperty(exports, "SAPCapabilityRegistry", { enumerable: true, get: function () { return registry_1.SAPCapabilityRegistry; } });
-var validator_1 = require("./validator");
-Object.defineProperty(exports, "SAPValidator", { enumerable: true, get: function () { return validator_1.SAPValidator; } });
-Object.defineProperty(exports, "SAPValidationError", { enumerable: true, get: function () { return validator_1.SAPValidationError; } });
-var subnetwork_1 = require("./subnetwork");
-Object.defineProperty(exports, "SubnetworkBuilder", { enumerable: true, get: function () { return subnetwork_1.SubnetworkBuilder; } });
-var scoring_1 = require("./scoring");
-Object.defineProperty(exports, "computeAgentHealthScore", { enumerable: true, get: function () { return scoring_1.computeAgentHealthScore; } });
-Object.defineProperty(exports, "computeNetworkAnalytics", { enumerable: true, get: function () { return scoring_1.computeNetworkAnalytics; } });
+Object.defineProperty(exports, "SAP_PROGRAM_ID", { enumerable: true, get: function () { return types_1.SAP_PROGRAM_ID; } });
+Object.defineProperty(exports, "SapDependencyError", { enumerable: true, get: function () { return types_1.SapDependencyError; } });
+/* ── Client bridge ── */
+var client_1 = require("./client");
+Object.defineProperty(exports, "SynapseAnchorSap", { enumerable: true, get: function () { return client_1.SynapseAnchorSap; } });
+var provider_1 = require("./provider");
+Object.defineProperty(exports, "createSapProvider", { enumerable: true, get: function () { return provider_1.createSapProvider; } });
+Object.defineProperty(exports, "createSapContextBlueprint", { enumerable: true, get: function () { return provider_1.createSapContextBlueprint; } });
 //# sourceMappingURL=index.js.map