@oobe-protocol-labs/synapse-sap-sdk 0.8.0 → 0.9.2

package/dist/cjs/core/client.js

@@ -49,6 +49,7 @@ const discovery_1 = require("../registries/discovery");
 const x402_1 = require("../registries/x402");
 const session_1 = require("../registries/session");
 const builder_1 = require("../registries/builder");
+const metaplex_bridge_1 = require("../registries/metaplex-bridge");
 // IDL is embedded inside the SDK — no external workspace dependency
 const synapse_agent_sap_json_1 = __importDefault(require("../idl/synapse_agent_sap.json"));
 /**
@@ -126,6 +127,7 @@ class SapClient {
     #discovery;
     #x402;
     #session;
+    #metaplex;
     constructor(program) {
         this.program = program;
         this.walletPubkey = program.provider.wallet.publicKey;
@@ -464,6 +466,35 @@ class SapClient {
     get builder() {
         return new builder_1.AgentBuilder(this.program);
     }
+    /**
+     * @name metaplex
+     * @description Bridge between SAP and the Metaplex Agent Kit
+     * (MPL Core Asset + AgentIdentity plugin). Read-side merges SAP
+     * `AgentAccount` with MPL Core asset metadata; write-side composes
+     * atomic dual-protocol delegation instructions.
+     *
+     * Requires the optional peer dependencies
+     * `@metaplex-foundation/mpl-core` and
+     * `@metaplex-foundation/umi-bundle-defaults`. They are imported lazily
+     * the first time a method that needs them is called, so consumers that
+     * do not use the bridge incur zero overhead.
+     *
+     * @returns {MetaplexBridge} The lazily-instantiated `MetaplexBridge` singleton.
+     * @category Registries
+     * @since v0.9.0
+     * @see {@link MetaplexBridge}
+     *
+     * @example
+     * ```ts
+     * const profile = await client.metaplex.getUnifiedProfile({
+     *   wallet: agentWallet,
+     *   rpcUrl: "https://api.mainnet-beta.solana.com",
+     * });
+     * ```
+     */
+    get metaplex() {
+        return (this.#metaplex ??= new metaplex_bridge_1.MetaplexBridge(this.program));
+    }
 }
 exports.SapClient = SapClient;
 //# sourceMappingURL=client.js.map

