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

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

@@ -1,210 +1,33 @@
 /**
  * @module ai/sap/types
- * @description Solana Agent Protocol (SAP) — Core type definitions.
+ * @description Integration types for the SAP bridge layer.
  *
- * Defines the on-chain account layout for agent identity, capability
- * registration, pricing, and reputation stored as Solana PDAs.
+ * Defines the configuration, wallet interface, and context shapes
+ * used by {@link SynapseAnchorSap} to connect the Synapse Client SDK
+ * with the standalone SAP SDK (`@oobe-protocol-labs/synapse-sap-sdk`).
  *
- * Account layout (Borsh-compatible):
- * ```
- * [0..8]    u8[8]   Anchor discriminator
- * [8]       u8      version (1)
- * [9]       u8      is_active (0 | 1)
- * [10..42]  u8[32]  wallet pubkey (raw bytes)
- * [42..50]  i64     created_at (unix ms)
- * [50..58]  i64     updated_at (unix ms)
- * [58..66]  u64     total_calls_served
- * [66..70]  u32     avg_latency_ms
- * [70]      u8      uptime_percent (0-100)
- * [71..]    Borsh   name (string), description (string),
- *                   capabilities (Vec<string>),
- *                   pricing tiers (Vec<AgentPricingOnChain>),
- *                   x402_endpoint (Option<string>)
- * ```
- *
- * @since 1.3.0
+ * @since 2.1.0
  */
 /* ═══════════════════════════════════════════════════════════════
- *  Program Constants
+ *  Constants
  * ═══════════════════════════════════════════════════════════════ */
 /**
- * @description Default SAP program ID. Replace with your own deployed program.
- * This is a placeholder — deploy the SAP Anchor program and set your ID.
- * @since 1.3.0
- */
-export const SAP_DEFAULT_PROGRAM_ID = 'SAPAgnt1111111111111111111111111111111111111';
-/**
- * @description PDA seed prefix used for all agent PDAs.
- * Seeds: `["synapse_agent", wallet_pubkey_bytes]`
- * @since 1.3.0
- */
-export const SAP_SEED_PREFIX = 'synapse_agent';
-/**
- * @description Anchor discriminator for the AgentAccount type.
- * Computed as: `sha256("account:AgentAccount")[0..8]`
- * @since 1.3.0
- */
-export const SAP_ACCOUNT_DISCRIMINATOR = new Uint8Array([
-    0x9b, 0x56, 0x1c, 0xa4, 0x7f, 0x3e, 0x21, 0xd8,
-]);
-/**
- * @description Instruction discriminators for SAP program methods.
- * Computed as: `sha256("global:<method_name>")[0..8]`
- * @since 1.3.0
- */
-export const SAP_INSTRUCTION_DISCRIMINATORS = {
-    register: new Uint8Array([0x18, 0xac, 0x2e, 0x6b, 0x01, 0xf9, 0x7c, 0xd4]),
-    update: new Uint8Array([0x27, 0x5d, 0x4b, 0x8e, 0x03, 0xa1, 0x6f, 0xb2]),
-    deactivate: new Uint8Array([0x34, 0x6e, 0x5a, 0x9f, 0x02, 0xb3, 0x5d, 0xc1]),
-    updateReputation: new Uint8Array([0x41, 0x7f, 0x6b, 0xa0, 0x04, 0xc2, 0x4e, 0xd3]),
-};
-/**
- * @description Conversion helpers to bridge SAP types to gateway types.
- * @since 1.3.0
- */
-export function pdaToIdentity(pda) {
-    return {
-        id: (pda.agentId ?? `did:sap:${pda.walletPubkey}`),
-        name: pda.name,
-        walletPubkey: pda.walletPubkey,
-        description: pda.description,
-        tags: pda.capabilities.map(c => c.id),
-        createdAt: pda.createdAt,
-    };
-}
-/**
- * @description Convert on-chain pricing to gateway PricingTier.
- * @param {AgentPricingOnChain} p - On-chain pricing entry
- * @returns {PricingTier} Gateway-compatible pricing tier
- * @since 1.3.0
- */
-export function pricingToTier(p) {
-    const token = p.tokenType === 'SOL' ? { type: 'SOL' } :
-        p.tokenType === 'USDC' ? { type: 'USDC' } :
-            { type: 'SPL', mint: p.tokenMint ?? '', decimals: p.tokenDecimals ?? 6 };
-    return {
-        id: p.tierId,
-        label: p.tierId,
-        pricePerCall: p.pricePerCall,
-        maxCallsPerSession: p.maxCallsPerSession,
-        rateLimit: p.rateLimit,
-        token,
-        includesAttestation: true,
-    };
-}
-/**
- * @description Compute the cost of a specific call number using volume curve pricing.
- *
- * Evaluates the agent's volume curve to determine the price for the Nth call.
- * This implements ERC-8004-style metered billing natively on Solana.
- *
- * @param {AgentPricingOnChain} pricing - The pricing tier
- * @param {number} callNumber - The call number (1-indexed, cumulative across sessions)
- * @returns {bigint} Cost of this specific call in smallest token unit
- *
- * @example
- * ```ts
- * const pricing = {
- *   tierId: 'base',
- *   pricePerCall: 1000n,       // 0.001 USDC base price
- *   volumeCurve: [
- *     { afterCalls: 100, pricePerCall: 800n },   // 20% off after 100 calls
- *     { afterCalls: 1000, pricePerCall: 500n },   // 50% off after 1000 calls
- *   ],
- *   // ...
- * };
+ * Canonical SAP program ID (mainnet deployment).
  *
- * computeCallCost(pricing, 1);    // → 1000n (base price)
- * computeCallCost(pricing, 101);  // → 800n  (first discount tier)
- * computeCallCost(pricing, 1001); // → 500n  (second discount tier)
- * ```
- *
- * @since 1.4.0
+ * This is the default used when no `programId` is specified.
+ * It matches `SAP_PROGRAM_ID` from `@oobe-protocol-labs/synapse-sap-sdk`.
  */
