@oobe-protocol-labs/synapse-sap-sdk 0.13.0 → 0.15.0

package/dist/esm/pdas/index.d.ts

@@ -0,0 +1,37 @@
+import { PublicKey } from "@solana/web3.js";
+import BN from "bn.js";
+/** Derive Agent PDA from wallet pubkey */
+export declare function getAgentPDA(wallet: PublicKey): [PublicKey, number];
+/** Derive AgentStats PDA from wallet pubkey */
+export declare function getAgentStatsPDA(wallet: PublicKey): [PublicKey, number];
+/** Derive AgentStake PDA from wallet pubkey */
+export declare function getAgentStakePDA(wallet: PublicKey): [PublicKey, number];
+/** Derive EscrowV2 PDA from agent wallet + nonce */
+export declare function getEscrowV2PDA(agent: PublicKey, escrowNonce: number): [PublicKey, number];
+/** Derive PendingSettlement PDA from escrow + settlement_index */
+export declare function getPendingSettlementPDA(escrow: PublicKey, settlementIndex: BN | number): [PublicKey, number];
+/** Derive Dispute PDA from escrow + settlement_index */
+export declare function getDisputePDA(escrow: PublicKey, settlementIndex: BN | number): [PublicKey, number];
+/** Derive Subscription PDA from agent + subscriber + nonce */
+export declare function getSubscriptionPDA(agent: PublicKey, subscriber: PublicKey, nonce: number): [PublicKey, number];
+/** Derive Vault PDA from agent pubkey */
+export declare function getVaultPDA(agent: PublicKey): [PublicKey, number];
+/** Derive SessionLedger PDA from vault + session number */
+export declare function getSessionLedgerPDA(vault: PublicKey, session: BN | number): [PublicKey, number];
+/** Derive EpochPage PDA from vault + epoch */
+export declare function getEpochPagePDA(vault: PublicKey, epoch: BN | number): [PublicKey, number];
+/** Derive VaultDelegate PDA from vault + delegate */
+export declare function getVaultDelegatePDA(vault: PublicKey, delegate: PublicKey): [PublicKey, number];
+/** Derive Tool PDA from agent + tool_name */
+export declare function getToolPDA(agent: PublicKey, toolName: string): [PublicKey, number];
+/** Derive ToolCategoryIndex PDA from category u8 */
+export declare function getToolCategoryIndexPDA(category: number): [PublicKey, number];
+/** Derive CapabilityIndex PDA from capability_hash (32 bytes) */
+export declare function getCapabilityIndexPDA(capabilityHash: Uint8Array): [PublicKey, number];
+/** Derive ProtocolIndex PDA from protocol_hash (32 bytes) */
+export declare function getProtocolIndexPDA(protocolHash: Uint8Array): [PublicKey, number];
+/** Derive GlobalConfig PDA (singleton) */
+export declare function getGlobalPDA(): [PublicKey, number];
+/** Convert a string to a 32-byte hash for capability/protocol indices */
+export declare function hashString(s: string): Uint8Array;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/pdas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pdas/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,MAAM,OAAO,CAAC;AAIvB,0CAA0C;AAC1C,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAKlE;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAKvE;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAKvE;AAED,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CASzF;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EACjB,eAAe,EAAE,EAAE,GAAG,MAAM,GAC3B,CAAC,SAAS,EAAE,MAAM,CAAC,CAQrB;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,eAAe,EAAE,EAAE,GAAG,MAAM,GAC3B,CAAC,SAAS,EAAE,MAAM,CAAC,CAQrB;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,SAAS,EACrB,KAAK,EAAE,MAAM,GACZ,CAAC,SAAS,EAAE,MAAM,CAAC,CAUrB;AAED,yCAAyC;AACzC,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAKjE;AAED,2DAA2D;AAC3D,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,EAAE,GAAG,MAAM,GACnB,CAAC,SAAS,EAAE,MAAM,CAAC,CAQrB;AAED,8CAA8C;AAC9C,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,EAAE,GAAG,MAAM,GACjB,CAAC,SAAS,EAAE,MAAM,CAAC,CAQrB;AAED,qDAAqD;AACrD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,SAAS,GAClB,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrB;AAED,6CAA6C;AAC7C,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAKlF;AAED,oDAAoD;AACpD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAK7E;AAED,iEAAiE;AACjE,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,UAAU,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAKrF;AAED,6DAA6D;AAC7D,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,UAAU,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAKjF;AAED,0CAA0C;AAC1C,wBAAgB,YAAY,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAKlD;AAKD,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,CAKhD"}