package/dist/cjs/core/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/core/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/core/client.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;;;;;AAEH,8CAAiE;AAEjE,4CAA8C;AAC9C,4CAA+C;AAC/C,kDAAqD;AACrD,kDAAqD;AACrD,4CAA+C;AAC/C,4CAA+C;AAC/C,8CAAiD;AACjD,oDAAsD;AACtD,gDAAmD;AACnD,gDAAmD;AACnD,0DAA6D;AAC7D,wDAA2D;AAC3D,8CAAiD;AACjD,sCAAwC;AACxC,6CAAqD;AACrD,uDAA4D;AAC5D,6CAAkD;AAClD,mDAAuD;AACvD,mDAAqD;AACrD,mEAA+D;AAE/D,oEAAoE;AACpE,2FAAgD;AAMhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAa,SAAS;IACpB;;;;;;;OAOG;IACM,OAAO,CAAa;IAE7B;;;;;;;;OAQG;IACM,YAAY,CAAY;IAEjC,qDAAqD;IACrD,MAAM,CAAe;IACrB,SAAS,CAAkB;IAC3B,SAAS,CAAkB;IAC3B,MAAM,CAAe;IACrB,MAAM,CAAe;IACrB,OAAO,CAAgB;IACvB,SAAS,CAAkB;IAC3B,QAAQ,CAAiB;IACzB,QAAQ,CAAiB;IACzB,aAAa,CAAsB;IACnC,YAAY,CAAqB;IACjC,OAAO,CAAgB;IACvB,OAAO,CAAe;IAEtB,iDAAiD;IACjD,OAAO,CAAqB;IAE5B,qDAAqD;IACrD,UAAU,CAAqB;IAC/B,KAAK,CAAgB;IACrB,QAAQ,CAAkB;IAC1B,SAAS,CAAkB;IAE3B,YAAoB,OAAmB;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,YAAY,GAAI,OAAO,CAAC,QAA2B,CAAC,MAAM,CAAC,SAAS,CAAC;IAC5E,CAAC;IAED,gDAAgD;IAChD,mBAAmB;IACnB,gDAAgD;IAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,MAAM,CAAC,IAAI,CACT,QAAwB,EACxB,YAAuB,0BAAc;QAErC,8DAA8D;QAC9D,MAAM,OAAO,GAAG,IAAI,gBAAO,CAAC,gCAAU,EAAE,QAAQ,CAAC,CAAC;QAClD,qCAAqC;QACrC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,0BAAc,CAAC,EAAE,CAAC;YACtC,8DAA8D;YAC7D,OAAe,CAAC,SAAS,GAAG,SAAS,CAAC;QACzC,CAAC;QACD,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,WAAW,CAAC,OAAmB;QACpC,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED,gDAAgD;IAChD,sCAAsC;IACtC,gDAAgD;IAEhD;;;;;;;;OAQG;IACH,IAAI,KAAK;QACP,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,mBAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,QAAQ;QACV,OAAO,CAAC,IAAI,CAAC,SAAS,KAAK,IAAI,yBAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,QAAQ;QACV,OAAO,CAAC,IAAI,CAAC,SAAS,KAAK,IAAI,yBAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,KAAK;QACP,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,mBAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,KAAK;QACP,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,mBAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,MAAM;QACR,OAAO,CAAC,IAAI,CAAC,OAAO,KAAK,IAAI,qBAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,QAAQ;QACV,OAAO,CAAC,IAAI,CAAC,SAAS,KAAK,IAAI,0BAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,OAAO;QACT,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,uBAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,OAAO;QACT,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,uBAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,YAAY;QACd,OAAO,CAAC,IAAI,CAAC,aAAa,KAAK,IAAI,iCAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACvE,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,WAAW;QACb,OAAO,CAAC,IAAI,CAAC,YAAY,KAAK,IAAI,+BAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,MAAM;QACR,OAAO,CAAC,IAAI,CAAC,OAAO,KAAK,IAAI,qBAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,MAAM;QACR,OAAO,CAAC,IAAI,CAAC,OAAO,KAAK,IAAI,oBAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,MAAM;QACR,OAAO,CAAC,IAAI,CAAC,OAAO,KAAK,IAAI,0BAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,gDAAgD;IAChD,gDAAgD;IAChD,gDAAgD;IAEhD;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,SAAS;QACX,OAAO,CAAC,IAAI,CAAC,UAAU,KAAK,IAAI,6BAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,IAAI;QACN,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,mBAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,OAAO;QACT,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,wBAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,sBAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,IAAI,QAAQ;QACV,OAAO,CAAC,IAAI,CAAC,SAAS,KAAK,IAAI,gCAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,CAAC;CACF;AAxbD,8BAwbC"}

package/dist/cjs/index.js

@@ -47,7 +47,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deriveSubscription = exports.deriveStake = exports.deriveDispute = exports.derivePendingSettlement = exports.deriveEscrowV2 = exports.deriveEscrow = exports.deriveTool = exports.deriveCheckpoint = exports.deriveVaultDelegate = exports.deriveEpochPage = exports.deriveSession = exports.deriveVault = exports.deriveToolCategoryIndex = exports.deriveProtocolIndex = exports.deriveCapabilityIndex = exports.deriveFeedback = exports.deriveAgentStats = exports.deriveAgent = exports.deriveGlobalRegistry = exports.IDL_METADATA = exports.IDL_PROGRAM_ADDRESS = exports.SAP_IDL = exports.SapNetwork = exports.HTTP_METHOD_VALUES = exports.TOOL_CATEGORY_VALUES = exports.VAULT_PROTOCOL_VERSION = exports.AGENT_VERSION = exports.LIMITS = exports.SEEDS = exports.LOCALNET_SAP_PROGRAM_ID = exports.DEVNET_SAP_PROGRAM_ID = exports.MAINNET_SAP_PROGRAM_ID = exports.SAP_PROGRAM_ID = exports.SAP_PROGRAM_ADDRESS = exports.ResolutionLayer = exports.DisputeType = exports.BillingInterval = exports.DisputeOutcome = exports.SettlementSecurity = exports.CompressionType = exports.SchemaType = exports.DelegatePermission = exports.ToolCategory = exports.ToolHttpMethod = exports.SettlementMode = exports.PluginType = exports.TokenType = exports.KeypairWallet = exports.SapConnection = exports.SapClient = void 0;
 exports.SapError = exports.getX402DirectPayments = exports.parseX402Headers = exports.SapMerchantValidator = exports.MissingEscrowAtaError = exports.toAccountMetas = exports.attachSplAccounts = exports.validateEscrowState = exports.DEFAULT_BATCH_SETTLE_COMPUTE_UNITS = exports.DEFAULT_SETTLE_COMPUTE_UNITS = exports.DEFAULT_SETTLE_PRIORITY_FEE = exports.FAST_BATCH_SETTLE_OPTIONS = exports.FAST_SETTLE_OPTIONS = exports.buildRpcOptions = exports.buildPriorityFeeIxs = exports.validateOrThrow = exports.createCallArgsSchema = exports.createRegisterAgentSchema = exports.createPreparePaymentSchema = exports.createAgentManifestSchema = exports.createToolManifestEntrySchema = exports.createHealthCheckSchema = exports.createEndpointDescriptorSchema = exports.createEnvSchema = exports.extractAnchorErrorCode = exports.classifyAnchorError = exports.findATA = exports.createDualConnection = exports.getFallbackRpcUrl = exports.getRpcUrl = exports.validateAgentEndpoints = exports.validateHealthCheck = exports.validateEndpointDescriptor = exports.validateEndpoint = exports.isKnownNetwork = exports.getNetworkClusterName = exports.getNetworkGenesisHash = exports.isNetworkEquivalent = exports.normalizeNetworkId = exports.serializeValue = exports.serializeAccount = exports.assert = exports.hashToArray = exports.sha256 = exports.deriveReceiptBatch = exports.deriveLedgerPage = exports.deriveLedger = exports.deriveAttestation = exports.deriveIndexPage = exports.deriveShard = void 0;