-export function computeCallCost(pricing, callNumber) {
-    let price = pricing.pricePerCall;
-    if (pricing.volumeCurve && pricing.volumeCurve.length > 0) {
-        // Sort breakpoints by afterCalls ascending
-        const sorted = [...pricing.volumeCurve].sort((a, b) => a.afterCalls - b.afterCalls);
-        for (const bp of sorted) {
-            if (callNumber > bp.afterCalls) {
-                price = bp.pricePerCall;
-            }
-            else {
-                break;
-            }
-        }
-    }
-    // Enforce floor/ceiling
-    if (pricing.minPricePerCall !== undefined && price < pricing.minPricePerCall) {
-        price = pricing.minPricePerCall;
-    }
-    if (pricing.maxPricePerCall !== undefined && price > pricing.maxPricePerCall) {
-        price = pricing.maxPricePerCall;
-    }
-    return price;
-}
+export const SAP_PROGRAM_ID = 'SAPTU7aUXk2AaAdktexae1iuxXpokxzNDBAYYhaVyQL';
 /**
- * @description Estimate total cost for N calls using the volume curve.
- *
- * @param {AgentPricingOnChain} pricing - The pricing tier
- * @param {number} totalCalls - Total number of calls
- * @param {number} [startingFrom=1] - Starting call number (for continuing sessions)
- * @returns {{ totalCost: bigint; avgPricePerCall: bigint; breakdown: Array<{ from: number; to: number; pricePerCall: bigint; subtotal: bigint }> }}
- *
- * @example
- * ```ts
- * const estimate = estimateTotalCost(pricing, 1500);
- * // estimate.totalCost    → 850_000n
- * // estimate.avgPricePerCall → 566n
- * // estimate.breakdown → [
- * //   { from: 1, to: 100, pricePerCall: 1000n, subtotal: 100_000n },
- * //   { from: 101, to: 1000, pricePerCall: 800n, subtotal: 720_000n },
- * //   { from: 1001, to: 1500, pricePerCall: 500n, subtotal: 250_000n },
- * // ]
- * ```
- *
- * @since 1.4.0
+ * Error thrown when a required peer dependency is missing.
  */
