@oobe-protocol-labs/sap-mcp-server 0.9.16 → 0.9.21

package/dist/schemas/common.schema.js

@@ -1,36 +1,73 @@
 /**
- * Common Zod schemas
+ * @name schemas/common
+ * @description Shared Zod schema primitives reused across every SAP MCP tool schema.
+ *
+ * These base schemas — wallet addresses, public keys, signatures, PDAs, pagination,
+ * amounts, and SOL amounts — are imported by domain-specific schema modules to
+ * build consistent validation rules without duplication.
+ *
+ * @flow
+ *   1. Domain schema modules (identity, registry, payments, etc.) import the
+ *      primitives they need from this file.
+ *   2. `schemas/index.ts` re-exports everything for the MCP tool layer.
+ *   3. Tool handlers consume the composed schemas for input validation.
+ *
+ * @module schemas/common
  */
 import { z } from 'zod';
 /**
- * Shared wallet schema definition used by the SAP MCP runtime.
+ * @name WalletSchema
+ * @description Zod schema validating a base58-encoded Solana wallet address.
+ *
+ * @usedBy `identity.schema.ts`, `registry.schema.ts`, `payments.schema.ts`, `reputation.schema.ts`, `settlement.schema.ts`
  */
 export const WalletSchema = z.string().describe('Wallet address (base58)');
 /**
- * Shared public key schema definition used by the SAP MCP runtime.
+ * @name PublicKeySchema
+ * @description Zod schema validating a base58-encoded Solana public key.
+ *
+ * @usedBy Domain schema modules requiring generic public key validation.
  */
 export const PublicKeySchema = z.string().describe('Public key (base58)');
 /**
- * Shared signature schema definition used by the SAP MCP runtime.
+ * @name SignatureSchema
+ * @description Zod schema validating a base58-encoded transaction signature.
+ *
+ * @usedBy `execution-proof.schema.ts`, `transaction.schema.ts`
  */
 export const SignatureSchema = z.string().describe('Transaction signature (base58)');
 /**
- * Shared pda schema definition used by the SAP MCP runtime.
+ * @name PdaSchema
+ * @description Zod schema validating a base58-encoded Program Derived Address.
+ *
+ * @usedBy `memory.schema.ts`, `registry.schema.ts`, `settlement.schema.ts`
  */
 export const PdaSchema = z.string().describe('Program Derived Address (base58)');
 /**
- * Shared pagination schema definition used by the SAP MCP runtime.
+ * @name PaginationSchema
+ * @description Zod schema for pagination parameters (limit and offset) with sensible defaults.
+ *
+ * @property limit  — Maximum number of items to return (default 50).
+ * @property offset — Number of items to skip (default 0).
+ *
+ * @usedBy List-type MCP tools across the SAP MCP runtime.
  */
 export const PaginationSchema = z.object({
     limit: z.number().default(50),
     offset: z.number().default(0),
 });
 /**
- * Shared amount schema definition used by the SAP MCP runtime.
+ * @name AmountSchema
+ * @description Zod schema validating a positive amount in lamports (1 SOL = 1e9 lamports).
+ *
+ * @usedBy `payments.schema.ts`, `settlement.schema.ts`
  */
 export const AmountSchema = z.number().positive().describe('Amount in lamports');
 /**
- * Shared sol amount schema definition used by the SAP MCP runtime.
+ * @name SolAmountSchema
+ * @description Zod schema validating a non-negative amount in SOL.
+ *
+ * @usedBy Transaction and balance-related MCP tools.
  */
 export const SolAmountSchema = z.number().nonnegative().describe('Amount in SOL');
 //# sourceMappingURL=common.schema.js.map