-exports.AgentBuilder = exports.SessionManager = exports.X402Registry = exports.DiscoveryRegistry = exports.TransactionParser = exports.extractAccountKeys = exports.filterSapInnerInstructions = exports.decodeInnerInstructions = exports.parseSapTransactionBatch = exports.parseSapTransactionComplete = exports.containsSapInstruction = exports.parseSapInstructionNamesFromList = exports.parseSapInstructionsFromList = exports.parseSapInstructionNamesFromTransaction = exports.parseSapInstructionsFromTransaction = exports.SAP_TABLE_MAP = exports.SapSyncEngine = exports.SapPostgres = exports.SAP_PROTOCOLS = exports.SAPPlugin = exports.createSAPPlugin = exports.BaseModule = exports.LedgerModule = exports.AttestationModule = exports.SubscriptionModule = exports.StakingModule = exports.ReceiptModule = exports.EscrowV2Module = exports.EscrowModule = exports.VaultModule = exports.ToolsModule = exports.IndexingModule = exports.FeedbackModule = exports.AgentModule = exports.GeyserEventStream = exports.SAP_EVENT_NAMES = exports.EventParser = exports.SapPermissionError = exports.SapTimeoutError = exports.SapAccountNotFoundError = exports.SapRpcError = exports.SapValidationError = void 0;
+exports.MetaplexBridge = exports.AgentBuilder = exports.SessionManager = exports.X402Registry = exports.DiscoveryRegistry = exports.TransactionParser = exports.extractAccountKeys = exports.filterSapInnerInstructions = exports.decodeInnerInstructions = exports.parseSapTransactionBatch = exports.parseSapTransactionComplete = exports.containsSapInstruction = exports.parseSapInstructionNamesFromList = exports.parseSapInstructionsFromList = exports.parseSapInstructionNamesFromTransaction = exports.parseSapInstructionsFromTransaction = exports.SAP_TABLE_MAP = exports.SapSyncEngine = exports.SapPostgres = exports.SAP_PROTOCOLS = exports.SAPPlugin = exports.createSAPPlugin = exports.BaseModule = exports.LedgerModule = exports.AttestationModule = exports.SubscriptionModule = exports.StakingModule = exports.ReceiptModule = exports.EscrowV2Module = exports.EscrowModule = exports.VaultModule = exports.ToolsModule = exports.IndexingModule = exports.FeedbackModule = exports.AgentModule = exports.GeyserEventStream = exports.SAP_EVENT_NAMES = exports.EventParser = exports.SapPermissionError = exports.SapTimeoutError = exports.SapAccountNotFoundError = exports.SapRpcError = exports.SapValidationError = void 0;
 // ── Core ─────────────────────────────────────────────
 var core_1 = require("./core");
 Object.defineProperty(exports, "SapClient", { enumerable: true, get: function () { return core_1.SapClient; } });
