@402flow/sdk 0.1.0-alpha.12 → 0.1.0-alpha.14

package/dist/contracts.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Public wire-contract schemas for @402flow/sdk.
+ *
+ * These schemas serve two roles:
+ * 1. validate control-plane and merchant-facing data at runtime
+ * 2. define the exported TypeScript shapes the SDK exposes to callers
+ */
 import { z } from 'zod';
 export declare const receiptAuthorizationOutcomeSchema: z.ZodEnum<["allowed"]>;
 export type ReceiptAuthorizationOutcome = z.infer<typeof receiptAuthorizationOutcomeSchema>;
@@ -30,7 +37,13 @@ export declare const externalIdSchema: z.ZodString;
 export declare const monetaryAmountSchema: z.ZodString;
 export declare const currencyCodeSchema: z.ZodString;
 export declare const moneyUnitSchema: z.ZodLiteral<"minor">;
+/**
+ * Convert a decimal amount into minor units using the declared precision.
+ * The SDK uses this when a merchant expresses payment terms in decimal form but
+ * downstream contracts require canonical minor-unit amounts.
+ */
 export declare function monetaryAmountToMinorUnits(amount: string, precision: number): string;
+/** Canonical normalized money shape used on receipts and payment requirements. */
 export declare const normalizedMoneySchema: z.ZodEffects<z.ZodObject<{
     asset: z.ZodString;
     amount: z.ZodString;
@@ -63,6 +76,7 @@ export declare const normalizedMoneySchema: z.ZodEffects<z.ZodObject<{
     unit: "minor";
 }>;
 export type NormalizedMoney = z.infer<typeof normalizedMoneySchema>;
+/** Request-scoped context the control plane uses for policy, audit, and identity. */
 export declare const paidRequestContextSchema: z.ZodObject<{
     organization: z.ZodString;
     agent: z.ZodString;
@@ -80,6 +94,7 @@ export declare const paidRequestContextSchema: z.ZodObject<{
     metadata?: Record<string, unknown> | undefined;
 }>;
 export type PaidRequestContext = z.infer<typeof paidRequestContextSchema>;
+/** Exact HTTP request shape that gets prepared, hashed, and later executed. */
 export declare const paidRequestHttpRequestSchema: z.ZodObject<{
     url: z.ZodString;
     method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
@@ -100,6 +115,7 @@ export declare const paidRequestHttpRequestSchema: z.ZodObject<{
     bodyHash?: string | undefined;
 }>;
 export type PaidRequestHttpRequest = z.infer<typeof paidRequestHttpRequestSchema>;
+/** Merchant challenge evidence captured during prepare or fetchPaid flows. */
 export declare const paidRequestChallengeSchema: z.ZodObject<{
     protocol: z.ZodEnum<["x402", "l402"]>;
     headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -114,6 +130,4121 @@ export declare const paidRequestChallengeSchema: z.ZodObject<{
     body?: unknown;
 }>;
 export type PaidRequestChallenge = z.infer<typeof paidRequestChallengeSchema>;
+export declare const sdkPreparationSourceSchema: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+export type SdkPreparationSource = z.infer<typeof sdkPreparationSourceSchema>;
+export declare const sdkPreparationAuthoritySchema: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+export type SdkPreparationAuthority = z.infer<typeof sdkPreparationAuthoritySchema>;
+export declare const sdkPreparationAttributionSchema: z.ZodObject<{
+    source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+    authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+    note: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+    authority: "authoritative" | "confirmatory" | "advisory";
+    note?: string | undefined;
+}, {
+    source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+    authority: "authoritative" | "confirmatory" | "advisory";
+    note?: string | undefined;
+}>;
+export type SdkPreparationAttribution = z.infer<typeof sdkPreparationAttributionSchema>;
+export declare const sdkPreparationFieldSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    defaultValue: z.ZodOptional<z.ZodUnknown>;
+    enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    type?: string | undefined;
+    required?: boolean | undefined;
+    description?: string | undefined;
+    defaultValue?: unknown;
+    enumValues?: string[] | undefined;
+}, {
+    name: string;
+    type?: string | undefined;
+    required?: boolean | undefined;
+    description?: string | undefined;
+    defaultValue?: unknown;
+    enumValues?: string[] | undefined;
+}>;
+export type SdkPreparationField = z.infer<typeof sdkPreparationFieldSchema>;
+/** Optional caller-supplied metadata used to enrich preparation hints. */
+export declare const sdkPreparationMetadataSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    requestBodyType: z.ZodOptional<z.ZodString>;
+    requestBodyExample: z.ZodOptional<z.ZodString>;
+    requestBodyFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        defaultValue: z.ZodOptional<z.ZodUnknown>;
+        enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }, {
+        name: string;
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }>, "many">>;
+    requestQueryParams: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        defaultValue: z.ZodOptional<z.ZodUnknown>;
+        enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }, {
+        name: string;
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }>, "many">>;
+    requestPathParams: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        defaultValue: z.ZodOptional<z.ZodUnknown>;
+        enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }, {
+        name: string;
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }>, "many">>;
+    notes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    description?: string | undefined;
+    requestBodyType?: string | undefined;
+    requestBodyExample?: string | undefined;
+    requestBodyFields?: {
+        name: string;
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }[] | undefined;
+    requestQueryParams?: {
+        name: string;
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }[] | undefined;
+    requestPathParams?: {
+        name: string;
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }[] | undefined;
+    notes?: string[] | undefined;
+}, {
+    description?: string | undefined;
+    requestBodyType?: string | undefined;
+    requestBodyExample?: string | undefined;
+    requestBodyFields?: {
+        name: string;
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }[] | undefined;
+    requestQueryParams?: {
+        name: string;
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }[] | undefined;
+    requestPathParams?: {
+        name: string;
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }[] | undefined;
+    notes?: string[] | undefined;
+}>;
+export type SdkPreparationMetadata = z.infer<typeof sdkPreparationMetadataSchema>;
+/** Optional external metadata channels the SDK knows how to merge. */
+export declare const sdkPreparationDiscoveryMetadataSchema: z.ZodObject<{
+    provider: z.ZodOptional<z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        requestBodyType: z.ZodOptional<z.ZodString>;
+        requestBodyExample: z.ZodOptional<z.ZodString>;
+        requestBodyFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            defaultValue: z.ZodOptional<z.ZodUnknown>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }, {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }>, "many">>;
+        requestQueryParams: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            defaultValue: z.ZodOptional<z.ZodUnknown>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }, {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }>, "many">>;
+        requestPathParams: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            defaultValue: z.ZodOptional<z.ZodUnknown>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }, {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }>, "many">>;
+        notes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        description?: string | undefined;
+        requestBodyType?: string | undefined;
+        requestBodyExample?: string | undefined;
+        requestBodyFields?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestQueryParams?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestPathParams?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        notes?: string[] | undefined;
+    }, {
+        description?: string | undefined;
+        requestBodyType?: string | undefined;
+        requestBodyExample?: string | undefined;
+        requestBodyFields?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestQueryParams?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestPathParams?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        notes?: string[] | undefined;
+    }>>;
+    marketplace: z.ZodOptional<z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        requestBodyType: z.ZodOptional<z.ZodString>;
+        requestBodyExample: z.ZodOptional<z.ZodString>;
+        requestBodyFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            defaultValue: z.ZodOptional<z.ZodUnknown>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }, {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }>, "many">>;
+        requestQueryParams: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            defaultValue: z.ZodOptional<z.ZodUnknown>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }, {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }>, "many">>;
+        requestPathParams: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            defaultValue: z.ZodOptional<z.ZodUnknown>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }, {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }>, "many">>;
+        notes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        description?: string | undefined;
+        requestBodyType?: string | undefined;
+        requestBodyExample?: string | undefined;
+        requestBodyFields?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestQueryParams?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestPathParams?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        notes?: string[] | undefined;
+    }, {
+        description?: string | undefined;
+        requestBodyType?: string | undefined;
+        requestBodyExample?: string | undefined;
+        requestBodyFields?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestQueryParams?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestPathParams?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        notes?: string[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    marketplace?: {
+        description?: string | undefined;
+        requestBodyType?: string | undefined;
+        requestBodyExample?: string | undefined;
+        requestBodyFields?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestQueryParams?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestPathParams?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        notes?: string[] | undefined;
+    } | undefined;
+    provider?: {
+        description?: string | undefined;
+        requestBodyType?: string | undefined;
+        requestBodyExample?: string | undefined;
+        requestBodyFields?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestQueryParams?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestPathParams?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        notes?: string[] | undefined;
+    } | undefined;
+}, {
+    marketplace?: {
+        description?: string | undefined;
+        requestBodyType?: string | undefined;
+        requestBodyExample?: string | undefined;
+        requestBodyFields?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestQueryParams?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestPathParams?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        notes?: string[] | undefined;
+    } | undefined;
+    provider?: {
+        description?: string | undefined;
+        requestBodyType?: string | undefined;
+        requestBodyExample?: string | undefined;
+        requestBodyFields?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestQueryParams?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestPathParams?: {
+            name: string;
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        notes?: string[] | undefined;
+    } | undefined;
+}>;
+export type SdkPreparationDiscoveryMetadata = z.infer<typeof sdkPreparationDiscoveryMetadataSchema>;
+export declare const sdkPreparedHintValueSchema: z.ZodObject<{
+    value: z.ZodString;
+    attribution: z.ZodObject<{
+        source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+        authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+        note: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        authority: "authoritative" | "confirmatory" | "advisory";
+        note?: string | undefined;
+    }, {
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        authority: "authoritative" | "confirmatory" | "advisory";
+        note?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    attribution: {
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        authority: "authoritative" | "confirmatory" | "advisory";
+        note?: string | undefined;
+    };
+}, {
+    value: string;
+    attribution: {
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        authority: "authoritative" | "confirmatory" | "advisory";
+        note?: string | undefined;
+    };
+}>;
+export type SdkPreparedHintValue = z.infer<typeof sdkPreparedHintValueSchema>;
+export declare const sdkPreparedHintFieldSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    defaultValue: z.ZodOptional<z.ZodUnknown>;
+    enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+} & {
+    attribution: z.ZodObject<{
+        source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+        authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+        note: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        authority: "authoritative" | "confirmatory" | "advisory";
+        note?: string | undefined;
+    }, {
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        authority: "authoritative" | "confirmatory" | "advisory";
+        note?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    attribution: {
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        authority: "authoritative" | "confirmatory" | "advisory";
+        note?: string | undefined;
+    };
+    type?: string | undefined;
+    required?: boolean | undefined;
+    description?: string | undefined;
+    defaultValue?: unknown;
+    enumValues?: string[] | undefined;
+}, {
+    name: string;
+    attribution: {
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        authority: "authoritative" | "confirmatory" | "advisory";
+        note?: string | undefined;
+    };
+    type?: string | undefined;
+    required?: boolean | undefined;
+    description?: string | undefined;
+    defaultValue?: unknown;
+    enumValues?: string[] | undefined;
+}>;
+export type SdkPreparedHintField = z.infer<typeof sdkPreparedHintFieldSchema>;
+/**
+ * Consolidated request-shape hints returned by preparePaidRequest(). Every hint
+ * carries attribution so callers can distinguish advisory metadata from live
+ * merchant-authoritative evidence.
+ */
+export declare const sdkPreparedRequestHintsSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodObject<{
+        value: z.ZodString;
+        attribution: z.ZodObject<{
+            source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+            authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+            note: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+    }, {
+        value: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+    }>>;
+    requestBodyType: z.ZodOptional<z.ZodObject<{
+        value: z.ZodString;
+        attribution: z.ZodObject<{
+            source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+            authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+            note: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+    }, {
+        value: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+    }>>;
+    requestBodyExample: z.ZodOptional<z.ZodObject<{
+        value: z.ZodString;
+        attribution: z.ZodObject<{
+            source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+            authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+            note: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+    }, {
+        value: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+    }>>;
+    requestBodyFields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        defaultValue: z.ZodOptional<z.ZodUnknown>;
+        enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    } & {
+        attribution: z.ZodObject<{
+            source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+            authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+            note: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }, {
+        name: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }>, "many">>;
+    requestQueryParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        defaultValue: z.ZodOptional<z.ZodUnknown>;
+        enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    } & {
+        attribution: z.ZodObject<{
+            source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+            authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+            note: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }, {
+        name: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }>, "many">>;
+    requestPathParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        defaultValue: z.ZodOptional<z.ZodUnknown>;
+        enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    } & {
+        attribution: z.ZodObject<{
+            source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+            authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+            note: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }, {
+        name: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }>, "many">>;
+    notes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        attribution: z.ZodObject<{
+            source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+            authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+            note: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+    }, {
+        value: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    requestBodyFields: {
+        name: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }[];
+    requestQueryParams: {
+        name: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }[];
+    requestPathParams: {
+        name: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }[];
+    notes: {
+        value: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+    }[];
+    description?: {
+        value: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+    } | undefined;
+    requestBodyType?: {
+        value: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+    } | undefined;
+    requestBodyExample?: {
+        value: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+    } | undefined;
+}, {
+    description?: {
+        value: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+    } | undefined;
+    requestBodyType?: {
+        value: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+    } | undefined;
+    requestBodyExample?: {
+        value: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+    } | undefined;
+    requestBodyFields?: {
+        name: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }[] | undefined;
+    requestQueryParams?: {
+        name: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }[] | undefined;
+    requestPathParams?: {
+        name: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+        type?: string | undefined;
+        required?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: unknown;
+        enumValues?: string[] | undefined;
+    }[] | undefined;
+    notes?: {
+        value: string;
+        attribution: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+    }[] | undefined;
+}>;
+export type SdkPreparedRequestHints = z.infer<typeof sdkPreparedRequestHintsSchema>;
+export declare const sdkPreparedPaymentRequirementAmountTypeSchema: z.ZodEnum<["exact", "max"]>;
+export type SdkPreparedPaymentRequirementAmountType = z.infer<typeof sdkPreparedPaymentRequirementAmountTypeSchema>;
+/** Normalized payment terms extracted from a merchant challenge when available. */
+export declare const sdkPreparedPaymentRequirementSchema: z.ZodObject<{
+    protocol: z.ZodEnum<["x402", "l402"]>;
+    description: z.ZodOptional<z.ZodString>;
+    asset: z.ZodOptional<z.ZodString>;
+    network: z.ZodOptional<z.ZodString>;
+    payee: z.ZodOptional<z.ZodString>;
+    amountType: z.ZodOptional<z.ZodEnum<["exact", "max"]>>;
+    amount: z.ZodOptional<z.ZodString>;
+    amountMinor: z.ZodOptional<z.ZodString>;
+    precision: z.ZodOptional<z.ZodNumber>;
+    provenance: z.ZodObject<{
+        source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+        authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+        note: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        authority: "authoritative" | "confirmatory" | "advisory";
+        note?: string | undefined;
+    }, {
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        authority: "authoritative" | "confirmatory" | "advisory";
+        note?: string | undefined;
+    }>;
+    confirmation: z.ZodOptional<z.ZodObject<{
+        source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+        authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+        note: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        authority: "authoritative" | "confirmatory" | "advisory";
+        note?: string | undefined;
+    }, {
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        authority: "authoritative" | "confirmatory" | "advisory";
+        note?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    protocol: "x402" | "l402";
+    provenance: {
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        authority: "authoritative" | "confirmatory" | "advisory";
+        note?: string | undefined;
+    };
+    asset?: string | undefined;
+    amount?: string | undefined;
+    amountMinor?: string | undefined;
+    precision?: number | undefined;
+    description?: string | undefined;
+    network?: string | undefined;
+    payee?: string | undefined;
+    amountType?: "exact" | "max" | undefined;
+    confirmation?: {
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        authority: "authoritative" | "confirmatory" | "advisory";
+        note?: string | undefined;
+    } | undefined;
+}, {
+    protocol: "x402" | "l402";
+    provenance: {
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        authority: "authoritative" | "confirmatory" | "advisory";
+        note?: string | undefined;
+    };
+    asset?: string | undefined;
+    amount?: string | undefined;
+    amountMinor?: string | undefined;
+    precision?: number | undefined;
+    description?: string | undefined;
+    network?: string | undefined;
+    payee?: string | undefined;
+    amountType?: "exact" | "max" | undefined;
+    confirmation?: {
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        authority: "authoritative" | "confirmatory" | "advisory";
+        note?: string | undefined;
+    } | undefined;
+}>;
+export type SdkPreparedPaymentRequirement = z.infer<typeof sdkPreparedPaymentRequirementSchema>;
+/** Evidence that the SDK performed an unpaid live probe before preparation. */
+export declare const sdkPreparedProbeResultSchema: z.ZodObject<{
+    responseStatus: z.ZodNumber;
+    confirmedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    responseStatus: number;
+    confirmedAt: string;
+}, {
+    responseStatus: number;
+    confirmedAt: string;
+}>;
+export type SdkPreparedProbeResult = z.infer<typeof sdkPreparedProbeResultSchema>;
+export declare const sdkPreparedValidationIssueLocationSchema: z.ZodEnum<["body", "query", "path", "headers"]>;
+export type SdkPreparedValidationIssueLocation = z.infer<typeof sdkPreparedValidationIssueLocationSchema>;
+export declare const sdkPreparedValidationSeveritySchema: z.ZodEnum<["error", "warning"]>;
+export type SdkPreparedValidationSeverity = z.infer<typeof sdkPreparedValidationSeveritySchema>;
+/** Structured remediation guidance derived from hints and the candidate request. */
+export declare const sdkPreparedValidationIssueSchema: z.ZodObject<{
+    location: z.ZodEnum<["body", "query", "path", "headers"]>;
+    field: z.ZodString;
+    code: z.ZodString;
+    message: z.ZodString;
+    source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+    blocking: z.ZodBoolean;
+    severity: z.ZodEnum<["error", "warning"]>;
+    suggestedFix: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    message: string;
+    source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+    location: "path" | "headers" | "body" | "query";
+    field: string;
+    blocking: boolean;
+    severity: "error" | "warning";
+    suggestedFix?: string | undefined;
+}, {
+    code: string;
+    message: string;
+    source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+    location: "path" | "headers" | "body" | "query";
+    field: string;
+    blocking: boolean;
+    severity: "error" | "warning";
+    suggestedFix?: string | undefined;
+}>;
+export type SdkPreparedValidationIssue = z.infer<typeof sdkPreparedValidationIssueSchema>;
+/** Narrow action summary the caller should take after preparation. */
+export declare const sdkPreparedNextActionSchema: z.ZodEnum<["execute", "revise_request", "treat_as_passthrough", "manual_review"]>;
+export type SdkPreparedNextAction = z.infer<typeof sdkPreparedNextActionSchema>;
+/** Preparation result when this exact request does not currently require payment. */
+export declare const sdkPreparedPaidRequestPassthroughSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"passthrough">;
+    protocol: z.ZodLiteral<"none">;
+    request: z.ZodObject<{
+        url: z.ZodString;
+        method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        body: z.ZodOptional<z.ZodString>;
+        bodyHash: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+        headers?: Record<string, string> | undefined;
+        body?: string | undefined;
+        bodyHash?: string | undefined;
+    }, {
+        url: string;
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+        headers?: Record<string, string> | undefined;
+        body?: string | undefined;
+        bodyHash?: string | undefined;
+    }>;
+    hints: z.ZodObject<{
+        description: z.ZodOptional<z.ZodObject<{
+            value: z.ZodString;
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }>>;
+        requestBodyType: z.ZodOptional<z.ZodObject<{
+            value: z.ZodString;
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }>>;
+        requestBodyExample: z.ZodOptional<z.ZodObject<{
+            value: z.ZodString;
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }>>;
+        requestBodyFields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            defaultValue: z.ZodOptional<z.ZodUnknown>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        } & {
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }>, "many">>;
+        requestQueryParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            defaultValue: z.ZodOptional<z.ZodUnknown>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        } & {
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }>, "many">>;
+        requestPathParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            defaultValue: z.ZodOptional<z.ZodUnknown>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        } & {
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }>, "many">>;
+        notes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        requestBodyFields: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        requestQueryParams: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        requestPathParams: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        notes: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }[];
+        description?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyType?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyExample?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+    }, {
+        description?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyType?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyExample?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyFields?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestQueryParams?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestPathParams?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        notes?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }[] | undefined;
+    }>;
+    probe: z.ZodOptional<z.ZodObject<{
+        responseStatus: z.ZodNumber;
+        confirmedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        responseStatus: number;
+        confirmedAt: string;
+    }, {
+        responseStatus: number;
+        confirmedAt: string;
+    }>>;
+    validationIssues: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        location: z.ZodEnum<["body", "query", "path", "headers"]>;
+        field: z.ZodString;
+        code: z.ZodString;
+        message: z.ZodString;
+        source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+        blocking: z.ZodBoolean;
+        severity: z.ZodEnum<["error", "warning"]>;
+        suggestedFix: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        location: "path" | "headers" | "body" | "query";
+        field: string;
+        blocking: boolean;
+        severity: "error" | "warning";
+        suggestedFix?: string | undefined;
+    }, {
+        code: string;
+        message: string;
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        location: "path" | "headers" | "body" | "query";
+        field: string;
+        blocking: boolean;
+        severity: "error" | "warning";
+        suggestedFix?: string | undefined;
+    }>, "many">>;
+    nextAction: z.ZodEnum<["execute", "revise_request", "treat_as_passthrough", "manual_review"]>;
+}, "strip", z.ZodTypeAny, {
+    protocol: "none";
+    kind: "passthrough";
+    request: {
+        url: string;
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+        headers?: Record<string, string> | undefined;
+        body?: string | undefined;
+        bodyHash?: string | undefined;
+    };
+    hints: {
+        requestBodyFields: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        requestQueryParams: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        requestPathParams: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        notes: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }[];
+        description?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyType?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyExample?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+    };
+    validationIssues: {
+        code: string;
+        message: string;
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        location: "path" | "headers" | "body" | "query";
+        field: string;
+        blocking: boolean;
+        severity: "error" | "warning";
+        suggestedFix?: string | undefined;
+    }[];
+    nextAction: "execute" | "revise_request" | "treat_as_passthrough" | "manual_review";
+    probe?: {
+        responseStatus: number;
+        confirmedAt: string;
+    } | undefined;
+}, {
+    protocol: "none";
+    kind: "passthrough";
+    request: {
+        url: string;
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+        headers?: Record<string, string> | undefined;
+        body?: string | undefined;
+        bodyHash?: string | undefined;
+    };
+    hints: {
+        description?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyType?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyExample?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyFields?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestQueryParams?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestPathParams?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        notes?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }[] | undefined;
+    };
+    nextAction: "execute" | "revise_request" | "treat_as_passthrough" | "manual_review";
+    probe?: {
+        responseStatus: number;
+        confirmedAt: string;
+    } | undefined;
+    validationIssues?: {
+        code: string;
+        message: string;
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        location: "path" | "headers" | "body" | "query";
+        field: string;
+        blocking: boolean;
+        severity: "error" | "warning";
+        suggestedFix?: string | undefined;
+    }[] | undefined;
+}>;
+export type SdkPreparedPaidRequestPassthrough = z.infer<typeof sdkPreparedPaidRequestPassthroughSchema>;
+/** Preparation result when this exact request is payable and executable. */
+export declare const sdkPreparedPaidRequestReadySchema: z.ZodObject<{
+    kind: z.ZodLiteral<"ready">;
+    protocol: z.ZodEnum<["x402", "l402"]>;
+    request: z.ZodObject<{
+        url: z.ZodString;
+        method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        body: z.ZodOptional<z.ZodString>;
+        bodyHash: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+        headers?: Record<string, string> | undefined;
+        body?: string | undefined;
+        bodyHash?: string | undefined;
+    }, {
+        url: string;
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+        headers?: Record<string, string> | undefined;
+        body?: string | undefined;
+        bodyHash?: string | undefined;
+    }>;
+    challenge: z.ZodObject<{
+        protocol: z.ZodEnum<["x402", "l402"]>;
+        headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        body: z.ZodOptional<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        headers: Record<string, string>;
+        protocol: "x402" | "l402";
+        body?: unknown;
+    }, {
+        protocol: "x402" | "l402";
+        headers?: Record<string, string> | undefined;
+        body?: unknown;
+    }>;
+    paymentRequirement: z.ZodOptional<z.ZodObject<{
+        protocol: z.ZodEnum<["x402", "l402"]>;
+        description: z.ZodOptional<z.ZodString>;
+        asset: z.ZodOptional<z.ZodString>;
+        network: z.ZodOptional<z.ZodString>;
+        payee: z.ZodOptional<z.ZodString>;
+        amountType: z.ZodOptional<z.ZodEnum<["exact", "max"]>>;
+        amount: z.ZodOptional<z.ZodString>;
+        amountMinor: z.ZodOptional<z.ZodString>;
+        precision: z.ZodOptional<z.ZodNumber>;
+        provenance: z.ZodObject<{
+            source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+            authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+            note: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }>;
+        confirmation: z.ZodOptional<z.ZodObject<{
+            source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+            authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+            note: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        protocol: "x402" | "l402";
+        provenance: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+        asset?: string | undefined;
+        amount?: string | undefined;
+        amountMinor?: string | undefined;
+        precision?: number | undefined;
+        description?: string | undefined;
+        network?: string | undefined;
+        payee?: string | undefined;
+        amountType?: "exact" | "max" | undefined;
+        confirmation?: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        } | undefined;
+    }, {
+        protocol: "x402" | "l402";
+        provenance: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+        asset?: string | undefined;
+        amount?: string | undefined;
+        amountMinor?: string | undefined;
+        precision?: number | undefined;
+        description?: string | undefined;
+        network?: string | undefined;
+        payee?: string | undefined;
+        amountType?: "exact" | "max" | undefined;
+        confirmation?: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        } | undefined;
+    }>>;
+    hints: z.ZodObject<{
+        description: z.ZodOptional<z.ZodObject<{
+            value: z.ZodString;
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }>>;
+        requestBodyType: z.ZodOptional<z.ZodObject<{
+            value: z.ZodString;
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }>>;
+        requestBodyExample: z.ZodOptional<z.ZodObject<{
+            value: z.ZodString;
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }>>;
+        requestBodyFields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            defaultValue: z.ZodOptional<z.ZodUnknown>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        } & {
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }>, "many">>;
+        requestQueryParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            defaultValue: z.ZodOptional<z.ZodUnknown>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        } & {
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }>, "many">>;
+        requestPathParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            defaultValue: z.ZodOptional<z.ZodUnknown>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        } & {
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }>, "many">>;
+        notes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        requestBodyFields: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        requestQueryParams: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        requestPathParams: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        notes: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }[];
+        description?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyType?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyExample?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+    }, {
+        description?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyType?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyExample?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyFields?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestQueryParams?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestPathParams?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        notes?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }[] | undefined;
+    }>;
+    probe: z.ZodOptional<z.ZodObject<{
+        responseStatus: z.ZodNumber;
+        confirmedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        responseStatus: number;
+        confirmedAt: string;
+    }, {
+        responseStatus: number;
+        confirmedAt: string;
+    }>>;
+    validationIssues: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        location: z.ZodEnum<["body", "query", "path", "headers"]>;
+        field: z.ZodString;
+        code: z.ZodString;
+        message: z.ZodString;
+        source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+        blocking: z.ZodBoolean;
+        severity: z.ZodEnum<["error", "warning"]>;
+        suggestedFix: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        location: "path" | "headers" | "body" | "query";
+        field: string;
+        blocking: boolean;
+        severity: "error" | "warning";
+        suggestedFix?: string | undefined;
+    }, {
+        code: string;
+        message: string;
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        location: "path" | "headers" | "body" | "query";
+        field: string;
+        blocking: boolean;
+        severity: "error" | "warning";
+        suggestedFix?: string | undefined;
+    }>, "many">>;
+    nextAction: z.ZodEnum<["execute", "revise_request", "treat_as_passthrough", "manual_review"]>;
+}, "strip", z.ZodTypeAny, {
+    protocol: "x402" | "l402";
+    kind: "ready";
+    request: {
+        url: string;
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+        headers?: Record<string, string> | undefined;
+        body?: string | undefined;
+        bodyHash?: string | undefined;
+    };
+    hints: {
+        requestBodyFields: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        requestQueryParams: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        requestPathParams: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        notes: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }[];
+        description?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyType?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyExample?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+    };
+    validationIssues: {
+        code: string;
+        message: string;
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        location: "path" | "headers" | "body" | "query";
+        field: string;
+        blocking: boolean;
+        severity: "error" | "warning";
+        suggestedFix?: string | undefined;
+    }[];
+    nextAction: "execute" | "revise_request" | "treat_as_passthrough" | "manual_review";
+    challenge: {
+        headers: Record<string, string>;
+        protocol: "x402" | "l402";
+        body?: unknown;
+    };
+    probe?: {
+        responseStatus: number;
+        confirmedAt: string;
+    } | undefined;
+    paymentRequirement?: {
+        protocol: "x402" | "l402";
+        provenance: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+        asset?: string | undefined;
+        amount?: string | undefined;
+        amountMinor?: string | undefined;
+        precision?: number | undefined;
+        description?: string | undefined;
+        network?: string | undefined;
+        payee?: string | undefined;
+        amountType?: "exact" | "max" | undefined;
+        confirmation?: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    protocol: "x402" | "l402";
+    kind: "ready";
+    request: {
+        url: string;
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+        headers?: Record<string, string> | undefined;
+        body?: string | undefined;
+        bodyHash?: string | undefined;
+    };
+    hints: {
+        description?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyType?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyExample?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyFields?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestQueryParams?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestPathParams?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        notes?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }[] | undefined;
+    };
+    nextAction: "execute" | "revise_request" | "treat_as_passthrough" | "manual_review";
+    challenge: {
+        protocol: "x402" | "l402";
+        headers?: Record<string, string> | undefined;
+        body?: unknown;
+    };
+    probe?: {
+        responseStatus: number;
+        confirmedAt: string;
+    } | undefined;
+    validationIssues?: {
+        code: string;
+        message: string;
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        location: "path" | "headers" | "body" | "query";
+        field: string;
+        blocking: boolean;
+        severity: "error" | "warning";
+        suggestedFix?: string | undefined;
+    }[] | undefined;
+    paymentRequirement?: {
+        protocol: "x402" | "l402";
+        provenance: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+        asset?: string | undefined;
+        amount?: string | undefined;
+        amountMinor?: string | undefined;
+        precision?: number | undefined;
+        description?: string | undefined;
+        network?: string | undefined;
+        payee?: string | undefined;
+        amountType?: "exact" | "max" | undefined;
+        confirmation?: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        } | undefined;
+    } | undefined;
+}>;
+export type SdkPreparedPaidRequestReady = z.infer<typeof sdkPreparedPaidRequestReadySchema>;
+/** Discriminated union returned by AgentPayClient.preparePaidRequest(). */
+export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"passthrough">;
+    protocol: z.ZodLiteral<"none">;
+    request: z.ZodObject<{
+        url: z.ZodString;
+        method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        body: z.ZodOptional<z.ZodString>;
+        bodyHash: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+        headers?: Record<string, string> | undefined;
+        body?: string | undefined;
+        bodyHash?: string | undefined;
+    }, {
+        url: string;
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+        headers?: Record<string, string> | undefined;
+        body?: string | undefined;
+        bodyHash?: string | undefined;
+    }>;
+    hints: z.ZodObject<{
+        description: z.ZodOptional<z.ZodObject<{
+            value: z.ZodString;
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }>>;
+        requestBodyType: z.ZodOptional<z.ZodObject<{
+            value: z.ZodString;
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }>>;
+        requestBodyExample: z.ZodOptional<z.ZodObject<{
+            value: z.ZodString;
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }>>;
+        requestBodyFields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            defaultValue: z.ZodOptional<z.ZodUnknown>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        } & {
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }>, "many">>;
+        requestQueryParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            defaultValue: z.ZodOptional<z.ZodUnknown>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        } & {
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }>, "many">>;
+        requestPathParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            defaultValue: z.ZodOptional<z.ZodUnknown>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        } & {
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }>, "many">>;
+        notes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        requestBodyFields: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        requestQueryParams: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        requestPathParams: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        notes: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }[];
+        description?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyType?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyExample?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+    }, {
+        description?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyType?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyExample?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyFields?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestQueryParams?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestPathParams?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        notes?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }[] | undefined;
+    }>;
+    probe: z.ZodOptional<z.ZodObject<{
+        responseStatus: z.ZodNumber;
+        confirmedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        responseStatus: number;
+        confirmedAt: string;
+    }, {
+        responseStatus: number;
+        confirmedAt: string;
+    }>>;
+    validationIssues: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        location: z.ZodEnum<["body", "query", "path", "headers"]>;
+        field: z.ZodString;
+        code: z.ZodString;
+        message: z.ZodString;
+        source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+        blocking: z.ZodBoolean;
+        severity: z.ZodEnum<["error", "warning"]>;
+        suggestedFix: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        location: "path" | "headers" | "body" | "query";
+        field: string;
+        blocking: boolean;
+        severity: "error" | "warning";
+        suggestedFix?: string | undefined;
+    }, {
+        code: string;
+        message: string;
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        location: "path" | "headers" | "body" | "query";
+        field: string;
+        blocking: boolean;
+        severity: "error" | "warning";
+        suggestedFix?: string | undefined;
+    }>, "many">>;
+    nextAction: z.ZodEnum<["execute", "revise_request", "treat_as_passthrough", "manual_review"]>;
+}, "strip", z.ZodTypeAny, {
+    protocol: "none";
+    kind: "passthrough";
+    request: {
+        url: string;
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+        headers?: Record<string, string> | undefined;
+        body?: string | undefined;
+        bodyHash?: string | undefined;
+    };
+    hints: {
+        requestBodyFields: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        requestQueryParams: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        requestPathParams: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        notes: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }[];
+        description?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyType?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyExample?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+    };
+    validationIssues: {
+        code: string;
+        message: string;
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        location: "path" | "headers" | "body" | "query";
+        field: string;
+        blocking: boolean;
+        severity: "error" | "warning";
+        suggestedFix?: string | undefined;
+    }[];
+    nextAction: "execute" | "revise_request" | "treat_as_passthrough" | "manual_review";
+    probe?: {
+        responseStatus: number;
+        confirmedAt: string;
+    } | undefined;
+}, {
+    protocol: "none";
+    kind: "passthrough";
+    request: {
+        url: string;
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+        headers?: Record<string, string> | undefined;
+        body?: string | undefined;
+        bodyHash?: string | undefined;
+    };
+    hints: {
+        description?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyType?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyExample?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyFields?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestQueryParams?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestPathParams?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        notes?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }[] | undefined;
+    };
+    nextAction: "execute" | "revise_request" | "treat_as_passthrough" | "manual_review";
+    probe?: {
+        responseStatus: number;
+        confirmedAt: string;
+    } | undefined;
+    validationIssues?: {
+        code: string;
+        message: string;
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        location: "path" | "headers" | "body" | "query";
+        field: string;
+        blocking: boolean;
+        severity: "error" | "warning";
+        suggestedFix?: string | undefined;
+    }[] | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"ready">;
+    protocol: z.ZodEnum<["x402", "l402"]>;
+    request: z.ZodObject<{
+        url: z.ZodString;
+        method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        body: z.ZodOptional<z.ZodString>;
+        bodyHash: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+        headers?: Record<string, string> | undefined;
+        body?: string | undefined;
+        bodyHash?: string | undefined;
+    }, {
+        url: string;
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+        headers?: Record<string, string> | undefined;
+        body?: string | undefined;
+        bodyHash?: string | undefined;
+    }>;
+    challenge: z.ZodObject<{
+        protocol: z.ZodEnum<["x402", "l402"]>;
+        headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        body: z.ZodOptional<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        headers: Record<string, string>;
+        protocol: "x402" | "l402";
+        body?: unknown;
+    }, {
+        protocol: "x402" | "l402";
+        headers?: Record<string, string> | undefined;
+        body?: unknown;
+    }>;
+    paymentRequirement: z.ZodOptional<z.ZodObject<{
+        protocol: z.ZodEnum<["x402", "l402"]>;
+        description: z.ZodOptional<z.ZodString>;
+        asset: z.ZodOptional<z.ZodString>;
+        network: z.ZodOptional<z.ZodString>;
+        payee: z.ZodOptional<z.ZodString>;
+        amountType: z.ZodOptional<z.ZodEnum<["exact", "max"]>>;
+        amount: z.ZodOptional<z.ZodString>;
+        amountMinor: z.ZodOptional<z.ZodString>;
+        precision: z.ZodOptional<z.ZodNumber>;
+        provenance: z.ZodObject<{
+            source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+            authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+            note: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }>;
+        confirmation: z.ZodOptional<z.ZodObject<{
+            source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+            authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+            note: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }, {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        protocol: "x402" | "l402";
+        provenance: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+        asset?: string | undefined;
+        amount?: string | undefined;
+        amountMinor?: string | undefined;
+        precision?: number | undefined;
+        description?: string | undefined;
+        network?: string | undefined;
+        payee?: string | undefined;
+        amountType?: "exact" | "max" | undefined;
+        confirmation?: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        } | undefined;
+    }, {
+        protocol: "x402" | "l402";
+        provenance: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+        asset?: string | undefined;
+        amount?: string | undefined;
+        amountMinor?: string | undefined;
+        precision?: number | undefined;
+        description?: string | undefined;
+        network?: string | undefined;
+        payee?: string | undefined;
+        amountType?: "exact" | "max" | undefined;
+        confirmation?: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        } | undefined;
+    }>>;
+    hints: z.ZodObject<{
+        description: z.ZodOptional<z.ZodObject<{
+            value: z.ZodString;
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }>>;
+        requestBodyType: z.ZodOptional<z.ZodObject<{
+            value: z.ZodString;
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }>>;
+        requestBodyExample: z.ZodOptional<z.ZodObject<{
+            value: z.ZodString;
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }>>;
+        requestBodyFields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            defaultValue: z.ZodOptional<z.ZodUnknown>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        } & {
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }>, "many">>;
+        requestQueryParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            defaultValue: z.ZodOptional<z.ZodUnknown>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        } & {
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }>, "many">>;
+        requestPathParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            defaultValue: z.ZodOptional<z.ZodUnknown>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        } & {
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }, {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }>, "many">>;
+        notes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            attribution: z.ZodObject<{
+                source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+                authority: z.ZodEnum<["authoritative", "confirmatory", "advisory"]>;
+                note: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }, {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }, {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        requestBodyFields: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        requestQueryParams: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        requestPathParams: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        notes: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }[];
+        description?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyType?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyExample?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+    }, {
+        description?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyType?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyExample?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyFields?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestQueryParams?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestPathParams?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        notes?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }[] | undefined;
+    }>;
+    probe: z.ZodOptional<z.ZodObject<{
+        responseStatus: z.ZodNumber;
+        confirmedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        responseStatus: number;
+        confirmedAt: string;
+    }, {
+        responseStatus: number;
+        confirmedAt: string;
+    }>>;
+    validationIssues: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        location: z.ZodEnum<["body", "query", "path", "headers"]>;
+        field: z.ZodString;
+        code: z.ZodString;
+        message: z.ZodString;
+        source: z.ZodEnum<["marketplace", "provider", "merchant_challenge", "runtime_probe"]>;
+        blocking: z.ZodBoolean;
+        severity: z.ZodEnum<["error", "warning"]>;
+        suggestedFix: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        location: "path" | "headers" | "body" | "query";
+        field: string;
+        blocking: boolean;
+        severity: "error" | "warning";
+        suggestedFix?: string | undefined;
+    }, {
+        code: string;
+        message: string;
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        location: "path" | "headers" | "body" | "query";
+        field: string;
+        blocking: boolean;
+        severity: "error" | "warning";
+        suggestedFix?: string | undefined;
+    }>, "many">>;
+    nextAction: z.ZodEnum<["execute", "revise_request", "treat_as_passthrough", "manual_review"]>;
+}, "strip", z.ZodTypeAny, {
+    protocol: "x402" | "l402";
+    kind: "ready";
+    request: {
+        url: string;
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+        headers?: Record<string, string> | undefined;
+        body?: string | undefined;
+        bodyHash?: string | undefined;
+    };
+    hints: {
+        requestBodyFields: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        requestQueryParams: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        requestPathParams: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[];
+        notes: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }[];
+        description?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyType?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyExample?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+    };
+    validationIssues: {
+        code: string;
+        message: string;
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        location: "path" | "headers" | "body" | "query";
+        field: string;
+        blocking: boolean;
+        severity: "error" | "warning";
+        suggestedFix?: string | undefined;
+    }[];
+    nextAction: "execute" | "revise_request" | "treat_as_passthrough" | "manual_review";
+    challenge: {
+        headers: Record<string, string>;
+        protocol: "x402" | "l402";
+        body?: unknown;
+    };
+    probe?: {
+        responseStatus: number;
+        confirmedAt: string;
+    } | undefined;
+    paymentRequirement?: {
+        protocol: "x402" | "l402";
+        provenance: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+        asset?: string | undefined;
+        amount?: string | undefined;
+        amountMinor?: string | undefined;
+        precision?: number | undefined;
+        description?: string | undefined;
+        network?: string | undefined;
+        payee?: string | undefined;
+        amountType?: "exact" | "max" | undefined;
+        confirmation?: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    protocol: "x402" | "l402";
+    kind: "ready";
+    request: {
+        url: string;
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+        headers?: Record<string, string> | undefined;
+        body?: string | undefined;
+        bodyHash?: string | undefined;
+    };
+    hints: {
+        description?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyType?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyExample?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        } | undefined;
+        requestBodyFields?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestQueryParams?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        requestPathParams?: {
+            name: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+            type?: string | undefined;
+            required?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: unknown;
+            enumValues?: string[] | undefined;
+        }[] | undefined;
+        notes?: {
+            value: string;
+            attribution: {
+                source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+                authority: "authoritative" | "confirmatory" | "advisory";
+                note?: string | undefined;
+            };
+        }[] | undefined;
+    };
+    nextAction: "execute" | "revise_request" | "treat_as_passthrough" | "manual_review";
+    challenge: {
+        protocol: "x402" | "l402";
+        headers?: Record<string, string> | undefined;
+        body?: unknown;
+    };
+    probe?: {
+        responseStatus: number;
+        confirmedAt: string;
+    } | undefined;
+    validationIssues?: {
+        code: string;
+        message: string;
+        source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+        location: "path" | "headers" | "body" | "query";
+        field: string;
+        blocking: boolean;
+        severity: "error" | "warning";
+        suggestedFix?: string | undefined;
+    }[] | undefined;
+    paymentRequirement?: {
+        protocol: "x402" | "l402";
+        provenance: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        };
+        asset?: string | undefined;
+        amount?: string | undefined;
+        amountMinor?: string | undefined;
+        precision?: number | undefined;
+        description?: string | undefined;
+        network?: string | undefined;
+        payee?: string | undefined;
+        amountType?: "exact" | "max" | undefined;
+        confirmation?: {
+            source: "marketplace" | "provider" | "merchant_challenge" | "runtime_probe";
+            authority: "authoritative" | "confirmatory" | "advisory";
+            note?: string | undefined;
+        } | undefined;
+    } | undefined;
+}>]>;
+export type SdkPreparedPaidRequest = z.infer<typeof sdkPreparedPaidRequestSchema>;
+/** Control-plane request shape used for governed paid execution decisions. */
 export declare const sdkPaymentDecisionRequestSchema: z.ZodObject<{
     context: z.ZodObject<{
         organization: z.ZodString;
@@ -165,12 +4296,6 @@ export declare const sdkPaymentDecisionRequestSchema: z.ZodObject<{
     }>;
     idempotencyKey: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    context: {
-        organization: string;
-        agent: string;
-        description?: string | undefined;
-        metadata?: Record<string, unknown> | undefined;
-    };
     request: {
         url: string;
         method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
@@ -183,14 +4308,14 @@ export declare const sdkPaymentDecisionRequestSchema: z.ZodObject<{
         protocol: "x402" | "l402";
         body?: unknown;
     };
-    idempotencyKey?: string | undefined;
-}, {
     context: {
         organization: string;
         agent: string;
         description?: string | undefined;
         metadata?: Record<string, unknown> | undefined;
     };
+    idempotencyKey?: string | undefined;
+}, {
     request: {
         url: string;
         method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
@@ -203,9 +4328,16 @@ export declare const sdkPaymentDecisionRequestSchema: z.ZodObject<{
         headers?: Record<string, string> | undefined;
         body?: unknown;
     };
+    context: {
+        organization: string;
+        agent: string;
+        description?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    };
     idempotencyKey?: string | undefined;
 }>;
 export type SdkPaymentDecisionRequest = z.infer<typeof sdkPaymentDecisionRequestSchema>;
+/** Durable receipt shape returned after the control plane records an outcome. */
 export declare const sdkReceiptSchema: z.ZodObject<{
     receiptId: z.ZodString;
     paidRequestId: z.ZodString;
@@ -285,12 +4417,12 @@ export declare const sdkReceiptSchema: z.ZodObject<{
     requestUrl: string;
     requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
     createdAt: string;
+    confirmedAt?: string | undefined;
     merchantId?: string | undefined;
     confirmationSource?: "chain_observer" | undefined;
     attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
     attributionBasis?: Record<string, unknown> | undefined;
     attributionRuleVersion?: string | undefined;
-    confirmedAt?: string | undefined;
     finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
     canonicalSettlementKey?: string | undefined;
     paymentReference?: string | undefined;
@@ -320,12 +4452,12 @@ export declare const sdkReceiptSchema: z.ZodObject<{
     requestUrl: string;
     requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
     createdAt: string;
+    confirmedAt?: string | undefined;
     merchantId?: string | undefined;
     confirmationSource?: "chain_observer" | undefined;
     attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
     attributionBasis?: Record<string, unknown> | undefined;
     attributionRuleVersion?: string | undefined;
-    confirmedAt?: string | undefined;
     finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
     canonicalSettlementKey?: string | undefined;
     paymentReference?: string | undefined;
@@ -337,6 +4469,7 @@ export declare const sdkReceiptSchema: z.ZodObject<{
     completedAt?: string | undefined;
 }>;
 export type SdkReceipt = z.infer<typeof sdkReceiptSchema>;
+/** Normalized merchant HTTP response embedded in SDK results and decisions. */
 export declare const sdkMerchantResponseSchema: z.ZodObject<{
     status: z.ZodNumber;
     headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -449,12 +4582,12 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        confirmedAt?: string | undefined;
         merchantId?: string | undefined;
         confirmationSource?: "chain_observer" | undefined;
         attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
         attributionBasis?: Record<string, unknown> | undefined;
         attributionRuleVersion?: string | undefined;
-        confirmedAt?: string | undefined;
         finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
         canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
@@ -484,12 +4617,12 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        confirmedAt?: string | undefined;
         merchantId?: string | undefined;
         confirmationSource?: "chain_observer" | undefined;
         attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
         attributionBasis?: Record<string, unknown> | undefined;
         attributionRuleVersion?: string | undefined;
-        confirmedAt?: string | undefined;
         finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
         canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
@@ -531,12 +4664,12 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        confirmedAt?: string | undefined;
         merchantId?: string | undefined;
         confirmationSource?: "chain_observer" | undefined;
         attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
         attributionBasis?: Record<string, unknown> | undefined;
         attributionRuleVersion?: string | undefined;
-        confirmedAt?: string | undefined;
         finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
         canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
@@ -578,12 +4711,12 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        confirmedAt?: string | undefined;
         merchantId?: string | undefined;
         confirmationSource?: "chain_observer" | undefined;
         attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
         attributionBasis?: Record<string, unknown> | undefined;
         attributionRuleVersion?: string | undefined;
-        confirmedAt?: string | undefined;
         finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
         canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
@@ -695,12 +4828,12 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        confirmedAt?: string | undefined;
         merchantId?: string | undefined;
         confirmationSource?: "chain_observer" | undefined;
         attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
         attributionBasis?: Record<string, unknown> | undefined;
         attributionRuleVersion?: string | undefined;
-        confirmedAt?: string | undefined;
         finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
         canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
@@ -730,12 +4863,12 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        confirmedAt?: string | undefined;
         merchantId?: string | undefined;
         confirmationSource?: "chain_observer" | undefined;
         attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
         attributionBasis?: Record<string, unknown> | undefined;
         attributionRuleVersion?: string | undefined;
-        confirmedAt?: string | undefined;
         finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
         canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
@@ -780,12 +4913,12 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        confirmedAt?: string | undefined;
         merchantId?: string | undefined;
         confirmationSource?: "chain_observer" | undefined;
         attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
         attributionBasis?: Record<string, unknown> | undefined;
         attributionRuleVersion?: string | undefined;
-        confirmedAt?: string | undefined;
         finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
         canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
@@ -830,12 +4963,12 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        confirmedAt?: string | undefined;
         merchantId?: string | undefined;
         confirmationSource?: "chain_observer" | undefined;
         attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
         attributionBasis?: Record<string, unknown> | undefined;
         attributionRuleVersion?: string | undefined;
-        confirmedAt?: string | undefined;
         finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
         canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
@@ -975,6 +5108,7 @@ export declare const sdkPaymentDecisionDenyResponseSchema: z.ZodObject<{
     paidRequestId?: string | undefined;
     policyReviewEventId?: string | undefined;
 }>;
+/** Full union of decision outcomes the control plane can return to the SDK. */
 export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"outcome", [z.ZodObject<{
     outcome: z.ZodLiteral<"allow">;
     paidRequestId: z.ZodString;
@@ -1073,12 +5207,12 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        confirmedAt?: string | undefined;
         merchantId?: string | undefined;
         confirmationSource?: "chain_observer" | undefined;
         attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
         attributionBasis?: Record<string, unknown> | undefined;
         attributionRuleVersion?: string | undefined;
-        confirmedAt?: string | undefined;
         finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
         canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
@@ -1108,12 +5242,12 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        confirmedAt?: string | undefined;
         merchantId?: string | undefined;
         confirmationSource?: "chain_observer" | undefined;
         attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
         attributionBasis?: Record<string, unknown> | undefined;
         attributionRuleVersion?: string | undefined;
-        confirmedAt?: string | undefined;
         finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
         canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
@@ -1155,12 +5289,12 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        confirmedAt?: string | undefined;
         merchantId?: string | undefined;
         confirmationSource?: "chain_observer" | undefined;
         attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
         attributionBasis?: Record<string, unknown> | undefined;
         attributionRuleVersion?: string | undefined;
-        confirmedAt?: string | undefined;
         finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
         canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
@@ -1202,12 +5336,12 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        confirmedAt?: string | undefined;
         merchantId?: string | undefined;
         confirmationSource?: "chain_observer" | undefined;
         attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
         attributionBasis?: Record<string, unknown> | undefined;
         attributionRuleVersion?: string | undefined;
-        confirmedAt?: string | undefined;
         finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
         canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
@@ -1318,12 +5452,12 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        confirmedAt?: string | undefined;
         merchantId?: string | undefined;
         confirmationSource?: "chain_observer" | undefined;
         attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
         attributionBasis?: Record<string, unknown> | undefined;
         attributionRuleVersion?: string | undefined;
-        confirmedAt?: string | undefined;
         finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
         canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
@@ -1353,12 +5487,12 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        confirmedAt?: string | undefined;
         merchantId?: string | undefined;
         confirmationSource?: "chain_observer" | undefined;
         attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
         attributionBasis?: Record<string, unknown> | undefined;
         attributionRuleVersion?: string | undefined;
-        confirmedAt?: string | undefined;
         finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
         canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
@@ -1403,12 +5537,12 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        confirmedAt?: string | undefined;
         merchantId?: string | undefined;
         confirmationSource?: "chain_observer" | undefined;
         attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
         attributionBasis?: Record<string, unknown> | undefined;
         attributionRuleVersion?: string | undefined;
-        confirmedAt?: string | undefined;
         finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
         canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
@@ -1453,12 +5587,12 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        confirmedAt?: string | undefined;
         merchantId?: string | undefined;
         confirmationSource?: "chain_observer" | undefined;
         attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
         attributionBasis?: Record<string, unknown> | undefined;
         attributionRuleVersion?: string | undefined;
-        confirmedAt?: string | undefined;
         finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
         canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
@@ -1594,6 +5728,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
     policyReviewEventId?: string | undefined;
 }>]>;
 export type SdkPaymentDecisionResponse = z.infer<typeof sdkPaymentDecisionResponseSchema>;
+/** Receipt lookup response returned by AgentPayClient.lookupReceipt(). */
 export declare const sdkReceiptResponseSchema: z.ZodObject<{
     receipt: z.ZodObject<{
         receiptId: z.ZodString;
@@ -1674,12 +5809,12 @@ export declare const sdkReceiptResponseSchema: z.ZodObject<{
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        confirmedAt?: string | undefined;
         merchantId?: string | undefined;
         confirmationSource?: "chain_observer" | undefined;
         attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
         attributionBasis?: Record<string, unknown> | undefined;
         attributionRuleVersion?: string | undefined;
-        confirmedAt?: string | undefined;
         finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
         canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
@@ -1709,12 +5844,12 @@ export declare const sdkReceiptResponseSchema: z.ZodObject<{
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        confirmedAt?: string | undefined;
         merchantId?: string | undefined;
         confirmationSource?: "chain_observer" | undefined;
         attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
         attributionBasis?: Record<string, unknown> | undefined;
         attributionRuleVersion?: string | undefined;
-        confirmedAt?: string | undefined;
         finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
         canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
@@ -1746,12 +5881,12 @@ export declare const sdkReceiptResponseSchema: z.ZodObject<{
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        confirmedAt?: string | undefined;
         merchantId?: string | undefined;
         confirmationSource?: "chain_observer" | undefined;
         attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
         attributionBasis?: Record<string, unknown> | undefined;
         attributionRuleVersion?: string | undefined;
-        confirmedAt?: string | undefined;
         finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
         canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;
@@ -1783,12 +5918,12 @@ export declare const sdkReceiptResponseSchema: z.ZodObject<{
         requestUrl: string;
         requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
         createdAt: string;
+        confirmedAt?: string | undefined;
         merchantId?: string | undefined;
         confirmationSource?: "chain_observer" | undefined;
         attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
         attributionBasis?: Record<string, unknown> | undefined;
         attributionRuleVersion?: string | undefined;
-        confirmedAt?: string | undefined;
         finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
         canonicalSettlementKey?: string | undefined;
         paymentReference?: string | undefined;