package/dist/schemas/common.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.schema.js","sourceRoot":"","sources":["../../src/schemas/common.schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC;AAC3E;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;AAC1E;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC,CAAC;AACrF;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC,CAAC;AAEjF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;CAC9B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;AACjF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC"}
+{"version":3,"file":"common.schema.js","sourceRoot":"","sources":["../../src/schemas/common.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC,CAAC;AAErF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC,CAAC;AAEjF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;CAC9B,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;AAEjF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC"}

package/dist/schemas/developer.schema.d.ts

@@ -1,9 +1,22 @@
 /**
- * Developer schemas
+ * @name schemas/developer
+ * @description Zod schemas for developer-facing MCP tool inputs (error explanation and code snippet generation).
+ *
+ * @flow
+ *   1. Developer MCP tools import these schemas for input validation.
+ *   2. `schemas/index.ts` re-exports them for external consumers.
+ *
+ * @module schemas/developer
  */
 import { z } from 'zod';
 /**
- * Shared explain error schema definition used by the SAP MCP runtime.
+ * @name ExplainErrorSchema
+ * @description Zod schema for the explain-error developer tool input.
+ *
+ * @property errorCode — The error code to explain.
+ * @property context   — Optional additional context string.
+ *
+ * @usedBy Developer tools in the SAP MCP runtime.
  */
 export declare const ExplainErrorSchema: z.ZodObject<{
     errorCode: z.ZodString;
@@ -16,7 +29,13 @@ export declare const ExplainErrorSchema: z.ZodObject<{
     context?: string | undefined;
 }>;
 /**
- * Shared generate snippet schema definition used by the SAP MCP runtime.
+ * @name GenerateSnippetSchema
+ * @description Zod schema for the generate-snippet developer tool input.
+ *
+ * @property operation — The SAP operation to generate a code snippet for.
+ * @property language  — Target language: `typescript`, `javascript`, or `python` (default `typescript`).
+ *
+ * @usedBy Developer tools in the SAP MCP runtime.
  */
 export declare const GenerateSnippetSchema: z.ZodObject<{
     operation: z.ZodString;

package/dist/schemas/developer.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"developer.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/developer.schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;EAGhC,CAAC"}
+{"version":3,"file":"developer.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/developer.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;EAGhC,CAAC"}

package/dist/schemas/developer.schema.js

@@ -1,16 +1,35 @@
 /**
- * Developer schemas
+ * @name schemas/developer
+ * @description Zod schemas for developer-facing MCP tool inputs (error explanation and code snippet generation).
+ *
+ * @flow
+ *   1. Developer MCP tools import these schemas for input validation.
+ *   2. `schemas/index.ts` re-exports them for external consumers.
+ *
+ * @module schemas/developer
  */
 import { z } from 'zod';
 /**
- * Shared explain error schema definition used by the SAP MCP runtime.
+ * @name ExplainErrorSchema
+ * @description Zod schema for the explain-error developer tool input.
+ *
+ * @property errorCode — The error code to explain.
+ * @property context   — Optional additional context string.
+ *
+ * @usedBy Developer tools in the SAP MCP runtime.
  */
 export const ExplainErrorSchema = z.object({
     errorCode: z.string(),
     context: z.string().optional(),
 });
 /**
- * Shared generate snippet schema definition used by the SAP MCP runtime.
+ * @name GenerateSnippetSchema
+ * @description Zod schema for the generate-snippet developer tool input.
+ *
+ * @property operation — The SAP operation to generate a code snippet for.
+ * @property language  — Target language: `typescript`, `javascript`, or `python` (default `typescript`).
+ *
+ * @usedBy Developer tools in the SAP MCP runtime.
  */
 export const GenerateSnippetSchema = z.object({
     operation: z.string(),

package/dist/schemas/developer.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"developer.schema.js","sourceRoot":"","sources":["../../src/schemas/developer.schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;CAC/E,CAAC,CAAC"}
+{"version":3,"file":"developer.schema.js","sourceRoot":"","sources":["../../src/schemas/developer.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;CAC/E,CAAC,CAAC"}

package/dist/schemas/execution-proof.schema.d.ts

@@ -1,9 +1,22 @@
 /**
- * Execution proof schemas
+ * @name schemas/execution-proof
+ * @description Zod schemas for execution proof operations — hash computation, proof submission, and hash verification.
+ *
+ * @flow
+ *   1. Execution-proof MCP tools import these schemas for input validation.
+ *   2. `schemas/index.ts` re-exports them for external consumers.
+ *
+ * @module schemas/execution-proof
  */
 import { z } from 'zod';
 /**
- * Shared hash execution schema definition used by the SAP MCP runtime.
+ * @name HashExecutionSchema
+ * @description Zod schema for computing a hash over an execution trace.
+ *
+ * @property trace     — The execution trace string to hash.
+ * @property algorithm — Hash algorithm: `sha256` or `keccak256` (default `sha256`).
+ *
+ * @usedBy Execution-proof MCP tools in the SAP MCP runtime.
  */
 export declare const HashExecutionSchema: z.ZodObject<{
     trace: z.ZodString;
@@ -16,7 +29,13 @@ export declare const HashExecutionSchema: z.ZodObject<{
     algorithm?: "sha256" | "keccak256" | undefined;
 }>;
 /**
- * Shared submit proof schema definition used by the SAP MCP runtime.
+ * @name SubmitProofSchema
+ * @description Zod schema for submitting a cryptographic proof with a signature.
+ *
+ * @property proof     — The proof string to submit.
+ * @property signature — The signature authorizing the proof.
+ *
+ * @usedBy Execution-proof MCP tools in the SAP MCP runtime.
  */
 export declare const SubmitProofSchema: z.ZodObject<{
     proof: z.ZodString;
@@ -29,7 +48,13 @@ export declare const SubmitProofSchema: z.ZodObject<{
     proof: string;
 }>;
 /**
- * Shared verify hash schema definition used by the SAP MCP runtime.
+ * @name VerifyHashSchema
+ * @description Zod schema for verifying that data matches a given hash.
+ *
+ * @property hash — The expected hash value.
+ * @property data — The data string to verify against the hash.
+ *
+ * @usedBy Execution-proof MCP tools in the SAP MCP runtime.
  */
 export declare const VerifyHashSchema: z.ZodObject<{
     hash: z.ZodString;

package/dist/schemas/execution-proof.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execution-proof.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/execution-proof.schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;EAG9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAC"}
+{"version":3,"file":"execution-proof.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/execution-proof.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;EAG9B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAC"}

package/dist/schemas/execution-proof.schema.js

@@ -1,23 +1,48 @@
 /**
- * Execution proof schemas
+ * @name schemas/execution-proof
+ * @description Zod schemas for execution proof operations — hash computation, proof submission, and hash verification.
+ *
+ * @flow
+ *   1. Execution-proof MCP tools import these schemas for input validation.
+ *   2. `schemas/index.ts` re-exports them for external consumers.
+ *
+ * @module schemas/execution-proof
  */
 import { z } from 'zod';
 /**
- * Shared hash execution schema definition used by the SAP MCP runtime.
+ * @name HashExecutionSchema
+ * @description Zod schema for computing a hash over an execution trace.
+ *
+ * @property trace     — The execution trace string to hash.
+ * @property algorithm — Hash algorithm: `sha256` or `keccak256` (default `sha256`).
+ *
+ * @usedBy Execution-proof MCP tools in the SAP MCP runtime.
  */
 export const HashExecutionSchema = z.object({
     trace: z.string(),
     algorithm: z.enum(['sha256', 'keccak256']).default('sha256'),
 });
 /**
- * Shared submit proof schema definition used by the SAP MCP runtime.
+ * @name SubmitProofSchema
+ * @description Zod schema for submitting a cryptographic proof with a signature.
+ *
+ * @property proof     — The proof string to submit.
+ * @property signature — The signature authorizing the proof.
+ *
+ * @usedBy Execution-proof MCP tools in the SAP MCP runtime.
  */
 export const SubmitProofSchema = z.object({
     proof: z.string(),
     signature: z.string(),
 });
 /**
- * Shared verify hash schema definition used by the SAP MCP runtime.
+ * @name VerifyHashSchema
+ * @description Zod schema for verifying that data matches a given hash.
+ *
+ * @property hash — The expected hash value.
+ * @property data — The data string to verify against the hash.
+ *
+ * @usedBy Execution-proof MCP tools in the SAP MCP runtime.
  */
 export const VerifyHashSchema = z.object({
     hash: z.string(),

package/dist/schemas/execution-proof.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"execution-proof.schema.js","sourceRoot":"","sources":["../../src/schemas/execution-proof.schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;CAC7D,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC"}
+{"version":3,"file":"execution-proof.schema.js","sourceRoot":"","sources":["../../src/schemas/execution-proof.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;CAC7D,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC"}

package/dist/schemas/identity.schema.d.ts

@@ -1,9 +1,23 @@
 /**
- * Identity schemas
+ * @name schemas/identity
+ * @description Zod schemas for identity verification operations across SAP Protocol bridges.
+ *
+ * @flow
+ *   1. Identity MCP tools import these schemas for input validation.
+ *   2. `schemas/index.ts` re-exports them for external consumers.
+ *
+ * @module schemas/identity
  */
 import { z } from 'zod';
 /**
- * Shared bridge identity schema definition used by the SAP MCP runtime.
+ * @name BridgeIdentitySchema
+ * @description Zod schema for resolving a bridge identity (Metaplex or SAID) for a given wallet.
+ *
+ * @property wallet  — Base58 wallet address of the agent.
+ * @property bridge  — Identity bridge type: `metaplex` or `said`.
+ * @property assetId — Optional on-chain asset id associated with the identity.
+ *
+ * @usedBy Identity MCP tools in the SAP MCP runtime.
  */
 export declare const BridgeIdentitySchema: z.ZodObject<{
     wallet: z.ZodString;
@@ -19,7 +33,13 @@ export declare const BridgeIdentitySchema: z.ZodObject<{
     assetId?: string | undefined;
 }>;
 /**
- * Shared verify identity schema definition used by the SAP MCP runtime.
+ * @name VerifyIdentitySchema
+ * @description Zod schema for verifying an agent's identity on a SAP Protocol bridge.
+ *
+ * @property wallet — Base58 wallet address of the agent to verify.
+ * @property bridge — Identity bridge type: `metaplex` or `said`.
+ *
+ * @usedBy Identity MCP tools in the SAP MCP runtime.
  */
 export declare const VerifyIdentitySchema: z.ZodObject<{
     wallet: z.ZodString;

package/dist/schemas/identity.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identity.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/identity.schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAC"}
+{"version":3,"file":"identity.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/identity.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAC"}

package/dist/schemas/identity.schema.js

@@ -1,10 +1,24 @@
 /**
- * Identity schemas
+ * @name schemas/identity
+ * @description Zod schemas for identity verification operations across SAP Protocol bridges.
+ *
+ * @flow
+ *   1. Identity MCP tools import these schemas for input validation.
+ *   2. `schemas/index.ts` re-exports them for external consumers.
+ *
+ * @module schemas/identity
  */
 import { z } from 'zod';
 import { WalletSchema } from './common.schema.js';
 /**
- * Shared bridge identity schema definition used by the SAP MCP runtime.
+ * @name BridgeIdentitySchema
+ * @description Zod schema for resolving a bridge identity (Metaplex or SAID) for a given wallet.
+ *
+ * @property wallet  — Base58 wallet address of the agent.
+ * @property bridge  — Identity bridge type: `metaplex` or `said`.
+ * @property assetId — Optional on-chain asset id associated with the identity.
+ *
+ * @usedBy Identity MCP tools in the SAP MCP runtime.
  */
 export const BridgeIdentitySchema = z.object({
     wallet: WalletSchema,
@@ -12,7 +26,13 @@ export const BridgeIdentitySchema = z.object({
     assetId: z.string().optional(),
 });
 /**
- * Shared verify identity schema definition used by the SAP MCP runtime.
+ * @name VerifyIdentitySchema
+ * @description Zod schema for verifying an agent's identity on a SAP Protocol bridge.
+ *
+ * @property wallet — Base58 wallet address of the agent to verify.
+ * @property bridge — Identity bridge type: `metaplex` or `said`.
+ *
+ * @usedBy Identity MCP tools in the SAP MCP runtime.
  */
 export const VerifyIdentitySchema = z.object({
     wallet: WalletSchema,

package/dist/schemas/identity.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"identity.schema.js","sourceRoot":"","sources":["../../src/schemas/identity.schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;CACrC,CAAC,CAAC"}
+{"version":3,"file":"identity.schema.js","sourceRoot":"","sources":["../../src/schemas/identity.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;CACrC,CAAC,CAAC"}

package/dist/schemas/index.d.ts

@@ -1,5 +1,15 @@
 /**
- * Schemas module barrel export.
+ * @name schemas/index
+ * @description Barrel export for all SAP MCP Zod schema modules.
+ *
+ * Re-exports every domain-specific schema so the MCP tool layer and external
+ * consumers can import from a single entry point.
+ *
+ * @flow
+ *   1. MCP tool handlers import schemas from `schemas/index.ts`.
+ *   2. Each domain schema module is re-exported in alphabetical order.
+ *
+ * @module schemas/index
  */
 export * from './common.schema.js';
 export * from './registry.schema.js';

package/dist/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}

package/dist/schemas/index.js

@@ -1,5 +1,15 @@
 /**
- * Schemas module barrel export.
+ * @name schemas/index
+ * @description Barrel export for all SAP MCP Zod schema modules.
+ *
+ * Re-exports every domain-specific schema so the MCP tool layer and external
+ * consumers can import from a single entry point.
+ *
+ * @flow
+ *   1. MCP tool handlers import schemas from `schemas/index.ts`.
+ *   2. Each domain schema module is re-exported in alphabetical order.
+ *
+ * @module schemas/index
  */
 export * from './common.schema.js';
 export * from './registry.schema.js';

package/dist/schemas/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}

package/dist/schemas/memory.schema.d.ts

@@ -1,9 +1,22 @@
 /**
- * Memory schemas
+ * @name schemas/memory
+ * @description Zod schemas for SAP on-chain memory vault operations (read and write).
+ *
+ * @flow
+ *   1. Memory MCP tools import these schemas for input validation.
+ *   2. `schemas/index.ts` re-exports them for external consumers.
+ *
+ * @module schemas/memory
  */
 import { z } from 'zod';
 /**
- * Shared read memory schema definition used by the SAP MCP runtime.
+ * @name ReadMemorySchema
+ * @description Zod schema for reading from a SAP memory vault at a given slot.
+ *
+ * @property vault — Program Derived Address of the memory vault.
+ * @property slot  — Non-negative slot number to read from.
+ *
+ * @usedBy Memory MCP tools in the SAP MCP runtime.
  */
 export declare const ReadMemorySchema: z.ZodObject<{
     vault: z.ZodString;
@@ -16,7 +29,14 @@ export declare const ReadMemorySchema: z.ZodObject<{
     slot: number;
 }>;
 /**
- * Shared write memory schema definition used by the SAP MCP runtime.
+ * @name WriteMemorySchema
+ * @description Zod schema for writing data to a SAP memory vault at an optional slot.
+ *
+ * @property vault — Program Derived Address of the memory vault.
+ * @property data  — String payload to write to the vault.
+ * @property slot  — Optional non-negative slot number (appends if omitted).
+ *
+ * @usedBy Memory MCP tools in the SAP MCP runtime.
  */
 export declare const WriteMemorySchema: z.ZodObject<{
     vault: z.ZodString;

package/dist/schemas/memory.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/memory.schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAI5B,CAAC"}
+{"version":3,"file":"memory.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/memory.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAI5B,CAAC"}

package/dist/schemas/memory.schema.js

@@ -1,17 +1,37 @@
 /**
- * Memory schemas
+ * @name schemas/memory
+ * @description Zod schemas for SAP on-chain memory vault operations (read and write).
+ *
+ * @flow
+ *   1. Memory MCP tools import these schemas for input validation.
+ *   2. `schemas/index.ts` re-exports them for external consumers.
+ *
+ * @module schemas/memory
  */
 import { z } from 'zod';
 import { PdaSchema } from './common.schema.js';
 /**
- * Shared read memory schema definition used by the SAP MCP runtime.
+ * @name ReadMemorySchema
+ * @description Zod schema for reading from a SAP memory vault at a given slot.
+ *
+ * @property vault — Program Derived Address of the memory vault.
+ * @property slot  — Non-negative slot number to read from.
+ *
+ * @usedBy Memory MCP tools in the SAP MCP runtime.
  */
 export const ReadMemorySchema = z.object({
     vault: PdaSchema,
     slot: z.number().nonnegative(),
 });
 /**
- * Shared write memory schema definition used by the SAP MCP runtime.
+ * @name WriteMemorySchema
+ * @description Zod schema for writing data to a SAP memory vault at an optional slot.
+ *
+ * @property vault — Program Derived Address of the memory vault.
+ * @property data  — String payload to write to the vault.
+ * @property slot  — Optional non-negative slot number (appends if omitted).
+ *
+ * @usedBy Memory MCP tools in the SAP MCP runtime.
  */
 export const WriteMemorySchema = z.object({
     vault: PdaSchema,

package/dist/schemas/memory.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory.schema.js","sourceRoot":"","sources":["../../src/schemas/memory.schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;CAC/B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC"}
+{"version":3,"file":"memory.schema.js","sourceRoot":"","sources":["../../src/schemas/memory.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;CAC/B,CAAC,CAAC;AAEH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC"}

package/dist/schemas/payments.schema.d.ts

@@ -1,9 +1,23 @@
 /**
- * Payments schemas
+ * @name schemas/payments
+ * @description Zod schemas for SAP payment operations — payment intent creation and x402 protocol requests.
+ *
+ * @flow
+ *   1. Payment MCP tools import these schemas for input validation.
+ *   2. `schemas/index.ts` re-exports them for external consumers.
+ *
+ * @module schemas/payments
  */
 import { z } from 'zod';
 /**
- * Shared create payment intent schema definition used by the SAP MCP runtime.
+ * @name CreatePaymentIntentSchema
+ * @description Zod schema for creating a payment intent for an agent.
+ *
+ * @property agent    — Base58 wallet address of the paying agent.
+ * @property amount   — Positive amount in lamports to escrow.
+ * @property maxCalls — Maximum number of calls the payment intent covers.
+ *
+ * @usedBy Payment MCP tools in the SAP MCP runtime.
  */
 export declare const CreatePaymentIntentSchema: z.ZodObject<{
     agent: z.ZodString;
@@ -19,7 +33,14 @@ export declare const CreatePaymentIntentSchema: z.ZodObject<{
     maxCalls: number;
 }>;
 /**
- * Shared x402 request schema definition used by the SAP MCP runtime.
+ * @name X402RequestSchema
+ * @description Zod schema for initiating an x402 protocol payment request.
+ *
+ * @property agent   — Base58 wallet address of the paying agent.
+ * @property amount  — Positive amount in lamports to charge.
+ * @property service — Service identifier string for the x402 payment.
+ *
+ * @usedBy Payment MCP tools in the SAP MCP runtime.
  */
 export declare const X402RequestSchema: z.ZodObject<{
     agent: z.ZodString;

package/dist/schemas/payments.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payments.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/payments.schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;EAIpC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAI5B,CAAC"}
+{"version":3,"file":"payments.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/payments.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;EAIpC,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAI5B,CAAC"}

package/dist/schemas/payments.schema.js

@@ -1,10 +1,24 @@
 /**
- * Payments schemas
+ * @name schemas/payments
+ * @description Zod schemas for SAP payment operations — payment intent creation and x402 protocol requests.
+ *
+ * @flow
+ *   1. Payment MCP tools import these schemas for input validation.
+ *   2. `schemas/index.ts` re-exports them for external consumers.
+ *
+ * @module schemas/payments
  */
 import { z } from 'zod';
 import { WalletSchema, AmountSchema } from './common.schema.js';
 /**
- * Shared create payment intent schema definition used by the SAP MCP runtime.
+ * @name CreatePaymentIntentSchema
+ * @description Zod schema for creating a payment intent for an agent.
+ *
+ * @property agent    — Base58 wallet address of the paying agent.
+ * @property amount   — Positive amount in lamports to escrow.
+ * @property maxCalls — Maximum number of calls the payment intent covers.
+ *
+ * @usedBy Payment MCP tools in the SAP MCP runtime.
  */
 export const CreatePaymentIntentSchema = z.object({
     agent: WalletSchema,
@@ -12,7 +26,14 @@ export const CreatePaymentIntentSchema = z.object({
     maxCalls: z.number().positive(),
 });
 /**
- * Shared x402 request schema definition used by the SAP MCP runtime.
+ * @name X402RequestSchema
+ * @description Zod schema for initiating an x402 protocol payment request.
+ *
+ * @property agent   — Base58 wallet address of the paying agent.
+ * @property amount  — Positive amount in lamports to charge.
+ * @property service — Service identifier string for the x402 payment.
+ *
+ * @usedBy Payment MCP tools in the SAP MCP runtime.
  */
 export const X402RequestSchema = z.object({
     agent: WalletSchema,

package/dist/schemas/payments.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"payments.schema.js","sourceRoot":"","sources":["../../src/schemas/payments.schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEhE;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC"}
+{"version":3,"file":"payments.schema.js","sourceRoot":"","sources":["../../src/schemas/payments.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEhE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAEH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC"}