@@ -231,4 +231,5 @@ Object.defineProperty(exports, "DiscoveryRegistry", { enumerable: true, get: fun
 Object.defineProperty(exports, "X402Registry", { enumerable: true, get: function () { return index_4.X402Registry; } });
 Object.defineProperty(exports, "SessionManager", { enumerable: true, get: function () { return index_4.SessionManager; } });
 Object.defineProperty(exports, "AgentBuilder", { enumerable: true, get: function () { return index_4.AgentBuilder; } });
+Object.defineProperty(exports, "MetaplexBridge", { enumerable: true, get: function () { return index_4.MetaplexBridge; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

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

package/dist/cjs/registries/index.js

@@ -39,7 +39,7 @@
  * @see {@link AgentBuilder}
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentBuilder = exports.SessionManager = exports.X402Registry = exports.DiscoveryRegistry = void 0;
+exports.MetaplexBridge = exports.AgentBuilder = exports.SessionManager = exports.X402Registry = exports.DiscoveryRegistry = void 0;
 var discovery_1 = require("./discovery");
 Object.defineProperty(exports, "DiscoveryRegistry", { enumerable: true, get: function () { return discovery_1.DiscoveryRegistry; } });
 var x402_1 = require("./x402");
@@ -48,4 +48,6 @@ var session_1 = require("./session");
 Object.defineProperty(exports, "SessionManager", { enumerable: true, get: function () { return session_1.SessionManager; } });
 var builder_1 = require("./builder");
 Object.defineProperty(exports, "AgentBuilder", { enumerable: true, get: function () { return builder_1.AgentBuilder; } });
+var metaplex_bridge_1 = require("./metaplex-bridge");
+Object.defineProperty(exports, "MetaplexBridge", { enumerable: true, get: function () { return metaplex_bridge_1.MetaplexBridge; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/registries/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;;;AAEH,yCAAgD;AAAvC,8GAAA,iBAAiB,OAAA;AAS1B,+BAAsC;AAA7B,oGAAA,YAAY,OAAA;AAYrB,qCAA2C;AAAlC,yGAAA,cAAc,OAAA;AASvB,qCAAyC;AAAhC,uGAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/registries/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;;;AAEH,yCAAgD;AAAvC,8GAAA,iBAAiB,OAAA;AAS1B,+BAAsC;AAA7B,oGAAA,YAAY,OAAA;AAYrB,qCAA2C;AAAlC,yGAAA,cAAc,OAAA;AASvB,qCAAyC;AAAhC,uGAAA,YAAY,OAAA;AASrB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA"}

package/dist/cjs/registries/metaplex-bridge.js

@@ -0,0 +1,513 @@
+"use strict";
+/**
+ * @module registries/metaplex-bridge
+ * @description Bridge between Synapse Agent Protocol (SAP) and Metaplex
+ * Core's `AgentIdentity` external plugin adapter (mpl-core ≥ 1.9.0).
+ *
+ * ## Why this design (verified against mpl-core PR #258, v1.9.0)
+ *
+ * The MPL Core `AgentIdentity` plugin has exactly one field:
+ *
+ * ```ts
+ * type AgentIdentity = { uri: string };
+ * ```
+ *
+ * The URI must point to an **EIP-8004** agent registration JSON. There is
+ * no on-chain executive list, no `addExecutive` / `delegateExecutionV1`
+ * instruction. Capabilities, services, executives, and reputation live
+ * off-chain in that JSON. The plugin only hooks the `Execute` lifecycle
+ * event, allowing the URI's authority to gate execution.
+ *
+ * The most efficient SAP × MPL integration therefore is:
+ *
+ *   1. SAP serves a **live EIP-8004 JSON** at a deterministic URL derived
+ *      from the SAP `AgentAccount` PDA (e.g.
+ *      `https://explorer.oobeprotocol.ai/agents/<sapAgentPda>/eip-8004.json`).
+ *   2. The MPL Core asset attaches an `AgentIdentity` adapter whose `uri`
+ *      points to that URL.
+ *   3. Every SAP write (capability change, vault delegate add/revoke, x402
+ *      tier update) is reflected in the JSON automatically — **no second
+ *      transaction required, on either chain or for any wallet.**
+ *
+ * One SAP transaction = both protocols updated. That is the efficiency
+ * win that motivated the Phase 1 redesign on 2026-04-22.
+ *
+ * @category Registries
+ * @since v0.9.0
+ * @see https://github.com/metaplex-foundation/mpl-core/pull/258
+ * @see https://eips.ethereum.org/EIPS/eip-8004
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetaplexBridge = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const pda_1 = require("../pda");
+// ═══════════════════════════════════════════════════════════════════
+//  Lazy peer-dep loader
+// ═══════════════════════════════════════════════════════════════════
+const PEER_DEP_INSTALL_HINT = "MetaplexBridge requires @metaplex-foundation/mpl-core (>=1.9.0) and " +
+    "@metaplex-foundation/umi-bundle-defaults. " +
+    "Install: npm i @metaplex-foundation/mpl-core @metaplex-foundation/umi-bundle-defaults";
+let cachedRuntime = null;
+async function loadMplCore() {
+    if (cachedRuntime)
+        return cachedRuntime;
+    try {
+        const [mplCore, umiBundle, umiCore] = await Promise.all([
+            Promise.resolve().then(() => __importStar(require("@metaplex-foundation/mpl-core"))),
+            Promise.resolve().then(() => __importStar(require("@metaplex-foundation/umi-bundle-defaults"))),
+            Promise.resolve().then(() => __importStar(require("@metaplex-foundation/umi"))),
+        ]);
+        cachedRuntime = { mplCore, umiBundle, umiCore };
+        return cachedRuntime;
+    }
+    catch (cause) {
+        throw new Error(PEER_DEP_INSTALL_HINT, { cause: cause });
+    }
+}
+// ═══════════════════════════════════════════════════════════════════
+//  MetaplexBridge
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name MetaplexBridge
+ * @description Read-side merger and write-side instruction composer for
+ * SAP × Metaplex Core `AgentIdentity` integration.
+ *
+ * Linking is **single-transaction**: the MPL `addExternalPluginAdapterV1`
+ * instruction sets a URI that points at SAP's live registration host.
+ * Subsequent SAP state changes propagate automatically — no extra MPL
+ * transaction required.
+ *
+ * @category Registries
+ * @since v0.9.0
+ */
+class MetaplexBridge {
+    program;
+    constructor(program) {
+        this.program = program;
+    }
+    // ─────────────────────────────────────────────────────
+    //  Pure helpers
+    // ─────────────────────────────────────────────────────
+    /**
+     * @name deriveRegistrationUrl
+     * @description Compute the deterministic EIP-8004 registration URL for
+     * a SAP agent. Hosts MUST serve the JSON at exactly this path so that
+     * {@link MetaplexBridge.verifyLink} validates without external config.
+     *
+     * @since v0.9.0
+     */
+    deriveRegistrationUrl(sapAgentPda, baseUrl) {
+        const trimmed = baseUrl.replace(/\/+$/, "");
+        return `${trimmed}/agents/${sapAgentPda.toBase58()}/eip-8004.json`;
+    }
+    /**
+     * @name buildEip8004Registration
+     * @description Build a canonical EIP-8004 JSON document for a SAP agent.
+     * Designed to be called server-side by a registry host.
+     *
+     * @since v0.9.0
+     */
+    async buildEip8004Registration(args) {
+        const [sapPda] = (0, pda_1.deriveAgent)(args.sapAgentOwner);
+        const identity = await this.fetchAgentNullable(sapPda);
+        if (!identity) {
+            throw new Error(`buildEip8004Registration: SAP agent not found for owner ${args.sapAgentOwner.toBase58()}`);
+        }
+        const delegates = await this.fetchActiveVaultDelegates(sapPda);
+        return {
+            version: "0.1",
+            name: this.readString(identity, "name") ?? "Synapse Agent",
+            description: this.readString(identity, "description") ?? undefined,
+            synapseAgent: sapPda.toBase58(),
+            authority: args.sapAgentOwner.toBase58(),
+            capabilities: this.readCapabilities(identity),
+            services: args.services ?? [],
+            executives: delegates,
+            updatedAt: new Date().toISOString(),
+            extra: args.extra,
+        };
+    }
+    // ─────────────────────────────────────────────────────
+    //  Write side — build MPL instructions only
+    // ─────────────────────────────────────────────────────
+    /**
+     * @name buildAttachAgentIdentityIx
+     * @description Build the MPL Core `addExternalPluginAdapterV1`
+     * `TransactionInstruction` that attaches an `AgentIdentity` plugin
+     * pointing at SAP's live EIP-8004 registration URL.
+     *
+     * @since v0.9.0
+     */
+    async buildAttachAgentIdentityIx(opts) {
+        const [sapPda] = (0, pda_1.deriveAgent)(opts.sapAgentOwner);
+        const uri = this.deriveRegistrationUrl(sapPda, opts.registrationBaseUrl);
+        return this.buildAddExternalPluginIx({
+            asset: opts.asset,
+            authority: opts.authority,
+            payer: opts.payer ?? opts.authority,
+            uri,
+            rpcUrl: opts.rpcUrl,
+        });
+    }
+    /**
+     * @name buildUpdateAgentIdentityUriIx
+     * @description Build the MPL Core `updateExternalPluginAdapterV1`
+     * instruction that re-points an existing `AgentIdentity` plugin.
+     *
+     * @since v0.9.0
+     */
+    async buildUpdateAgentIdentityUriIx(opts) {
+        const { mplCore, umiBundle, umiCore } = await loadMplCore();
+        const umi = umiBundle.createUmi(opts.rpcUrl).use(mplCore.mplCore());
+        const authority = umiCore.createNoopSigner(umiCore.publicKey(opts.authority.toBase58()));
+        const payer = umiCore.createNoopSigner(umiCore.publicKey((opts.payer ?? opts.authority).toBase58()));
+        const builder = mplCore.updateExternalPluginAdapterV1(umi, {
+            asset: umiCore.publicKey(opts.asset.toBase58()),
+            authority,
+            payer,
+            key: { __kind: "AgentIdentity" },
+            updateInfo: {
+                __kind: "AgentIdentity",
+                fields: [
+                    {
+                        uri: opts.newUri,
+                        lifecycleChecks: null,
+                    },
+                ],
+            },
+        });
+        return this.firstWeb3Ix(builder, "updateExternalPluginAdapterV1");
+    }
+    // ─────────────────────────────────────────────────────
+    //  Read side
+    // ─────────────────────────────────────────────────────
+    /**
+     * @name getUnifiedProfile
+     * @description Fetch a merged view of an agent across SAP and Metaplex.
+     * Provide `wallet` (SAP-first) or `asset` (MPL-first), or both.
+     *
+     * @since v0.9.0
+     */
+    async getUnifiedProfile(input) {
+        if (!input.wallet && !input.asset) {
+            throw new Error("getUnifiedProfile: provide `wallet` or `asset`");
+        }
+        let sapPda = null;
+        let identity = null;
+        let stats = null;
+        if (input.wallet) {
+            [sapPda] = (0, pda_1.deriveAgent)(input.wallet);
+            identity = await this.fetchAgentNullable(sapPda);
+            stats = await this.fetchStatsNullable(sapPda);
+        }
+        let mpl = null;
+        if (input.asset) {
+            mpl = await this.fetchMplSnapshot(input.asset, input.rpcUrl);
+            if (!sapPda && mpl?.registration?.synapseAgent) {
+                try {
+                    sapPda = new web3_js_1.PublicKey(mpl.registration.synapseAgent);
+                    identity = await this.fetchAgentNullable(sapPda);
+                    stats = await this.fetchStatsNullable(sapPda);
+                }
+                catch {
+                    /* invalid PDA in JSON */
+                }
+            }
+        }
+        if (!sapPda) {
+            throw new Error("getUnifiedProfile: failed to resolve SAP agent PDA");
+        }
+        return {
+            sap: { pda: sapPda, identity, stats },
+            mpl,
+            linked: this.detectLink(sapPda, mpl),
+        };
+    }
+    /**
+     * @name resolveAgentIdentifier
+     * @description Resolve a generic agent identifier to canonical SAP routing
+     * keys. Useful when callers may receive either owner wallets or Metaplex
+     * Core asset IDs (e.g. metaplex.com/agents/<core-asset-id>).
+     *
+     * Resolution order:
+     *   1) Treat input as wallet and check if a SAP agent exists.
+     *   2) If not found, treat input as MPL Core asset and resolve owner wallet.
+     *
+     * @since v0.9.2
+     */
+    async resolveAgentIdentifier(input) {
+        let asPubkey;
+        try {
+            asPubkey = new web3_js_1.PublicKey(input.identifier);
+        }
+        catch {
+            return {
+                input: input.identifier,
+                kind: "unknown",
+                wallet: null,
+                sapAgentPda: null,
+                asset: null,
+                hasSapAgent: false,
+                error: "Invalid public key",
+            };
+        }
+        // 1) Wallet-first resolution (SAP-native)
+        const [walletSapPda] = (0, pda_1.deriveAgent)(asPubkey);
+        const walletIdentity = await this.fetchAgentNullable(walletSapPda);
+        if (walletIdentity) {
+            return {
+                input: input.identifier,
+                kind: "wallet",
+                wallet: asPubkey,
+                sapAgentPda: walletSapPda,
+                asset: null,
+                hasSapAgent: true,
+                error: null,
+            };
+        }
+        // 2) MPL Core asset resolution
+        const mpl = await this.fetchMplSnapshot(asPubkey, input.rpcUrl);
+        if (!mpl) {
+            return {
+                input: input.identifier,
+                kind: "unknown",
+                wallet: null,
+                sapAgentPda: null,
+                asset: null,
+                hasSapAgent: false,
+                error: "Not a SAP wallet and not a readable MPL Core asset",
+            };
+        }
+        const [sapPdaFromOwner] = (0, pda_1.deriveAgent)(mpl.owner);
+        const ownerIdentity = await this.fetchAgentNullable(sapPdaFromOwner);
+        return {
+            input: input.identifier,
+            kind: "core-asset",
+            wallet: mpl.owner,
+            sapAgentPda: sapPdaFromOwner,
+            asset: asPubkey,
+            hasSapAgent: !!ownerIdentity,
+            error: ownerIdentity ? null : "Core asset owner has no SAP agent profile",
+        };
+    }
+    /**
+     * @name verifyLink
+     * @description Verify the bidirectional link between an MPL Core asset
+     * and a SAP agent. Returns `true` only when both URL and JSON sides
+     * reference the SAP agent PDA.
+     *
+     * @since v0.9.0
+     */
+    async verifyLink(args) {
+        const snap = await this.fetchMplSnapshot(args.asset, args.rpcUrl);
+        if (!snap?.agentIdentityUri || !snap.registration)
+            return false;
+        const expectedSuffix = `/agents/${args.sapAgentPda.toBase58()}/eip-8004.json`;
+        if (!snap.agentIdentityUri.endsWith(expectedSuffix))
+            return false;
+        return snap.registration.synapseAgent === args.sapAgentPda.toBase58();
+    }
+    // ═════════════════════════════════════════════════════
+    //  Private — SAP fetching
+    // ═════════════════════════════════════════════════════
+    get accounts() {
+        return this.program.account;
+    }
+    async fetchAgentNullable(pda) {
+        try {
+            return await this.accounts.agentAccount.fetch(pda);
+        }
+        catch {
+            return null;
+        }
+    }
+    async fetchStatsNullable(agentPda) {
+        try {
+            const [statsPda] = (0, pda_1.deriveAgentStats)(agentPda);
+            return await this.accounts.agentStats.fetch(statsPda);
+        }
+        catch {
+            return null;
+        }
+    }
+    async fetchActiveVaultDelegates(agentPda) {
+        try {
+            const [vaultPda] = (0, pda_1.deriveVault)(agentPda);
+            // VaultDelegate layout: [discriminator(8) | bump(1) | vault(32) | ...]
+            const all = await this.accounts.vaultDelegate.all([
+                { memcmp: { offset: 8 + 1, bytes: vaultPda.toBase58() } },
+            ]);
+            const now = Math.floor(Date.now() / 1000);
+            return all
+                .map(({ account }) => {
+                const expiresRaw = account.expiresAt.toString();
+                const expiresAt = expiresRaw === "0" ? null : expiresRaw;
+                return { wallet: account.delegate.toBase58(), expiresAt };
+            })
+                .filter((d) => d.expiresAt === null || Number(d.expiresAt) > now);
+        }
+        catch {
+            return [];
+        }
+    }
+    // ═════════════════════════════════════════════════════
+    //  Private — MPL fetching
+    // ═════════════════════════════════════════════════════
+    async fetchMplSnapshot(asset, rpcUrl) {
+        const { mplCore, umiBundle, umiCore } = await loadMplCore();
+        const umi = umiBundle.createUmi(rpcUrl).use(mplCore.mplCore());
+        try {
+            const fetched = await mplCore.fetchAsset(umi, umiCore.publicKey(asset.toBase58()));
+            const owner = new web3_js_1.PublicKey(fetched.owner.toString());
+            const uri = this.extractAgentIdentityUri(fetched);
+            const registration = uri ? await this.fetchEip8004Safe(uri) : null;
+            return {
+                asset,
+                owner,
+                name: fetched.name ?? null,
+                agentIdentityUri: uri,
+                registration,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    extractAgentIdentityUri(asset) {
+        const adapters = asset.agentIdentities;
+        if (!adapters || adapters.length === 0)
+            return null;
+        const first = adapters[0];
+        if (!first)
+            return null;
+        return typeof first.uri === "string" ? first.uri : null;
+    }
+    async fetchEip8004Safe(uri) {
+        try {
+            const res = await fetch(uri, { method: "GET" });
+            if (!res.ok)
+                return null;
+            const json = (await res.json());
+            if (typeof json.synapseAgent !== "string" ||
+                typeof json.authority !== "string") {
+                return null;
+            }
+            return {
+                version: json.version ?? "0.1",
+                name: json.name ?? "",
+                description: json.description,
+                synapseAgent: json.synapseAgent,
+                authority: json.authority,
+                capabilities: Array.isArray(json.capabilities) ? json.capabilities : [],
+                services: Array.isArray(json.services) ? json.services : [],
+                executives: Array.isArray(json.executives) ? json.executives : [],
+                updatedAt: json.updatedAt ?? "",
+                extra: json.extra,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    // ═════════════════════════════════════════════════════
+    //  Private — MPL instruction building
+    // ═════════════════════════════════════════════════════
+    async buildAddExternalPluginIx(args) {
+        const { mplCore, umiBundle, umiCore } = await loadMplCore();
+        const umi = umiBundle.createUmi(args.rpcUrl).use(mplCore.mplCore());
+        const authority = umiCore.createNoopSigner(umiCore.publicKey(args.authority.toBase58()));
+        const payer = umiCore.createNoopSigner(umiCore.publicKey(args.payer.toBase58()));
+        // HookableLifecycleEvent.Execute = 4; ExternalCheckResult { flags: 1 } = CanApprove
+        const ExecuteEvent = mplCore.HookableLifecycleEvent.Execute;
+        const builder = mplCore.addExternalPluginAdapterV1(umi, {
+            asset: umiCore.publicKey(args.asset.toBase58()),
+            authority,
+            payer,
+            initInfo: {
+                __kind: "AgentIdentity",
+                fields: [
+                    {
+                        uri: args.uri,
+                        initPluginAuthority: { __kind: "UpdateAuthority" },
+                        lifecycleChecks: [[ExecuteEvent, { flags: 1 }]],
+                    },
+                ],
+            },
+        });
+        return this.firstWeb3Ix(builder, "addExternalPluginAdapterV1");
+    }
+    async firstWeb3Ix(builder, name) {
+        const items = builder.getInstructions();
+        const first = items[0];
+        if (!first) {
+            throw new Error(`MetaplexBridge: ${name} produced no instructions`);
+        }
+        return this.umiIxToWeb3(first);
+    }
+    umiIxToWeb3(ix) {
+        return {
+            programId: new web3_js_1.PublicKey(ix.programId.toString()),
+            keys: ix.keys.map((k) => ({
+                pubkey: new web3_js_1.PublicKey(k.pubkey.toString()),
+                isSigner: k.isSigner,
+                isWritable: k.isWritable,
+            })),
+            data: Buffer.from(ix.data),
+        };
+    }
+    // ═════════════════════════════════════════════════════
+    //  Private — link detection + duck-typed readers
+    // ═════════════════════════════════════════════════════
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    detectLink(sapPda, mpl) {
+        if (!mpl?.agentIdentityUri || !mpl.registration)
+            return false;
+        const expectedSuffix = `/agents/${sapPda.toBase58()}/eip-8004.json`;
+        if (!mpl.agentIdentityUri.endsWith(expectedSuffix))
+            return false;
+        return mpl.registration.synapseAgent === sapPda.toBase58();
+    }
+    readString(identity, key) {
+        const value = identity[key];
+        return typeof value === "string" ? value : null;
+    }
+    readCapabilities(identity) {
+        const caps = identity.capabilities ?? [];
+        return caps.map((c) => c.id).filter((s) => typeof s === "string");
+    }
+}
+exports.MetaplexBridge = MetaplexBridge;
+//# sourceMappingURL=metaplex-bridge.js.map