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

package/dist/esm/utils/schemas.d.ts

@@ -0,0 +1,351 @@
+/**
+ * @module utils/schemas
+ * @description Zod schemas for runtime validation of environment variables,
+ * tool arguments, agent manifests, and x402 payment parameters.
+ *
+ * These schemas enforce correctness at the boundary: CLI scripts refuse
+ * to run if required fields are missing or mis-typed, and SDK methods
+ * validate inputs before hitting the chain.
+ *
+ * Zod is a peer dependency — these schemas are tree-shaken if not imported.
+ *
+ * @category Utils
+ * @since v0.6.0
+ */
+/**
+ * @name createEnvSchema
+ * @description Create a Zod schema for SAP SDK environment variables.
+ * Validates that all required env vars are present and correctly typed.
+ *
+ * @returns A Zod schema object for env validation.
+ *
+ * @category Utils
+ * @since v0.6.0
+ *
+ * @example
+ * ```ts
+ * import { createEnvSchema } from "@synapse-sap/sdk";
+ *
+ * const schema = createEnvSchema();
+ * const env = schema.parse(process.env);
+ * // env.SOLANA_CLUSTER is typed as "mainnet-beta" | "devnet" | "localnet"
+ * ```
+ */
+export declare function createEnvSchema(): import("zod").ZodObject<{
+    SOLANA_CLUSTER: import("zod").ZodDefault<import("zod").ZodEnum<{
+        "mainnet-beta": "mainnet-beta";
+        devnet: "devnet";
+        localnet: "localnet";
+    }>>;
+    SOLANA_RPC_URL: import("zod").ZodOptional<import("zod").ZodString>;
+    SOLANA_FALLBACK_RPC_URL: import("zod").ZodOptional<import("zod").ZodString>;
+    SOLANA_WS_URL: import("zod").ZodOptional<import("zod").ZodString>;
+    WALLET_KEYPAIR_PATH: import("zod").ZodOptional<import("zod").ZodString>;
+    WALLET_PRIVATE_KEY: import("zod").ZodOptional<import("zod").ZodString>;
+    SAP_PROGRAM_ID: import("zod").ZodOptional<import("zod").ZodString>;
+    DATABASE_URL: import("zod").ZodOptional<import("zod").ZodString>;
+    LOG_LEVEL: import("zod").ZodDefault<import("zod").ZodEnum<{
+        error: "error";
+        info: "info";
+        debug: "debug";
+        warn: "warn";
+    }>>;
+    X402_ENDPOINT: import("zod").ZodOptional<import("zod").ZodString>;
+    AGENT_URI: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>;
+/**
+ * @name createEndpointDescriptorSchema
+ * @description Zod schema for {@link EndpointDescriptor}.
+ * @returns A Zod schema for endpoint descriptor validation.
+ * @category Utils
+ * @since v0.6.0
+ */
+export declare function createEndpointDescriptorSchema(): import("zod").ZodObject<{
+    url: import("zod").ZodString;
+    method: import("zod").ZodDefault<import("zod").ZodEnum<{
+        GET: "GET";
+        POST: "POST";
+        PUT: "PUT";
+        DELETE: "DELETE";
+    }>>;
+    contentType: import("zod").ZodDefault<import("zod").ZodString>;
+    requiresAuth: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    authType: import("zod").ZodOptional<import("zod").ZodEnum<{
+        bearer: "bearer";
+        "api-key": "api-key";
+        x402: "x402";
+        none: "none";
+    }>>;
+    requiresCSRF: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    requiresCookies: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    corsOrigins: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    requiredHeaders: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+}, import("zod/v4/core").$strip>;
+/**
+ * @name createHealthCheckSchema
+ * @description Zod schema for {@link HealthCheckDescriptor}.
+ * @returns A Zod schema for health check validation.
+ * @category Utils
+ * @since v0.6.0
+ */
+export declare function createHealthCheckSchema(): import("zod").ZodObject<{
+    url: import("zod").ZodString;
+    expectedStatus: import("zod").ZodDefault<import("zod").ZodNumber>;
+    timeoutMs: import("zod").ZodDefault<import("zod").ZodNumber>;
+    method: import("zod").ZodDefault<import("zod").ZodEnum<{
+        GET: "GET";
+        HEAD: "HEAD";
+    }>>;
+}, import("zod/v4/core").$strip>;
+/**
+ * @name createToolManifestEntrySchema
+ * @description Zod schema for a single tool in an agent manifest.
+ * @returns A Zod schema for tool manifest entry validation.
+ * @category Utils
+ * @since v0.6.0
+ */
+export declare function createToolManifestEntrySchema(): import("zod").ZodObject<{
+    name: import("zod").ZodString;
+    description: import("zod").ZodString;
+    protocol: import("zod").ZodString;
+    category: import("zod").ZodString;
+    inputSchema: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+    outputSchema: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+    httpMethod: import("zod").ZodDefault<import("zod").ZodEnum<{
+        GET: "GET";
+        POST: "POST";
+        PUT: "PUT";
+        DELETE: "DELETE";
+        COMPOUND: "COMPOUND";
+    }>>;
+    paymentMode: import("zod").ZodDefault<import("zod").ZodEnum<{
+        subscription: "subscription";
+        x402: "x402";
+        free: "free";
+        prepaid: "prepaid";
+    }>>;
+    pricePerCall: import("zod").ZodDefault<import("zod").ZodNumber>;
+    requiredArgs: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+    prerequisites: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+    endpointOverride: import("zod").ZodOptional<import("zod").ZodObject<{
+        url: import("zod").ZodString;
+        method: import("zod").ZodDefault<import("zod").ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PUT: "PUT";
+            DELETE: "DELETE";
+        }>>;
+        contentType: import("zod").ZodDefault<import("zod").ZodString>;
+        requiresAuth: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        authType: import("zod").ZodOptional<import("zod").ZodEnum<{
+            bearer: "bearer";
+            "api-key": "api-key";
+            x402: "x402";
+            none: "none";
+        }>>;
+        requiresCSRF: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        requiresCookies: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        corsOrigins: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        requiredHeaders: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>;
+/**
+ * @name createAgentManifestSchema
+ * @description Zod schema for a complete agent manifest.
+ * @returns A Zod schema for manifest validation.
+ * @category Utils
+ * @since v0.6.0
+ *
+ * @example
+ * ```ts
+ * import { createAgentManifestSchema } from "@synapse-sap/sdk";
+ *
+ * const schema = createAgentManifestSchema();
+ * const manifest = schema.parse(JSON.parse(fs.readFileSync("manifest.json", "utf-8")));
+ * ```
+ */
+export declare function createAgentManifestSchema(): import("zod").ZodObject<{
+    version: import("zod").ZodLiteral<"1.0.0">;
+    wallet: import("zod").ZodString;
+    name: import("zod").ZodString;
+    description: import("zod").ZodString;
+    endpoint: import("zod").ZodObject<{
+        url: import("zod").ZodString;
+        method: import("zod").ZodDefault<import("zod").ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PUT: "PUT";
+            DELETE: "DELETE";
+        }>>;
+        contentType: import("zod").ZodDefault<import("zod").ZodString>;
+        requiresAuth: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        authType: import("zod").ZodOptional<import("zod").ZodEnum<{
+            bearer: "bearer";
+            "api-key": "api-key";
+            x402: "x402";
+            none: "none";
+        }>>;
+        requiresCSRF: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        requiresCookies: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        corsOrigins: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        requiredHeaders: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+    }, import("zod/v4/core").$strip>;
+    healthCheck: import("zod").ZodOptional<import("zod").ZodObject<{
+        url: import("zod").ZodString;
+        expectedStatus: import("zod").ZodDefault<import("zod").ZodNumber>;
+        timeoutMs: import("zod").ZodDefault<import("zod").ZodNumber>;
+        method: import("zod").ZodDefault<import("zod").ZodEnum<{
+            GET: "GET";
+            HEAD: "HEAD";
+        }>>;
+    }, import("zod/v4/core").$strip>>;
+    tools: import("zod").ZodArray<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        description: import("zod").ZodString;
+        protocol: import("zod").ZodString;
+        category: import("zod").ZodString;
+        inputSchema: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+        outputSchema: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+        httpMethod: import("zod").ZodDefault<import("zod").ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PUT: "PUT";
+            DELETE: "DELETE";
+            COMPOUND: "COMPOUND";
+        }>>;
+        paymentMode: import("zod").ZodDefault<import("zod").ZodEnum<{
+            subscription: "subscription";
+            x402: "x402";
+            free: "free";
+            prepaid: "prepaid";
+        }>>;
+        pricePerCall: import("zod").ZodDefault<import("zod").ZodNumber>;
+        requiredArgs: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+        prerequisites: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+        endpointOverride: import("zod").ZodOptional<import("zod").ZodObject<{
+            url: import("zod").ZodString;
+            method: import("zod").ZodDefault<import("zod").ZodEnum<{
+                GET: "GET";
+                POST: "POST";
+                PUT: "PUT";
+                DELETE: "DELETE";
+            }>>;
+            contentType: import("zod").ZodDefault<import("zod").ZodString>;
+            requiresAuth: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            authType: import("zod").ZodOptional<import("zod").ZodEnum<{
+                bearer: "bearer";
+                "api-key": "api-key";
+                x402: "x402";
+                none: "none";
+            }>>;
+            requiresCSRF: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            requiresCookies: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            corsOrigins: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            requiredHeaders: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>>;
+    supportedNetworks: import("zod").ZodArray<import("zod").ZodString>;
+    generatedAt: import("zod").ZodString;
+}, import("zod/v4/core").$strip>;
+/**
+ * @name createPreparePaymentSchema
+ * @description Zod schema for x402 payment preparation parameters.
+ * @returns A Zod schema for payment option validation.
+ * @category Utils
+ * @since v0.6.0
+ */
+export declare function createPreparePaymentSchema(): import("zod").ZodObject<{
+    pricePerCall: import("zod").ZodUnion<readonly [import("zod").ZodNumber, import("zod").ZodString, import("zod").ZodBigInt]>;
+    maxCalls: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodNumber, import("zod").ZodString, import("zod").ZodBigInt]>>;
+    deposit: import("zod").ZodUnion<readonly [import("zod").ZodNumber, import("zod").ZodString, import("zod").ZodBigInt]>;
+    expiresAt: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodNumber, import("zod").ZodString, import("zod").ZodBigInt]>>;
+    volumeCurve: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+        afterCalls: import("zod").ZodNumber;
+        pricePerCall: import("zod").ZodUnion<readonly [import("zod").ZodNumber, import("zod").ZodString, import("zod").ZodBigInt]>;
+    }, import("zod/v4/core").$strip>>>;
+    tokenMint: import("zod").ZodOptional<import("zod").ZodString>;
+    tokenDecimals: import("zod").ZodDefault<import("zod").ZodNumber>;
+    networkIdentifier: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>;
+/**
+ * @name createRegisterAgentSchema
+ * @description Zod schema for agent registration arguments.
+ * @returns A Zod schema for registration validation.
+ * @category Utils
+ * @since v0.6.0
+ */
+export declare function createRegisterAgentSchema(): import("zod").ZodObject<{
+    name: import("zod").ZodString;
+    description: import("zod").ZodString;
+    agentId: import("zod").ZodNullable<import("zod").ZodOptional<import("zod").ZodString>>;
+    agentUri: import("zod").ZodNullable<import("zod").ZodOptional<import("zod").ZodString>>;
+    x402Endpoint: import("zod").ZodNullable<import("zod").ZodOptional<import("zod").ZodString>>;
+    capabilities: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        description: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        protocolId: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        version: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    }, import("zod/v4/core").$strip>>>;
+    protocols: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+    pricing: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
+        tierId: import("zod").ZodString;
+        pricePerCall: import("zod").ZodUnion<readonly [import("zod").ZodNumber, import("zod").ZodString]>;
+        rateLimit: import("zod").ZodNumber;
+        tokenType: import("zod").ZodDefault<import("zod").ZodEnum<{
+            sol: "sol";
+            usdc: "usdc";
+            spl: "spl";
+        }>>;
+        settlementMode: import("zod").ZodDefault<import("zod").ZodEnum<{
+            escrow: "escrow";
+            x402: "x402";
+            instant: "instant";
+            batched: "batched";
+        }>>;
+    }, import("zod/v4/core").$strip>>>;
+}, import("zod/v4/core").$strip>;
+/**
+ * @name createCallArgsSchema
+ * @description Zod schema for `npm run call` script arguments.
+ * Ensures all required fields are present before executing an x402 call.
+ *
+ * @returns A Zod schema for call argument validation.
+ * @category Utils
+ * @since v0.6.0
+ */
+export declare function createCallArgsSchema(): import("zod").ZodObject<{
+    agentWallet: import("zod").ZodString;
+    tool: import("zod").ZodString;
+    args: import("zod").ZodDefault<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+    endpoint: import("zod").ZodOptional<import("zod").ZodString>;
+    network: import("zod").ZodOptional<import("zod").ZodString>;
+    maxRetries: import("zod").ZodDefault<import("zod").ZodNumber>;
+    timeoutMs: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>;
+/**
+ * @name validateOrThrow
+ * @description Validate a value against a Zod schema, throwing a SapValidationError
+ * with a friendly message if validation fails.
+ *
+ * @param schema - A Zod schema.
+ * @param value - The value to validate.
+ * @param label - A label for error messages (e.g. "environment", "call args").
+ * @returns The parsed and typed value.
+ * @throws {Error} With formatted validation errors.
+ *
+ * @category Utils
+ * @since v0.6.0
+ */
+export declare function validateOrThrow<T>(schema: {
+    parse: (v: unknown) => T;
+    safeParse: (v: unknown) => {
+        success: boolean;
+        error?: {
+            issues: Array<{
+                path: Array<string | number>;
+                message: string;
+            }>;
+        };
+    };
+}, value: unknown, label: string): T;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/esm/utils/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/utils/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA2BH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe;;;;;;;;;;;;;;;;;;;;;iCAsD9B;AAMD;;;;;;GAMG;AACH,wBAAgB,8BAA8B;;;;;;;;;;;;;;;;;;;;iCAc7C;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB;;;;;;;;iCAStC;AAMD;;;;;;GAMG;AACH,wBAAgB,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAiB5C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAcxC;AAMD;;;;;;GAMG;AACH,wBAAgB,0BAA0B;;;;;;;;;;;;iCAoBzC;AAMD;;;;;;GAMG;AACH,wBAAgB,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAkCxC;AAMD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB;;;;;;;;iCAYnC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,MAAM,EAAE;IAAE,KAAK,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC;IAAC,SAAS,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,MAAM,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAA;KAAE,CAAA;CAAE,EACnK,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,CAAC,CAYH"}

package/dist/esm/utils/schemas.js

@@ -0,0 +1,320 @@
+/**
+ * @module utils/schemas
+ * @description Zod schemas for runtime validation of environment variables,
+ * tool arguments, agent manifests, and x402 payment parameters.
+ *
+ * These schemas enforce correctness at the boundary: CLI scripts refuse
+ * to run if required fields are missing or mis-typed, and SDK methods
+ * validate inputs before hitting the chain.
+ *
+ * Zod is a peer dependency — these schemas are tree-shaken if not imported.
+ *
+ * @category Utils
+ * @since v0.6.0
+ */
+// ═══════════════════════════════════════════════════════════════════
+//  Dynamic Zod import (peer dependency)
+// ═══════════════════════════════════════════════════════════════════
+// We use a lazy getter pattern to avoid hard failures when zod is not installed
+let _z = null;
+function getZod() {
+    if (!_z) {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            _z = require("zod");
+        }
+        catch {
+            throw new Error("[SAP SDK] Zod is required for schema validation. Install it: npm install zod");
+        }
+    }
+    return _z;
+}
+// ═══════════════════════════════════════════════════════════════════
+//  Environment Schemas
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name createEnvSchema
+ * @description Create a Zod schema for SAP SDK environment variables.
+ * Validates that all required env vars are present and correctly typed.
+ *
+ * @returns A Zod schema object for env validation.
+ *
+ * @category Utils
+ * @since v0.6.0
+ *
+ * @example
+ * ```ts
+ * import { createEnvSchema } from "@synapse-sap/sdk";
+ *
+ * const schema = createEnvSchema();
+ * const env = schema.parse(process.env);
+ * // env.SOLANA_CLUSTER is typed as "mainnet-beta" | "devnet" | "localnet"
+ * ```
+ */
+export function createEnvSchema() {
+    const z = getZod();
+    return z.object({
+        SOLANA_CLUSTER: z
+            .enum(["mainnet-beta", "devnet", "localnet"])
+            .default("devnet")
+            .describe("Solana cluster"),
+        SOLANA_RPC_URL: z
+            .string()
+            .url()
+            .optional()
+            .describe("Primary RPC endpoint URL"),
+        SOLANA_FALLBACK_RPC_URL: z
+            .string()
+            .url()
+            .optional()
+            .describe("Fallback RPC for SPL token ops"),
+        SOLANA_WS_URL: z
+            .string()
+            .url()
+            .optional()
+            .describe("WebSocket endpoint URL"),
+        WALLET_KEYPAIR_PATH: z
+            .string()
+            .optional()
+            .describe("Path to keypair JSON file"),
+        WALLET_PRIVATE_KEY: z
+            .string()
+            .optional()
+            .describe("Base58 private key (alternative to file)"),
+        SAP_PROGRAM_ID: z
+            .string()
+            .optional()
+            .describe("Custom SAP program ID override"),
+        DATABASE_URL: z
+            .string()
+            .optional()
+            .describe("PostgreSQL connection URL"),
+        LOG_LEVEL: z
+            .enum(["debug", "info", "warn", "error"])
+            .default("info")
+            .describe("Log level"),
+        X402_ENDPOINT: z
+            .string()
+            .url()
+            .optional()
+            .describe("Agent x402 payment endpoint"),
+        AGENT_URI: z
+            .string()
+            .url()
+            .optional()
+            .describe("Agent public API URI"),
+    });
+}
+// ═══════════════════════════════════════════════════════════════════
+//  Endpoint Schemas
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name createEndpointDescriptorSchema
+ * @description Zod schema for {@link EndpointDescriptor}.
+ * @returns A Zod schema for endpoint descriptor validation.
+ * @category Utils
+ * @since v0.6.0
+ */
+export function createEndpointDescriptorSchema() {
+    const z = getZod();
+    return z.object({
+        url: z.string().url(),
+        method: z.enum(["GET", "POST", "PUT", "DELETE"]).default("POST"),
+        contentType: z.string().default("application/json"),
+        requiresAuth: z.boolean().default(false),
+        authType: z.enum(["bearer", "api-key", "x402", "none"]).optional(),
+        requiresCSRF: z.boolean().default(false),
+        requiresCookies: z.boolean().default(false),
+        corsOrigins: z.array(z.string()).optional(),
+        requiredHeaders: z.record(z.string(), z.string()).optional(),
+    });
+}
+/**
+ * @name createHealthCheckSchema
+ * @description Zod schema for {@link HealthCheckDescriptor}.
+ * @returns A Zod schema for health check validation.
+ * @category Utils
+ * @since v0.6.0
+ */
+export function createHealthCheckSchema() {
+    const z = getZod();
+    return z.object({
+        url: z.string().url(),
+        expectedStatus: z.number().int().min(100).max(599).default(200),
+        timeoutMs: z.number().int().min(100).max(60_000).default(5000),
+        method: z.enum(["GET", "HEAD"]).default("GET"),
+    });
+}
+// ═══════════════════════════════════════════════════════════════════
+//  Tool Manifest Schemas
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name createToolManifestEntrySchema
+ * @description Zod schema for a single tool in an agent manifest.
+ * @returns A Zod schema for tool manifest entry validation.
+ * @category Utils
+ * @since v0.6.0
+ */
+export function createToolManifestEntrySchema() {
+    const z = getZod();
+    return z.object({
+        name: z.string().min(1).max(64),
+        description: z.string().max(256),
+        protocol: z.string().min(1).max(64),
+        category: z.string().min(1),
+        inputSchema: z.record(z.string(), z.unknown()),
+        outputSchema: z.record(z.string(), z.unknown()),
+        httpMethod: z.enum(["GET", "POST", "PUT", "DELETE", "COMPOUND"]).default("POST"),
+        paymentMode: z.enum(["x402", "free", "prepaid", "subscription"]).default("x402"),
+        pricePerCall: z.number().int().min(0).default(0),
+        requiredArgs: z.array(z.string()).default([]),
+        prerequisites: z.array(z.string()).default([]),
+        endpointOverride: createEndpointDescriptorSchema().optional(),
+    });
+}
+/**
+ * @name createAgentManifestSchema
+ * @description Zod schema for a complete agent manifest.
+ * @returns A Zod schema for manifest validation.
+ * @category Utils
+ * @since v0.6.0
+ *
+ * @example
+ * ```ts
+ * import { createAgentManifestSchema } from "@synapse-sap/sdk";
+ *
+ * const schema = createAgentManifestSchema();
+ * const manifest = schema.parse(JSON.parse(fs.readFileSync("manifest.json", "utf-8")));
+ * ```
+ */
+export function createAgentManifestSchema() {
+    const z = getZod();
+    return z.object({
+        version: z.literal("1.0.0"),
+        wallet: z.string().min(32).max(50),
+        name: z.string().min(1).max(64),
+        description: z.string().max(256),
+        endpoint: createEndpointDescriptorSchema(),
+        healthCheck: createHealthCheckSchema().optional(),
+        tools: z.array(createToolManifestEntrySchema()),
+        supportedNetworks: z.array(z.string()).min(1),
+        generatedAt: z.string().datetime(),
+    });
+}
+// ═══════════════════════════════════════════════════════════════════
+//  x402 Payment Schemas
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name createPreparePaymentSchema
+ * @description Zod schema for x402 payment preparation parameters.
+ * @returns A Zod schema for payment option validation.
+ * @category Utils
+ * @since v0.6.0
+ */
+export function createPreparePaymentSchema() {
+    const z = getZod();
+    return z.object({
+        pricePerCall: z.union([z.number(), z.string(), z.bigint()]),
+        maxCalls: z.union([z.number(), z.string(), z.bigint()]).optional(),
+        deposit: z.union([z.number(), z.string(), z.bigint()]),
+        expiresAt: z.union([z.number(), z.string(), z.bigint()]).optional(),
+        volumeCurve: z
+            .array(z.object({
+            afterCalls: z.number().int().min(1),
+            pricePerCall: z.union([z.number(), z.string(), z.bigint()]),
+        }))
+            .optional(),
+        tokenMint: z.string().optional(),
+        tokenDecimals: z.number().int().min(0).max(18).default(9),
+        networkIdentifier: z.string().optional(),
+    });
+}
+// ═══════════════════════════════════════════════════════════════════
+//  Agent Registration Schemas
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name createRegisterAgentSchema
+ * @description Zod schema for agent registration arguments.
+ * @returns A Zod schema for registration validation.
+ * @category Utils
+ * @since v0.6.0
+ */
+export function createRegisterAgentSchema() {
+    const z = getZod();
+    return z.object({
+        name: z.string().min(1).max(64),
+        description: z.string().min(1).max(256),
+        agentId: z.string().max(128).optional().nullable(),
+        agentUri: z.string().max(256).optional().nullable(),
+        x402Endpoint: z.string().url().max(256).optional().nullable(),
+        capabilities: z
+            .array(z.object({
+            id: z.string().min(1),
+            description: z.string().nullable().optional(),
+            protocolId: z.string().nullable().optional(),
+            version: z.string().nullable().optional(),
+        }))
+            .max(10)
+            .default([]),
+        protocols: z.array(z.string()).max(5).default([]),
+        pricing: z
+            .array(z.object({
+            tierId: z.string().min(1),
+            pricePerCall: z.union([z.number(), z.string()]),
+            rateLimit: z.number().int().min(0),
+            tokenType: z.enum(["sol", "usdc", "spl"]).default("sol"),
+            settlementMode: z.enum(["instant", "escrow", "batched", "x402"]).default("x402"),
+        }))
+            .max(5)
+            .default([]),
+    });
+}
+// ═══════════════════════════════════════════════════════════════════
+//  CLI Script Argument Schemas
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name createCallArgsSchema
+ * @description Zod schema for `npm run call` script arguments.
+ * Ensures all required fields are present before executing an x402 call.
+ *
+ * @returns A Zod schema for call argument validation.
+ * @category Utils
+ * @since v0.6.0
+ */
+export function createCallArgsSchema() {
+    const z = getZod();
+    return z.object({
+        agentWallet: z.string().min(32).max(50).describe("Agent wallet (base58)"),
+        tool: z.string().min(1).describe("Tool name to invoke"),
+        args: z.record(z.string(), z.unknown()).default({}).describe("Tool arguments (JSON)"),
+        endpoint: z.string().url().optional().describe("Endpoint URL override"),
+        network: z.string().optional().describe("Network identifier override"),
+        maxRetries: z.number().int().min(0).max(10).default(2),
+        timeoutMs: z.number().int().min(1000).max(120_000).default(30_000),
+    });
+}
+/**
+ * @name validateOrThrow
+ * @description Validate a value against a Zod schema, throwing a SapValidationError
+ * with a friendly message if validation fails.
+ *
+ * @param schema - A Zod schema.
+ * @param value - The value to validate.
+ * @param label - A label for error messages (e.g. "environment", "call args").
+ * @returns The parsed and typed value.
+ * @throws {Error} With formatted validation errors.
+ *
+ * @category Utils
+ * @since v0.6.0
+ */
+export function validateOrThrow(schema, value, label) {
+    const result = schema.safeParse(value);
+    if (result.success)
+        return schema.parse(value);
+    const issues = result.error?.issues ?? [];
+    const formatted = issues
+        .map((i) => `  • ${i.path.join(".")}: ${i.message}`)
+        .join("\n");
+    throw new Error(`[SAP SDK] Invalid ${label}:\n${formatted}`);
+}
+//# sourceMappingURL=schemas.js.map