/** * @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