package/dist/esm/pdas/index.js

@@ -0,0 +1,101 @@
+// ================================================================
+//  synapse-sap-sdk / src/pdas/index.ts
+//  PDA derivation utilities — byte-perfect with on-chain seeds
+// ================================================================
+import { PublicKey } from "@solana/web3.js";
+import { SEEDS, PROGRAM_ID } from "../constants";
+const PROGRAM_PUBLIC_KEY = new PublicKey(PROGRAM_ID);
+/** Derive Agent PDA from wallet pubkey */
+export function getAgentPDA(wallet) {
+    return PublicKey.findProgramAddressSync([Buffer.from(SEEDS.AGENT), wallet.toBuffer()], PROGRAM_PUBLIC_KEY);
+}
+/** Derive AgentStats PDA from wallet pubkey */
+export function getAgentStatsPDA(wallet) {
+    return PublicKey.findProgramAddressSync([Buffer.from(SEEDS.AGENT_STATS), wallet.toBuffer()], PROGRAM_PUBLIC_KEY);
+}
+/** Derive AgentStake PDA from wallet pubkey */
+export function getAgentStakePDA(wallet) {
+    return PublicKey.findProgramAddressSync([Buffer.from(SEEDS.AGENT_STAKE), wallet.toBuffer()], PROGRAM_PUBLIC_KEY);
+}
+/** Derive EscrowV2 PDA from agent wallet + nonce */
+export function getEscrowV2PDA(agent, escrowNonce) {
+    return PublicKey.findProgramAddressSync([
+        Buffer.from(SEEDS.ESCROW_V2),
+        agent.toBuffer(),
+        Buffer.from(new Uint32Array([escrowNonce]).buffer),
+    ], PROGRAM_PUBLIC_KEY);
+}
+/** Derive PendingSettlement PDA from escrow + settlement_index */
+export function getPendingSettlementPDA(escrow, settlementIndex) {
+    const idxBuf = typeof settlementIndex === "number"
+        ? Buffer.from(new Uint32Array([settlementIndex]).buffer)
+        : settlementIndex.toArrayLike(Buffer, "le", 4);
+    return PublicKey.findProgramAddressSync([Buffer.from(SEEDS.PENDING_SETTLE), escrow.toBuffer(), idxBuf], PROGRAM_PUBLIC_KEY);
+}
+/** Derive Dispute PDA from escrow + settlement_index */
+export function getDisputePDA(escrow, settlementIndex) {
+    const idxBuf = typeof settlementIndex === "number"
+        ? Buffer.from(new Uint32Array([settlementIndex]).buffer)
+        : settlementIndex.toArrayLike(Buffer, "le", 4);
+    return PublicKey.findProgramAddressSync([Buffer.from(SEEDS.DISPUTE), escrow.toBuffer(), idxBuf], PROGRAM_PUBLIC_KEY);
+}
+/** Derive Subscription PDA from agent + subscriber + nonce */
+export function getSubscriptionPDA(agent, subscriber, nonce) {
+    return PublicKey.findProgramAddressSync([
+        Buffer.from(SEEDS.SUBSCRIPTION),
+        agent.toBuffer(),
+        subscriber.toBuffer(),
+        Buffer.from(new Uint32Array([nonce]).buffer),
+    ], PROGRAM_PUBLIC_KEY);
+}
+/** Derive Vault PDA from agent pubkey */
+export function getVaultPDA(agent) {
+    return PublicKey.findProgramAddressSync([Buffer.from(SEEDS.VAULT), agent.toBuffer()], PROGRAM_PUBLIC_KEY);
+}
+/** Derive SessionLedger PDA from vault + session number */
+export function getSessionLedgerPDA(vault, session) {
+    const sessionBuf = typeof session === "number"
+        ? Buffer.from(new Uint32Array([session]).buffer)
+        : session.toArrayLike(Buffer, "le", 4);
+    return PublicKey.findProgramAddressSync([Buffer.from(SEEDS.SESSION), vault.toBuffer(), sessionBuf], PROGRAM_PUBLIC_KEY);
+}
+/** Derive EpochPage PDA from vault + epoch */
+export function getEpochPagePDA(vault, epoch) {
+    const epochBuf = typeof epoch === "number"
+        ? Buffer.from(new Uint32Array([epoch]).buffer)
+        : epoch.toArrayLike(Buffer, "le", 4);
+    return PublicKey.findProgramAddressSync([Buffer.from(SEEDS.EPOCH_PAGE), vault.toBuffer(), epochBuf], PROGRAM_PUBLIC_KEY);
+}
+/** Derive VaultDelegate PDA from vault + delegate */
+export function getVaultDelegatePDA(vault, delegate) {
+    return PublicKey.findProgramAddressSync([Buffer.from(SEEDS.VAULT_DELEGATE), vault.toBuffer(), delegate.toBuffer()], PROGRAM_PUBLIC_KEY);
+}
+/** Derive Tool PDA from agent + tool_name */
+export function getToolPDA(agent, toolName) {
+    return PublicKey.findProgramAddressSync([Buffer.from(SEEDS.TOOL), agent.toBuffer(), Buffer.from(toolName)], PROGRAM_PUBLIC_KEY);
+}
+/** Derive ToolCategoryIndex PDA from category u8 */
+export function getToolCategoryIndexPDA(category) {
+    return PublicKey.findProgramAddressSync([Buffer.from(SEEDS.TOOL_CAT_IDX), Buffer.from([category])], PROGRAM_PUBLIC_KEY);
+}
+/** Derive CapabilityIndex PDA from capability_hash (32 bytes) */
+export function getCapabilityIndexPDA(capabilityHash) {
+    return PublicKey.findProgramAddressSync([Buffer.from(SEEDS.CAPABILITY_IDX), Buffer.from(capabilityHash)], PROGRAM_PUBLIC_KEY);
+}
+/** Derive ProtocolIndex PDA from protocol_hash (32 bytes) */
+export function getProtocolIndexPDA(protocolHash) {
+    return PublicKey.findProgramAddressSync([Buffer.from(SEEDS.PROTOCOL_IDX), Buffer.from(protocolHash)], PROGRAM_PUBLIC_KEY);
+}
+/** Derive GlobalConfig PDA (singleton) */
+export function getGlobalPDA() {
+    return PublicKey.findProgramAddressSync([Buffer.from(SEEDS.GLOBAL)], PROGRAM_PUBLIC_KEY);
+}
+// ── Re-export convenience ──
+/** Convert a string to a 32-byte hash for capability/protocol indices */
+export function hashString(s) {
+    // On-chain uses SHA-256; SDK can compute with crypto or just use the same 
+    // For now, we use sha256 import from solana-sha256-hasher or crypto
+    // We'll provide a fallback in utils
+    return new Uint8Array(32); // placeholder - filled by utils.hasher
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/esm/plugin/index.d.ts

@@ -0,0 +1,171 @@
+/**
+ * @module plugin
+ * @description SynapsePlugin adapter for SAP v2.
+ *
+ * Exposes 52 tools across 8 on-chain protocol domains as a drop-in
+ * `SynapsePlugin` for `SynapseAgentKit`:
+ *
+ * ```ts
+ * import { SynapseAgentKit } from '@oobe-protocol-labs/synapse-client-sdk/ai/plugins';
+ * import { createSAPPlugin } from '@synapse-sap/sdk/plugin';
+ *
+ * const sapPlugin = createSAPPlugin({ provider });
+ * const kit = new SynapseAgentKit({ rpcUrl })
+ *   .use(sapPlugin);
+ *
+ * const tools = kit.getTools();   // → StructuredTool[] (LangChain)
+ * ```
+ *
+ * Architecture:
+ *   1. Schemas (Zod) → runtime validation + LLM-friendly descriptions
+ *   2. Protocols → 8 domain method registries (agent, feedback, …)
+ *   3. Executor → dispatches tool calls to SapClient module methods
+ *   4. Serialization → PublicKey↔string, BN↔string bridging
+ *
+ * @category Plugin
+ * @since v0.1.0
+ */
+import { type AnchorProvider } from "@coral-xyz/anchor";
+import { PublicKey } from "@solana/web3.js";
+import { type PluginProtocol, type ProtocolMethod } from "./protocols";
+/**
+ * Plugin metadata exposed via {@link SynapsePlugin.meta}.
+ *
+ * @interface PluginMeta
+ * @name PluginMeta
+ * @description Describes a SynapsePlugin’s identity, version, and
+ *   discovery tags for the SynapseAgentKit plugin registry.
+ * @category Plugin
+ * @since v0.1.0
+ */
+export interface PluginMeta {
+    readonly id: string;
+    readonly name: string;
+    readonly version: string;
+    readonly description: string;
+    readonly tags: readonly string[];
+}
+/**
+ * Context injected by SynapseAgentKit during `install()`.
+ *
+ * @interface PluginContext
+ * @name PluginContext
+ * @description Provides the RPC transport and original AgentKit configuration
+ *   to the plugin at installation time.
+ * @category Plugin
+ * @since v0.1.0
+ */
+export interface PluginContext {
+    /** The SynapseClient providing RPC transport. */
+    readonly client: {
+        readonly transport: unknown;
+    };
+    /** Original AgentKitConfig. */
+    readonly config: Record<string, unknown>;
+}
+/**
+ * Result of `install()` containing the tool executor and optional teardown.
+ *
+ * @interface PluginInstallResult
+ * @name PluginInstallResult
+ * @description Returned by {@link SynapsePlugin.install}. The `executor`
+ *   dispatches incoming tool calls to the correct SapClient module method.
+ *   The optional `teardown` callback is invoked on `kit.destroy()`.
+ * @category Plugin
+ * @since v0.1.0
+ */
+export interface PluginInstallResult {
+    /** Main executor dispatching method calls. */
+    executor: (method: ProtocolMethod, input: unknown) => Promise<unknown>;
+    /** Optional teardown for cleanup on `kit.destroy()`. */
+    teardown?: () => Promise<void>;
+}
+/**
+ * The SynapsePlugin interface (duck-typed for zero external deps).
+ *
+ * @interface SynapsePlugin
+ * @name SynapsePlugin
+ * @description Core contract for SynapseAgentKit plugins. Provides metadata,
+ *   protocol definitions, and an `install()` entry point that yields
+ *   a tool executor.
+ * @category Plugin
+ * @since v0.1.0
+ */
+export interface SynapsePlugin {
+    readonly meta: PluginMeta;
+    readonly protocols: readonly PluginProtocol[];
+    install(context: PluginContext): PluginInstallResult;
+}
+/**
+ * Configuration for the SAP plugin.
+ *
+ * @interface SAPPluginConfig
+ * @name SAPPluginConfig
+ * @description Options passed to {@link createSAPPlugin} to instantiate
+ *   the SAP v2 plugin with an Anchor provider and optional program ID override.
+ * @category Plugin
+ * @since v0.1.0
+ */
+export interface SAPPluginConfig {
+    /**
+     * Anchor provider with wallet signer.
+     * Required for all write operations (transactions).
+     */
+    readonly provider: AnchorProvider;
+    /**
+     * Override the SAP program ID.
+     * Defaults to the canonical program ID from constants.
+     */
+    readonly programId?: PublicKey;
+}
+/**
+ * Create a SynapsePlugin for SAP v2.
+ *
+ * @name createSAPPlugin
+ * @description Factory function that returns a fully configured
+ *   {@link SynapsePlugin} exposing 52 tools across 8 on-chain
+ *   protocol domains. The plugin can be installed into a
+ *   `SynapseAgentKit` instance or used standalone.
+ * @param config - Plugin configuration with Anchor provider and optional program ID
+ * @returns A configured {@link SynapsePlugin} instance
+ * @category Plugin
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { createSAPPlugin } from '@synapse-sap/sdk/plugin';
+ *
+ * const sapPlugin = createSAPPlugin({ provider });
+ *
+ * // Use with SynapseAgentKit:
+ * kit.use(sapPlugin);
+ *
+ * // Or standalone:
+ * const executor = sapPlugin.install({ client, config: {} }).executor;
+ * await executor(someMethod, someInput);
+ * ```
+ */
+export declare function createSAPPlugin(config: SAPPluginConfig): SynapsePlugin;
+/**
+ * Pre-built plugin object for static use patterns.
+ *
+ * @name SAPPlugin
+ * @description Convenience namespace exposing a `configure` method
+ *   that delegates to {@link createSAPPlugin}. Useful for concise
+ *   one-liner instantiation.
+ * @category Plugin
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { SAPPlugin } from '@synapse-sap/sdk/plugin';
+ *
+ * const plugin = SAPPlugin.configure({ provider });
+ * kit.use(plugin);
+ * ```
+ */
+export declare const SAPPlugin: {
+    /** Create a configured SynapsePlugin from an AnchorProvider. */
+    readonly configure: typeof createSAPPlugin;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAqBrB;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;KAC7B,CAAC;IACF,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,QAAQ,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvE,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;IAC9C,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,mBAAmB,CAAC;CACtD;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAElC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;CAChC;AA89BD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,aAAa,CAgCtE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,SAAS;IACpB,gEAAgE;;CAExD,CAAC"}

package/dist/esm/plugin/protocols.d.ts

@@ -0,0 +1,152 @@
+/**
+ * @module plugin/protocols
+ * @description Protocol definitions + method registries for the SAP v2 plugin.
+ *
+ * Each protocol maps 1:1 to a SAP SDK domain module.
+ * Methods carry Zod-typed input/output + LLM-friendly descriptions.
+ *
+ * Follows the `SynapsePlugin.protocols` contract exactly.
+ *
+ * @category Plugin
+ * @since v0.1.0
+ */
+import type { z } from "zod";
+/**
+ * A single tool method exposed by a protocol.
+ *
+ * @interface ProtocolMethod
+ * @name ProtocolMethod
+ * @description Defines a callable tool within a SAP protocol domain,
+ *   including its name, LLM-friendly description, Zod input/output schemas,
+ *   and parent protocol identifier.
+ * @category Plugin
+ * @since v0.1.0
+ */
+export interface ProtocolMethod {
+    readonly name: string;
+    readonly description: string;
+    readonly input: z.ZodTypeAny;
+    readonly output: z.ZodTypeAny;
+    readonly protocol: string;
+}
+/**
+ * A protocol group containing typed methods.
+ *
+ * @interface PluginProtocol
+ * @name PluginProtocol
+ * @description Groups related tool methods under a named protocol domain
+ *   (e.g. `"sap-agent"`, `"sap-escrow"`). Each protocol maps 1:1 to a
+ *   SapClient domain module.
+ * @category Plugin
+ * @since v0.1.0
+ */
+export interface PluginProtocol {
+    readonly id: string;
+    readonly name: string;
+    readonly methods: ProtocolMethod[];
+    readonly requiresClient: boolean;
+}
+/**
+ * SAP Agent Identity protocol — 8 tools for on-chain agent registration,
+ * updates, activation lifecycle, call reporting, and reputation metrics.
+ *
+ * @name sapAgentProtocol
+ * @description Covers `registerAgent`, `updateAgent`, `deactivateAgent`,
+ *   `reactivateAgent`, `reportCalls`, `updateReputation`, `fetchAgent`,
+ *   and `fetchGlobalRegistry`.
+ * @category Plugin
+ * @since v0.1.0
+ */
+export declare const sapAgentProtocol: PluginProtocol;
+/**
+ * SAP Trustless Reputation protocol — 4 tools for on-chain feedback
+ * (give, update, revoke, fetch) tied to agent identity PDAs.
+ *
+ * @name sapFeedbackProtocol
+ * @description Covers `giveFeedback`, `updateFeedback`, `revokeFeedback`,
+ *   and `fetchFeedback`.
+ * @category Plugin
+ * @since v0.1.0
+ */
+export declare const sapFeedbackProtocol: PluginProtocol;
+/**
+ * SAP Web of Trust protocol — 3 tools for creating, revoking, and
+ * fetching on-chain attestations between agents.
+ *
+ * @name sapAttestationProtocol
+ * @description Covers `createAttestation`, `revokeAttestation`,
+ *   and `fetchAttestation`.
+ * @category Plugin
+ * @since v0.1.0
+ */
+export declare const sapAttestationProtocol: PluginProtocol;
+/**
+ * SAP x402 Escrow protocol — 6 tools for creating, depositing into,
+ * settling, withdrawing from, batch-settling, and fetching escrow accounts.
+ *
+ * @name sapEscrowProtocol
+ * @description Covers `createEscrow`, `depositEscrow`, `settleEscrow`,
+ *   `withdrawEscrow`, `batchSettle`, and `fetchEscrow`.
+ * @category Plugin
+ * @since v0.1.0
+ */
+export declare const sapEscrowProtocol: PluginProtocol;
+/**
+ * SAP Tool Registry protocol — 7 tools for publishing, updating,
+ * deactivating/reactivating tool descriptors and reporting invocations.
+ *
+ * @name sapToolsProtocol
+ * @description Covers `publishToolByName`, `inscribeToolSchema`, `updateTool`,
+ *   `deactivateTool`, `reactivateTool`, `reportInvocations`, and `fetchTool`.
+ * @category Plugin
+ * @since v0.1.0
+ */
+export declare const sapToolsProtocol: PluginProtocol;
+/**
+ * SAP Encrypted Memory Vault protocol — 10 tools for vault lifecycle,
+ * session management, encrypted memory inscription, nonce rotation,
+ * and delegate authorization.
+ *
+ * @name sapVaultProtocol
+ * @description Covers `initVault`, `openSession`, `inscribeMemory`,
+ *   `closeSession`, `closeVault`, `rotateNonce`, `addDelegate`,
+ *   `revokeDelegate`, `fetchVault`, and `fetchSession`.
+ * @category Plugin
+ * @since v0.1.0
+ */
+export declare const sapVaultProtocol: PluginProtocol;
+/**
+ * SAP Discovery Indexes protocol — 8 tools for creating and managing
+ * capability and protocol indexes used for agent discovery.
+ *
+ * @name sapIndexingProtocol
+ * @description Covers `initCapabilityIndex`, `addToCapabilityIndex`,
+ *   `removeFromCapabilityIndex`, `initProtocolIndex`, `addToProtocolIndex`,
+ *   `removeFromProtocolIndex`, `fetchCapabilityIndex`, and `fetchProtocolIndex`.
+ * @category Plugin
+ * @since v0.1.0
+ */
+export declare const sapIndexingProtocol: PluginProtocol;
+/**
+ * SAP Unified Memory Ledger protocol — 6 tools for initializing,
+ * writing to, sealing, closing, and fetching ring-buffer ledgers
+ * and their sealed archive pages.
+ *
+ * @name sapLedgerProtocol
+ * @description Covers `initLedger`, `writeLedger`, `sealLedger`,
+ *   `closeLedger`, `fetchLedger`, and `fetchLedgerPage`.
+ * @category Plugin
+ * @since v0.1.0
+ */
+export declare const sapLedgerProtocol: PluginProtocol;
+/**
+ * Ordered array of all 8 SAP v2 plugin protocols.
+ *
+ * @name SAP_PROTOCOLS
+ * @description Contains agent, feedback, attestation, escrow, tools,
+ *   vault, indexing, and ledger protocols (52 tools total).
+ * @category Plugin
+ * @since v0.1.0
+ */
+export declare const SAP_PROTOCOLS: readonly PluginProtocol[];
+//# sourceMappingURL=protocols.d.ts.map

package/dist/esm/plugin/protocols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocols.d.ts","sourceRoot":"","sources":["../../../src/plugin/protocols.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAiBH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,UAAU,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAwCD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAoB9B,CAAC;AAMF;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,EAAE,cAcjC,CAAC;AAMF;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,EAAE,cAYpC,CAAC;AAMF;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,EAAE,cAkB/B,CAAC;AAMF;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAkB9B,CAAC;AAMF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAyB9B,CAAC;AAMF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,EAAE,cAsBjC,CAAC;AAMF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,EAAE,cAkB/B,CAAC;AAMF;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,cAAc,EASzC,CAAC"}