-export function estimateTotalCost(pricing, totalCalls, startingFrom = 1) {
-    if (totalCalls <= 0) {
-        return { totalCost: 0n, avgPricePerCall: 0n, breakdown: [] };
-    }
-    const curve = pricing.volumeCurve && pricing.volumeCurve.length > 0
-        ? [...pricing.volumeCurve].sort((a, b) => a.afterCalls - b.afterCalls)
-        : [];
-    // Build segments: [0, bp1, bp2, ...] with corresponding prices
-    const segments = [
-        { afterCalls: 0, pricePerCall: pricing.pricePerCall },
-        ...curve,
-    ];
-    const endCall = startingFrom + totalCalls - 1;
-    const breakdown = [];
-    let totalCost = 0n;
-    for (let i = 0; i < segments.length; i++) {
-        const segStart = segments[i].afterCalls + 1;
-        const segEnd = i + 1 < segments.length ? segments[i + 1].afterCalls : Infinity;
-        let price = segments[i].pricePerCall;
-        // Enforce floor/ceiling
-        if (pricing.minPricePerCall !== undefined && price < pricing.minPricePerCall)
-            price = pricing.minPricePerCall;
-        if (pricing.maxPricePerCall !== undefined && price > pricing.maxPricePerCall)
-            price = pricing.maxPricePerCall;
-        const rangeStart = Math.max(segStart, startingFrom);
-        const rangeEnd = Math.min(segEnd, endCall);
-        if (rangeStart > rangeEnd)
-            continue;
-        const count = rangeEnd - rangeStart + 1;
-        const subtotal = price * BigInt(count);
-        totalCost += subtotal;
-        breakdown.push({
-            from: rangeStart,
-            to: rangeEnd,
-            pricePerCall: price,
-            subtotal,
-        });
+export class SapDependencyError extends Error {
+    name = 'SapDependencyError';
+    packageName;
+    constructor(packageName) {
+        super(`Missing peer dependency: ${packageName} is required for SAP integration. ` +
+            `Install it: pnpm add ${packageName}`);
+        this.packageName = packageName;
     }
-    const avgPricePerCall = totalCalls > 0 ? totalCost / BigInt(totalCalls) : 0n;
-    return { totalCost, avgPricePerCall, breakdown };
 }
 //# sourceMappingURL=types.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/ai/sap/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH;;qEAEqE;AAErE;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,8CAA8C,CAAC;AAErF;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,eAAe,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,UAAU,CAAC;IACtD,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CAC/C,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,QAAQ,EAAE,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1E,MAAM,EAAE,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACxE,UAAU,EAAE,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5E,gBAAgB,EAAE,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;CAC1E,CAAC;AAgVX;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAoB;IAChD,OAAO;QACL,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,IAAI,WAAW,GAAG,CAAC,YAAY,EAAE,CAAY;QAC7D,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,IAAI,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,CAAsB;IAClD,MAAM,KAAK,GACT,CAAC,CAAC,SAAS,KAAK,KAAK,CAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1C,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACjB,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,aAAa,IAAI,CAAC,EAAE,CAAC;IAErG,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,MAAM;QACZ,KAAK,EAAE,CAAC,CAAC,MAAM;QACf,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,kBAAkB,EAAE,CAAC,CAAC,kBAAkB;QACxC,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,KAAK;QACL,mBAAmB,EAAE,IAAI;KAC1B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,eAAe,CAAC,OAA4B,EAAE,UAAkB;IAC9E,IAAI,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC;IAEjC,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,2CAA2C;QAC3C,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;QAEpF,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;YACxB,IAAI,UAAU,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC;gBAC/B,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACN,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,KAAK,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;QAC7E,KAAK,GAAG,OAAO,CAAC,eAAe,CAAC;IAClC,CAAC;IACD,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,KAAK,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;QAC7E,KAAK,GAAG,OAAO,CAAC,eAAe,CAAC;IAClC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAA4B,EAC5B,UAAkB,EAClB,YAAY,GAAG,CAAC;IAMhB,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC/D,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;QACjE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;QACtE,CAAC,CAAC,EAAE,CAAC;IAEP,+DAA+D;IAC/D,MAAM,QAAQ,GAAwD;QACpE,EAAE,UAAU,EAAE,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE;QACrD,GAAG,KAAK;KACT,CAAC;IAEF,MAAM,OAAO,GAAG,YAAY,GAAG,UAAU,GAAG,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAgF,EAAE,CAAC;IAClG,IAAI,SAAS,GAAG,EAAE,CAAC;IAEnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC/E,IAAI,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;QAErC,wBAAwB;QACxB,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,KAAK,GAAG,OAAO,CAAC,eAAe;YAAE,KAAK,GAAG,OAAO,CAAC,eAAe,CAAC;QAC9G,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,KAAK,GAAG,OAAO,CAAC,eAAe;YAAE,KAAK,GAAG,OAAO,CAAC,eAAe,CAAC;QAE9G,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAE3C,IAAI,UAAU,GAAG,QAAQ;YAAE,SAAS;QAEpC,MAAM,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QACvC,SAAS,IAAI,QAAQ,CAAC;QAEtB,SAAS,CAAC,IAAI,CAAC;YACb,IAAI,EAAE,UAAU;YAChB,EAAE,EAAE,QAAQ;YACZ,YAAY,EAAE,KAAK;YACnB,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IAED,MAAM,eAAe,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE7E,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC;AACnD,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/ai/sap/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH;;qEAEqE;AAErE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,6CAA6C,CAAC;AAsJ5E;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACzB,IAAI,GAAG,oBAAoB,CAAC;IACrC,WAAW,CAAS;IAE7B,YAAY,WAAmB;QAC7B,KAAK,CACH,4BAA4B,WAAW,oCAAoC;YAC3E,wBAAwB,WAAW,EAAE,CACtC,CAAC;QACF,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oobe-protocol-labs/synapse-client-sdk",
-  "version": "2.0.2",
+  "version": "2.0.5",
   "description": "Synapse Client SDK -- Typed Solana RPC gateway with @solana/kit native types, 53 JSON-RPC methods, DAS, WebSocket, gRPC/Geyser parser, 110+ plugin-based AI tools (Token, NFT, DeFi, Misc, Blinks), MCP server & client, and x402 payments | Powered by oobeprotocol.ai (OOBE)",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -251,23 +251,6 @@
       ]
     }
   },
