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

package/dist/cjs/plugin/schemas.js

@@ -0,0 +1,863 @@
+"use strict";
+/**
+ * @module plugin/schemas
+ * @description Zod schemas for every SAP v2 plugin tool.
+ *
+ * Each schema is an `{ input, output }` pair that drives:
+ *   1. Runtime validation (LLM → tool call)
+ *   2. LangChain StructuredTool generation
+ *   3. MCP/Vercel AI tool descriptors
+ *
+ * Conventions:
+ *   - Solana public keys → `z.string().describe('Base58 public key …')`
+ *   - BN/bigint amounts  → `z.string().describe('Amount in lamports …')`
+ *   - Hashes ([u8;32])   → `z.array(z.number()).length(32)`
+ *   - Tool outputs always include `txSignature` for write ops
+ *
+ * @category Plugin
+ * @since v0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ledgerSchemas = exports.indexingSchemas = exports.vaultSchemas = exports.toolsSchemas = exports.escrowSchemas = exports.attestationSchemas = exports.feedbackSchemas = exports.agentSchemas = void 0;
+const zod_1 = require("zod");
+// ═══════════════════════════════════════════════════════════════════
+//  Shared Primitives
+// ═══════════════════════════════════════════════════════════════════
+/** Base58-encoded Solana public key (32–44 chars). */
+const pubkey = zod_1.z
+    .string()
+    .min(32)
+    .max(44)
+    .describe("Solana public key (base58)");
+/** Base58-encoded transaction signature. */
+const txSig = zod_1.z.string().describe("Transaction signature (base58)");
+/** 32-byte SHA-256 hash represented as a fixed-length integer array. */
+const hash32 = zod_1.z.array(zod_1.z.number().int().min(0).max(255)).length(32);
+/** Token amount in the smallest unit, serialized as a string for BN safety. */
+const lamports = zod_1.z.string().describe("Amount in smallest token unit (string)");
+/** Optional public key (nullable). */
+const optPubkey = pubkey.nullish();
+/** Standard write-operation output containing the transaction signature. */
+const writeOutput = zod_1.z.object({ txSignature: txSig });
+// ═══════════════════════════════════════════════════════════════════
+//  Nested Sub-schemas
+// ═══════════════════════════════════════════════════════════════════
+/** Reusable schema for an agent capability entry. */
+const capabilitySchema = zod_1.z.object({
+    id: zod_1.z.string().describe("Capability identifier (e.g. 'jupiter:swap')"),
+    description: zod_1.z.string().nullish().describe("Human-readable description"),
+    protocolId: zod_1.z.string().nullish().describe("Protocol namespace"),
+    version: zod_1.z.string().nullish().describe("Semver version"),
+});
+/** Reusable schema for a volume curve breakpoint (tiered pricing). */
+const volumeBreakpointSchema = zod_1.z.object({
+    afterCalls: zod_1.z.number().int().describe("Call threshold for this tier"),
+    pricePerCall: lamports.describe("Price per call after threshold"),
+});
+/** Reusable schema for a pricing tier with token, settlement, and volume curve config. */
+const pricingTierSchema = zod_1.z.object({
+    tierId: zod_1.z.string().describe("Pricing tier ID (e.g. 'standard')"),
+    pricePerCall: lamports,
+    minPricePerCall: lamports.nullish().describe("Price floor"),
+    maxPricePerCall: lamports.nullish().describe("Price ceiling"),
+    rateLimit: zod_1.z.number().int().describe("Calls per second"),
+    maxCallsPerSession: zod_1.z.number().int().describe("0 = unlimited"),
+    burstLimit: zod_1.z.number().int().nullish(),
+    tokenType: zod_1.z
+        .enum(["sol", "usdc", "spl"])
+        .describe("Payment token type"),
+    tokenMint: optPubkey.describe("SPL token mint address (when tokenType=spl)"),
+    tokenDecimals: zod_1.z.number().int().nullish(),
+    settlementMode: zod_1.z
+        .enum(["instant", "escrow", "batched", "x402"])
+        .nullish()
+        .describe("Settlement mode"),
+    minEscrowDeposit: lamports.nullish(),
+    batchIntervalSec: zod_1.z.number().int().nullish(),
+    volumeCurve: zod_1.z.array(volumeBreakpointSchema).nullish(),
+});
+/** Reusable schema for a settlement entry (calls + service hash). */
+const settlementSchema = zod_1.z.object({
+    callsToSettle: zod_1.z.string().describe("Number of calls to settle"),
+    serviceHash: hash32.describe("SHA-256 hash of the service rendered"),
+});
+// ═══════════════════════════════════════════════════════════════════
+//  Agent Schemas
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Zod input/output schemas for the **sap-agent** protocol (8 tools).
+ *
+ * @name agentSchemas
+ * @description Covers agent registration, updates, activation lifecycle,
+ *   call reporting, reputation metrics, and on-chain data fetching.
+ * @category Plugin
+ * @since v0.1.0
+ */
+exports.agentSchemas = {
+    registerAgent: {
+        input: zod_1.z.object({
+            name: zod_1.z.string().max(64).describe("Agent display name (max 64 chars)"),
+            description: zod_1.z
+                .string()
+                .max(512)
+                .describe("Agent description (max 512 chars)"),
+            capabilities: zod_1.z
+                .array(capabilitySchema)
+                .describe("List of capabilities this agent offers"),
+            pricing: zod_1.z
+                .array(pricingTierSchema)
+                .describe("Pricing tiers for agent services"),
+            protocols: zod_1.z
+                .array(zod_1.z.string())
+                .describe("Protocol IDs this agent supports"),
+            agentId: zod_1.z.string().nullish().describe("Optional DID-style agent ID"),
+            agentUri: zod_1.z
+                .string()
+                .url()
+                .nullish()
+                .describe("Optional agent metadata URI"),
+            x402Endpoint: zod_1.z
+                .string()
+                .url()
+                .nullish()
+                .describe("x402 payment endpoint URL"),
+        }),
+        output: writeOutput,
+    },
+    updateAgent: {
+        input: zod_1.z.object({
+            name: zod_1.z.string().max(64).nullish(),
+            description: zod_1.z.string().max(512).nullish(),
+            capabilities: zod_1.z.array(capabilitySchema).nullish(),
+            pricing: zod_1.z.array(pricingTierSchema).nullish(),
+            protocols: zod_1.z.array(zod_1.z.string()).nullish(),
+            agentId: zod_1.z.string().nullish(),
+            agentUri: zod_1.z.string().url().nullish(),
+            x402Endpoint: zod_1.z.string().url().nullish(),
+        }),
+        output: writeOutput,
+    },
+    deactivateAgent: {
+        input: zod_1.z.object({}),
+        output: writeOutput,
+    },
+    reactivateAgent: {
+        input: zod_1.z.object({}),
+        output: writeOutput,
+    },
+    reportCalls: {
+        input: zod_1.z.object({
+            callsServed: zod_1.z.number().int().positive().describe("Number of calls served"),
+        }),
+        output: writeOutput,
+    },
+    updateReputation: {
+        input: zod_1.z.object({
+            avgLatencyMs: zod_1.z.number().int().min(0).describe("Average latency in ms"),
+            uptimePercent: zod_1.z
+                .number()
+                .int()
+                .min(0)
+                .max(100)
+                .describe("Uptime percentage (0-100)"),
+        }),
+        output: writeOutput,
+    },
+    fetchAgent: {
+        input: zod_1.z.object({
+            wallet: pubkey.nullish().describe("Agent wallet (defaults to caller)"),
+        }),
+        output: zod_1.z.object({
+            name: zod_1.z.string(),
+            description: zod_1.z.string(),
+            isActive: zod_1.z.boolean(),
+            reputationScore: zod_1.z.number(),
+            totalCallsServed: zod_1.z.string(),
+            totalFeedbacks: zod_1.z.number(),
+            avgLatencyMs: zod_1.z.number(),
+            uptimePercent: zod_1.z.number(),
+            wallet: pubkey,
+            agentId: zod_1.z.string().nullish(),
+            x402Endpoint: zod_1.z.string().nullish(),
+            capabilities: zod_1.z.array(capabilitySchema),
+            pricing: zod_1.z.array(pricingTierSchema),
+            protocols: zod_1.z.array(zod_1.z.string()),
+        }),
+    },
+    fetchGlobalRegistry: {
+        input: zod_1.z.object({}),
+        output: zod_1.z.object({
+            totalAgents: zod_1.z.string(),
+            activeAgents: zod_1.z.string(),
+            totalFeedbacks: zod_1.z.string(),
+            totalCapabilities: zod_1.z.number(),
+            totalProtocols: zod_1.z.number(),
+            totalTools: zod_1.z.number(),
+            totalVaults: zod_1.z.number(),
+            totalEscrows: zod_1.z.number(),
+            totalAttestations: zod_1.z.number(),
+            authority: pubkey,
+        }),
+    },
+};
+// ═══════════════════════════════════════════════════════════════════
+//  Feedback Schemas
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Zod input/output schemas for the **sap-feedback** protocol (4 tools).
+ *
+ * @name feedbackSchemas
+ * @description Covers giving, updating, revoking, and fetching on-chain
+ *   feedback entries tied to agent identity PDAs.
+ * @category Plugin
+ * @since v0.1.0
+ */
+exports.feedbackSchemas = {
+    giveFeedback: {
+        input: zod_1.z.object({
+            agentWallet: pubkey.describe("Wallet of the agent to review"),
+            score: zod_1.z
+                .number()
+                .int()
+                .min(1)
+                .max(5)
+                .describe("Feedback score (1-5)"),
+            tag: zod_1.z
+                .string()
+                .max(32)
+                .describe("Short tag (e.g. 'reliable', 'fast', 'accurate')"),
+            commentHash: hash32
+                .nullish()
+                .describe("Optional SHA-256 hash of off-chain comment"),
+        }),
+        output: writeOutput,
+    },
+    updateFeedback: {
+        input: zod_1.z.object({
+            agentWallet: pubkey.describe("Wallet of the reviewed agent"),
+            newScore: zod_1.z.number().int().min(1).max(5).describe("Updated score (1-5)"),
+            newTag: zod_1.z.string().max(32).nullish().describe("Updated tag"),
+            commentHash: hash32.nullish(),
+        }),
+        output: writeOutput,
+    },
+    revokeFeedback: {
+        input: zod_1.z.object({
+            agentWallet: pubkey.describe("Wallet of the reviewed agent"),
+        }),
+        output: writeOutput,
+    },
+    fetchFeedback: {
+        input: zod_1.z.object({
+            agentWallet: pubkey.describe("Wallet of the reviewed agent"),
+            reviewer: pubkey.nullish().describe("Reviewer wallet (defaults to caller)"),
+        }),
+        output: zod_1.z.object({
+            agent: pubkey,
+            reviewer: pubkey,
+            score: zod_1.z.number(),
+            tag: zod_1.z.string(),
+            isRevoked: zod_1.z.boolean(),
+            createdAt: zod_1.z.string(),
+            updatedAt: zod_1.z.string(),
+        }),
+    },
+};
+// ═══════════════════════════════════════════════════════════════════
+//  Attestation Schemas
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Zod input/output schemas for the **sap-attestation** protocol (3 tools).
+ *
+ * @name attestationSchemas
+ * @description Covers creating, revoking, and fetching on-chain attestations
+ *   between agents in the SAP Web of Trust.
+ * @category Plugin
+ * @since v0.1.0
+ */
+exports.attestationSchemas = {
+    createAttestation: {
+        input: zod_1.z.object({
+            agentWallet: pubkey.describe("Wallet of the agent to attest"),
+            attestationType: zod_1.z
+                .string()
+                .max(32)
+                .describe("Type of attestation (e.g. 'identity', 'capability', 'compliance')"),
+            metadataHash: hash32.describe("SHA-256 hash of attestation metadata"),
+            expiresAt: zod_1.z
+                .string()
+                .describe("Unix timestamp (seconds) when attestation expires"),
+        }),
+        output: writeOutput,
+    },
+    revokeAttestation: {
+        input: zod_1.z.object({
+            agentWallet: pubkey.describe("Wallet of the attested agent"),
+        }),
+        output: writeOutput,
+    },
+    fetchAttestation: {
+        input: zod_1.z.object({
+            agentWallet: pubkey.describe("Wallet of the attested agent"),
+            attester: pubkey
+                .nullish()
+                .describe("Attester wallet (defaults to caller)"),
+        }),
+        output: zod_1.z.object({
+            agent: pubkey,
+            attester: pubkey,
+            attestationType: zod_1.z.string(),
+            isActive: zod_1.z.boolean(),
+            expiresAt: zod_1.z.string(),
+            createdAt: zod_1.z.string(),
+        }),
+    },
+};
+// ═══════════════════════════════════════════════════════════════════
+//  Escrow Schemas
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Zod input/output schemas for the **sap-escrow** protocol (6 tools).
+ *
+ * @name escrowSchemas
+ * @description Covers escrow creation, deposits, settlement (single and batch),
+ *   withdrawal, and account data fetching for x402 micropayments.
+ * @category Plugin
+ * @since v0.1.0
+ */
+exports.escrowSchemas = {
+    createEscrow: {
+        input: zod_1.z.object({
+            agentWallet: pubkey.describe("Agent wallet to deposit escrow for"),
+            pricePerCall: lamports.describe("Base price per call"),
+            maxCalls: zod_1.z.string().describe("Maximum calls allowed"),
+            initialDeposit: lamports.describe("Initial deposit amount"),
+            expiresAt: zod_1.z.string().describe("Expiry timestamp (unix seconds)"),
+            volumeCurve: zod_1.z.array(volumeBreakpointSchema).default([]),
+            tokenMint: optPubkey.describe("SPL token mint (null = native SOL)"),
+            tokenDecimals: zod_1.z
+                .number()
+                .int()
+                .default(9)
+                .describe("Token decimals (9=SOL, 6=USDC)"),
+        }),
+        output: writeOutput,
+    },
+    depositEscrow: {
+        input: zod_1.z.object({
+            agentWallet: pubkey.describe("Agent wallet of the escrow"),
+            amount: lamports.describe("Additional deposit amount"),
+        }),
+        output: writeOutput,
+    },
+    settleEscrow: {
+        input: zod_1.z.object({
+            depositorWallet: pubkey.describe("Depositor (client) wallet"),
+            callsToSettle: zod_1.z.string().describe("Number of calls to settle"),
+            serviceHash: hash32.describe("SHA-256 hash of the service rendered"),
+            priorityFeeMicroLamports: zod_1.z
+                .number()
+                .int()
+                .min(0)
+                .nullish()
+                .describe("Priority fee in microlamports per CU (0 = none, 5000 = recommended)"),
+            computeUnits: zod_1.z
+                .number()
+                .int()
+                .min(0)
+                .nullish()
+                .describe("Compute unit limit (default 200k, recommended 100k for settle)"),
+            skipPreflight: zod_1.z
+                .boolean()
+                .nullish()
+                .describe("Skip Solana simulation before submitting (saves ~400ms)"),
+        }),
+        output: writeOutput,
+    },
+    withdrawEscrow: {
+        input: zod_1.z.object({
+            agentWallet: pubkey.describe("Agent wallet of the escrow"),
+            amount: lamports.describe("Amount to withdraw"),
+        }),
+        output: writeOutput,
+    },
+    batchSettle: {
+        input: zod_1.z.object({
+            depositorWallet: pubkey.describe("Depositor (client) wallet"),
+            settlements: zod_1.z
+                .array(settlementSchema)
+                .min(1)
+                .max(10)
+                .describe("Up to 10 settlement entries"),
+            priorityFeeMicroLamports: zod_1.z
+                .number()
+                .int()
+                .min(0)
+                .nullish()
+                .describe("Priority fee in microlamports per CU (0 = none, 5000 = recommended)"),
+            computeUnits: zod_1.z
+                .number()
+                .int()
+                .min(0)
+                .nullish()
+                .describe("Compute unit limit (default 200k, recommended 300k for batch)"),
+            skipPreflight: zod_1.z
+                .boolean()
+                .nullish()
+                .describe("Skip Solana simulation before submitting (saves ~400ms)"),
+        }),
+        output: writeOutput,
+    },
+    fetchEscrow: {
+        input: zod_1.z.object({
+            agentWallet: pubkey.describe("Agent wallet"),
+            depositor: pubkey.nullish().describe("Depositor wallet (defaults to caller)"),
+        }),
+        output: zod_1.z.object({
+            agent: pubkey,
+            depositor: pubkey,
+            agentWallet: pubkey,
+            balance: zod_1.z.string(),
+            totalDeposited: zod_1.z.string(),
+            totalSettled: zod_1.z.string(),
+            totalCallsSettled: zod_1.z.string(),
+            pricePerCall: zod_1.z.string(),
+            maxCalls: zod_1.z.string(),
+            expiresAt: zod_1.z.string(),
+            tokenDecimals: zod_1.z.number(),
+            tokenMint: zod_1.z.string().nullish(),
+        }),
+    },
+};
+// ═══════════════════════════════════════════════════════════════════
+//  Tools Schemas
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Zod input/output schemas for the **sap-tools** protocol (7 tools).
+ *
+ * @name toolsSchemas
+ * @description Covers tool publishing, schema inscription, updates,
+ *   activation lifecycle, invocation reporting, and descriptor fetching.
+ * @category Plugin
+ * @since v0.1.0
+ */
+exports.toolsSchemas = {
+    publishToolByName: {
+        input: zod_1.z.object({
+            toolName: zod_1.z.string().max(64).describe("Tool name (e.g. 'swap')"),
+            protocolId: zod_1.z.string().describe("Protocol ID (e.g. 'jupiter')"),
+            description: zod_1.z
+                .string()
+                .max(256)
+                .describe("Tool description for LLM consumption"),
+            inputSchema: zod_1.z
+                .string()
+                .describe("JSON schema string for tool input"),
+            outputSchema: zod_1.z
+                .string()
+                .describe("JSON schema string for tool output"),
+            httpMethod: zod_1.z
+                .enum(["get", "post", "put", "delete", "compound"])
+                .describe("HTTP method"),
+            category: zod_1.z
+                .enum([
+                "swap",
+                "lend",
+                "stake",
+                "nft",
+                "payment",
+                "data",
+                "governance",
+                "bridge",
+                "analytics",
+                "custom",
+            ])
+                .describe("Tool category for discovery"),
+            paramsCount: zod_1.z.number().int().describe("Total parameter count"),
+            requiredParams: zod_1.z.number().int().describe("Required parameter count"),
+            isCompound: zod_1.z
+                .boolean()
+                .default(false)
+                .describe("Whether tool chains multiple actions"),
+        }),
+        output: writeOutput,
+    },
+    inscribeToolSchema: {
+        input: zod_1.z.object({
+            toolName: zod_1.z.string().describe("Tool name"),
+            schemaType: zod_1.z
+                .enum(["input", "output", "description"])
+                .describe("Schema type to inscribe"),
+            schemaData: zod_1.z.string().describe("Schema content (JSON string)"),
+            compression: zod_1.z
+                .enum(["none", "deflate", "gzip", "brotli"])
+                .default("none")
+                .describe("Compression algorithm"),
+        }),
+        output: writeOutput,
+    },
+    updateTool: {
+        input: zod_1.z.object({
+            toolName: zod_1.z.string().describe("Tool name to update"),
+            httpMethod: zod_1.z
+                .enum(["get", "post", "put", "delete", "compound"])
+                .nullish(),
+            category: zod_1.z
+                .enum([
+                "swap",
+                "lend",
+                "stake",
+                "nft",
+                "payment",
+                "data",
+                "governance",
+                "bridge",
+                "analytics",
+                "custom",
+            ])
+                .nullish(),
+            paramsCount: zod_1.z.number().int().nullish(),
+            requiredParams: zod_1.z.number().int().nullish(),
+        }),
+        output: writeOutput,
+    },
+    deactivateTool: {
+        input: zod_1.z.object({
+            toolName: zod_1.z.string().describe("Tool name to deactivate"),
+        }),
+        output: writeOutput,
+    },
+    reactivateTool: {
+        input: zod_1.z.object({
+            toolName: zod_1.z.string().describe("Tool name to reactivate"),
+        }),
+        output: writeOutput,
+    },
+    reportInvocations: {
+        input: zod_1.z.object({
+            toolName: zod_1.z.string().describe("Tool name"),
+            invocations: zod_1.z
+                .number()
+                .int()
+                .positive()
+                .describe("Number of invocations to report"),
+        }),
+        output: writeOutput,
+    },
+    fetchTool: {
+        input: zod_1.z.object({
+            agentWallet: pubkey.describe("Agent wallet that published the tool"),
+            toolName: zod_1.z.string().describe("Tool name"),
+        }),
+        output: zod_1.z.object({
+            toolName: zod_1.z.string(),
+            version: zod_1.z.number(),
+            isActive: zod_1.z.boolean(),
+            totalInvocations: zod_1.z.string(),
+            paramsCount: zod_1.z.number(),
+            requiredParams: zod_1.z.number(),
+            isCompound: zod_1.z.boolean(),
+            agent: pubkey,
+            createdAt: zod_1.z.string(),
+            updatedAt: zod_1.z.string(),
+        }),
+    },
+};
+// ═══════════════════════════════════════════════════════════════════
+//  Vault Schemas
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Zod input/output schemas for the **sap-vault** protocol (10 tools).
+ *
+ * @name vaultSchemas
+ * @description Covers vault initialization, session management, encrypted
+ *   memory inscription, nonce rotation, delegate authorization, and
+ *   vault/session data fetching.
+ * @category Plugin
+ * @since v0.1.0
+ */
+exports.vaultSchemas = {
+    initVault: {
+        input: zod_1.z.object({
+            vaultNonce: hash32.describe("32-byte encryption nonce for vault initialization"),
+        }),
+        output: writeOutput,
+    },
+    openSession: {
+        input: zod_1.z.object({
+            sessionHash: hash32.describe("32-byte session identifier hash"),
+        }),
+        output: writeOutput,
+    },
+    inscribeMemory: {
+        input: zod_1.z.object({
+            sessionHash: zod_1.z
+                .string()
+                .describe("Hex-encoded session hash for PDA derivation"),
+            sequence: zod_1.z.number().int().describe("Sequence number within session"),
+            encryptedData: zod_1.z
+                .string()
+                .describe("Hex-encoded encrypted payload"),
+            nonce: zod_1.z
+                .array(zod_1.z.number().int().min(0).max(255))
+                .length(12)
+                .describe("12-byte AES-GCM nonce"),
+            contentHash: hash32.describe("SHA-256 of plaintext content"),
+            totalFragments: zod_1.z
+                .number()
+                .int()
+                .min(1)
+                .default(1)
+                .describe("Total fragments (1 = single)"),
+            fragmentIndex: zod_1.z.number().int().default(0).describe("Fragment index"),
+            compression: zod_1.z
+                .number()
+                .int()
+                .default(0)
+                .describe("Compression type (0=none, 1=deflate, 2=gzip, 3=brotli)"),
+            epochIndex: zod_1.z.number().int().default(0).describe("Epoch page index"),
+        }),
+        output: writeOutput,
+    },
+    closeSession: {
+        input: zod_1.z.object({
+            sessionHash: zod_1.z
+                .string()
+                .describe("Hex-encoded session hash for PDA derivation"),
+        }),
+        output: writeOutput,
+    },
+    closeVault: {
+        input: zod_1.z.object({}),
+        output: writeOutput,
+    },
+    rotateNonce: {
+        input: zod_1.z.object({
+            newNonce: hash32.describe("New 32-byte encryption nonce"),
+        }),
+        output: writeOutput,
+    },
+    addDelegate: {
+        input: zod_1.z.object({
+            delegatePubkey: pubkey.describe("Wallet to authorize as delegate"),
+            permissions: zod_1.z
+                .number()
+                .int()
+                .min(1)
+                .max(7)
+                .describe("Permission bitmask (1=inscribe, 2=closeSession, 4=openSession, 7=all)"),
+            expiresAt: zod_1.z
+                .string()
+                .describe("Delegation expiry (unix timestamp seconds)"),
+        }),
+        output: writeOutput,
+    },
+    revokeDelegate: {
+        input: zod_1.z.object({
+            delegatePubkey: pubkey.describe("Delegate wallet to revoke"),
+        }),
+        output: writeOutput,
+    },
+    fetchVault: {
+        input: zod_1.z.object({
+            agentWallet: pubkey
+                .nullish()
+                .describe("Agent wallet (defaults to caller)"),
+        }),
+        output: zod_1.z.object({
+            agent: pubkey,
+            wallet: pubkey,
+            totalSessions: zod_1.z.number(),
+            totalInscriptions: zod_1.z.string(),
+            totalBytesInscribed: zod_1.z.string(),
+            protocolVersion: zod_1.z.number(),
+            nonceVersion: zod_1.z.number(),
+            createdAt: zod_1.z.string(),
+        }),
+    },
+    fetchSession: {
+        input: zod_1.z.object({
+            agentWallet: pubkey.describe("Agent wallet"),
+            sessionHash: zod_1.z
+                .string()
+                .describe("Hex-encoded session hash"),
+        }),
+        output: zod_1.z.object({
+            vault: pubkey,
+            sequenceCounter: zod_1.z.number(),
+            totalBytes: zod_1.z.string(),
+            currentEpoch: zod_1.z.number(),
+            totalEpochs: zod_1.z.number(),
+            isClosed: zod_1.z.boolean(),
+            createdAt: zod_1.z.string(),
+            lastInscribedAt: zod_1.z.string(),
+        }),
+    },
+};
+// ═══════════════════════════════════════════════════════════════════
+//  Indexing Schemas
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Zod input/output schemas for the **sap-indexing** protocol (8 tools).
+ *
+ * @name indexingSchemas
+ * @description Covers capability and protocol index creation, agent
+ *   registration/removal within indexes, and index data fetching.
+ * @category Plugin
+ * @since v0.1.0
+ */
+exports.indexingSchemas = {
+    initCapabilityIndex: {
+        input: zod_1.z.object({
+            capabilityId: zod_1.z
+                .string()
+                .describe("Capability ID to index (e.g. 'jupiter:swap')"),
+        }),
+        output: writeOutput,
+    },
+    addToCapabilityIndex: {
+        input: zod_1.z.object({
+            capabilityId: zod_1.z.string().describe("Capability ID"),
+        }),
+        output: writeOutput,
+    },
+    removeFromCapabilityIndex: {
+        input: zod_1.z.object({
+            capabilityId: zod_1.z.string().describe("Capability ID"),
+        }),
+        output: writeOutput,
+    },
+    initProtocolIndex: {
+        input: zod_1.z.object({
+            protocolId: zod_1.z
+                .string()
+                .describe("Protocol ID to index (e.g. 'jupiter')"),
+        }),
+        output: writeOutput,
+    },
+    addToProtocolIndex: {
+        input: zod_1.z.object({
+            protocolId: zod_1.z.string().describe("Protocol ID"),
+        }),
+        output: writeOutput,
+    },
+    removeFromProtocolIndex: {
+        input: zod_1.z.object({
+            protocolId: zod_1.z.string().describe("Protocol ID"),
+        }),
+        output: writeOutput,
+    },
+    fetchCapabilityIndex: {
+        input: zod_1.z.object({
+            capabilityId: zod_1.z.string().describe("Capability ID to look up"),
+        }),
+        output: zod_1.z.object({
+            capabilityId: zod_1.z.string(),
+            agents: zod_1.z.array(pubkey).describe("Agents registered for this capability"),
+            totalPages: zod_1.z.number(),
+            lastUpdated: zod_1.z.string(),
+        }),
+    },
+    fetchProtocolIndex: {
+        input: zod_1.z.object({
+            protocolId: zod_1.z.string().describe("Protocol ID to look up"),
+        }),
+        output: zod_1.z.object({
+            protocolId: zod_1.z.string(),
+            agents: zod_1.z.array(pubkey).describe("Agents registered for this protocol"),
+            totalPages: zod_1.z.number(),
+            lastUpdated: zod_1.z.string(),
+        }),
+    },
+};
+// ═══════════════════════════════════════════════════════════════════
+//  Ledger Schemas
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Zod input/output schemas for the **sap-ledger** protocol (6 tools).
+ *
+ * @name ledgerSchemas
+ * @description Covers ledger initialization, ring-buffer writes, sealing
+ *   to permanent pages, ledger closure, and metadata/page fetching.
+ * @category Plugin
+ * @since v0.1.0
+ */
+exports.ledgerSchemas = {
+    initLedger: {
+        input: zod_1.z.object({
+            sessionHash: zod_1.z
+                .string()
+                .describe("Hex-encoded session hash (the session must exist)"),
+            agentWallet: pubkey
+                .nullish()
+                .describe("Agent wallet (defaults to caller)"),
+        }),
+        output: writeOutput,
+    },
+    writeLedger: {
+        input: zod_1.z.object({
+            sessionHash: zod_1.z.string().describe("Hex-encoded session hash"),
+            agentWallet: pubkey
+                .nullish()
+                .describe("Agent wallet (defaults to caller)"),
+            data: zod_1.z
+                .string()
+                .describe("Hex-encoded data to write to ring buffer"),
+            contentHash: hash32.describe("SHA-256 of the plaintext data"),
+        }),
+        output: writeOutput,
+    },
+    sealLedger: {
+        input: zod_1.z.object({
+            sessionHash: zod_1.z.string().describe("Hex-encoded session hash"),
+            agentWallet: pubkey
+                .nullish()
+                .describe("Agent wallet (defaults to caller)"),
+        }),
+        output: writeOutput,
+    },
+    closeLedger: {
+        input: zod_1.z.object({
+            sessionHash: zod_1.z.string().describe("Hex-encoded session hash"),
+            agentWallet: pubkey
+                .nullish()
+                .describe("Agent wallet (defaults to caller)"),
+        }),
+        output: writeOutput,
+    },
+    fetchLedger: {
+        input: zod_1.z.object({
+            sessionHash: zod_1.z.string().describe("Hex-encoded session hash"),
+            agentWallet: pubkey
+                .nullish()
+                .describe("Agent wallet (defaults to caller)"),
+        }),
+        output: zod_1.z.object({
+            session: pubkey,
+            authority: pubkey,
+            numEntries: zod_1.z.number(),
+            totalDataSize: zod_1.z.string(),
+            numPages: zod_1.z.number(),
+            createdAt: zod_1.z.string(),
+            updatedAt: zod_1.z.string(),
+        }),
+    },
+    fetchLedgerPage: {
+        input: zod_1.z.object({
+            sessionHash: zod_1.z.string().describe("Hex-encoded session hash"),
+            agentWallet: pubkey
+                .nullish()
+                .describe("Agent wallet (defaults to caller)"),
+            pageIndex: zod_1.z.number().int().describe("Page index"),
+        }),
+        output: zod_1.z.object({
+            ledger: pubkey,
+            pageIndex: zod_1.z.number(),
+            sealedAt: zod_1.z.string(),
+            entriesInPage: zod_1.z.number(),
+            dataSize: zod_1.z.number(),
+            data: zod_1.z.array(zod_1.z.number()).describe("Raw page data bytes"),
+        }),
+    },
+};
+//# sourceMappingURL=schemas.js.map