-  "scripts": {
-    "build": "rm -rf dist && tsc -p tsconfig.cjs.json && tsc -p tsconfig.esm.json && node scripts/fix-esm-imports.mjs && pnpm run -s build:docs",
-    "build:docs": "typedoc --out dist/docs src/index.ts && cp -r dist/docs docs && touch docs/.nojekyll",
-    "docs": "typedoc --out docs src/index.ts",
-    "win-build": "rimraf dist && tsc -p tsconfig.cjs.json && tsc -p tsconfig.esm.json && pnpm run -s win-build:docs",
-    "win-build:docs": "typedoc --out dist/docs src/index.ts || echo 'typedoc not found, skipping docs build'",
-    "dev": "tsc --watch",
-    "lint": "eslint src/**/*.ts --fix",
-    "lint:check": "eslint src/**/*.ts",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "pnpm build",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "benchmark": "node benchmark/performance.mjs",
-    "stress-test": "node benchmark/stress-test.mjs"
-  },
   "keywords": [
     "solana",
     "solana-kit",
@@ -320,7 +303,10 @@
     "typescript": ">=5.0.0",
     "zod": ">=3.23.0 || >=4.0.0",
     "ioredis": ">=5.0.0",
-    "pg": ">=8.0.0"
+    "pg": ">=8.0.0",
+    "@oobe-protocol-labs/synapse-sap-sdk": ">=0.1.0",
+    "@coral-xyz/anchor": ">=0.30.0",
+    "@solana/web3.js": ">=1.90.0"
   },
   "peerDependenciesMeta": {
     "zod": {
@@ -334,6 +320,15 @@
     },
     "pg": {
       "optional": true
+    },
+    "@oobe-protocol-labs/synapse-sap-sdk": {
+      "optional": true
+    },
+    "@coral-xyz/anchor": {
+      "optional": true
+    },
+    "@solana/web3.js": {
+      "optional": true
     }
   },
   "engines": {
@@ -346,5 +341,21 @@
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.cjs.json && tsc -p tsconfig.esm.json && node scripts/fix-esm-imports.mjs && pnpm run -s build:docs",
+    "build:docs": "typedoc --out dist/docs src/index.ts && cp -r dist/docs docs && touch docs/.nojekyll",
+    "docs": "typedoc --out docs src/index.ts",
+    "win-build": "rimraf dist && tsc -p tsconfig.cjs.json && tsc -p tsconfig.esm.json && pnpm run -s win-build:docs",
+    "win-build:docs": "typedoc --out dist/docs src/index.ts || echo 'typedoc not found, skipping docs build'",
+    "dev": "tsc --watch",
+    "lint": "eslint src/**/*.ts --fix",
+    "lint:check": "eslint src/**/*.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "benchmark": "node benchmark/performance.mjs",
+    "stress-test": "node benchmark/stress-test.mjs"
   }
-}
+}

package/dist/cjs/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/cjs/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/cjs/ai/sap/adapter.js

@@ -1,181 +0,0 @@
-"use strict";
-/**
- * @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
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.OnChainPersistenceAdapter = void 0;
-const types_1 = require("./types");
-const discovery_1 = require("./discovery");
-/* ═══════════════════════════════════════════════════════════════
- *  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
- */
-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 discovery_1.SAPDiscovery(client, {
-            programId: config?.programId ?? types_1.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: (0, types_1.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: (0, types_1.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();
-    }
-}
-exports.OnChainPersistenceAdapter = OnChainPersistenceAdapter;
-//# sourceMappingURL=adapter.js.map

package/dist/cjs/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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"}